1. Obtén tu API key
Ve a Ajustes → API keys y genera una key. La key de test (isk_test_…) usa el sandbox de AEAT (Pre-Producción) y no genera asientos contables reales.
export ISAAK_API_KEY="isk_test_xxxxxxxxxxxxxxxx"Crea, valida y emite una factura a VeriFactu desde cURL. Sin instalar nada, solo tu API key.
Ve a Ajustes → API keys y genera una key. La key de test (isk_test_…) usa el sandbox de AEAT (Pre-Producción) y no genera asientos contables reales.
export ISAAK_API_KEY="isk_test_xxxxxxxxxxxxxxxx"La primera llamada debería devolver los datos fiscales de tu empresa. Si recibes 401, revisa que el header Authorization tenga el formato exacto "Bearer <key>".
curl https://isaak.verifactu.business/api/v1/companies/current \
-H "Authorization: Bearer $ISAAK_API_KEY"{
"ok": true,
"data": {
"id": "tnt_xxx",
"name": "Acme SL",
"nif": "B12345678",
"verifactuEnabled": true
},
"meta": { "requestId": "req_...", "timestamp": "2026-05-28T10:00:00.000Z" }
}El POST devuelve la factura en estado draft. Todavía NO está en AEAT — solo está guardada en Isaak. Aprovecha para revisar líneas, NIF del cliente y totales antes de emitir.
curl -X POST https://isaak.verifactu.business/api/v1/invoices \
-H "Authorization: Bearer $ISAAK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"clientName": "Cliente Demo SL",
"clientNif": "B87654321",
"lines": [
{ "description": "Consultoría mayo 2026", "quantity": 1, "unitPrice": 1000.00, "vatRate": 21 }
]
}'Las emisiones a VeriFactu son inmutables. Por eso el endpoint /issue exige un confirmationToken: lo devuelve el preview anterior y caduca a los 5 minutos. Sin él recibes 400 missing_confirmation.
curl -X POST https://isaak.verifactu.business/api/v1/invoices/inv_xxx/issue \
-H "Authorization: Bearer $ISAAK_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "confirmationToken": "tkn_xxx_del_paso_previo" }'Una vez emitida, el PDF incluye el QR con el hash VeriFactu y el código seguro. Se sirve como application/pdf desde el endpoint /pdf.
curl https://isaak.verifactu.business/api/v1/invoices/inv_xxx/pdf \
-H "Authorization: Bearer $ISAAK_API_KEY" \
-o factura.pdf