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
Passo 1 — 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.
Passo 2 — 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
Passo 3 — 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)
O endereço do depósito é obtido automaticamente a partir do cadastro 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. Pedidos com outros status são ignorados até que sejam pagos
Retentar pedidos com erro: na tela de Pedidos, pedidos 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, por item e no total
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
Auto-criar produtos: quando ativado, produtos incluídos no Omie são criados automaticamente no Zydon
Auto-atualizar produtos: quando ativado, alterações em produtos no Omie são refletidas automaticamente no Zydon
Clientes
Auto-criar clientes: quando ativado, clientes incluídos no Omie são criados automaticamente no Zydon
Auto-atualizar clientes: quando ativado, alterações em clientes no Omie são refletidas automaticamente no Zydon
Vendedores
Auto-criar vendedores: quando ativado, vendedores incluídos no Omie são criados automaticamente no Zydon
Auto-atualizar vendedores: quando ativado, alterações em vendedores no Omie são refletidas automaticamente no Zydon
Locais de Estoque
Auto-criar locais de estoque: quando ativado, novos depósitos no Omie são criados automaticamente no Zydon
Auto-atualizar locais de estoque: quando ativado, alterações nos depósitos são refletidas no Zydon
Auto-atualizar estoque: quando ativado, movimentações de estoque no Omie atualizam o saldo no Zydon automaticamente
Buscar Estoque: botão para forçar a sincronização manual do estoque de todos os produtos
Categorias
Sincronizar categorias: quando ativado, famílias de produto do Omie são sincronizadas como categorias no Zydon
Pedidos
Somente pagos: quando ativado, apenas pedidos com status Pago são enviados ao Omie
Cenário de Impostos: selecione o cenário fiscal que será aplicado aos pedidos enviados ao Omie
Categoria: selecione a categoria padrão dos pedidos no Omie
Conta Corrente: selecione a conta corrente para registro financeiro dos pedidos
CFOP: selecione o código fiscal de operações e prestações para os pedidos
Tela de Pedidos
A tela de Pedidos Realizados permite acompanhar todos os pedidos enviados do Zydon para o Omie.
Dashboard de estatísticas
No topo da tela, 4 cards resumem a situação dos pedidos:
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
Clique em qualquer card para filtrar a listagem pelo status correspondente.
Filtros
Utilize os filtros para localizar pedidos específicos por ID Zydon, ID Omie, ID do Parceiro ou Status.
Retentar pedidos com erro
Pedidos com status Erro exibem um botão de Retentar na coluna de ações. Clique para reprocessar o envio. Antes de retentar, consulte o detalhe do erro clicando no ícone de erro na coluna Status.
Resumo das responsabilidades
Automático (feito pela integração)
Produtos, variações e categorias (Omie → Zydon)
Clientes e transportadoras, com roteamento por tags (Omie → Zydon)
Vendedores (Omie → Zydon)
Locais de estoque e saldo de estoque (Omie → Zydon)
Pedidos (Zydon → Omie), incluindo criação automática de cliente quando necessário
Cálculo de impostos em tempo real no checkout (Zydon → Omie)
Desativação de cadastros quando excluídos ou inativados na origem
Manual (responsabilidade do usuário)
Webhooks: configurar os eventos de webhook no Portal do Desenvolvedor Omie conforme orientado na instalação
Tags: garantir que clientes no Omie possuam a tag "Cliente" e/ou "Transportadora" para que sejam sincronizados corretamente. Registros sem tag são ignorados
Configurações de pedido: selecionar cenário de impostos, categoria, conta corrente e CFOP antes de enviar pedidos
Dados fiscais: garantir que clientes possuam CNPJ/CPF preenchidos para que a criação automática no Omie funcione corretamente
Pedidos com erro: consultar o detalhe do erro e retentar quando necessário