Mapeamento de serviços de transportadora: transportadora/serviço do canal ↔ códigos internos

Traduza automaticamente o texto de transportadora/serviço do canal (ex. UPS / Ground) para seu carrier_code / service_code padrão ao receber pedidos. Inclui referência de campos e passos.

Cada canal nomeia transportadoras e serviços do seu jeito: um diz "UPS / Ground", outro "United Parcel Service / Standard". Este mapeamento traduz esse texto para seus códigos padrão internos (carrier_code / service_code) para que TMS, OMS e WMS falem a mesma língua.

Onde a tradução acontece#

Logo após channel.pull_orders receber os pedidos e antes de o fluxo gravá-los no OMS: o carrier / service de cada pedido é buscado nesta tabela e, se houver correspondência, o pedido recebe carrier_code / service_code. O texto original nunca é sobrescrito.

Referência de campos#

• Channel Carrier (obrigatório): texto da transportadora como o canal o reporta, ex. "UPS". A correspondência ignora maiúsculas e espaços.
• Channel Service (obrigatório): texto do serviço como o canal o reporta, ex. "Ground".
• Internal Carrier (obrigatório): seu carrier_code padrão, ex. "ups". A cotação TMS e a impressão de etiquetas leem isto.
• Internal Service (obrigatório): seu service_code padrão, ex. "ground".
• Channel Code: a qual plataforma de canal esta linha se aplica (ex. shopify). Vazio = mapeamento global para todos os canais.
• Connection: opcionalmente ate a linha a uma conexão específica. Uma linha específica vence a genérica do canal.
• Active: interruptor. Desligue para aposentar um mapeamento sem excluí-lo.

Prioridade de correspondência#

1. Linha específica da conexão (channel_id coincide com a conexão do pedido).
2. Linha genérica por código de canal (mesma plataforma, qualquer conexão).
3. Linha global (sem código de canal nem conexão).

Configurar um mapeamento#

1. Abra Master Data → Carrier Service Mappings.
2. Clique em Novo. Digite Channel Carrier e Channel Service exatamente como o canal os reporta (copie de um pedido recebido se duvidar).
3. Preencha Internal Carrier e Internal Service com seus códigos padrão (minúsculas, ex. ups / ground).
4. Ponha Channel Code (ex. shopify) para um mapeamento do canal todo, ou escolha uma Connection para uma loja. Ambos vazios = global.
5. Salve e receba um pedido de teste: o pedido deve chegar com carrier_code / service_code.

Perguntas frequentes#

• O pedido chegou sem carrier_code: ainda não há linha de mapeamento. Veja o aviso "carrier-mapping" nos logs e adicione a linha.
• Um mapeamento ausente nunca bloqueia o pedido: o texto original é mantido e o pedido é gravado no OMS normalmente.
• "UPS" vs "ups": a correspondência não diferencia maiúsculas; uma linha basta.
• Para desativar temporariamente um mapeamento: desligue o interruptor Active em vez de excluir; o histórico fica.