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
- Confirmar o recebimento do CTe: Garantir que o documento foi enviado e processado pelo sistema.
- Validar informações fiscais e legais: Apontar conformidades ou inconsistências nos dados enviados.
- Registrar status de autorização: Informar se o CTe foi autorizado, rejeitado ou se precisa de ajustes.
Estrutura das notificações
Campo | Descrição |
---|---|
status | Indica o status geral do processamento (ex.: authorized , rejected , pending ). |
message | Texto descritivo sobre o resultado do processamento. |
cte_id | Identificador ú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. |
protocol | Número do protocolo de autorização (caso autorizado). |
timestamp | Data 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
- Autorizado: O CT-e foi validado e autorizado, estando apto para uso fiscal.
- Rejeitado: O documento contém erros que precisam ser corrigidos antes de reenviar.
- Pendente: O CT-e está em processamento e requer acompanhamento para um status final.
Boas práticas
- Verificar conformidade fiscal: Antes de enviar, valide os campos obrigatórios e suas especificações.
- Monitorar os retornos: Corrija erros e revise avisos para evitar problemas em etapas posteriores.
- 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