Ciclo de vida do documento

Um pedido de emissão vira um documento que caminha por um conjunto pequeno e fechado de estados. Cada dialeto projeta esses estados no vocabulário do provedor. Os nomes mudam, o significado não.

Como cada dialeto nomeia os estados

Situação	ACBrAPI (status)	FocusNFE (status)
Autorizado pela SEFAZ	autorizado	autorizado
Rejeitado pela SEFAZ	rejeitado (com codigo_status)	erro_autorizacao (com status_sefaz)
Recusado por nós, antes da SEFAZ	erro	422 erro_validacao (não é um estado do documento)
Denegado	denegado	denegado
Cancelado	cancelado	cancelado
Emitido em contingência, ainda não entregue	pendente	autorizado + contingencia_offline: true
Envio sem desfecho conhecido, aguardando prova	pendente	processando_autorizacao

Duas leituras para guardar:

• erro no ACBrAPI não é rejeição da SEFAZ. É recusa nossa antes do envio. O codigo_status vem nulo justamente porque não existe resposta da SEFAZ para reportar. O motivo chega em autorizacao.motivo_status e a orientação em autorizacao.mensagem. Ver Validação e diagnósticos.
• Nem o ACBrAPI nem o FocusNFE dizem "autorizado" sem protocolo. Quando um envio fica sem desfecho conhecido, o documento fica no estado de espera até que uma consulta prove o que aconteceu (pendente no ACBrAPI, processando_autorizacao no FocusNFE). A exceção aparente é o documento de contingência offline, que é um documento legalmente emitido aguardando entrega. Por isso ele vem acompanhado das flags de contingência no FocusNFE.

O caminho normal

1. Validação. O documento passa pelo conjunto de regras antes de consumir número. Uma recusa aqui não queima numeração.
2. Numeração. Número e código numérico (cNF) são alocados, e a chave de acesso de 44 caracteres é montada. Ver Numeração.
3. Assinatura e transmissão. O documento é assinado com o certificado da empresa e transmitido à SEFAZ dentro de um orçamento de tempo.
4. Desfecho. Autorizado, rejeitado ou denegado, na mesma resposta HTTP. Se a SEFAZ não responder, o caminho é a contingência.

Um documento autorizado entra na custódia do Veraciti, junto com os documentos que você já emite por outros caminhos. O XML processado e o DANFE ficam disponíveis pelas rotas de arquivo do dialeto. O documento também aparece nos relatórios e painéis da plataforma.

Operações de ciclo de vida

Além da emissão, três operações estão disponíveis em todos os dialetos:

Operação	Janela	Observação
Cancelamento	30 minutos após a autorização	Justificativa de 15 a 255 caracteres, exigida pela SEFAZ
Inutilização	—	Fecha faixas de numeração não usadas
Consulta	—	Lê o estado atual. Não altera nada

A janela de 30 minutos é a regra da NFC-e. Nós a validamos antes de ir à SEFAZ. Assim um pedido fora do prazo falha com uma mensagem clara, em vez de um código de rejeição.

Cancelamento por substituição (evento 110112) existe internamente, como parte da resolução de tentativas sem desfecho descrita em Contingência. Nenhum dos dois provedores expõe esse verbo, então nós também não.

Quando o cancelamento não pode ser confirmado

Se a comunicação com a SEFAZ falhar durante um cancelamento, nós não afirmamos que ele falhou. A resposta é uma confirmação pendente (502), sem nada registrado. Consulte o documento em seguida: se o evento chegou à SEFAZ, a consulta mostra o documento cancelado. Repetir o cancelamento é seguro. Um evento já registrado é reconhecido como tal, não tratado como erro.