Beacon

Fiscal API

Ver como Markdown

Fiscal API

Endpoints de emisión fiscal, conciliación y gobernanza operacional en contexto PT.

reference • updated 2026-03-15

Objetivo

Controlar emisión fiscal, conciliación y readiness de configuración para mantener cumplimiento continuo sin bloquear la operación comercial.

Endpoints principales

EndpointFunciónCuándo usar
GET /v1/fiscal/overviewestado fiscal agregadomonitorización diaria y handover
POST /v1/fiscal/documentsemisión de documentos fiscalestras eventos comerciales elegibles
POST /v1/fiscal/reconciliationconciliación de discrepanciascierre diario/mensual o incidentes
GET /v1/fiscal/setup-statevalidación de readiness fiscalantes de go-live y tras cambios de configuración

Prerrequisitos de emisión

  • Perfil fiscal de la organización validado.
  • Series/secuencias activas en el modo correcto (test o live).
  • Integración con proveedor fiscal activa y monitorizada.

Flujo recomendado de emisión

  1. 11) Verificar setup

    Consulta setup-state y bloquea emisión con pendientes críticos.

  2. 22) Emitir documento

    Llama documents con payload consistente e idempotente.

  3. 33) Persistir resultado

    Guarda identificadores fiscales y estado final.

  4. 44) Conciliar

    Ejecuta reconciliation para cerrar diferencias pendientes.

Errores típicos

CódigoCausa comúnMitigación
400payload fiscal incompletovalidar campos obligatorios antes de enviar
409conflicto de serie/secuenciaresincronizar estado y reintentar de forma segura
422regla fiscal no cumplidarevisar tipo de documento, régimen y datos cliente
503indisponibilidad transitoria del proveedorretry con backoff y alerta operacional

Controles recomendados

  • Alertas por backlog fiscal y ratio de error por organización.
  • Conciliación diaria con SLA de corrección definido.
  • Trazabilidad de cambios en series, perfil y permisos.