Por padrão, a integração Wake → ANYMARKET envia sempre o mesmo contrato de frete em todos os pedidos exportados — o contrato de frete padrão definido pelo seller na configuração de envio. O mapeamento de contrato de frete por transportadora permite que o seller defina, para cada transportadora esperada pelo marketplace, qual contrato de frete deve ser enviado à Wake na exportação do pedido. Com isso, o contrato passa a variar conforme a transportadora identificada no pedido, em vez de ser um valor fixo único.
Neste artigo:
- Pré-requisitos
- Objetivo do mapeamento
- Como ativar o mapeamento
- Como configurar o de-para transportadora → contrato de frete
- Como o ANYMARKET identifica a transportadora do pedido
- Comportamento quando a transportadora não está mapeada
- Dúvidas comuns
Pré-requisitos
- Integração Wake → ANYMARKET configurada e ativa.
- Acesso à aba Configuração de envio do módulo Wake no ANYMARKET.
- Contratos de frete já cadastrados na Wake — o campo de seleção do contrato é populado a partir dos contratos de frete retornados pela própria Wake.
Objetivo do mapeamento
A Wake exige o envio de um contrato de frete obrigatório na exportação do pedido. No comportamento padrão, o ANYMARKET utiliza um único contrato de frete fixo, aplicado a todos os pedidos independentemente da transportadora informada pelo marketplace.
O ANYMARKET também envia a transportadora do pedido dentro das informações adicionais, mas nem todos os ERPs conectados à Wake capturam esse dado — parte deles ainda utiliza o nome do contrato de frete para identificar a transportadora. Quando o nome do contrato não corresponde ao nome de transportadora esperado pelo marketplace, a atualização pode ser rejeitada e o pedido permanecer no status Pago.
Exemplo prático: no fluxo com a Dafiti, o marketplace espera a transportadora "Correios", mas o contrato de frete se chama "PAC". Ao atualizar o pedido, o ERP retorna "PAC" à Dafiti, o marketplace não reconhece o valor e o pedido fica preso no status Pago.
Com o mapeamento ativo, o seller define que a transportadora "Correios" corresponde ao contrato "PAC", e o ANYMARKET passa a enviar o contrato correto conforme a transportadora identificada em cada pedido.
Como ativar o mapeamento
Na aba Configuração de envio existe um parâmetro (ativo/inativo) para o mapeamento de contrato de frete por transportadora, semelhante ao de-para de formas de pagamento.
- Inativo (padrão): mantém o comportamento atual. O campo de contrato de frete padrão permanece disponível e o mesmo contrato é enviado em todos os pedidos.
- Ativo: o campo de contrato de frete padrão é ocultado e a tela de mapeamento por transportadora passa a ser exibida.
⚠️ Atenção: ao ativar o mapeamento, não é possível configurar um contrato de frete padrão. A partir desse momento, os pedidos só são exportados com contrato de frete se houver um mapeamento correspondente à transportadora identificada. Ao desativar o mapeamento, o comportamento de contrato fixo é restaurado e os vínculos cadastrados são preservados.
Como configurar o de-para transportadora → contrato de frete
Com o mapeamento ativo, a tela exibe uma lista editável com dois campos por linha:
- Transportadora do marketplace: campo de texto livre, preenchido pelo seller com o nome da transportadora esperada pelo marketplace.
- Contrato de frete Wake: campo de seleção, populado com os contratos de frete cadastrados na Wake.
O seller pode adicionar quantas linhas quiser. Não há exigência de exclusividade: o mesmo contrato de frete pode ser vinculado a mais de uma transportadora — por exemplo, "Correios" e "Jadlog" apontando para um mesmo "Contrato Único".
⚠️ Atenção: a comparação entre a transportadora do pedido e a transportadora cadastrada ignora diferença de maiúsculas e minúsculas ("Correios" e "correios" são equivalentes), mas considera acentuação e grafia. Cadastre o nome da transportadora exatamente como ele é normalizado no pedido, para evitar que a correspondência não seja encontrada.
Como o ANYMARKET identifica a transportadora do pedido
Na exportação do pedido, com o mapeamento ativo, o ANYMARKET compara os dados de transportadora retornados pelo marketplace com as transportadoras cadastradas no mapeamento, seguindo esta ordem de prioridade:
| Prioridade | Campo(s) comparado(s) | O que identifica |
|---|---|---|
| 1 |
shippingCarrierNormalized + shippingCarrierTypeNormalized
|
Transportadora e tipo de serviço combinados |
| 2 | shippingCarrierTypeNormalized |
Tipo de serviço |
| 3 | shippingCarrierNormalized |
Transportadora |
| 4 | shippingType |
Modalidade de envio, usada quando não há de-para cadastrado para os campos acima |
Ao encontrar a primeira correspondência na ordem acima, o ANYMARKET envia à Wake o contrato de frete vinculado à transportadora identificada. Um vínculo mais específico (transportadora + tipo de serviço) tem prioridade sobre um vínculo mais genérico.
Comportamento quando a transportadora não está mapeada
Se nenhuma das opções acima encontrar um contrato de frete mapeado para a transportadora do pedido, o ANYMARKET bloqueia a exportação do pedido para a Wake e gera um alerta no painel de monitoramento, informando que a transportadora identificada não possui contrato de frete mapeado.
Esse bloqueio é intencional: ele evita enviar o pedido à Wake sem contrato de frete, situação em que a Wake retornaria um erro genérico que não indica a causa real. Com o alerta no painel, o seller identifica o motivo do bloqueio e corrige o mapeamento sem precisar abrir chamado de suporte.
Dúvidas comuns
Posso continuar usando um contrato de frete padrão com o mapeamento ativo?
Não. Ao ativar o mapeamento, o campo de contrato de frete padrão é ocultado. Enquanto o mapeamento estiver ativo, o contrato enviado é sempre o vinculado à transportadora identificada no pedido.
O mesmo contrato de frete pode ser usado para mais de uma transportadora?
Sim. O mapeamento não exige exclusividade — o mesmo contrato pode ser vinculado a quantas transportadoras forem necessárias.
O que acontece se eu ativar o mapeamento sem cadastrar nenhuma transportadora?
Todos os pedidos ficam sem correspondência e têm a exportação bloqueada, com o respectivo alerta no painel de monitoramento. Antes de ativar, cadastre pelo menos as transportadoras que você opera.
E se o pedido não trouxer a transportadora normalizada?
Quando os campos de transportadora normalizada não são informados, o ANYMARKET utiliza o valor de shippingType (modalidade de envio) para identificar a transportadora, conforme a ordem de prioridade. Basta ter o vínculo correspondente cadastrado no mapeamento.
Como sei por que um pedido não foi exportado?
Consulte o painel de monitoramento do pedido. Quando o bloqueio ocorre por ausência de mapeamento, o painel exibe um alerta — no mesmo padrão dos demais erros do fluxo de exportação — indicando que a transportadora identificada não possui contrato de frete mapeado.
Se eu desativar o mapeamento, perco os vínculos que cadastrei?
Não. Ao desativar, o comportamento de contrato de frete padrão fixo é restaurado, e os vínculos cadastrados permanecem salvos. Se o mapeamento for reativado, os vínculos voltam a ser exibidos e aplicados.
Comentários
0 comentário
Por favor, entre para comentar.