Códigos de motivo (Reason Codes)

Uma lista compartilhada de motivos padrão para cada fluxo: 10 categorias (falta, cancelamento, ajuste, devolução, dano, bloqueio, contagem cíclica, separação, endereçamento, destinação), importável com um clique; cada menu lê daqui.

Os códigos de motivo são dados mestres compartilhados: uma lista padrão e reutilizável de opções de "por quê" para cada fluxo. Em vez de digitar texto livre em cada documento, escolhe-se um código em um menu: os relatórios sempre falam a mesma língua. Cada tenant mantém seu próprio conjunto, cada código tem nomes em seis idiomas (en / zh / es / pt / fr / ja) e o sistema exibe o idioma correto automaticamente.

Por que códigos em vez de texto livre#

• Relatórios consistentes: "Sem estoque", "sem estoque" e "faltante" deixam de ser categorias distintas: um código, uma categoria.
• Sem listas fixas no código: cada menu de motivos lê estes dados mestres; adicione um código aqui e ele aparece em toda parte, nos seis idiomas.
• O histórico continua legível: desativar um código o oculta de novos documentos, mas os antigos mantêm o nome original.

As 10 categorias#

Cada categoria é uma aba na página de gestão. Uma frase por categoria: para que serve e onde é usada:

• shortage · Motivos de falta: ao registrar faltas em expedições WMS ou picks curtos no app móvel, ex. "Sem estoque", "Venda em excesso (estoque fantasma)", "Reservado para outro pedido".
• order_cancel · Motivos de cancelamento: obrigatórios ao cancelar pedidos OMS ou agendamentos WMS, ex. "Cancelamento solicitado pelo cliente", "Pagamento falhou / não recebido", "Suspeita de fraude".
• adjustment · Motivos de ajuste: ao ajustar o estoque manualmente no WMS, ex. "Diferença de contagem cíclica", "Estoque encontrado (não registrado)", "Sucata / baixa".
• return · Motivos de devolução: ao registrar devoluções no RMS, ex. "Produto defeituoso", "Danificado em trânsito", "Item errado enviado".
• damage · Motivos de dano: ao registrar mercadoria danificada, indicando em que etapa ocorreu, ex. "Danificado no manuseio do armazém", "Dano por empilhadeira / equipamento", "Dano por água / umidade".
• hold · Motivos de bloqueio: ao bloquear estoque, ex. "Bloqueio de qualidade (aguardando inspeção)", "Recall de produto", "Inspeção reprovada".
• cycle_count · Motivos de contagem: ao registrar diferenças de contagem cíclica, ex. "Diferença de contagem encontrada", "Estoque encontrado em localização incorreta", "Sobra / Falta de contagem".
• picking · Exceções de separação: ao registrar anomalias ou picks incompletos, ex. "Separação curta (estoque insuficiente na localização)", "Mercadoria não está na localização esperada", "Código de barras / etiqueta ilegível".
• putaway · Exceções de endereçamento: ao registrar anomalias em tarefas de putaway, ex. "Localização de destino cheia", "Localização bloqueada / porta-palete danificado", "Dano detectado durante o endereçamento".
• disposition · Destinação: decisão de tratamento de devoluções no RMS, ex. "Reintegrar ao estoque vendável", "Recondicionar / reparar", "Descartar / sucata", "Devolver ao fornecedor", "Doar".

Gerenciar os códigos de motivo#

1. Abra Master Data → Códigos de motivo. Você verá uma aba por categoria (10 abas).
2. Clique em "Importar padrões" para carregar o conjunto padrão de uma vez. A importação é idempotente: só preenche o que falta e nunca sobrescreve códigos que você renomeou ou desativou.
3. Novos tenants recebem os padrões automaticamente ao criar a conta; sem importação manual.
4. Adicione seus próprios códigos com o botão Novo, renomeie editando e desative os que não usar mais em vez de excluí-los.

Como os fluxos os usam#

Cada menu de motivos no OMS, WMS, RMS e no app móvel lê estes dados mestres; nada está fixo no código. Mantenha a lista aqui e cada página a assume automaticamente:

• Renomear um código atualiza sua exibição em toda parte de uma vez, inclusive nas visões de histórico.
• Desativar um código o oculta apenas de novos documentos; os existentes continuam funcionando e legíveis.
• Os códigos de motivo são dados compartilhados no nível do tenant: todos os clientes usam o mesmo conjunto. Para distinguir por cliente, prefixe o nome, ex. "Cliente A — …".

Perguntas frequentes#

• O conjunto padrão não serve ao meu negócio — posso mudar? Sim. Renomeie, desative ou adicione códigos livremente. Uma importação posterior só preenche o que falta; não sobrescreve nada.
• Desativar um código quebra documentos antigos? Não. Os documentos antigos mantêm seu código e exibem normalmente; o código só some do menu para novos documentos.
• Os códigos aparecem no meu idioma? Sim: cada código tem nomes nos seis idiomas e as páginas exibem automaticamente o do seu idioma de interface.