> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onbeef.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Vincule produtos e categorias ao seu sistema

> Ligue os produtos e as categorias que a loja já tem aos códigos do seu sistema. Evite produto duplicado e categoria vazia.

Vincular é dizer à Onbeef qual produto dela é qual produto do seu sistema. Exemplo: a picanha é o produto 1001 no seu sistema, então você escreve 1001 na picanha da Onbeef.

Faça depois de gerar a chave (a coluna do código só aparece aí) e antes de entregá-la ao fornecedor. Nome igual não conta: a Onbeef só reconhece o produto pelo código.

## O que acontece sem o código

| Situação | Resultado |
| - | - |
| Produto ou categoria sem código | O sistema cria outro igual, sem as suas fotos e cortes. |
| Preço enviado para produto sem código | O preço não muda. O cartão **Status da Integração PDV** mostra **Erro** com "Itens não encontrados". |

## Passo a passo

**1. Peça os códigos ao fornecedor**

Diga: "Me mande o código de cada produto e de cada categoria que o sistema vai enviar para a Onbeef." Lá, a categoria pode se chamar grupo ou seção.

**2. Preencha os produtos**

No menu **Catálogo**, clique em **Códigos & Balança**. Digite os códigos na coluna **Código de integração com PDV** e clique em **Salvar Identificadores**: um clique salva todos.

**3. Preencha as categorias**

Em **Catálogo** > **Produtos & Categorias**, abra a edição de cada categoria. Marque **Vincular esta categoria ao seu sistema de PDV** e preencha o **Código de integração com PDV**.

**4. Entregue a chave e libere o envio**

Confira com a lista se ficou algo sem código. Depois, diga: "Pode fazer o primeiro envio."

### Regras

* **Aproveite o que já existe.** Vincule em vez de recriar: se você excluir as categorias para o sistema enviar tudo de novo, perde as fotos e os cortes.
* **É digitado na tela.** O fornecedor não preenche pela integração, e a importação de arquivo preenche só o **Código da balança**, outro campo.
* **Um código, um lugar.** Se a tela perguntar **Salvar com códigos duplicados?**, clique em **Revisar**.
* **Igual ao do sistema.** Com os zeros à esquerda.

> [!WARNING]
>
> Excluir uma categoria exclui junto os produtos que estão só nela. Confira antes se é a que o sistema criou, e não a sua.

## Como resolver

> [accordion] Meu produto duplicou
>
> Exclua o que o sistema criou. Depois, preencha o código no original. Nessa ordem: o código não pode estar nos dois.

> [accordion] Duplicou a loja inteira
>
> Peça ao fornecedor: "Pare os envios até eu avisar." Exclua as categorias que o sistema criou: os produtos repetidos saem junto. Preencha os códigos e libere.

> [accordion] Apareceu uma categoria vazia ou repetida
>
> Abra a categoria que o sistema criou e anote o código dela. Exclua essa categoria e preencha o código anotado na sua. O aviso "Já existe outra categoria com o código de integração com PDV informado" quer dizer que a outra ainda não foi excluída.

Copia uma pergunta pronta para colar no Claude, no ChatGPT ou no seu assistente

> [card] [Catálogo integrado](https://docs.onbeef.app/lojistas/catalogo.md)
>
> O que o sistema atualiza.

> [card] [Para o fornecedor do sistema](https://docs.onbeef.app/guides/catalog-linking.md)
>
> O guia técnico.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.