A integração entre o Eccosys e a plataforma Yampi permite centralizar a gestão da sua loja, controlando cadastros, estoque, preços, pedidos de venda, rastreamento e faturamento em um único lugar. Com a sincronização automática dos dados, você ganha agilidade, reduz erros manuais e tem mais controle sobre todo o processo, desde o pedido até a entrega.
Neste manual, você aprenderá:
Fluxo da integração
Particularidades da Yampi
Pré-requisitos para configuração
Como configurar a integração Eccosys - Yampi
Como funciona a importação de depósitos
Como funciona a importação e envio de catálogo
Categorias, Marcas e Atributos
Como funciona a importação de pedidos
Como funciona a atualização de estoque entre Eccosys e Yampi
Fluxo da integração
(*) Enviados apenas em conjunto, quando informados no cadastro do produto.
Entenda quais campos são comunicados entre o Eccosys e a Yampi.
Variações são obrigatórias apenas para produtos do tipo Pai>Filho.
Particularidades da Yampi;
Caso o transportador não esteja corretamente mapeado, os pedidos de venda não serão importados
Atualiza status "Entregue" por meio de tarefa própria
Painéis que possuem mais de um depósito deverão ter o ID depósito padrão da plataforma informado no eccosys antes da importação do catálogo
Pré-requisitos para configuração
URL da Loja (Opcional)
User-Token
User-Secret-Key
Alias
Para configurar a integração entre Eccosys e Yampi, será necessário acessar o painel em sua plataforma.
Procure pelo Menu do usuário (canto superior direito do painel Yampi) > Credenciais API
Como configurar sua Integração com a Yampi
Caso deseje migrar sua operação para uma outra plataforma ou serviço já integrado ao Eccosys, solicitamos que notifique o time de suporte com antecedência mínima de 30 dias. Desta forma, poderemos fornecer as orientações necessárias e avaliar quaisquer ajustes relacionados à migração.
Para integrar o Eccosys com a Yampi, acesse menu Configurações > Plataforma > Multiplataforma, clique em "Incluir uma Plataforma", informe:
Nome da loja: Insira o nome da sua loja.
Domínio: Informe o domínio da sua loja.
Selecione Yampi no campo "Plataforma".
Escolha o depósito correspondente para a integração. O campo Depósito define qual é o depósito cadastrado no ERP que enviará os saldos de estoque para a plataforma;
Na aba Conexão, preencha os campos:
Ambiente: User-Token
User Secret Key
Alias
Para verificar se a sua integração ocorreu corretamente, acesse Configurações > Plataforma > Multiplataforma.
Selecione a plataforma referente à Yampi e clique no botão "Testar conexão".
Na aba "Parâmetros da Plataforma", é possível configurar a comunicação com a Yampi, ajustando parâmetros e funcionalidades para uma integração eficiente.
Estes campos permitem personalizar a troca de dados conforme as necessidades da sua loja.
Importação de produtos - Apenas Ativo: Identifica se apenas produtos ativos devem ser importados da plataforma ao seu Eccosys;
Origem padrão de produtos importados da loja: Define, qual será a origem será vinculada aos cadastros dos produtos durante a importação;
Enviar Imagens: Define se as imagens devem ser enviadas do Eccosys a Yampi;
Lista de preço para a plataforma: Possibilita o envio de preço de venda de uma lista de preço a yampi, que não seja o preço de cadastro do produto.
Depósito: Identifique o depósito padrão para envio de estoque do Eccosys para a Yampi;
Regra de Envio de Estoque: Define como deve ser o envio de estoque para a plataforma, podendo ser “O depósito padrão da integração”, o “O saldo consolidado dos depósitos no eccosys” ou o “Envio de estoque separado por depósito”, quando eles estiverem vinculados pela integração;
ID do depósito padrão na Plataforma: Quando houver mais de um depósito cadastrado na plataforma, deve-se preencher esse campo com o ID depósito padrão Yampi, antes de fazer a importação do catálogo.
Data de corte mínima para a baixa de pedidos: Informe nesse campo a data inicial para a importação de pedidos de venda;
Importar pedidos de vendas por situação: Define se todos os pedidos, ou apenas os pagos devem ser importados da Yampi ao Eccosys.
Veja mais detalhes sobre o envio de estoque à Yampi considera as seguintes regras:
Envia estoque do depósito padrão da plataforma: Atualizará apenas o depósito informado nas configurações da plataforma;
Envia estoque consolidado de todos os depósitos: Soma o estoque de todos os depósitos do Eccosys e envia um valor único para a plataforma;
Envia estoque de depósitos mapeados que consideram saldos: Atualiza o estoque de todos os depósitos que possuírem referência e que estiverem selecionados para considerar saldo. O envio para a plataforma é feito de forma individual.
Como funciona a importação de depósito
Para que seja possível atualizar estoque de produtos, é necessário que pelo menos um depósito seja cadastrado na Yampi e importado para o Eccosys via tarefa agendada.
Esta tarefa agendada pode ser habilitada em Configurações > Outros > Tarefas agendadas (tarefa "Instalador Multiplataforma Apenas Depósitos").
Importação e envio de catálogo: como fazer?
A sincronização do catálogo entre a plataforma e o Eccosys pode ser feita de duas formas: em massa (via tarefas) ou individualmente (via painel).
Importação e Exportação em Massa
Para realizar a importação em massa do catálogo da plataforma para o Eccosys, utilize a tarefa agendada:
“Instalador Multiplataforma – Apenas Catálogo”
Para o envio de produtos do Eccosys para a plataforma, utilize a tarefa:
“Instalador Multiplataforma”
Essas tarefas garantem que as informações de produtos sejam atualizadas e sincronizadas corretamente entre os sistemas.
⚠️ Atenção:
Caso sua conta possua mais de uma integração ativa, é necessário desabilitar temporariamente as demais antes de rodar essas tarefas.
Isso porque, atualmente, não é possível executá-las de forma segmentada por integração — ou seja, a tarefa será aplicada a todas as plataformas habilitadas no momento.
✅ Recomendamos entrar em contato com o nosso time de suporte antes de executar essas tarefas, para que possamos validar as configurações e garantir que tudo ocorra conforme o esperado.
Já o envio de produtos individualmente do Eccosys para a plataforma pode ser feito acessando Configurações > Plataforma > Produtos. Para enviar ou importar os produtos, basta utilizar os botões de ação na linha correspondente:
Seta para cima: Enviar o produto para a plataforma.
Seta para baixo: Importar o produto da plataforma para o Eccosys.
As categorias e as marcas possuem telas próprias para envio em Configurações > Plataforma.
Os atributos precisam ser criados na plataforma e importados para o Eccosys por meio de uma tarefa agendada, localizada em Configurações > Outros > Tarefas Agendadas.
Importante: somente o Departamento e a Categoria serão exportados ou importados. Subcategorias não serão sincronizadas.
Para sua segurança, recomendamos que o processo de envio seja feito com o acompanhamento de nossa equipe de suporte.
Como mapear atributos da ficha técnica
Os atributos dos produtos são importados automaticamente da plataforma para o Eccosys. Para garantir que esses atributos sejam corretamente reconhecidos e mapeados no sistema, é fundamental que você crie os atributos diretamente na plataforma, utilizando nomes específicos que permitam uma integração clara e eficiente no Eccosys.
Por exemplo, para evitar confusão e garantir a correta identificação das integrações, você pode nomear os atributos de forma distinta, como: "Tamanhos" (utilizado para a integração com Yampi) e "Tamanho" (caso haja outra integração diferente).
Após criar os atributos na plataforma, é necessário realizar o mapeamento entre eles e os atributos correspondentes no Eccosys.
Para configurar esse mapeamento, acesse: Configurações > Plataformas > Mapeamentos. Nesta tela, será possível definir as relações de mapeamento entre as variações, realizando o processo de De/Para conforme necessário.
Como funciona a atualização de estoque, produtos e
pedidos
A atualização do estoque e demais campos dos cadastros dos produtos será feita por meio de tarefas agendadas.
O Eccosys trabalha com duas formas de identificação de estoque: o estoque físico e o estoque disponível. Por padrão, as atualizações de estoque na plataforma são baseadas no estoque disponível, que é calculado pela diferença entre o estoque físico e as reservas feitas por pedidos.
A reserva de estoque no Eccosys ocorre sempre que um pedido é criado, independentemente de como ele é gerado. Ou seja, toda vez que um pedido é registrado, uma tarefa agendada chamada "Atualização de Estoque" é acionada, ajustando a quantidade do produto disponível para venda de acordo com as reservas.
Para gerenciar as tarefas disponíveis em seu ambiente, acesse Configurações > Outros > Tarefas agendadas.
A importação de pedidos também ocorrerá por meio da funcionalidade de tarefa agendada. Esta integração também possui uma tela própria para seleção e importação manual de pedidos. Você pode acessá-la em Configurações > Plataforma > Pedidos de venda.
Para que a importação de pedidos aconteça, é necessário configurar as transportadoras na plataforma e posteriormente no Eccosys em Cadastros > Transportadoras.
Seu vínculo também precisa ser feito em Configurações > Cadastros > Vínculos de transportadoras. Para mais detalhes sobre a criação e vínculo de transportadoras, clique aqui.
Como enviar código de rastreio para Yampi
No Eccosys é possível montar a URL de rastreio e enviar essa informação para a plataforma Yampi.
Para isso, além de garantir a integração logística ativa e preencher o campo referente ao Vínculo da transportadora, será necessário configurar a tarefa '’Sincronizar Status dos Pedidos de Venda’' por meio da funcionalidade de 'agendamento de tarefa'.
Conclusão
Após realizar e revisar todas as configurações da plataforma, recomendamos a execução de testes para envio e baixa de produtos, bem como para a gestão de pedidos, a fim de garantir o funcionamento adequado de todos os processos.
Em caso de dúvidas, nosso time de suporte está à disposição para auxiliar.