# GUIA DE INFORMAÇÕES - TRAY PDV

<p class="callout info"><span data-path-to-node="1,0">O **Tray PDV** é a solução *White Label* da ConnectPlug integrada ao e-commerce da Tray, conectando a vitrine digital, o caixa presencial e o ERP 2.0 em uma operação *omnichannel* unificada</span><span data-path-to-node="1,2">.</span></p>

---

##### 🎯 **Contexto e Por que Fazer**

<span data-path-to-node="4,0">A integração entre o ERP 2.0 ConnectPlug e o ecossistema Tray elimina a dessincronização de estoque entre lojas físicas e virtuais, automatizando processos fiscais e operacionais</span><span data-path-to-node="4,2">.</span>

- **Sincronismo Bidirecional de Catálogo:** A sincronização de produtos, preços e imagens é 100% bidirecional. Seja iniciando o cadastro na loja virtual da Tray ou dentro do ERP, todos os dados — incluindo as imagens de produtos e variações de grade — são integrados e mantidos atualizados.
- <span data-path-to-node="5,1,0,0">**Inteligência de Variações de Atributos:** O ERP 2.0 permite o cadastro de produtos com **múltiplos atributos.**</span><span data-path-to-node="5,1,0,2"> Caso o produto exceda o limite de atributos aceitos pela loja virtual da Tray (que processa apenas um atributo de grade de tamanho), o ERP exibe uma mensagem e permite salvar o item</span><span data-path-to-node="5,1,0,4">. O produto fica sinalizado como **inelegível para a Tray**, mas funciona normalmente para vendas físicas no PDV</span><span data-path-to-node="5,1,0,6">.</span>
- <span data-path-to-node="5,2,0,0">**Para o Comercial:** Diferencial competitivo ao entregar uma solução *omnichannel* completa</span><span data-path-to-node="5,2,0,2">. Permite vender para lojistas que buscam expansão para e-commerce ou necessitam de controle presencial ágil</span><span data-path-to-node="5,2,0,4">. Destaca o uso do **Smart TEF** (sem custos adicionais de TEF tradicional)</span><span data-path-to-node="5,2,0,6"> e o suporte nativo a **Multi CD** com emissão fiscal fracionada por CNPJ</span><span data-path-to-node="5,2,0,8">.</span>
- <span data-path-to-node="5,3,0,0">**Para a Implantação:** Garante a estrutura do **Kit Mínimo Operacional**, padronizando a jornada do cliente, minimizando retrabalhos na carga inicial e assegurando que os disparos via *Webhook* ocorram sem falhas</span><span data-path-to-node="5,3,0,2">.</span>
- <span data-path-to-node="5,4,0,0">**Para o Suporte:** Estabelece a lógica interna do sistema (como a dependência do NCM no ERP para emissão de NFC-e), reduzindo o tempo de diagnóstico de chamados sobre divergências de saldo ou falhas em pedidos</span><span data-path-to-node="5,4,0,2">.</span>

---

##### 📋 **Pré-Requisitos**

- <span data-path-to-node="8,0,0,0">Acesso administrativo ao **Painel Tray** e ao **ERP 2.0** (`pdv.tray.com.br`)</span><span data-path-to-node="8,0,0,2">.</span>
- <span data-path-to-node="8,1,0,0">Computador/Notebook com leitor de código de barras ou maquininha **POS Smart** (Stone, Cielo, Rede) com **Smart TEF** habilitado (se aplicável)</span><span data-path-to-node="8,1,0,2">.</span>
- <span data-path-to-node="8,3,0,0">**Dados fiscais completos** previstos no ERP (NCM e regra de tributação) para emissão no caixa presencial</span><span data-path-to-node="8,3,0,2">.</span>
- <span data-path-to-node="8,4,0,0">Ao menos 2 Depósitos/Filiais criados no ERP<span style="color: #ff0000;"> *caso a operação utilize **Multi CD***</span></span><span style="color: #ff0000;">*.*</span>
- <span data-path-to-node="8,5,0,0">Listagem dos IDs numéricos das Filiais/CDs cadastrados na plataforma Tray</span><span data-path-to-node="8,5,0,2">.</span>

---

##### ⚙️ **Passo a Passo**

- <span data-path-to-node="11,0,0,0">**Acesso ao Ambiente White Label** Acesse o painel do ERP 2.0 diretamente pelo link dedicado ou via atalho no painel da Tray</span><span data-path-to-node="11,0,0,2">.</span>

- <span data-path-to-node="11,1,0,0">**Cadastro de Produto, Imagens e Múltiplos Atributos (No ERP 2.0 ou Tray)** Acesse **Produtos &gt; Cadastro de Produtos**</span><span data-path-to-node="11,1,0,2">. Crie o produto definindo suas variações e anexe as imagens do produto/grade. As imagens e cadastros sincronizarão de forma bidirecional. *Atenção aos Atributos:* Se o produto tiver múltiplos atributos (ex.: cafeteria com tamanho + adicionais), o ERP salvará o item para uso no balcão físico, exibindo um aviso de que o item é inelegível para sincronização na loja virtual da Tray</span><span data-path-to-node="11,1,0,4">.</span>

![](https://manual.cplug.com.br/uploads/images/gallery/2026-08/scaled-1680-/hpNjFUevZNxMVHjY-image-1787836781729.png)

![](https://manual.cplug.com.br/uploads/images/gallery/2026-08/scaled-1680-/zZhsFdVTNvCS0Tyx-image-1787836840194.png)

<span data-path-to-node="11,2,0,0">**Parametrização Fiscal Obrigatória** No ERP, preencha o campo de **NCM** e a **Tributação** do produto</span><span data-path-to-node="11,2,0,2">. Como a loja virtual não exige NCM para venda online, essa informação deve ser preenchida obrigatoriamente no ERP para liberar a emissão de NFC-e na maquininha presencial</span><span data-path-to-node="11,2,0,4">.</span>

- <span data-path-to-node="11,3,0,0">**Configuração da Integração e Sincronismo** Acesse **Configurações Gerais &gt; Integrações &gt; Tray**</span><span data-path-to-node="11,3,0,2">. Informe o código da loja, a URL e clique em **Autenticar**</span><span data-path-to-node="11,3,0,4">. Mantenha ativas as opções de **Sincronização Automática de Cadastro** e **Publicação Imediata** para preservar a bidirecionalidade do catálogo e imagens</span><span data-path-to-node="11,3,0,6">.</span>

![](https://manual.cplug.com.br/uploads/images/gallery/2026-08/scaled-1680-/sYrrt1NJlXOH5MXi-image-1787836898548.png)

<span data-path-to-node="11,4,0,0">**Mapeamento De-Para de Filiais / Multi CD** Acesse o **Painel Tray &gt; Configurações &gt; Filiais e CDs** e anote os IDs numéricos de cada centro de distribuição (ex.: Matriz SP = ID 1, Filial RJ = ID 2)</span><span data-path-to-node="11,4,0,2">. No ERP 2.0, acesse **Integrações &gt; Tray &gt; Mapeamento de Filiais**</span><span data-path-to-node="11,4,0,4">. Relacione cada Depósito/Filial do ERP ao respectivo ID da Tray e clique em **Salvar Mapeamento**</span><span data-path-to-node="11,4,0,6">.</span>

![](https://manual.cplug.com.br/uploads/images/gallery/2026-08/scaled-1680-/bVQe3WTNufYzfJd2-image-1787837011214.png)

<span data-path-to-node="11,5,0,0">**Definição do Gatilho de Estoque e Pagamentos** Na aba de configurações da integração no ERP, defina o gatilho de baixa de estoque para o status **Aprovado / Pago**</span><span data-path-to-node="11,5,0,2">. Isso evita o travamento desnecessário de saldo em pedidos pendentes (como boletos)</span><span data-path-to-node="11,5,0,4">. Configure os parâmetros do **Smart TEF** para as maquininhas POS Smart em **Configurações &gt; Formas de Pagamento**</span><span data-path-to-node="11,5,0,6">.</span>

---

##### 📊 **Matriz de Sincronização e Integração de Dados**

<div id="bkmrk-dado-%2F-informa%C3%A7%C3%A3o-fl"><table data-path-to-node="14" style="height: 392px;"><thead><tr style="height: 29px;"><td class="align-center" style="width: 221px; height: 29px;">**Dado / Informação**</td><td style="width: 154px; height: 29px;">**Fluxo de Integração**</td><td style="width: 131px; height: 29px;">**Origem Primária**</td><td style="width: 301px; height: 29px;">**Impacto e Regras da Operação**</td></tr></thead><tbody><tr style="height: 57px;"><td style="width: 221px; height: 57px;"><span data-path-to-node="14,1,0,0">**Estoque**</span></td><td class="align-center" style="width: 154px; height: 57px;">**Bidirecional**

</td><td class="align-center" style="width: 131px; height: 57px;"><span data-path-to-node="14,1,2,0,0">Ambas</span>

</td><td style="width: 301px; height: 57px; text-align: justify;"><span data-path-to-node="14,1,3,0,0">Venda física baixa o e-commerce em tempo real; entrada no ERP atualiza o balcão e o site</span><span data-path-to-node="14,1,3,0,2">.</span>

</td></tr><tr style="height: 57px;"><td style="width: 221px; height: 57px;"><span data-path-to-node="14,2,0,0">**Imagens de Produtos**</span></td><td class="align-center" style="width: 154px; height: 57px;">**Bidirecional**

</td><td class="align-center" style="width: 131px; height: 57px;"><span data-path-to-node="14,2,2,0,0">Ambas</span>

</td><td style="width: 301px; height: 57px; text-align: justify;"><span data-path-to-node="14,2,3,0,0">Imagens anexadas no ERP ou na Tray sincronizam automaticamente para produto e variações</span><span data-path-to-node="14,2,3,0,2">.</span>

</td></tr><tr style="height: 66px;"><td style="width: 221px; height: 66px;"><span data-path-to-node="14,3,0,0">**Produtos (1 Atributo/Grade)**</span></td><td class="align-center" style="width: 154px; height: 66px;"><span data-path-to-node="14,3,1,0">**Bidirecional**</span></td><td class="align-center" style="width: 131px; height: 66px;"><span data-path-to-node="14,4,2,0,0">ERP 2.0</span>

</td><td style="width: 301px; height: 66px; text-align: justify;"><span data-path-to-node="14,3,3,0">Sincroniza catálogo, preços, SKUs e variações simples entre e-commerce e PDV.</span></td></tr><tr style="height: 57px;"><td style="width: 221px; height: 57px;"><span data-path-to-node="14,4,0,0">**Produtos (Múltiplos Atributos)**</span></td><td class="align-center" style="width: 154px; height: 57px;"><span data-path-to-node="14,4,1,0,0">Exclusivo PDV / ERP</span>

</td><td class="align-center" style="width: 131px; height: 57px;"><span data-path-to-node="14,4,2,0,0">ERP 2.0</span>

</td><td style="width: 301px; height: 57px; text-align: justify;"><span data-path-to-node="14,4,3,0,0">Salva no ERP e funciona no PDV presencial, mas fica marcado como inelegível para o site da Tray</span><span data-path-to-node="14,4,3,0,2">.</span>

</td></tr><tr style="height: 46px;"><td style="width: 221px; height: 46px;"><span data-path-to-node="14,5,0,0">**Clientes**</span></td><td class="align-center" style="width: 154px; height: 46px;"><span data-path-to-node="14,4,1,0,0">Exclusivo PDV / ERP</span></td><td class="align-center" style="width: 131px; height: 46px;"><span data-path-to-node="14,4,2,0,0">ERP 2.0</span></td><td style="width: 301px; height: 46px; text-align: justify;"><span data-path-to-node="14,5,3,0">Consulta clientes no ERP pelo balcão e envia cadastros do PDV para a base unificada.</span></td></tr><tr style="height: 80px;"><td style="width: 221px; height: 80px;"><span data-path-to-node="14,6,0,0">**Vendas e Caixas**</span></td><td class="align-center" style="width: 154px; height: 80px;"><span data-path-to-node="14,4,1,0,0">Exclusivo PDV / ERP</span>

</td><td class="align-center" style="width: 131px; height: 80px;"><span data-path-to-node="14,6,2,0,0">Tray PDV</span>

</td><td style="width: 301px; height: 80px; text-align: justify;"><span data-path-to-node="14,6,3,0,0">Transmite vendas presenciais, sangrias, suprimentos e meios de pagamento ao financeiro do ERP</span><span data-path-to-node="14,6,3,0,2">.</span>

</td></tr></tbody></table>

</div>#####  

---

##### ❓ **Dúvidas Frequentes**

- <span data-path-to-node="17,0,0,0">**Cadastrei um produto com imagens no ERP e ele não subiu para a Tray. O que verificar?** A sincronização de imagens é bidirecional</span><span data-path-to-node="17,0,0,2">. Verifique se a **Sincronização Automática de Cadastro** está ativa no ERP e se o produto não foi marcado como inelegível por conter múltiplos atributos de variação.</span>
- <span data-path-to-node="17,1,0,0">**Por que o sistema exibiu um alerta de "produto inelegível para a Tray" ao cadastrar atributos?** A plataforma e-commerce da Tray aceita produtos com apenas um atributo de variação (ex.: Tamanho)</span><span data-path-to-node="17,1,0,2">. Se você cadastrar mais de um atributo no ERP (ex.: Tamanho + Cor + Adicional), o ERP salva o item normalmente para ser vendido no caixa físico (PDV), mas bloqueia o envio para o e-commerce para evitar erros de integração</span><span data-path-to-node="17,1,0,4">.</span>
- <span data-path-to-node="17,2,0,0">**Por que o NCM cadastrado no ERP não aparece no painel da Tray?** O campo NCM não é um requisito do e-commerce da Tray, portanto não é exibido no painel da loja virtual</span><span data-path-to-node="17,2,0,2">. </span>
- <span data-path-to-node="17,3,0,0">**O pedido realizado no e-commerce caiu na filial/depósito incorreto no ERP. O que ocorreu?** Verifique o mapeamento De-Para</span><span data-path-to-node="17,3,0,2">. Se a amarração entre os IDs da Tray e as filiais do ERP não estiver salva corretamente, o *Webhook* direcionará a baixa para a filial padrão</span><span data-path-to-node="17,3,0,4">.</span>
- <span data-path-to-node="17,4,0,0">**Foi realizada uma venda na loja física, mas o estoque no e-commerce não atualizou. Como resolver?** Verifique se os SKUs/EANs das variações do produto no ERP estão 100% idênticos aos cadastrados na Tray</span><span data-path-to-node="17,4,0,2">. Divergências em caracteres ou espaços impedem a localização da variação e a atualização do saldo</span><span data-path-to-node="17,4,0,4">.</span>
- <span data-path-to-node="17,5,0,0">**O e-commerce permitiu a venda de um produto com saldo zerado no ERP. Por quê?** A flag de **Estoque Infinito** está ativada no cadastro do produto dentro da plataforma Tray</span><span data-path-to-node="17,5,0,2">. Essa opção deve ser desativada para produtos acabados e mantida ativa apenas para itens sob encomenda</span><span data-path-to-node="17,5,0,4">.</span>