Abbiamo DocsIntegrações de Transportadora — Troubleshooting
Soluções para problemas comuns com integrações de transportadora
Este guia ajuda a resolver as dúvidas e problemas mais comuns ao configurar e usar integrações de transportadora.
Leitura prévia
Se estiver começando agora, veja primeiro a Visão Geral e o guia Como Usar.
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.