Fale conosco
WhatsApp
Info
Content

4 - Eventos e o conteúdo enviado

Este capítulo descreve quando a notificação sai e o que vai dentro dela. É o material que você precisa ter em mãos para combinar a integração com o cliente.

1. O momento exato de cada evento

A notificação nasce quando a SEFAZ confirma o evento e o sistema grava essa confirmação. Na prática, cada evento corresponde a uma situação (cStat) do documento:

Evento Situação que dispara Significado
AUTORIZADA 100, 120 ou 150 Autorizado, autorizado com alerta, autorizado fora do prazo
CANCELADA 101 (e 151 na consulta) Cancelamento homologado
ENCERRADA 132 Encerramento de MDF-e homologado

O 120 — autorizado com alerta, criado pela NT 2026.002 — conta como autorizada e notifica normalmente. Ele só ocorre em NF-e e NFC-e. A nota está válida; o alerta é uma observação da SEFAZ, não um impedimento.

2. A notificação também nasce na consulta de situação

Nem sempre a resposta da SEFAZ chega na hora do envio: o lote pode ficar em processamento, a conexão pode cair depois de enviado. Nesses casos o sistema descobre o desfecho depois, ao consultar a situação do documento — e a notificação é gerada nesse momento.

O sistema controla isso por documento e evento: se a notificação da autorização já foi criada no envio, a consulta não cria outra. O cliente não recebe o mesmo evento duas vezes por causa de uma reconsulta.

3. O corpo da notificação

No método POST, o corpo é um JSON com Content-Type: application/json. Exemplo no nível Resumido:

{
  "versaoPayload": "1.0",
  "evento": "AUTORIZADA",
  "tipoDocumento": "NFe",
  "ambiente": "producao",
  "dataEvento": "2026-09-20T14:32:07-03:00",
  "documento": {
    "id": 18442,
    "modelo": "55",
    "serie": "1",
    "numero": 4471,
    "chaveAcesso": "35260912345678000199550010000044711234567890",
    "protocolo": "135260004471234",
    "cStat": 100,
    "motivo": "Autorizado o uso da NF-e"
  },
  "emitente": {
    "cnpj": "12345678000199",
    "razaoSocial": "EMPRESA EXEMPLO LTDA"
  }
}

4. Os campos

Campo Conteúdo
versaoPayload Versão do formato. Hoje "1.0". Existe para o cliente conseguir evoluir sem quebrar
evento AUTORIZADA, CANCELADA ou ENCERRADA
tipoDocumento NFe, NFCe, CTe, CTeOS ou MDFe
ambiente producao ou homologacao
dataEvento Data/hora do evento, com fuso (ISO 8601)
documento.id Código interno do documento no TryERP — é o que a API usa
documento.chaveAcesso Chave de 44 dígitos
documento.protocolo Protocolo da autorização — ou do cancelamento, quando o evento é CANCELADA
documento.cStat / motivo Código e descrição devolvidos pela SEFAZ
emitente.cnpj / razaoSocial Identificação da filial emitente

Campo sem valor vai como null, não é omitido. O sistema do cliente deve tratar null em vez de assumir que a chave não existe.

5. Resumido ou Completo

O nível Completo mantém tudo do Resumido e acrescenta:

Campo adicional Conteúdo
documento.dataEmissao Data de emissão do documento
documento.naturezaOperacao Natureza da operação
documento.valorTotal Valor total do documento
destinatario.nome Razão social / nome do destinatário
destinatario.cnpjCpf CNPJ ou CPF do destinatário
destinatario.inscricaoEstadual Inscrição estadual do destinatário

O Completo coloca dado de terceiro (o destinatário da nota) dentro da notificação. Se o endpoint do cliente é hospedado fora, isso é tráfego de dado pessoal e deve ser uma decisão consciente. Resumido é o padrão certo para quem tem a API: com a chave e o id, o cliente busca o resto quando precisar — e só do que precisar.

6. Os cabeçalhos que acompanham

Cabeçalho Conteúdo
X-TryERP-Delivery Número único da entrega. Repetido em toda tentativa da mesma notificação — é a chave para o cliente não processar duas vezes
X-TryERP-Event O evento (AUTORIZADA, CANCELADA, ENCERRADA)
X-TryERP-Signature Só quando a assinatura está ligada. Formato sha256=<hexadecimal>

Além desses, vão os cabeçalhos configurados em Headers (JSON) e o Content-Type: application/json.

7. No método GET

Com GET não há corpo. Os campos simples viram query string — os do primeiro nível e os de documento:

https://sistema.cliente.com.br/integracao?versaoPayload=1.0&evento=AUTORIZADA&tipoDocumento=NFe&ambiente=producao&id=18442&chaveAcesso=35260912...&protocolo=135260004471234&cStat=100

Os blocos emitente e destinatario não são enviados no GET, e não há assinatura. Os cabeçalhos de rastreio continuam indo.

Próximo capítulo: Entrega, reenvio e histórico — como acompanhar o que saiu e tratar o que falhou.

Back to top