Integração entre Magento e ERP parou: de quem é o problema e como descobrir

Os elos de uma integração entre Magento e ERP

Quase toda integração tem três elos, mesmo quando parece uma coisa só:

1. A loja Magento: gera o pedido, guarda estoque e preço e expõe a API REST. Depende do cron e das filas de mensagens para as tarefas agendadas e assíncronas.
2. O conector: uma extensão instalada na loja, um middleware ou hub externo, ou um serviço do próprio ERP. É quem chama a API de um lado e do outro, com agenda, fila e log.
3. O ERP: recebe o pedido, valida cadastro e dados fiscais e devolve estoque, preço, status e rastreio.

Cada elo costuma ter um dono diferente: a agência ou o suporte da loja, o fornecedor do conector e o fornecedor do ERP. Por isso a primeira pergunta não é quem errou, e sim até onde o dado chegou.

Pedido não chega no ERP ou estoque não atualiza: onde olhar

Pontos de verificação dentro do Magento

• Integração ativa: em Sistema > Extensões > Integrações (System > Extensions > Integrations no admin em inglês) aparece o status de cada integração. Atenção ao botão de reautorizar: ele apaga o token atual e gera outro, e o conector precisa receber as credenciais novas.
• Cron e filas: a Adobe documenta o cron como o mecanismo padrão que reinicia os consumidores das filas. Na configuração padrão, cron parado é fila parada. A lista de consumidores sai de bin/magento queue:consumers:list.
• Relatórios de erro: exceção registrada em var/report no horário da falha, com o número do registro.

O que o código HTTP da chamada diz sobre o responsável

Os significados são os das especificações HTTP (RFC 9110 e, para o 429, RFC 6585). A coluna do Magento é o que muda a conversa: 401 na loja quase nunca é problema do ERP.

Token de integração do Magento expirou?

Pela documentação da Adobe, token de integração não expira: dura até ser revogado. Token de administrador dura 4 horas por padrão e o de cliente, 1 hora. Quando alguém diz que o token expirou, normalmente é uma destas situações:

• o conector entra com usuário de administrador em vez de integração e não renova o token a cada 4 horas;
• o conector usa o token de integração sozinho, como Bearer. Desde a 2.4.4 isso vem desligado por padrão e só funciona com a opção Allow OAuth Access Tokens to be used as standalone Bearer tokens ativa, então quem atualizou de uma versão anterior costuma tropeçar aqui;
• a integração foi reautorizada e o conector continua com o token antigo, que foi apagado.

Ligar a opção de Bearer resolve rápido, mas a Adobe não recomenda: um token que nunca expira e vaza dá acesso persistente sem ninguém perceber. O caminho certo é o conector assinar as chamadas com as quatro credenciais OAuth da integração.

Quem é responsável pela integração e o que mandar no chamado

Modelo de chamado:

Assunto: pedido 000012345 não chegou no ERP
Quando: 09/10/2026 14:32 (horário de Brasília)
Sintoma: pedido pago na loja, ausente no ERP
Última chamada: GET /rest/V1/orders?searchCriteria... -> 401
Resposta: The consumer isn't authorized to access Magento_Sales::actions_view.
Já conferido: integração ativa no admin, cron rodando

Com esse bilhete, quem recebe começa a investigar sem perguntar nada. Cron, filas e relatórios de erro também entram na rotina de manutenção preventiva, que pega boa parte dessas quebras antes do pedido sumir. Para revisar ou refazer uma integração, veja o que cobre o suporte Magento 2.