Configurar compliance fiscal

Pré-requisitos

• Organização em plano pago elegível.
• Owner/admin com acesso ao ambiente certo (test ou live).
• Setup-state acessível e sem segredos manuais do cliente.

Passo a passo

1. 11) Preparar motor fiscal

   Executa o provisioning gerido pela Beacon e confirma setup-state.

2. 22) Configurar AT em live

   Usa POST /api/fiscal/setup/at?org=<slug>&mode=live para guardar credenciais cifradas e validar acesso apenas em live.

3. 33) Configurar perfil e contexto

   Preenche o perfil fiscal e usa state.issuanceContextOptions de GET /api/fiscal/setup-state para confirmar estabelecimento e série default.

4. 44) Resolver bloqueios

   Usa series/communicate, saft/automatic e setup/self-heal até o ambiente ficar em ready.

5. 55) Testar emissão

   Gera setup/preview, emite documentos de teste em test e valida a primeira emissão controlada em live.

Controlo de qualidade antes de live

1. Confirmar que o frontend usa apenas GET /api/fiscal/setup-state?org=<slug>&mode=<modo> para decidir CTAs e ler state.issuanceContextOptions.
2. Verificar que o frontend lê o estado funcional a partir do campo state do response, sem inventar endpoints paralelos.
3. Verificar reconciliação entre eventos Stripe e documentos fiscais emitidos.
4. Garantir runbooks de provisioning bloqueado, rotação de KEK e backlog fiscal.

Endpoint canónico para o frontend

Usa sempre GET /api/fiscal/setup-state?org=<slug>&mode=<modo>. O response público actual é um envelope { ok, state, context }.

Erros frequentes