Saltar al contenido principal

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.

​
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

ConceptoDescripción
OrganizaciónLa 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.
VeriFactuSistema 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ónToken Bearer de corta duración (24 h) obtenido al intercambiar tu api_key. Requerido en todos los endpoints protegidos.

​
Inicio rápido

1

Obtén tu API key

2

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"}'
3

Envía un lote de facturas

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