Integrações de Transportadora — Troubleshooting

Troubleshooting de Integrações de Transportadora

Este guia ajuda a resolver as dúvidas e problemas mais comuns ao configurar e usar integrações de transportadora.

1. “O pedido falhou com erro de prazo não encontrado”

O envio falha quando a automação tenta fazer a solicitação de coleta com um prazo que não existe na tabela de frete vinculada à integração.

Causa mais comum: a tabela de frete foi editada (prazo removido ou renomeado) sem atualizar as automações.

O que fazer:

Verifique qual prazo a automação está tentando usar (ex.: D1).
Acesse Operação > Tabelas de frete e verifique se o prazo existe na tabela vinculada à integração.
Se o prazo não existe: edite a automação para usar um prazo disponível, ou mude a ação para mais barato / mais rápido.
Se o prazo existe mas a tabela é outra: edite a integração e vincule a tabela correta.

2. “O pedido falhou como ‘fora de cobertura’”

O envio falha quando o destino não está coberto pela tabela de frete e a cobertura restrita está ativada na integração.

O que fazer:

Ampliar a cobertura: edite a tabela de frete e adicione a faixa de CEP ou km que cobre o destino.
Desativar a restrição: edite a integração e desmarque a opção de cobertura restrita.

3. “A integração está ativa mas os pedidos não estão sendo enviados por ela”

Checklist rápido:

A integração está ativa? Verifique a coluna “Ativa” na tabela.
A filial está correta? Confirme que a integração pertence à filial do pedido.
O tipo de operação está correto? Integrações de Entrega só atendem pedidos de entrega; Reversa só atende reversas.
Existe automação configurada? Verifique se há uma automação de envio que referencia esta integração ou que usa ação mais barato/mais rápido.
A tabela de frete cobre o destino? Se a integração tem cobertura restrita ativada, o destino precisa estar mapeado na tabela.
O horário de corte foi ultrapassado? Se o pedido chegou depois do horário de corte, a solicitação de coleta pode estar agendada para o próximo dia útil.

4. “A data de entrega esperada está errada”

A data de entrega esperada depende de vários fatores configurados na integração:

Horário de corte — Se o pedido foi criado depois do horário de corte, a contagem começa no próximo dia útil. Veja Horário de corte.
Dias de operação — Dias em que a transportadora não opera são pulados.
Feriados — Feriados cadastrados são pulados.
Prazo da tabela de frete — Confira se o prazo (D1, D3, etc.) está correto na tabela.

O que verificar:

Confira o horário de corte na integração.
Verifique os dias de operação configurados.
Confirme o prazo na tabela de frete vinculada.

5. “Não consigo criar uma integração — erro de duplicidade”

Cada filial pode ter apenas uma integração por combinação de transportadora + modalidade + tipo de operação. Exemplo: não é possível ter duas integrações Uber / Carro / Entrega para a mesma filial.

O que fazer:

Verifique se já existe uma integração com a mesma combinação. Use os filtros de filial e transportador para encontrar.
Se a integração existente está desativada, ative-a em vez de criar uma nova.
Se precisa de configurações diferentes para a mesma combinação, edite a integração existente.

6. “Alterei a tabela de frete e as automações ficaram inválidas”

Ao trocar a tabela de frete de uma integração, os prazos disponíveis mudam. Automações que usam prazo específico com prazos da tabela anterior ficam inválidas.

O que fazer:

No modal de edição da integração, clique nas abas de automações (envio, reenvio, inatividade).
Localize automações com indicador vermelho.
Ajuste o prazo para um que existe na nova tabela, ou mude a ação para mais barato / mais rápido.
Salve.

7. “A automação mostra alerta de ‘integração desativada’”

Na tela de Automações de Envio, automações que referenciam uma integração desativada ou excluída mostram um badge de alerta.

O que fazer:

Se a integração foi desativada: reative-a na tela de integrações.
Se a integração foi excluída: edite a automação e selecione outra integração, ou desative a automação.

8. “Quero usar a mesma tabela de frete em várias filiais”

Uma tabela de frete pode ser compartilhada por várias integrações. Para isso:

Crie a tabela de frete uma única vez em Operação > Tabelas de frete.
Ao criar ou editar cada integração, selecione a mesma tabela de frete.
Ou use a opção de duplicar uma integração que já tem a tabela vinculada — a tabela é mantida na cópia.

9. “Não tenho acesso à tela de Integrações de Transportadora”

O acesso à tela depende das permissões configuradas na sua conta. Entre em contato com o administrador da conta ou com o suporte da Abbiamo para verificar se o módulo de integrações de transportadora está habilitado.