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.

Entender essa arquitetura é fundamental para a configuração correta do sistema e para um diagnóstico rápido em atendimentos de suporte.

🎯 Contexto e Por que Fazer

A sincronização de catálogo e estoque elimina o retrabalho de dupla digitação e blinda a operação contra falhas, como a venda online de um produto que acabou de esgotar na loja física. A integração foi desenhada para que os canais de venda (e-commerce e balcão) se retroalimentem em tempo real, enquanto o ERP atua como o centralizador das regras de negócio, do financeiro e do ecossistema fiscal.

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

As informações abaixo fluem de forma automática em ambas as direções. Uma alteração na Tray refletirá no ERP 2.0 e vice-versa:

📦 Gestão de Estoque: As baixas geradas por vendas (tanto no PDV físico quanto no e-commerce) e as entradas manuais ou via notas fiscais atualizam o saldo de ambos os sistemas em tempo real.
🏷️ Catálogo de Produtos (Atributo Único): A criação de produtos com até 1 atributo de variação (exemplo: apenas "Tamanho"), assim como a edição de preços de venda, SKUs e códigos EAN, sincronizam perfeitamente em ambos os sentidos.
🖼️ Imagens de Produtos: Imagens anexadas a um produto principal ou a uma variação de grade específica (sejam elas inseridas via ERP 2.0 ou via painel Tray) são enviadas e integradas corretamente entre as duas plataformas.
👥 Base de Clientes: Um cliente que cria uma conta e finaliza uma compra no site da Tray tem seu cadastro enviado ao ERP. Do mesmo modo, um novo cliente cadastrado presencialmente no caixa da loja física (Tray PDV) alimenta a base de dados unificada.

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

Devido às diferenças operacionais entre o mundo digital e o mundo físico, algumas informações possuem um fluxo restrito:

💰 Vendas e Fluxo de Caixa (Tray / PDV ➔ ERP 2.0): O fluxo financeiro é unidirecional. As transações de vendas finalizadas, sangrias, suprimentos e os meios de pagamento recebidos nas pontas de venda (Loja Virtual e Caixa Físico) descem para consolidar o DRE e os relatórios financeiros dentro do ERP 2.0.
⚖️ Parâmetros Fiscais e NCM (Exclusivo ERP 2.0): A plataforma de e-commerce da Tray não exige o preenchimento de NCM para processar vendas online. Por isso, o NCM não é integrado da CPlug para a Tray e nem vice-versa. Toda a parametrização fiscal e de tributação deve ocorrer exclusivamente no ERP 2.0 para garantir a emissão correta da nota fiscal de balcão (NFC-e).
🧩 Produtos com Múltiplos Atributos (Exclusivo ERP 2.0): A loja virtual da Tray processa apenas produtos com um atributo de variação. Se um lojista cadastrar no ERP 2.0 um produto com múltiplos atributos (ex: Tamanho + Adicional + Borda Recheada), o ERP salvará o item para que seja utilizado perfeitamente nas vendas físicas do PDV, mas o sinalizará com um alerta de Inelegível para a Tray. Esse item não subirá para o e-commerce para evitar falhas sistêmicas.

📊 Matriz de Resumo da Sincronização

Informação / Recurso	Fluxo Ativo	Onde Cadastrar/Gerir	Ação do Sistema
Saldos de Estoque	Bidirecional	ERP ou Tray	Consome o estoque em tempo real na outra ponta.
Imagens e Grades Simples	Bidirecional	ERP ou Tray	Replicação idêntica de SKUs, Preços e Fotos.
Base de Clientes	Bidirecional	ERP ou Tray	Histórico de compras e dados mantidos na base unificada.
NCM e Dados Fiscais	Exclusivo ERP	ERP 2.0	Essencial para o funcionamento do caixa físico. Não sobe para a Tray.
Múltiplos Atributos	Exclusivo ERP	ERP 2.0	Salvo no ERP, visível no PDV físico, mas bloqueado (inelegível) para a Tray.
Vendas e Financeiro	Unidirecional (Para ERP)	Lojas ➔ ERP	ERP recebe as baixas para consolidar o relatório central.

❓ Dúvidas Frequentes e Boas Práticas

Onde é recomendável iniciar o cadastro de um produto novo? Embora a integração de produtos simples seja 100% bidirecional, a melhor prática recomendada é que o cadastro sempre nasça no ERP 2.0. Dessa forma, o lojista já insere os dados de custo, formação de preço e, principalmente, as informações fiscais (NCM) necessárias para a operação física desde o primeiro momento, antes de exportá-lo para a internet.
Por que o NCM não sobe para a Tray? O NCM não é um requisito operacional do e-commerce e, portanto, seu painel não consome esse dado. Se o cliente relatar que o NCM "sumiu", basta orientá-lo que esta é uma informação lida e gerenciada unicamente na retaguarda do ERP 2.0.
Um produto ficou marcado como "Inelegível" no ERP. O que isso afeta?

Este status é gerado apenas como proteção para a loja virtual, pois a Tray não suporta a estrutura de múltiplos atributos cadastrada. Contudo, o produto não está "quebrado"; ele operará perfeitamente para vendas de balcão ou caixa rápido na loja física.