Pular para o conteúdo principal

Notificação do processamento do CTe

Após o envio do CT-e para processamento, o sistema realiza validações específicas e retorna uma notificação para informar o resultado.

Objetivo das notificações

  1. Confirmar o recebimento do CTe: Garantir que o documento foi enviado e processado pelo sistema.
  2. Validar informações fiscais e legais: Apontar conformidades ou inconsistências nos dados enviados.
  3. Registrar status de autorização: Informar se o CTe foi autorizado, rejeitado ou se precisa de ajustes.

Estrutura das notificações

CampoDescrição
statusIndica o status geral do processamento (ex.: authorized, rejected, pending).
messageTexto descritivo sobre o resultado do processamento.
cte_idIdentificador único do documento CT-e.
errors(Opcional) Lista de erros encontrados no envio, detalhando os campos com problemas.
warnings(Opcional) Lista de avisos ou recomendações para melhorar a qualidade do documento.
protocolNúmero do protocolo de autorização (caso autorizado).
timestampData e hora do processamento.

Exemplo de retorno

CT-e autorizado:


{
"status": "authorized",
"message": "CT-e autorizado com sucesso.",
"cte_id": "CTE987654",
"protocol": "135202412030000123456789",
"timestamp": "2024-12-03T15:00:00Z"
}

CT-e rejeitado:


{
"status": "rejected",
"message": "Erro no processamento do CT-e. Verifique os campos indicados.",
"cte_id": "CTE987654",
"errors": [
{
"field": "issuer.cnpj",
"message": "CNPJ do emissor inválido."
},
{
"field": "recipient.address",
"message": "Endereço do destinatário está incompleto."
}
],
"timestamp": "2024-12-03T15:05:00Z"
}

Como interpretar as notificações

  1. Autorizado: O CT-e foi validado e autorizado, estando apto para uso fiscal.
  2. Rejeitado: O documento contém erros que precisam ser corrigidos antes de reenviar.
  3. Pendente: O CT-e está em processamento e requer acompanhamento para um status final.

Boas práticas

  1. Verificar conformidade fiscal: Antes de enviar, valide os campos obrigatórios e suas especificações.
  2. Monitorar os retornos: Corrija erros e revise avisos para evitar problemas em etapas posteriores.
  3. Armazenar o protocolo: Guarde o número do protocolo para fins de auditoria e rastreamento.

Próximos passos

Acompanhar as notificações de conciliação do documento CT-e