Como operar o fiscal

Rotinas: regra FAY006, cálculo no faturamento, lançamento FAY002, NF-e/NFC-e/NFS-e, apuração e SPED.

Dúvida: como o M3R calcula imposto e emite NF-e?

Ambiente: motor RegraFiscal (FAY006) + emissão FAT_NFE. O cálculo não é uma planilha no pedido: o faturamento chama o serviço.

1º Certificado A1

Um por filial (FACE01). CNPJ do certificado = CNPJ da filial.

2º Cadastro da regra fiscal

Matching NCM (prefixo), CFOP, UF, regime, contribuinte, CEST, vigência. Artigo: regras.

Alíquotas no produto são fallback.

3º Cálculo no documento

No fulfill e na classificação da entrada. Lançamento rascunho FAY002 (idempotente). Flags (fiscal.icms_st.nfe, ipi.nfe, ibs_cbs.nfe, iss.nfse, …) controlam o que vai para XML/vNF. Sem a flag, o livro pode existir e o XML permanece o comportamento anterior.

IPs IP.FISCAL.CALC.* wired fail-open. NFE.BEFORE_SIGN não wired.

4º Emissão e monitor

/apps/nfe-monitor. Status SEFAZ, cancelamento, CC-e, contingência. Destinatário 55: NEED_FISCAL_CUSTOMER se faltar IBGE/documento. Artigo: NF-e.

NFS-e: /apps/nf-e/nfse — família IP.FISCAL.NFSE.* (não reutiliza NFE, não patcheia XML).

5º Entrada e classificação

IP ENTRY.BEFORE_CLASSIFY wired. Uso/consumo não credita. Artigo: entrada.

6º Fechar período

POST /regras-fiscais/livro/:filialId/fechar { "periodo": "YYYY-MM" }. IPs APURACAO.BEFORE_CLOSE / AFTER_CLOSE. EFD Bloco E: flag fiscal.apuracao.efd.

7º Dashboard

/apps/fiscal-dashboard (métricas, DLQ, audit).

API e IPs

API fiscal · catálogo de IPs