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:

Cliente contrata o módulo “Tray PDV” dentro da Tray.
O comercial da Tray cria a conta manualmente no sistema da CPlug pelo painel de parceiros e envia as credenciais ao cliente.
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:

No ERP, acessar Integrações > Integrações ERP > Tray.
Preencher código da loja e URL.
Clicar em Ativar: será redirecionado para o painel da Tray para autorizar a conexão.
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.