> ## 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.

# Ative a integração da sua loja

> Gere a chave no painel da Onbeef, vincule os produtos, entregue a chave ao fornecedor do seu sistema e confira se a integração funcionou.

Você gera uma chave no painel da Onbeef, vincula os produtos e entrega a chave ao fornecedor do seu sistema.

## Antes de começar

* **Plano Expert.** Sem ele, a tela **Integrações** mostra **Exclusivo do plano Expert**: clique em **Quero ter acesso** para falar com a Onbeef pelo WhatsApp. Com o plano, a chave já vale, sem liberação da Onbeef.
* **Permissão.** Se **Integrações** não aparece no menu, peça a permissão ao dono da loja.
* **Fornecedor.** Confirme se o sistema integra com a Onbeef, o que ele integra (produtos, pedidos ou os dois) e se cobra. Se não integra, encaminhe a [documentação para desenvolvedores](https://docs.onbeef.app/desenvolvedores.md).

## Passo a passo

**1. Abra a tela de integrações**

Vá em **Configurações** > **Canais e Integrações** > **Integrações**. Se o seu sistema aparece em **Explorar integrações**, clique em **Conectar** e siga a janela no lugar dos passos 2 e 3.

**2. Gere a chave**

Clique no cartão **Nova chave API**. Em **Nome**, escreva o nome do sistema. Clique em **Adicionar Chave**.

**3. Copie o ID e a Chave**

A janela **Credenciais Geradas com Sucesso!** mostra o **ID** e a **Chave** uma única vez. Copie os dois e clique em **Continuar**. Não envie ainda.

**4. Vincule produtos e categorias**

Sem os códigos, o primeiro envio cria produtos repetidos. Veja [Vincule produtos e categorias](https://docs.onbeef.app/lojistas/vincular-produtos.md).

**5. Entregue a chave ao fornecedor**

Mande o **ID** e a **Chave** em conversa particular, nunca em grupo. Diga: "Já preenchi os códigos. Pode fazer o primeiro envio." Se ele precisar da chave antes, avise: "Não envie produtos antes de eu terminar os códigos."

**6. Confira**

**Produtos:** depois do primeiro envio, a tela **Integrações** mostra o cartão **Status da Integração PDV** como **Ativo**. **Pedidos:** crie um pedido em **Painel de Vendas** > **Novo pedido** e veja com o fornecedor se ele chegou. Avise antes: "Vou criar um pedido de teste. Não emita cupom dele." Depois, cancele o pedido.

> [!WARNING]
>
> A chave dá acesso aos produtos e aos pedidos da loja. Envie só a quem você confia.

### Regras

* **O ID certo.** O fornecedor precisa do **ID** da janela do passo 3. O **ID do Merchant**, do botão **Dados de Integrações**, é outro dado.
* **Uma chave por sistema e por loja.** Caixa e empresa de entregas usam chaves separadas.

## Desligar ou trocar a chave

| Na tela Integrações | O que acontece |
| - | - |
| Interruptor em **Inativa** | O sistema perde o acesso à loja. Em **Ativa**, a mesma chave volta a valer. |
| Ícone de lixeira, **Apagar Chave API** > **Apagar** | O acesso do sistema acaba de vez. Os produtos e os códigos continuam na loja. Confira o **Nome** antes de apagar. |
| Perdeu a chave | Gere outra, envie ao fornecedor e apague a antiga. |

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

> [card] [Vincule os produtos](https://docs.onbeef.app/lojistas/vincular-produtos.md)
>
> O passo 4, com as telas.

> [card] [Perguntas frequentes](https://docs.onbeef.app/lojistas/faq.md)
>
> O sistema parou, produto duplicou, preço não mudou.


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