Sobre YoFacturo

YoFacturo es una plataforma de facturación española que permite a las organizaciones crear, emitir y gestionar facturas conforme a la normativa fiscal española, incluyendo el sistema VeriFactu para la sincronización de facturas en tiempo real con la Agencia Tributaria (AEAT).

Qué puedes hacer con la API

La API v1 de YoFacturo permite a sistemas externos e integraciones:

Enviar lotes de facturas — envía hasta 1.000 facturas por solicitud para su procesamiento y emisión asíncrona.
Consultar el estado del lote — consulta el estado de los lotes enviados e inspecciona el resultado del procesamiento de cada factura individual.
Monitorizar la sincronización con VeriFactu — comprueba si cada factura ha sido sincronizada con el sistema fiscal VeriFactu de España.

¿A quién va dirigida esta documentación?

Esta documentación está dirigida a desarrolladores que integran sistemas de terceros (ERPs, herramientas de facturación, software de contabilidad) con YoFacturo de forma programática mediante la API REST. Si eres usuario final de la aplicación web de YoFacturo, visita app.yofacturo.es.

Conceptos clave

Concepto	Descripción
Organización	La entidad facturadora en YoFacturo. Cada organización tiene una `api_key` para autenticar las solicitudes a la API.
Lote de facturas (`invoice_batch`)	Un contenedor de 1–1.000 facturas enviadas en una única llamada a la API. Los lotes se procesan de forma asíncrona.
Factura del lote (`batch_invoice`)	Una factura individual dentro de un lote. Registra `processing_status` y `verifactu_state`.
VeriFactu	Sistema de verificación de facturas en tiempo real de España, gestionado por la AEAT. Las facturas emitidas se envían automáticamente a VeriFactu.
Token de sesión	Token Bearer de corta duración (24 h) obtenido al intercambiar tu `api_key`. Requerido en todos los endpoints protegidos.

Inicio rápido

Obtén tu API key

Intercámbiala por un token de sesión

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

Envía un lote de facturas

Usa el session_token del paso anterior como Bearer token para llamar a POST /api/v1/invoice_batches.

👋 Introducción

🔌 API REST

🤖 MCP

Primeros pasos

Sobre YoFacturo

Qué puedes hacer con la API

¿A quién va dirigida esta documentación?

Conceptos clave

Inicio rápido

​Sobre YoFacturo

​Qué puedes hacer con la API

​¿A quién va dirigida esta documentación?

​Conceptos clave

​Inicio rápido

Sobre YoFacturo

Qué puedes hacer con la API

¿A quién va dirigida esta documentación?

Conceptos clave

Inicio rápido