Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.yofacturo.es/llms.txt

Use this file to discover all available pages before exploring further.

YoFacturo

YoFacturo is a Spanish invoicing platform that lets organizations create, issue, and manage invoices in compliance with Spanish fiscal regulations, including the VeriFactu system for real-time invoice synchronization with the Spanish tax authorities (AEAT).

What you can do with the API

The YoFacturo API v1 allows external systems and integrations to:
  • Submit invoice batches — send up to 1,000 invoices per request for asynchronous processing and issuance.
  • Track batch status — poll the status of submitted batches and inspect the processing result of each individual invoice.
  • Monitor VeriFactu synchronization — check whether each invoice has been synchronized with Spain’s VeriFactu fiscal system.

Who is this documentation for?

This documentation is aimed at developers integrating third-party systems (ERPs, billing tools, accounting software) with YoFacturo programmatically via the REST API. If you are an end user of the YoFacturo web application, visit app.yofacturo.es instead.

Key concepts

ConceptDescription
OrganizationThe billing entity in YoFacturo. Each organization has an api_key used to authenticate API requests.
Invoice Batch (invoice_batch)A container of 1–1,000 invoices submitted in a single API call. Batches are processed asynchronously.
Batch Invoice (batch_invoice)An individual invoice inside a batch. Tracks processing_status and verifactu_state.
VeriFactuSpain’s real-time invoice verification system managed by AEAT. Issued invoices are automatically submitted to VeriFactu.
Session TokenA short-lived bearer token (24 h) obtained by exchanging your api_key. Required for all protected endpoints.

Quick start

1

Get your API key

Log in to YoFacturo, go to Settings → API, and copy your organization’s api_key.
2

Exchange it for a session token

curl -X POST https://app.yofacturo.es/api/v1/auth/sessions \
  -H "Content-Type: application/json" \
  -d '{"api_key": "org_live_your_key_here"}'
3

Submit an invoice batch

Use the session_token from the previous step as a Bearer token to call POST /api/v1/invoice_batches.