About 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

Concept	Description
Organization	The 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`.
VeriFactu	Spain’s real-time invoice verification system managed by AEAT. Issued invoices are automatically submitted to VeriFactu.
Session Token	A short-lived bearer token (24 h) obtained by exchanging your `api_key`. Required for all protected endpoints.

Quick start

Get your API key

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": "your_api_key_here"}'

Submit an invoice batch

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

👋 Introduction

🔌 API REST

🤖 MCP

Getting started

About YoFacturo

What you can do with the API

Who is this documentation for?

Key concepts

Quick start

​About YoFacturo

​What you can do with the API

​Who is this documentation for?

​Key concepts

​Quick start

About YoFacturo

What you can do with the API

Who is this documentation for?

Key concepts

Quick start