Saltar al contingut 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 és una plataforma de facturació espanyola que permet a les organitzacions crear, emetre i gestionar factures conforme a la normativa fiscal espanyola, incloent-hi el sistema VeriFactu per a la sincronització de factures en temps real amb l’Agència Tributària (AEAT).

​
Què pots fer amb l’API

L’API v1 de YoFacturo permet a sistemes externs i integracions:
  • Enviar lots de factures — envia fins a 1.000 factures per sol·licitud per al seu processament i emissió asíncrons.
  • Consultar l’estat del lot — consulta l’estat dels lots enviats i inspecciona el resultat del processament de cada factura individual.
  • Monitoritzar la sincronització amb VeriFactu — comprova si cada factura ha estat sincronitzada amb el sistema fiscal VeriFactu d’Espanya.

​
A qui va dirigida aquesta documentació?

Aquesta documentació va dirigida a desenvolupadors que integren sistemes de tercers (ERPs, eines de facturació, programari de comptabilitat) amb YoFacturo de manera programàtica mitjançant l’API REST. Si ets usuari final de l’aplicació web de YoFacturo, visita app.yofacturo.es.

​
Conceptes clau

ConcepteDescripció
OrganitzacióL’entitat facturadora a YoFacturo. Cada organització té una api_key per autenticar les sol·licituds a l’API.
Lot de factures (invoice_batch)Un contenidor d’1–1.000 factures enviades en una única crida a l’API. Els lots es processen de manera asíncrona.
Factura del lot (batch_invoice)Una factura individual dins d’un lot. Registra processing_status i verifactu_state.
VeriFactuSistema de verificació de factures en temps real d’Espanya, gestionat per l’AEAT. Les factures emeses s’envien automàticament a VeriFactu.
Token de sessióToken Bearer de curta durada (24 h) obtingut en intercanviar la teva api_key. Necessari per a tots els endpoints protegits.

​
Inici ràpid

1

Obtén la teva API key

2

Intercanvia-la per un token de sessió

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

Envia un lot de factures

Utilitza el session_token del pas anterior com a Bearer token per cridar POST /api/v1/invoice_batches.