Callback de emissão de NFS-e por transação

Callback de nota autorizada

Quando a NFS-e é gerada com sucesso, o payload de callback enviado terá o seguinte formato:

{
  "Identificador": "0bd31465-d307-43e5-b3bb-e43a483bf196",
  "Status": 2,
  "StatusDescricao": "Nota fiscal autorizada",
  "UrlXmlAutorizacao": "https://stnotafiscalhml.blob.core.windows.net/nfse/3/0bd31465-d307-43e5-b3bb-e43a483bf196-Autorizacao.xml",
  "UrlPdf": "https://stnotafiscalhml.blob.core.windows.net/nfse/3/0bd31465-d307-43e5-b3bb-e43a483bf196.pdf",
  "NumeroNfse": "202500000000412",
  "NumeroRps": "250407173831919",
  "Mensagem": "Sucesso - NFSe Gerada",
  "Protocolo": "41407426220d40749367db184fb50b70",
  "DataEmissao": "2025-04-07T17:39:07+00:00"
}

Campo	Descrição
Identificador	UUID único da solicitação de emissão da NFS-e
Status	Código de status da NFS-e
StatusDescricao	Descrição do status da NFS-e
UrlXmlAutorizacao	URL para download do XML da autorização da NFS-e
UrlPdf	URL para download do PDF da nota fiscal
NumeroNfse	Número gerado da NFS-e
NumeroRps	Número do RPS utilizado para emissão da NFS-e
Mensagem	Mensagem de retorno indicando sucesso
Protocolo	Protocolo de autorização da NFS-e
DataEmissao	Data e hora de emissão da NFS-e

Callback de nota cancelada

Quando a NFS-e é cancelada com sucesso, o payload de callback enviado terá o seguinte formato:

{
  "Identificador": "338ab883-3379-4d17-b14a-90ffcb1eb248",
  "Status": 4,
  "StatusDescricao": "Nota fiscal cancelada",
  "UrlXmlCancelamento": "https://stnotafiscalhml.blob.core.windows.net/nfse/3/338ab883-3379-4d17-b14a-90ffcb1eb248-Cancelamento.xml",
  "Protocolo": "6e26ed9e19f84608987967474cf49d5a"
}

Campo	Descrição
Identificador	UUID único da solicitação de emissão da NFS-e
Status	Código de status da NFS-e
StatusDescricao	Descrição do status da NFS-e
UrlXmlCancelamento	URL para download do XML de cancelamento da NFS-e
Protocolo	Protocolo de autorização da NFS-e

Callback de nota rejeitada

Caso a solicitação de emissão de NFS-e encontre um erro, como duplicidade de chave de idempotência, o callback será enviado neste formato:

{
  "Identificador": "afab7c3d-9fc0-457e-8930-2dc7308b94b5",
  "Status": 9,
  "StatusDescricao": "O seu pedido foi rejeitado",
  "Erro": "Já existe uma nota fiscal de serviço autorizada ou em processamento para a chave de idempotência informada(8401F48A02F1BEFBF5827543741EF1DB1D633226E7F5CBC2F8126744A60EF0B1)."
}

{
  "Identificador": "30242a6e-2bd0-48eb-9797-8e739e40a118",
  "Status": 9,
  "StatusDescricao": "O seu pedido foi rejeitado",
  "Erro": "O código de serviço 50, informado para emissão de NFS-e, não existe."
}

Campo	Descrição
Identificador	UUID único da solicitação de emissão da NFS-e
Status	Código de status da NFS-e
StatusDescricao	Descrição do status da NFS-e
Erro	Mensagem explicando o motivo da falha

Mapeamento dos status de callback

A seguir, o significado de cada código de status enviado via callback:

Status	Descrição	Observações
1	Aguardando processamento	Nota fiscal de serviço aguardando processamento.
2	Autorizada	Nota fiscal de serviço emitida com sucesso. URLs de XML e PDF serão enviadas por e-mail e callback.
4	Cancelada	Nota fiscal de serviço cancelada com sucesso. URLs de XML enviadas por e-mail e callback.
9	Exceção não tratada	Ocorreu uma falha inesperada na emissão. Verifique os logs ou contate o suporte.
19	Erro de validação	Dados obrigatórios não informados ou inválidos, como ausência de serviço ou método de de pagamento.