Integração Magento 2 e Omie: como configurar o Omie.Hub

Quando pedidos precisam ser digitados novamente e o saldo é conferido em planilhas, cada venda cria uma nova tarefa. Integrar a loja ao ERP ajuda a organizar esse trabalho, desde que o projeto defina quais informações circulam, quem pode alterá-las e como tratar falhas.

A Mage2 preparou este roteiro para lojistas, gestores de e-commerce e equipes responsáveis pela implantação. O nome correto do sistema é Omie; a solução usada neste procedimento é o Omie.Hub.

Como funciona a integração Magento 2, Omie.Hub e Omie.ERP?

Pense no projeto em três partes: a experiência de compra na loja, a conexão operada pelo hub e os processos de gestão no ERP. Essa divisão ajuda a identificar onde uma informação foi criada e em qual etapa ocorreu um problema.

Antes de configurar o conector, recomendamos registrar as decisões abaixo. Elas são um roteiro de planejamento da Mage2; confirme os recursos disponíveis para sua conta e seu cenário com o fornecedor.

Um fluxo bem definido pode reduzir redigitação, facilitar a conferência e liberar tempo da equipe. O resultado depende da qualidade dos cadastros, dos testes e do acompanhamento da operação.

Quais são os requisitos para integrar Magento 2 ao Omie?

A referência técnica da Awake sobre Omie/Mintegra orienta verificar os seguintes pontos:

• Magento 2 ou superior, com domínio em HTTPS.
• Infraestrutura: servidor dedicado recomendado para lidar com o volume da integração.
• CPF/CNPJ: captura do documento em customer_taxvat.
• Dimensões: atributos width, length e height, com valores inteiros em centímetros, vinculados ao conjunto Default.
• Peso: atributo padrão weight em quilogramas.

Na preparação, verifique se o checkout grava o documento no campo esperado. Um campo personalizado com nome semelhante deve ser avaliado pela equipe técnica. Por exemplo, 500 gramas correspondem a 0,5 kg; confira a unidade usada no cadastro.

O servidor dedicado é uma recomendação de infraestrutura. Dimensione a operação considerando quantidade de produtos, pedidos, chamadas de API e recursos consumidos pela própria loja.

Como gerar o token do Magento 2 para o Omie.Hub?

O guia de token da Omie apresenta o cadastro pelo painel administrativo:

1. Acesse Sistema > Extensões > Integrações.
2. Adicione uma integração e dê a ela um nome identificável, como Omie.Hub.
3. Na aba API, selecione acesso Personalizado.
4. Habilite os recursos de Vendas, Catálogo e Clientes.
5. Salve e confirme a senha administrativa quando solicitada.

A documentação da Adobe esclarece a ativação: na lista de integrações, clique em Ativar e depois em Permitir. Copie o token de acesso apresentado e guarde as credenciais em local seguro. Se precisar reautorizar a integração, atualize o conector com as novas credenciais.

Por que um token pode falhar em versões recentes?

A Adobe informa que o uso isolado do token de integração como Bearer está desabilitado por padrão. Antes de alterar essa configuração, confirme com o suporte do hub o método de autenticação compatível com sua versão. Veja a documentação de autenticação por token.

Evite testar credenciais em ferramentas públicas. Ao solicitar diagnóstico, envie o horário, o endpoint e a mensagem de erro com os dados de autenticação ocultos.

Como integrar produtos com variações de cor ou tamanho?

A Omie documenta suporte a produtos simples e com variações pela API. Para variações, revise a integração existente no Magento, abra a aba API e habilite Sales, Products e Stores. Salve e confirme a senha. Confira as permissões no guia oficial de variações.

Os nomes dos recursos podem aparecer em inglês ou traduzidos. Revise a árvore de permissões efetivamente exibida no seu painel e mantenha os acessos exigidos pelo conector.

Na homologação, escolha um produto com combinações conhecidas, como camiseta azul nos tamanhos P e M. Compare a identificação, a opção selecionada e a quantidade em cada sistema. Esse teste evita aprovar o catálogo olhando apenas o nome do produto principal.

Como configurar a loja no Omie.Hub e conectar o Omie.ERP?

Siga a sequência descrita na configuração oficial da Omie:

1. No hub, entre em Lojas > Incluir.
2. Informe o nome interno, selecione Magento e preencha o token e a URL da loja. Salve.
3. Em Lojas > Gerenciar, edite a loja Magento.
4. Preencha App Key e App Secret do aplicativo Omie.ERP.
5. Defina a composição de preço e as regras de movimentação de estoque e notas. Salve.

Registre quem aprovou cada regra comercial. Também mantenha uma lista de pedidos de teste e dos resultados esperados, para que a liberação seja baseada em evidências.

Checklist: o que testar antes de liberar a integração?

Recomendamos começar com poucos itens e ampliar os testes conforme os resultados. A matriz abaixo deve ser adaptada ao escopo contratado e aos recursos confirmados pelo suporte.

• Acesso: integração ativa e chamadas autorizadas para os recursos necessários.
• Cadastros: item simples e produto com variações, com identificação consistente.
• Valores: produto, desconto, frete e total comparados com o pedido original.
• Comprador: cenários de pessoa física, pessoa jurídica e visitante, quando habilitados.
• Estoque: saldo antes e depois da venda, incluindo o limite de disponibilidade.
• Processo: pedido elegível, tratamento de exceções e conclusão das etapas acordadas.
• Reenvio: comportamento após uma falha e controle para evitar pedidos duplicados.
• Monitoramento: responsável, canal de alerta e procedimento de conferência.

Para cada cenário, registre o número do pedido, o horário e o resultado. Quando houver divergência, corrija a causa e repita aquele teste antes de ampliar o volume.

A sincronização é instantânea?

Não adote um prazo de atualização sem medi-lo. Peça ao fornecedor a frequência prevista e observe o intervalo entre uma mudança e sua chegada ao destino. Esse tempo deve orientar a operação e a comunicação com a equipe de atendimento.

Problemas na integração Magento 2 e Omie: por onde começar?

Use este roteiro de diagnóstico e encaminhe as evidências ao responsável pela etapa afetada. As verificações abaixo são recomendações técnicas; a causa precisa ser confirmada em cada instalação.

A conexão não autentica

Confira URL, status da integração, credenciais cadastradas e permissões do recurso solicitado. Se houve reautorização, verifique se o hub recebeu o token atual. Compare o método de autenticação com a orientação da Adobe e do fornecedor.

Um produto ou uma variação não aparece

Escolha um SKU e acompanhe seu percurso. Verifique os dados de origem, a associação da variação, a resposta da API e a etapa em que o item parou. Compare com outro produto que tenha sido processado corretamente.

Há divergência de preço ou quantidade

Compare o valor de origem, a regra aplicada e o horário da última atualização. Evite corrigir o mesmo dado simultaneamente nos dois sistemas: primeiro identifique qual deles deve ser a referência para aquele campo.

Os pedidos não chegam ao destino

Acompanhe um pedido específico desde a criação. Confira a etapa comercial em que ele se encontra, as respostas de processamento e os dados exigidos. Encaminhe ao suporte o identificador e os horários para facilitar a localização do evento.