Fluxo de emissão¶
Estas páginas descrevem o fluxo de emissão, o caminho comum a todos os adaptadores. O documento é validado, numerado, assinado, transmitido e resolvido do mesmo jeito, seja qual for o dialeto que você usa para falar conosco. As páginas de cada dialeto descrevem apenas como esse comportamento aparece no contrato que você já conhece.
O que garantimos¶
A emissão é síncrona. O POST de emissão espera a resposta da SEFAZ e devolve o desfecho no mesmo corpo (autorizado ou rejeitado). Não há fila a acompanhar no caminho normal. Os dialetos que têm um estado "em processamento" continuam válidos no contrato. O seu laço de consulta encontra o documento já resolvido na primeira volta.
Nunca transmitimos duas vezes. Se o envio à SEFAZ falha, ou se a resposta se perde no caminho de volta, nós consultamos a chave antes de concluir qualquer coisa. Se o documento chegou, nós o fechamos com o protocolo real, sem reemissão e sem número queimado. Só reapresentamos um documento de contingência que a consulta prova ausente. Ver Contingência.
Nunca afirmamos autorização sem resposta da SEFAZ. Um envio de desfecho desconhecido fica parado até que uma consulta prove o que aconteceu. Em nenhum dialeto ele aparece como autorizado antes dessa prova.
Nunca reaproveitamos um número. Uma tentativa que queimou um número deixa uma lacuna, e nós a fechamos por inutilização. O número não volta em outro documento. Ver Numeração.
Uma referência sempre responde o estado atual. Reenviar a mesma referência não emite um segundo documento: a resposta é o estado do documento que aquela referência já identifica. Ver Referência e reenvio.
Onde ler o quê¶
| Página | Responde |
|---|---|
| Ambientes e credenciais | Para onde apontar, o que apresentar, como você escolhe o ambiente |
| Ciclo de vida do documento | Que estados existem e como cada dialeto os nomeia |
| Validação e diagnósticos | O que recusamos antes da SEFAZ, e como o motivo chega até você |
| Referência e reenvio | Idempotência, replay e o caminho de correção |
| Numeração | Quem escolhe número e série, e o que acontece com as lacunas |
| Contingência | O que acontece quando a SEFAZ não responde |
| Webhooks | Quais eventos empurramos, e por qual dialeto |