Avisos que enviamos

Aviso de teste

POST para a URL configurada no seu webhook, evento teste

Chega quando você pede Enviar um webhook de teste. Use para conferir que o seu sistema recebe o aviso e valida a assinatura.

Parâmetros

Nome	Onde	Tipo	Descrição
webhook-id obrigatório	cabeçalho	string	O `id` do aviso. É o mesmo em todas as tentativas e no reenvio — use para não processar duas vezes.
webhook-timestamp obrigatório	cabeçalho	integer	Quando esta tentativa foi enviada, em segundos desde 1970 (Unix). Recuse se tiver mais de 5 minutos.
webhook-signature obrigatório	cabeçalho	string	A assinatura, no formato `es256,<código da chave>,<assinatura em base64url>`. Na troca de chave podem vir duas, separadas por espaço: basta uma estar certa.

Corpo da requisição

Campo	Tipo	Descrição
id obrigatório	string	Identificador estável do evento, usado na deduplicação.
tipo obrigatório	string	Tipo do evento enviado. Valores: `nfse.recebida`, `nfse.autorizada`, `nfse.rejeitada`, `nfse.erro`, `nfse.cancelada`, `nfse.cancelamento_rejeitado`, `cte.autorizado`, `cte.rejeitado`, `cte.cancelado`, `cte.carta_correcao_registrada`, `cte.erro`, `mdfe.autorizado`, `mdfe.rejeitado`, `mdfe.cancelado`, `mdfe.encerrado`, `mdfe.erro`, `teste`.
versao obrigatório	string	Versão do formato do evento.
ocorridoEm obrigatório	string (date-time)	Data e hora em que o evento ocorreu.
empresa obrigatório	object	A empresa da nota.
empresa.cnpj obrigatório	string	CNPJ sem pontos, barra ou traço (14 posições). Já aceita o CNPJ com letras, que começa a valer em 2026.
dados	object	A nota (NFS-e, CT-e ou MDF-e) como estava no momento do aviso.

Exemplo

JSON

{
  "id": "evt_01K8G2C4R7V9X3Z5B8D1F6H0JG",
  "tipo": "teste",
  "versao": "v1",
  "ocorridoEm": "2026-10-26T12:30:00Z",
  "empresa": {
    "cnpj": "21664333000195"
  }
}

Respostas

2XX: Recebido.

← Voltar ao início