INTEGRAÇÃO TRAY

• INTEGRAÇÃO TRAY + CPLUG
• GUIA DE INFORMAÇÕES - TRAY PDV
• JORNADA DE IMPLANTAÇÃO - TRAY PDV
• GUIA DE SINCRONIZAÇÃO - INTEGRAÇÃO TRAY/ERP
• CENTRAL DE APOIO - IMPLANTAÇÃO TRAY PDV

INTEGRAÇÃO TRAY + CPLUG

O que é a integração entre Tray e Cplug?

A integração Tray + CPlug conecta o sistema de ERP e PDV da CPlug com a plataforma de e-commerce Tray, permitindo que o estoque seja controlado exclusivamente pelo ERP, enquanto a Tray gerencia a loja online e oferece funções de PDV físico. Isso garante que as vendas online e no PDV físico sejam sincronizadas de forma eficiente, com o ERP cuidando do controle de estoque, financeiro e emissão de notas fiscais.

O processo começa com a criação manual da conta do cliente no sistema da CPlug pela Tray. Após isso, as vendas realizadas na loja online Tray são importadas para o ERP, que gerencia as operações, enquanto a emissão de notas fiscais pode ser feita automaticamente ou manualmente, dependendo dos módulos contratados. O estoque é sempre controlado pelo ERP, e a Tray exibe as informações recebidas, sem permitir alterações diretamente nela.

Produtos podem ser sincronizados entre as plataformas, com a possibilidade de vinculação manual para evitar erros, especialmente em grandes volumes. Para clientes Tray, não é necessário contratar um plano adicional na CPlug, mas clientes CPlug que desejam integrar com a Tray precisarão contratar planos em ambas as plataformas, gerando custos duplos até uma possível unificação.

A integração otimiza a gestão de vendas e estoque, oferecendo mais controle e agilidade tanto para o e-commerce quanto para as vendas físicas.

1. Estrutura e Premissas da Integração Tray + CPlug

Parceria White-label

• A Tray revende o ERP e PDV da CPlug como um produto white-label (com marca Tray).

• Toda a contratação, cobrança e suporte inicial são feitos pela Tray.
  
  

2. Ativação e Criação da Conta

Passo a passo:

1. Cliente contrata o módulo “Tray PDV” dentro da Tray.

2. O comercial da Tray cria a conta manualmente no sistema da CPlug pelo painel de parceiros e envia as credenciais ao cliente.

3. A conta criada não terá plano no painel da CPlug, pois o faturamento é feito pela Tray.
   
   

3. Integração ERP + Loja Online da Tray

Como ativar:

1. No ERP, acessar Integrações > Integrações ERP > Tray.

2. Preencher código da loja e URL.

3. Clicar em Ativar: será redirecionado para o painel da Tray para autorizar a conexão.

4. Pré-requisito: o módulo "Tray PDV" deve estar ativo no plano da Tray.
   
   

4. Fluxo de Vendas e Estoque

Vendas:

• Vendas feitas na Tray (loja online) são importadas para o ERP da CPlug, que:

  • Baixa estoque

  • Gera financeiro

  • Permite emissão de nota (manual ou automática, dependendo do módulo ativo)

• Vendas no PDV físico não retornam para a Tray, o controle é unidirecional.

Estoque:

• O estoque é controlado exclusivamente pelo ERP.

• Tray apenas “exibe” o estoque recebido do ERP.

• Alterações na Tray não afetam o ERP.
  
  

5. Produtos e Sincronização

Bidirecionalidade:

• Cadastro pode ser feito na Tray ou no ERP.

• Campos sincronizados: nome, código, preço, imagem, categoria, código de barras, variação simples.

• Campos exclusivos da Tray (ex: marca, garantia) devem ser preenchidos manualmente na Tray.

⚠️ Limitações:

• Tray limita produtos por plano.

• Nomes duplicados de categorias impedem sincronização.

Conciliação Manual de Produtos:

• É possível vincular manualmente um produto da CPlug com um da Tray via tela de integração.

• Listas lado a lado: coluna esquerda (Tray), coluna direita (CPlug).

• Seleciona-se os produtos correspondentes e realiza-se a conciliação.

Recomendação:

• Preferência por cadastrar produtos com variação complexa diretamente na Tray.

• Em bases grandes, exportar os produtos do ERP para a Tray para evitar conflitos.
  
  

6. Variações de Produto

Tray:

• Suporta variação simples (ex: cor) e variação dupla (ex: cor + tamanho), mas trata a dupla como grade única.

No ERP:

• Ao importar uma variação dupla da Tray, o ERP concatena os atributos (ex: “cor - tamanho”).

• Para garantir compatibilidade, prefira cadastrar produtos com variações diretamente na Tray.
  
  

7. Emissão de Notas

Cenários:

1. Cliente com Emissor Tray:

• O cliente pode contratar apenas o módulo de emissão de NFe/NFC-e da Tray (sem PDV nem ERP).

• A nota é emitida através de uma interface visual da Tray, mas por trás é o sistema da CPlug que processa a nota.

• Uma conta CPlug é criada automaticamente em segundo plano (identificável pelo código de login "tray-xxxxx").

• Toda a parametrização fiscal é feita pela Tray, mas os dados são refletidos no ERP da CPlug.

2. Cliente Tray PDV + ERP CPlug:

• Quando o cliente deseja usar também o PDV (físico) e o ERP, ele pode migrar essa conta de emissor para o ambiente completo do ERP.

• A conta do emissor é reaproveitada e expandida para evitar perda de histórico de notas fiscais.

• Nesse caso, as configurações fiscais já feitas no emissor serão mantidas no ERP e a emissão de NFCE no PDV ocorrerá normalmente, seguindo o fluxo já conhecido.

• Vendas recebidas da Tray (loja online) cairão no ERP e poderão gerar:

  • NFe automática na Tray, caso o módulo de emissor esteja habilitado.

  • NFe manual na Cplug, se o cliente não tiver contratado o emissor.

3. Vendas no PDV (físico):

• Emitem NFC-e normalmente, conforme parametrização fiscal já replicada da conta emissor para o ERP.

Observações:

• A emissão automática de NFe está vinculada à contratação do módulo emissor.

• Sem esse módulo, a nota (NFe) deverá ser emitida manualmente.

• Emissão de NFCE no PDV ocorre seguindo o fluxo normal.

8. Planos e Cobrança

• Cliente vindo da Tray:

  • Não precisa de plano no painel da CPlug.

  • Tudo é cobrado e gerenciado pela Tray.

• Cliente CPlug que deseja integrar com a Tray:

  • Precisa contratar o plano na Tray também → paga duplamente até unificação futura.
    
    

9. Dicas Gerais e Observações Importantes

✅ Variações complexas: cadastrar diretamente na Tray facilita a integração e evita problemas com atributos.

✅ Produtos existentes nas duas plataformas podem ser vinculados manualmente na tela de conciliação.

✅ É recomendado exportar os produtos do ERP para a Tray em casos de grande volume para manter organização e consistência.

✅ Estoque é controlado exclusivamente pelo ERP. Ao ativar a integração, ele sobrepõe o estoque da Tray.

✅ Tray possui limitação de produtos por plano. Fique atento ao número permitido antes de exportar.

✅ Categorias com mesmo nome causam erro de sincronização.

✅ O código de login "tray-xxxxx" identifica contas criadas automaticamente via emissor da Tray.

✅ Promoções criadas na Tray não são integradas ao ERP.

✅ Promoções criadas na Cplug não são integradas à Tray.

GUIA DE INFORMAÇÕES - TRAY PDV

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.

🎯 Contexto e Por que Fazer

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.

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

• Inteligência de Variações de Atributos: O ERP 2.0 permite o cadastro de produtos com múltiplos atributos. 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. O produto fica sinalizado como inelegível para a Tray, mas funciona normalmente para vendas físicas no PDV.

• Para o Comercial: Diferencial competitivo ao entregar uma solução omnichannel completa. Permite vender para lojistas que buscam expansão para e-commerce ou necessitam de controle presencial ágil. Destaca o uso do Smart TEF (sem custos adicionais de TEF tradicional) e o suporte nativo a Multi CD com emissão fiscal fracionada por CNPJ.

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

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

📋 Pré-Requisitos

• Acesso administrativo ao Painel Tray e ao ERP 2.0 (pdv.tray.com.br).

• Computador/Notebook com leitor de código de barras ou maquininha POS Smart (Stone, Cielo, Rede) com Smart TEF habilitado (se aplicável).

• Dados fiscais completos previstos no ERP (NCM e regra de tributação) para emissão no caixa presencial.

• Ao menos 2 Depósitos/Filiais criados no ERP caso a operação utilize Multi CD.

• Listagem dos IDs numéricos das Filiais/CDs cadastrados na plataforma Tray.

⚙️ Passo a Passo

• Acesso ao Ambiente White Label Acesse o painel do ERP 2.0 diretamente pelo link dedicado ou via atalho no painel da Tray.

• Cadastro de Produto, Imagens e Múltiplos Atributos (No ERP 2.0 ou Tray) Acesse Produtos > Cadastro de Produtos. 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.

Parametrização Fiscal Obrigatória No ERP, preencha o campo de NCM e a Tributação do produto. 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.

• Configuração da Integração e Sincronismo Acesse Configurações Gerais > Integrações > Tray. Informe o código da loja, a URL e clique em Autenticar. 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.

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

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. Isso evita o travamento desnecessário de saldo em pedidos pendentes (como boletos). Configure os parâmetros do Smart TEF para as maquininhas POS Smart em Configurações > Formas de Pagamento.

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

❓ Dúvidas Frequentes

• Cadastrei um produto com imagens no ERP e ele não subiu para a Tray. O que verificar? A sincronização de imagens é bidirecional. 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.

• 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). 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.

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

• O pedido realizado no e-commerce caiu na filial/depósito incorreto no ERP. O que ocorreu? Verifique o mapeamento De-Para. 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.

• 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. Divergências em caracteres ou espaços impedem a localização da variação e a atualização do saldo.

• 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. Essa opção deve ser desativada para produtos acabados e mantida ativa apenas para itens sob encomenda.

JORNADA DE IMPLANTAÇÃO - TRAY PDV

📦 Fase 1: Preparação do Catálogo e Regras Fiscais

🏢 Fase 2: Estruturação de Estoques (Multi CD)

Se a operação do lojista possui mais de um local de armazenamento (ex: Loja Centro e Loja Shopping), é necessário configurar os múltiplos estoques.

• Ativação de Depósitos no ERP: É preciso criar as filiais e lançar os saldos iniciais de estoque de cada uma diretamente no ERP 2.0.
• Identificação na Tray: Deve-se acessar o painel da Tray em Configurações > Filiais e CDs e anotar o ID numérico de cada Centro de Distribuição cadastrado na plataforma.

• O Mapeamento (De-Para): A plataforma Tray decide de qual loja sai o pedido (com base no CEP do comprador), mas o ERP é o sistema que executa a baixa do estoque.

Para isso funcionar, é necessário acessar ERP 2.0 > Integrações > Tray > Mapeamento de Filiais e ligar o depósito do ERP ao respectivo ID numérico da Tray. Em seguida, basta clicar em Salvar Mapeamento.

⚙️ Fase 3: Gatilhos e Automações

✅ Fase 4: Homologação (A Venda de Teste)

❓ Dúvidas Frequentes e Boas Práticas

GUIA DE SINCRONIZAÇÃO - INTEGRAÇÃO TRAY/ERP

A integração entre a loja virtual Tray e o ERP 2.0 (ConnectPlug) destaca-se pelo seu motor de sincronização de dados. Para garantir uma operação omnichannel fluida, é essencial compreender o fluxo dessas informações — ou seja, quais dados viajam em ambos os sentidos (bidirecionais) e quais possuem regras exclusivas ou sentido único.

🎯 Contexto e Por que Fazer

🔁 1. Dados 100% Bidirecionais (Sincronização Dupla)

🛤️ 2. Dados Unidirecionais e Exclusivos (Regras Específicas)

📊 Matriz de Resumo da Sincronização

❓ Dúvidas Frequentes e Boas Práticas

CENTRAL DE APOIO - IMPLANTAÇÃO TRAY PDV

🛠️ 1. Guia de Bolso & Script de Campo

2. Plano Mestre de Treinamento

🖥️ 3. Apresentações de Apoio (Slides)

🎙️ 4. Podcasts e Gravações

❓ FAQ Dinâmico: Qual material usar e quando?