Pular para o conteúdo
Veltra Ajuda
Manual da APIPlaybookEntrar

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.

Catálogo de códigos de ocorrência, com o de-para para o evento fiscal.
Catálogo de códigos de ocorrência, com o de-para para o evento fiscal.

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#

  1. 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.
  2. Para criar, clique em Novo código (administrador).
  3. 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.
  4. Clique em Cadastrar código. Para mudar, use Editar e Salvar alterações.
  5. Para tirar um código de uso, clique em Desativar e depois em Confirmar desativação.

Os motivos SEFAZ#

MotivoQuando usar
Entrega realizadaA entrega aconteceu.
Recusa do recebedorO recebedor recusou a mercadoria.
Recebedor não encontradoNinguém para receber.
Endereço inexistenteO endereço não foi localizado.
Outros (insucesso)Qualquer outro motivo de insucesso.
Sem evento SEFAZA ocorrência não gera evento fiscal.

Campos e filtros#

ColunaO que mostra
CódigoO código, em fonte de código.
DescriçãoO texto que o motorista vê.
Motivo SEFAZO evento fiscal ligado ao código.
ProcedaO código Proceda/OCOREN, ou um traço.
SituaçãoAtivo 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).

Veja também#