# Prefixos de código: quando o cliente escreve o código sem o prefixo

> Para o administrador: cadastre prefixos de código para a Dri achar o produto quando o cliente escreve só o número, como 8020 em vez de DV8020.

Fonte: https://vendria.com/ajuda/prefixos-de-codigo

## Onde fica

No menu da sua conta, em **Catálogo e Preços**, aba **Contexto**, no cartão
**Prefixos de código**.

## Para que servem os prefixos de código

Muitos catálogos cadastram os produtos com um prefixo (`DV8020`, `FJ91465`),
e muitos clientes escrevem só o número: pedem "8020" numa mensagem, numa foto
de lista ou numa planilha. Sem ajuda, a linha termina em "código não
encontrado".

Os prefixos de código ensinam a Dri a tentar o prefixo antes de desistir. Com
`DV` configurado, um `8020` que não existe no catálogo é procurado também como
`DV8020`. Se `DV8020` existe, a linha é montada com ele.

Use quando o seu catálogo tem prefixos fixos e os clientes costumam omiti-los.
Se os seus códigos não têm prefixo, deixe a lista vazia: a tela mostra
**Nenhum prefixo configurado — a busca não tenta prefixo nenhum.**

## Como cadastrar os prefixos de código

1. Abra **Catálogo e Preços** e procure o cartão **Prefixos de código**.
2. Digite o prefixo no campo (ex.: `DV`) e clique em **Adicionar**, ou aperte
   Enter. O prefixo vira uma etiqueta na lista.
3. Repita para cada prefixo. Para tirar um, clique no **x** da etiqueta.
4. Clique em **Salvar**. A mensagem **Prefixos salvos** confirma.

Nada muda até você clicar em **Salvar**: adicionar e remover etiquetas só mexe
no rascunho da tela.

As regras de um prefixo:

- até 12 caracteres, entre letras, números e os separadores ponto, sublinhado, hífen e barra;
- pelo menos **uma letra**: um prefixo só de números é recusado;
- no máximo 10 prefixos;
- letras minúsculas viram maiúsculas, e repetidos são descartados.

## Os prefixos valem para a organização inteira

⚠️ A lista de prefixos de código é **da organização**, não da loja que está no
seletor do hub. Qualquer loja que você escolha mostra e edita a **mesma** lista,
e cada prefixo cadastrado é testado contra o catálogo de todas as lojas.

Na prática: se a loja A usa `FJ` e a loja B usa `DV`, cadastre os dois uma vez
só. Um `FJ8020` simplesmente não existe no catálogo da loja B, então o prefixo
da outra loja não atrapalha.

## Quando o prefixo entra em ação

Três garantias evitam que o prefixo troque produtos:

1. Ele só é tentado **depois** que a busca normal falhou. Nenhum código que já
   casa hoje passa a apontar para outro produto.
2. Código de um caractere só não é expandido: ele não identificaria nada.
3. Se mais de um prefixo casar (por exemplo, `DV8020` e `FJ8020` existem nas
   duas lojas), a linha vira uma **pergunta com as opções** para o vendedor
   escolher, nunca um palpite silencioso.

## Quando dá errado

**"Cadastrei o prefixo e o código continua não encontrado."** Confira se clicou
em **Salvar**, se o código com o prefixo existe mesmo no catálogo (busque
`DV8020` na lista de produtos) e se o produto está ativo.

**"A tela recusou o prefixo."** A mensagem diz o motivo: prefixo sem letra,
com mais de 12 caracteres, com caractere fora de letras, números, ponto, sublinhado, hífen e barra,
ou lista com mais de 10 prefixos.

**"A linha virou pergunta em vez de ser montada."** Dois prefixos formaram
códigos que existem. É de propósito: escolha o produto certo na linha.
