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