Integração Zydon ↔ Omie | Zydon Help Desk

O QUE É O OMIE?

O Omie é um sistema de gestão empresarial (ERP) que centraliza operações de vendas, estoque, financeiro e emissão de documentos fiscais na nuvem, oferecendo uma solução completa para a administração do seu negócio.

 

O QUE É A INTEGRAÇÃO ZYDON E OMIE?

A integração conecta a plataforma Zydon ao ERP Omie, permitindo a troca automática de informações entre os dois sistemas. Cadastros, estoque e pedidos são sincronizados de forma contínua, mantendo seus dados sempre atualizados e eliminando retrabalho manual.

Essa integração é ideal para distribuidores, atacadistas e indústrias que utilizam o Zydon como canal de vendas B2B e o Omie como ERP para gestão fiscal e operacional.

 

BENEFÍCIOS:

Consistência de dados entre o portal B2B e o ERP;

Eliminação de tarefas manuais e retrabalho de digitação;

Controle de estoque sincronizado em tempo real;

Pedidos enviados automaticamente para o ERP;

Cálculo de impostos em tempo real no checkout;

Configuração granular do que deve ou não sincronizar.

 

COMO INSTALAR A INTEGRAÇÃO:

Acessar o App Center: No menu lateral esquerdo do Zydon, clique em App Center e selecione a opção Aplicativos. Na barra de busca, digite Omie e clique em Instalar.

 

Configurar os Webhooks no Omie: Ainda no Portal do Desenvolvedor, cadastre o webhook do Zydon para que o Omie envie notificações automáticas de mudanças nos cadastros. A URL do webhook será exibida na tela de configuração do plugin e pode ser copiada com um clique. Você deve inscrever os seguintes eventos:

clientefornecedor.* — inclusão, alteração e exclusão de clientes/fornecedores;

localestoque.* — inclusão, alteração e exclusão de locais de estoque;

produto.* — inclusão, alteração, exclusão e movimentação de estoque;

vendedor.* — inclusão, alteração e exclusão de vendedores.

 

Inserir as credenciais: De volta ao Zydon, informe a App Key e o App Secret gerados no Portal do Desenvolvedor Omie e clique em Conectar. Após a validação, a integração estará ativa.

 

APÓS FINALIZAR A INTEGRAÇÃO:

Você terá acesso ao painel de sincronização, que é a tela principal do plugin. Nela, é possível visualizar e gerenciar todos os dados sincronizados entre Zydon e Omie, organizados em abas.

 

STATUS DE SINCRONIZAÇÃO:

Cada registro possui um status que indica o estado da sincronização:

Não Sincronizado — o registro existe no Omie mas ainda não foi enviado para o Zydon;

Pendente — o registro está na fila aguardando processamento;

Sucesso — sincronização concluída com sucesso;

Falha — ocorreu um erro durante a sincronização. Clique em "Ver mais" para consultar os detalhes do erro.

 

O QUE A INTEGRAÇÃO SINCRONIZA:

Produtos (Omie → Zydon)

Produtos cadastrados no Omie são sincronizados automaticamente para o Zydon sempre que um webhook de inclusão, alteração ou exclusão é recebido.

Campos sincronizados: descrição, código, EAN, peso bruto, valor unitário, unidade, marca e status (ativo/inativo);

Variações de produto: são detectadas automaticamente e sincronizadas como variações no Zydon, sem necessidade de configuração adicional;

Sincronização manual: na aba Produtos, selecione os itens desejados e clique em Sincronizar para forçar a sincronização;

Quando um produto é excluído ou inativado no Omie, ele é automaticamente desativado no Zydon.

 

Clientes (Omie → Zydon)

Clientes e fornecedores cadastrados no Omie são sincronizados para o Zydon como Parceiros Comerciais.

Campos sincronizados: razão social, CNPJ/CPF, e-mail, telefone, endereço e tags;

Regra importante — Roteamento por Tags: o Omie utiliza tags para classificar cadastros. O comportamento da sincronização depende das tags configuradas:

Tag "Cliente" → o registro é sincronizado como Parceiro Comercial no Zydon;

Tag "Transportadora" → o registro é sincronizado como Método de Entrega no Zydon;

Ambas as tags → o registro é sincronizado como ambos (Parceiro Comercial e Método de Entrega);

Nenhuma tag → o registro é ignorado e não será sincronizado.

Se a tag "Cliente" for removida de um registro que também é Transportadora, o Parceiro Comercial correspondente será desativado no Zydon (e vice-versa);

Sincronização manual: na aba Clientes, selecione os registros e clique em Sincronizar.

 

Vendedores (Omie → Zydon)

Vendedores cadastrados no Omie são sincronizados automaticamente para o Zydon.

Campos sincronizados: nome, e-mail e status (ativo/inativo);

Vendedores excluídos ou inativados no Omie são desativados no Zydon;

Sincronização manual: na aba Vendedores, selecione e clique em Sincronizar.

 

Locais de Estoque (Omie → Zydon)

Locais de estoque (depósitos) cadastrados no Omie são sincronizados como depósitos no Zydon.

Campos sincronizados: código, descrição e endereço (enriquecido automaticamente com os dados da empresa no Omie);

Sincronização manual: na aba Locais de Estoque, selecione e clique em Sincronizar.

 

Categorias de Produto (Omie → Zydon)

Famílias de produto do Omie são sincronizadas como categorias no Zydon.

Campos sincronizados: nome da família e status (ativo/inativo);

Essa sincronização é opcional e deve ser habilitada nas configurações do plugin (opção "Sincronizar categorias");

Sincronização manual: na aba Categorias, selecione e clique em Sincronizar.

 

Estoque (Omie → Zydon)

Movimentações de estoque no Omie atualizam automaticamente o saldo de estoque no Zydon.

Regra importante: o estoque é sempre sobrescrito no Zydon com o valor atual do Omie. A integração não soma nem subtrai — ela substitui o saldo pelo valor informado pelo Omie;

O controle é feito por produto + local de estoque, garantindo que cada combinação tenha seu saldo correto;

Sincronização manual: nas Configurações do plugin, na aba Estoque, clique em Buscar Estoque para forçar a sincronização de todos os produtos.

 

Pedidos (Zydon → Omie)

Quando um pedido é realizado na plataforma Zydon, ele é enviado automaticamente para o Omie.

O pedido é montado com o cenário de impostos, categoria, conta corrente e CFOP configurados nas configurações do plugin;

Criação automática de cliente: se o cliente do pedido ainda não existir no Omie, a integração cria o cadastro automaticamente no Omie antes de enviar o pedido, utilizando os dados do Parceiro Comercial no Zydon;

Se o pedido possuir um método de entrega vinculado a uma Transportadora sincronizada, a informação de frete é adicionada automaticamente ao pedido no Omie;

Regra "Somente Pagos": quando habilitada nas configurações, apenas pedidos com status Pago são enviados para o Omie;

Retentar pedidos com erro: na tela de Pedidos, registros com status "Erro" possuem um botão de Retentar para reprocessar o envio.

 

Cálculo de Impostos (Zydon → Omie, em tempo real)

Durante o checkout na plataforma Zydon, a integração consulta o Omie em tempo real para calcular os impostos do pedido.

O cálculo considera o cliente, os produtos e o cenário de impostos configurado;

São retornados os valores de CBS, COFINS, ICMS, IPI, PIS e demais tributos aplicáveis;

Esse fluxo é síncrono — o resultado é retornado imediatamente para exibição no checkout.

 

CONFIGURAÇÕES DO PLUGIN:

Após a instalação, acesse as configurações do plugin para personalizar o comportamento da sincronização. As opções estão organizadas por aba:

Produtos: Opções de Auto-criar e Auto-atualizar produtos;

Clientes: Opções de Auto-criar e Auto-atualizar clientes;

Vendedores: Opções de Auto-criar e Auto-atualizar vendedores;

Locais de Estoque: Auto-criar, Auto-atualizar locais e Auto-atualizar estoque, além do botão Buscar Estoque;

Categorias: Opção Sincronizar categorias;

Pedidos: Opção Somente pagos e campos para Cenário de Impostos, Categoria, Conta Corrente e CFOP.

 

TELA DE PEDIDOS:

A tela de Pedidos Realizados permite acompanhar todos os pedidos enviados do Zydon para o Omie. No topo, o Dashboard de estatísticas resume a situação:

Total de Pedidos — quantidade total de pedidos processados;

Pendentes — pedidos aguardando envio ao Omie;

Sincronizados — pedidos enviados com sucesso;

Com Erro — pedidos que falharam no envio.

Para localizar registros, utilize os filtros por ID Zydon, ID Omie, ID do Parceiro ou Status. Pedidos com erro exibem um botão de reenvio na coluna de ações.

 

RESUMO DAS RESPONSABILIDADES:

Automático (feito pela integração)

Sincronização de Produtos, variações e categorias (Omie → Zydon);

Clientes e transportadoras, com roteamento por tags (Omie → Zydon);

Vendedores e Locais de estoque (Omie → Zydon);

Envio de Pedidos e criação automática de clientes (Zydon → Omie);

Cálculo de impostos em tempo real e desativação automática de cadastros inativos.

 

Manual (responsabilidade do usuário)

Webhooks: configurar os eventos no Portal do Desenvolvedor Omie;

Tags: garantir que clientes possuam as tags "Cliente" e/ou "Transportadora" no Omie;

Configurações de pedido: selecionar cenário de impostos, categoria, conta corrente e CFOP;

Dados fiscais: garantir CNPJ/CPF preenchidos para criação automática de cadastros.

 

IMPORTANTE:

Para obter mais informações ou qualquer outra dúvida, entre em contato com nossa equipe de suporte.

 

🚀 Quer Omie e Zydon 100% sincronizados? Teste grátis por 15 dias!

Crie sua conta agora: https://admin.zydon.com.br/criacao-conta