REST API · JSON · HTTPS

Integra Zicobro en tu aplicación

Una llamada API. Tu factura firmada, encadenada y enviada a la AEAT. Con el CSV oficial de vuelta en la respuesta.

Obtener API Key gratis Referencia Swagger

Autenticación

Todas las rutas autenticadas requieren el header Authorization con tu API Key en formato Bearer.

Authorization: Bearer vf_live_XXXX_YYYYYYYYYYYY

Recibes tu API Key al completar el registro. Solo se muestra una vez — guárdala en un lugar seguro.

POST/api/facturas/emitir

Emitir factura

Firma con XAdES-BES, encadena criptográficamente y envía a la AEAT en una sola llamada. Devuelve el CSV oficial y el QR de verificación.

curl -X POST https://api.zicobro.com/api/facturas/emitir \
  -H "Authorization: Bearer vf_live_XXXX_YYYY" \
  -H "Content-Type: application/json" \
  -d '{
    "emisor": {
      "nif": "B12345678",
      "nombre": "Mi Empresa SL"
    },
    "receptor": {
      "nif": "12345678Z",
      "nombre": "Cliente SA"
    },
    "factura": {
      "numSerie": "FAC-2025-001",
      "fechaExpedicion": "2025-10-01",
      "tipoFactura": "F1",
      "descripcionGeneral": "Servicios de consultoría",
      "importeTotal": 121.00
    },
    "desglose": [{
      "tipoImpuesto": "IVA",
      "claveRegimen": "01",
      "calificacionOperacion": "S1",
      "baseImponible": 100.00,
      "tipoImpositivo": 21.00,
      "cuotaRepercutida": 21.00
    }]
  }'

Respuesta

{
  "ok": true,
  "ledgerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "huella": "a3f1c2d4...",
  "totales": {
    "cuotaTotal": "21.00",
    "importeTotal": "121.00"
  },
  "urlQR": "https://sede.agenciatributaria.gob.es/...",
  "aeat": {
    "estado": "CORRECTO",
    "csv": "ABC123DEF456",
    "timestampPresentacion": "2025-10-01T10:30:00Z"
  }
}

Referencia de endpoints

Método	Ruta	Descripción
POST	/api/facturas/emitir	Emite y envía una factura a la AEAT
POST	/api/facturas/anular	Anula una factura emitida
GET	/api/facturas	Lista facturas con filtros y paginación
GET	/api/facturas/:nif/:numSerie	Detalle completo de una factura
GET	/api/facturas/xml/:id	Descarga el XML firmado (XAdES-BES)
GET	/api/facturas/cadena/verificar	Verifica la integridad criptográfica del registro
GET	/api/tenants/me	Perfil, certificado activo y estadísticas
POST	/api/tenants/me/api-key/regenerate	Rota la API Key (la anterior queda inválida)
PUT	/api/tenants/me/webhook	Configura la URL de webhook

Webhooks

Configura una URL y Zicobro te notificará en tiempo real cuando la AEAT procese cada factura. Los envíos fallidos se reintentan automáticamente con backoff exponencial.

{
  "evento": "factura.procesada",
  "ledgerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "numSerie": "FAC-2025-001",
  "estado": "CORRECTO",
  "csv": "ABC123DEF456",
  "timestamp": "2025-10-01T10:30:00Z"
}

Configura tu webhook desde el dashboard o vía PUT /api/tenants/me/webhook.

Listo para integrar

Regístrate gratis, obtén tu API Key y emite tu primera factura en minutos.

Crear cuenta gratis Ver Swagger completo