Códigos de ocorrência
O catálogo do que o motorista pode registrar quando a entrega ou a coleta não acontece, com o de-para para o evento fiscal.
Códigos de ocorrência
Quando o motorista não consegue entregar ou coletar, ele escolhe no aplicativo um código de ocorrência (por exemplo, "recebedor ausente"). Este catálogo define quais códigos existem e a que evento fiscal cada um corresponde.

Para que serve#
- Controlar as opções que o motorista vê ao registrar uma ocorrência.
- Ligar cada código ao padrão Proceda/OCOREN (usado em integrações com o seu sistema) e ao motivo do evento fiscal (SEFAZ) que ele gera.
- Criar códigos próprios da transportadora.
Como usar#
- No menu, abra Códigos de ocorrência. A tabela mostra Código, Descrição, Motivo SEFAZ, Proceda, Situação e as ações. As colunas podem ser ordenadas.
- Para criar, clique em Novo código (administrador).
- Preencha:
- Código (obrigatório, até 20 caracteres).
- Código Proceda/OCOREN (opcional para códigos criados pela transportadora; até 20 caracteres).
- Descrição (obrigatória, mínimo de 3 caracteres).
- Motivo SEFAZ (obrigatório): define qual evento de entrega do CT-e ou da NF-e a ocorrência gera.
- Clique em Cadastrar código. Para mudar, use Editar e Salvar alterações.
- Para tirar um código de uso, clique em Desativar e depois em Confirmar desativação.
Os motivos SEFAZ#
| Motivo | Quando usar |
|---|---|
| Entrega realizada | A entrega aconteceu. |
| Recusa do recebedor | O recebedor recusou a mercadoria. |
| Recebedor não encontrado | Ninguém para receber. |
| Endereço inexistente | O endereço não foi localizado. |
| Outros (insucesso) | Qualquer outro motivo de insucesso. |
| Sem evento SEFAZ | A ocorrência não gera evento fiscal. |
Campos e filtros#
| Coluna | O que mostra |
|---|---|
| Código | O código, em fonte de código. |
| Descrição | O texto que o motorista vê. |
| Motivo SEFAZ | O evento fiscal ligado ao código. |
| Proceda | O código Proceda/OCOREN, ou um traço. |
| Situação | Ativo ou Inativo. |
Quem vê e quem altera#
Todos os perfis da transportadora veem o catálogo. Criar, editar e desativar são só do administrador.
Estados da tela#
- Catálogo vazio: "Nenhum código de ocorrência. A base Proceda/OCOREN é pré-carregada na homologação."
- Erro ao desativar: "Não foi possível desativar o código."
- Erro ao salvar: "Não foi possível salvar o código."
Boas práticas#
- Mantenha a lista enxuta: poucos códigos claros reduzem erro de escolha no campo.
- Escolha o Motivo SEFAZ com cuidado: ele determina o evento fiscal, e um motivo errado leva a um evento errado.
- Desative em vez de reaproveitar um código para outro significado: ocorrências antigas continuam com o sentido original.
- Um código que não existe aqui gera a anomalia "Código de ocorrência inválido" (veja Anomalias).