API pública

Documentación de Integración

Integra la API de FE para crear, emitir y consultar e-CF de manera segura con autenticación por API Key y operaciones idempotentes.

Ver OpenAPI YAMLEndpoint base v1

Autenticación

Usa `Authorization: Bearer <API_KEY>`.

Idempotencia

Incluye `Idempotency-Key` en POST/PATCH/DELETE para evitar duplicados.

Formato de errores

Las respuestas fallidas incluyen `error` y `code`.

Endpoints disponibles

23 operaciones documentadas

  • GET/api/v1/invoices

    Listar facturas

  • POST/api/v1/invoices

    Crear factura en borrador

  • GET/api/v1/invoices/{id}

    Obtener detalle de factura

  • POST/api/v1/invoices/{id}/emit

    Emitir factura a DGII

  • GET/api/v1/invoices/{id}/status

    Consultar estado de una factura

  • POST/api/v1/invoices/{id}/retry-emit

    Reintentar emisión de factura

  • POST/api/v1/invoices/{id}/cancel

    Anular factura

  • GET/api/v1/invoices/{id}/pdf

    Descargar/visualizar PDF de factura

  • GET/api/v1/invoices/{id}/xml

    Obtener XML firmado o generado

  • GET/api/v1/customers

    Listar clientes

  • POST/api/v1/customers

    Crear cliente

  • GET/api/v1/customers/{id}

    Obtener cliente

  • PATCH/api/v1/customers/{id}

    Actualizar cliente

  • GET/api/v1/catalogs

    Consultar catálogos DGII

  • GET/api/v1/idempotency/keys

    Listar llaves de idempotencia

  • POST/api/v1/idempotency/cleanup

    Limpiar llaves de idempotencia expiradas/stale

  • GET/api/v1/webhooks/endpoints

    Listar endpoints webhook

  • POST/api/v1/webhooks/endpoints

    Crear endpoint webhook

  • DELETE/api/v1/webhooks/endpoints/{id}

    Desactivar endpoint webhook

  • GET/api/v1/webhooks/deliveries

    Listar entregas de webhook

  • GET/api/v1/webhooks/deliveries/{id}

    Obtener detalle de entrega webhook

  • POST/api/v1/webhooks/deliveries/{id}/retry

    Reintentar entrega de webhook

  • POST/api/v1/webhooks/process

    Procesar cola asíncrona de webhooks