Configurar compliance fiscal

Prerrequisitos

• Organización en un plan de pago elegible.
• Owner/admin operando en el modo correcto (test o live).
• setup-state disponible y sin secretos manuales del cliente.

Paso a paso

1. 11) Preparar motor fiscal

   Ejecuta el provisioning gestionado por Beacon y confirma setup-state.

2. 22) Configurar AT en live

   Usa POST /api/fiscal/setup/at?org=<slug>&mode=live para guardar credenciales cifradas y validar el acceso solo en live.

3. 33) Configurar perfil y contexto

   Completa el perfil fiscal y usa state.issuanceContextOptions de GET /api/fiscal/setup-state para confirmar establecimiento y serie por defecto.

4. 44) Resolver bloqueos

   Usa series/communicate, saft/automatic y setup/self-heal hasta que el entorno llegue a ready.

5. 55) Probar emisión

   Genera setup/preview, emite documentos en test y valida la primera emisión controlada en live.

Control de calidad antes de live

1. Confirmar que el frontend usa solo GET /api/fiscal/setup-state?org=<slug>&mode=<mode> para CTAs y state.issuanceContextOptions.
2. Verificar que el frontend lee el estado funcional desde el campo state del response, sin endpoints paralelos.
3. Verificar conciliación entre eventos Stripe y documentos fiscales emitidos.
4. Garantizar runbooks para provisioning bloqueado, rotación de KEK y backlog fiscal.

Endpoint canónico para frontend

Usa siempre GET /api/fiscal/setup-state?org=<slug>&mode=<mode>. El response público actual es un sobre { ok, state, context }.

Errores frecuentes