A integração entre o Eccosys e a Shopify foi desenvolvida para oferecer a você uma experiência simples, segura e eficiente na gestão do seu e-commerce. Com essa conexão, sua operação se torna mais ágil, centralizando as informações de pedidos, produtos e estoque em um único ambiente.

Nosso objetivo é garantir que você aproveite ao máximo os recursos das duas plataformas, mantendo sua loja online sempre atualizada e integrada com os processos internos.

Neste manual, você aprenderá:

• Fluxo da integração
• Pré-requisitos para configuração
• Como configurar a integração Eccosys - Shopify
• Particularidades da Shopify
• Como mapear atributos da ficha técnica
• Como é a atualização de estoque com a Shopify
• Como é a atualização de produtos com a Shopify
• Como é a atualização de pedidos com a Shopify

Fluxo da Integração

(*) Enviados apenas em conjunto, quando informados no cadastro do produto. "Atributos" e "Marcas" serão enviados nos produtos desde que estas informações tenham sidos previamente cadastradas e importadas da plataforma para o Eccosys.

Como configurar a integração Eccosys - Shopify

Pré-requisitos

• URL da loja
• Acess Token 

Aba Dados de Acesso

Para ativar a comunicação entre o Eccosys e a plataforma Shopify, será necessário preencher no sistema Eccosys corretamente os dados de acesso fornecidos pela própria Shopify.

Acesse o menu: 

1. Configurações > Integrações > Plataformas.
2. Clique no botão Incluir Plataforma.
3. O sistema exibirá uma lista com todas as plataformas disponíveis para integração.
4. Localize e clique sobre Shopify para iniciar a configuração.

Na tela de configuração da integração com a Shopify, preencha os campos da aba Acesso com as informações abaixo:

• Nome: Defina um nome interno para identificar a integração. Exemplo sugerido: Integração Shopify.
• Status da Integração: Deixe como Ativa para que o Eccosys possa iniciar as sincronizações com a plataforma.
• URL da Loja: Informe o endereço da sua loja na Shopify.
• Acesso Token: Para integrar com a Shopify, é necessário obter o token de integração pelo aplicativo no painel da Shopify. Basta instalar e configurar o app, mantendo o Eccosys aberto no mesmo navegador. O token será preenchido automaticamente na tela de integração, sem necessidade de copiar ou colar.

Após preencher os dados, clique no botão Testar conexão para validar se as credenciais estão corretas e o Eccosys consegue se comunicar com a loja.

Aba Configurações

Após concluir o preenchimento dos dados de acesso à plataforma de e-commerce, o sistema Eccosys disponibiliza uma estrutura padronizada de abas para gerenciamento da integração.

Entre elas, a aba Configurações é uma das mais importantes, pois centraliza os parâmetros que controlam o comportamento da sincronização entre o ERP e a plataforma Shopify, tanto em relação aos produtos quanto ao estoque e aos pedidos de venda.

Abaixo, explicamos cada campo disponível nessa aba:

Produto

• Importação de Produtos – Apenas Ativos: Define se o Eccosys deve importar somente os produtos marcados como ativos na plataforma Shopify.
  • Sim: apenas produtos ativos serão sincronizados.
  • Não: todos os produtos serão importados, independentemente do status.
• Origem padrão de produtos importados da loja: Define a origem fiscal padrão (nacional/importado) a ser atribuída aos produtos que vierem da Shopify. Útil para emissão de notas fiscais.
• Enviar imagens: Determina se as imagens dos produtos cadastradas no Eccosys devem ser enviadas para a plataforma.
  • Sim: as imagens do ERP serão sincronizadas com a Shopify.
  • Não: nenhuma imagem será enviada.
• Data de Corte - Tarefa importação de produtos novos: Permite definir uma data a partir da qual os produtos passarão a ser sincronizados.
• Lista de preço da Plataforma: Permite vincular uma lista de preço específica do Eccosys à integração, para envio de valores personalizados.
  • Nenhuma: utiliza os preços padrão dos produtos.
• Envio de categorias: Determina se as categorias dos produtos cadastradas no Eccosys devem ser enviadas para a plataforma.
  • Não: Nenhuma categoria do produto será enviada para a plataforma.
  • Sim, enviar árvore de categorias: Envia todas as categorias e subcategorias vinculadas ao produto, mantendo a hierarquia completa.
  • Sim, enviar último nível da árvore: Envia apenas a categoria mais específica (último nível) à qual o produto pertence.

Estoque 

• ID do Depósito Padrão na Plataforma: Código do depósito padrão da plataforma.
• Regra de Envio de Estoque: Define de que forma o estoque será enviado à plataforma Shopify:
  • Enviar Estoque do Depósito Padrão da Plataforma: Envia apenas o saldo de estoque do depósito definido como padrão no cadastro da plataforma.
  • Enviar Estoque Consolidado de Todos os Depósitos: Soma o estoque disponível em todos os depósitos cadastrados no ERP e envia o total para a Shopify.
  • Enviar Estoque de Depósitos Mapeados que Consideram Saldo: Permite definir quais depósitos devem ser considerados, conforme os mapeamentos cadastrados na integração.

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.

Pedidos de Venda

• Enviar imagens do produto pai nas variações: Define se a imagem do produto principal (pai) será replicada nas variações (filhas).
• Data de corte mínima para baixa de pedidos: Permite definir uma data a partir da qual os pedidos passarão a ser sincronizados.
• Importar pedidos de vendas por situação: Define qual status os pedidos precisam ter na Shopify para serem importados pelo Eccosys.
  • Exemplo: Pagos — apenas pedidos já pagos serão integrados.
• Regra de envio de status para a Plataforma: Define quando o Eccosys deve comunicar à Shopify que o pedido foi processado.
  • Exemplo: Nota Fiscal Autorizada com Pedido Atendido — envia status somente após a emissão da NF-e e que o pedido permaneça com situação atendido.
• Integração com Cotação Frenet: Define se o Eccosys deve utilizar a integração com a Frenet para calcular automaticamente os valores de frete durante a cotação

Com as configurações ajustadas conforme o fluxo da sua operação, clique em Salvar para aplicar as alterações.

Aba Mapeamentos

A aba Mapeamentos permite configurar campos personalizados entre o Eccosys e a plataforma integrada, utilizados quando determinadas informações não são contempladas na comunicação padrão da integração.

Ela serve como um complemento, possibilitando que dados específicos — como NCM, descrições adicionais, canais de venda, entre outros — sejam alinhados corretamente entre os sistemas, conforme a estrutura e nomenclatura utilizadas na plataforma.

Aba Automações

A aba Automações permite ativar ou desativar tarefas automáticas específicas da integração entre o Eccosys e a plataforma Shopify. Essa flexibilidade é essencial para personalizar o comportamento da sincronização, de acordo com as necessidades operacionais de cada loja.

As automações ativadas serão executadas de forma recorrente, em intervalos definidos no menu Configurações > Outros > Tarefas Agendadas do sistema.

A seguir, veja a descrição de cada opção disponível:

Produto

• Criar/Atualizar Produtos: Permite que o Eccosys crie ou atualize automaticamente os produtos na plataforma Shopify, com base nos dados do ERP.
• Sincronizar produtos: Habilita a sincronização periódica do catálogo entre os sistemas.
• Importar produtos: Autoriza o Eccosys a buscar os produtos cadastrados na Shopify e importar para a base do ERP.
• Definir produtos como estoque alterado: Marca os produtos para que sejam considerados na rotina de envio de estoque.
• Definir produtos como alterados: Força os produtos que foram atualizados no Eccosys a serem incluídos na fila de sincronização.
• Instalador Multiplataforma – Apenas catálogo/categorias/marcas: Importa seletivamente as estruturas da plataforma, ideal para implantações controladas:
  • Catálogo: apenas produtos.
  • Categorias: apenas as categorias.
  • Marcas: apenas as marcas.
• Instalador Multiplataforma: Executa a importação inicial completa da plataforma (catálogo, categorias, marcas e depósitos).
• Sincronizar produtos novos: Inclui na rotina apenas produtos que ainda não foram enviados à plataforma.
• Sincronizar produtos inativos: Habilita o envio de produtos inativos, atualizando a situação na plataforma.
• Atualização de Preços: Permite que o Eccosys atualize automaticamente os preços dos produtos na Shopify.

Estoque

• Instalador Multiplataforma – Apenas depósitos: Importa apenas os depósitos (centros de distribuição) cadastrados na plataforma.
• Enviar estoque para a plataforma: Ativa o envio automático de saldos de estoque conforme as regras configuradas na aba anterior.

Vendas

• Sincronizar status dos pedidos de venda: Permite que o Eccosys atualize o status dos pedidos com base no processamento interno (ex: faturado, enviado).
• Consultar status de pedidos com pagamento pendente: Importa atualizações de pedidos que ainda não foram pagos.
• Importar pedidos de venda: Habilita a entrada automática de pedidos recebidos na Shopify conforme as regras configuradas na aba anterior.
• Cancelar pedidos: Permite que cancelamentos feitos no ERP sejam sincronizados com a plataforma.
• Enviar informação de entrega para Loja Virtual: Habilita o envio de dados de rastreamento e status de entrega para a Shopify.

Como funciona a importação de depósito

Para que a sincronização de produtos funcione corretamente entre o Eccosys e a Shopify, os depósitos (centro de distribuição) devem ser criados com a mesma nomenclatura entre eccosys e Shopify. Após criados, deve-se programar a tarefa “Instalador apenas depósito” para que ela identifique os depósitos entre os ambientes e permita sua devida identificação nos pedidos de venda. Essa estrutura é fundamental, pois é a partir do vínculo com o depósito que o sistema controla estoque, disponibilidade e expedição dos produtos.

• Sempre que um novo depósito for criado na Shopify, é importante habilitar a automação de importação de depósitos na aba Automações da integração.
• Após a execução da tarefa e o mapeamento correto do depósito no Eccosys, a automação pode ser desabilitada novamente, caso deseje evitar importações repetidas.

Como funciona a importação e envio de catálogo

A integração entre Eccosys e Shopify permite tanto a importação quanto a exportação do catálogo de produtos, mantendo as informações atualizadas e consistentes entre os dois sistemas.

Essas ações garantem que dados como nome, descrição, preço, imagens, categorias e estoque sejam sincronizados corretamente, seja para enviar do Eccosys para a Shopify ou para importar da Shopify para o ERP.

• Exportação de produtos: Permite enviar produtos cadastrados no Eccosys para a Shopify. Consulte o manual específico: Exportação de Catálogo nas Integrações de Plataforma
• Importação de produtos: Permite trazer para o Eccosys os produtos já existentes na Shopify. Consulte o manual específico: Importação de Catálogo nas Integrações de Plataforma

Ambas as rotinas podem ser executadas manualmente ou por meio das automações da integração.

Importação de pedidos

Para que os pedidos de venda sejam importados corretamente da plataforma Shopify para o Eccosys, é necessário que as transportadoras estejam previamente mapeadas.

Para instruções completas sobre criação e vínculo de transportadoras, consulte:

Manual de Cadastro e Vínculo de Transportadoras

Após essas configurações, os pedidos serão importados automaticamente por meio da automação disponível na aba Automações da integração. O Eccosys buscará periodicamente novos pedidos na plataforma, conforme o agendamento definido em Configurações > Outros > Tarefas Agendadas.

Também é possível realizar a importação manual, caso precise trazer pedidos pontualmente ou em situações específicas de contingência.

Para mais detalhes sobre como funciona o processo de importação de pedidos, acesse:
Importação de Pedidos de Venda nas Integrações de Plataforma

Como funciona a importação de pedidos com Multi CD

Para entender o fluxo de pedidos e atualização de estoque entre Eccosys e Shopify, considere o seguinte exemplo:

1. Um cliente do estado de São Paulo efetua a compra de 5 camisas sociais e 2 calças. Sua loja possui saldo disponível para estes produtos, mas eles se encontram em depósitos diferentes.
2. A compra do cliente será confirmada, porém cada produto vai entregue por uma transportadora, em datas distintas.
3. Ao importar o pedido, o Eccosys irá identificar que o pedido possui dois centros de distribuição. Neste caso serão baixados dois pedidos para a mesma ordem de compra.
4. As reservas dos produtos no Eccosys, assim como sua na plataforma, serão sempre para o depósito informado pela Shopify. Neste caso, as 5 camisas para o CD SP capital e as 2 calças para o CD Campinas.
5. O Eccosys irá enviar todas as movimentações sobre a compra do cliente, porém na plataforma elas ficarão como "Separados parcialmente" e "Enviado parcialmente", até conclusão do fluxo para todos os produtos.

Envio de rastreamento para a plataforma

O envio das informações de rastreamento para a plataforma Shopify acontece de forma automática durante a sincronização do status dos pedidos, conforme configurado na aba Automações da integração.

Quando a automação “Sincronizar status dos pedidos de venda” está ativa, o Eccosys atualiza o status do pedido na plataforma com base no progresso da operação dentro do ERP.

Se houver um código de rastreamento retornado pela logística integrada e uma URL de rastreio configurada no vínculo da transportadora, essas informações também serão enviadas para a plataforma no momento da atualização de status.

Dessa forma, o consumidor final poderá acompanhar o andamento do pedido diretamente pela loja, com base nos dados transmitidos automaticamente pelo Eccosys.

Conclusão

A integração entre o Eccosys e a Shopify oferece uma solução robusta e eficiente para centralizar a gestão de vendas em marketplaces, garantindo fluidez na comunicação entre sistemas, redução de retrabalho e mais controle sobre os processos operacionais.

Com os parâmetros corretamente configurados, é possível automatizar a sincronização de produtos, estoques, pedidos e informações logísticas, proporcionando uma operação mais ágil, integrada e escalável.

Em caso de dúvidas, nosso time de suporte está à disposição para auxiliar.