POST /v1/verifactu/crear
{
"version": "1.0",
"cabecera": {
"serie": "A", "numero": "882",
"fechaExpedicion": "03-04-2026",
"tipoFactura": "F1", "descripcion": "…"
},
"emisor": { "nif": "B76116342", "nombre": "…" },
"detalleDesglose": [ { "baseImponible": "100.00", … } ],
"totales": {
"cuotaTotal": "21.00", "importeTotal": "121.00"
}
}
// 200 OK
{
"estado": "aceptada",
"urlValidacion": "https://www2.agenciatributaria.gob.es/…",
"qrBase64": "data:image/png;base64,…", …
}
// Webhook · factura.registrada
{
"datos": {
"estadoFactura": "registrada", "csvAeat": "…", …
}
}POST /v1/verifactu/crear
{
"cabecera": {
"serie": "A",
"numero": "882",
"fechaExpedicion": "03-04-2026"
},
"emisor": { "nif": "B76116342" },
"detalleDesglose": [ … ],
"totales": {
"importeTotal": "121.00"
}
}
// 200 OK
{
"estado": "aceptada",
"urlValidacion": "https://…",
"qrBase64": "data:image/png;…"
}
// Webhook · factura.registrada
{
"datos": {
"estadoFactura": "registrada",
"csvAeat": "…"
}
}
POST /v1/ticketbai/crear
{
"provincia": "gipuzkoa",
"serie": "A", "numero": "882",
"fechaExpedicion": "03-04-2026",
"tipoFactura": "F1",
"emisor": { "nif": "B76116342", "nombre": "…" },
"desglose": [ { "baseImponible": "100.00", … } ],
"importeTotal": "121.00"
}
// 200 OK
{
"estado": "aceptada",
"idTbai": "TBAI-B76116342-030426-Ijx21+K7AzOQr-026",
"urlValidacion": "https://tbai.egoitza.gipuzkoa.eus/qr/…",
"qrBase64": "data:image/png;base64,…", …
}
// Webhook · factura.registrada
{
"datos": {
"estadoFactura": "registrada",
"idRegistroTbai": "TBAI-B76116342-030426…", …
}
}POST /v1/ticketbai/crear
{
"provincia": "gipuzkoa",
"serie": "A",
"numero": "882",
"fechaExpedicion": "03-04-2026",
"emisor": { "nif": "B76116342" },
"desglose": [ … ],
"importeTotal": "121.00"
}
// 200 OK
{
"estado": "aceptada",
"idTbai": "TBAI-B76116342-0304…",
"qrBase64": "data:image/png;…"
}
// Webhook · factura.registrada
{
"datos": {
"estadoFactura": "registrada",
"idRegistroTbai": "TBAI-B761…"
}
}