Pular para o conteúdo principal

DE-PARA Transportadora

A tela DE-PARA Transportadora é a tabela de tradução entre as transportadoras que os canais de venda informam nos pedidos e as transportadoras cadastradas no idworks. Cada linha amarra um par "Integração + transportadora do canal" a uma "transportadora interna" e ainda guarda informações adicionais sobre como o pedido será tratado: armazém de saída, modo do frete, status final do pedido, modalidade da transportadora e regras de cotação.

Sem essa amarração, pedidos vindos dos marketplaces chegam ao idworks com a transportadora em branco — o que impede a emissão de etiqueta, o cálculo de prazo de entrega e o despacho automático no romaneio.

A tela tem três blocos no formulário: à esquerda os identificadores do canal (Integração e Transportadora canal), e à direita um conjunto rico de configurações sobre como a transportadora será aplicada (Transportadora, Modo frete, Status final pedido, Armazém, Tipo de cotação, Modalidade transportadora, Preferência na cotação e Critério de desempate).

Índice​

Conceito

Cadastro e edição

Regras de negócio

Boas práticas

Referência rápida

O que é a tela DE-PARA Transportadora?​

É a tela onde você cria a tabela de tradução entre transportadoras que vêm dos canais de venda e as transportadoras cadastradas no idworks. Vai além de um simples DE-PARA — para cada amarração, define também armazém de saída, modo do frete, status final do pedido e regras de cotação que serão aplicadas em pedidos chegando daquela combinação.

📍 Onde: menu lateral → Integrações (HUB) → DE-PARA Transportadora.

Por que preciso fazer esse DE-PARA?​

Quando um pedido chega de um canal (Mercado Livre, Shopee, VTEX, etc.), o canal informa o nome ou código da transportadora escolhida pelo cliente no formato dele — algo como correios_pac, flex, ME_2, jadlog_express. Esses identificadores não fazem sentido para o idworks sozinhos: o sistema precisa saber qual transportadora cadastrada no idworks corresponde para:

  • Emitir a etiqueta de envio com os dados corretos.
  • Calcular o prazo previsto de entrega.
  • Amarrar o pedido ao romaneio da transportadora correta.
  • Aplicar o contrato de frete (taxas, regras de cobrança) da operação.

Sem o DE-PARA, a transportadora chega em branco no pedido — o operador precisa atribuir manualmente uma por uma.

Qual a diferença entre Transportadora canal e Transportadora (idworks)?​

Transportadora canalTransportadora (idworks)
O que éO identificador da transportadora no canal de venda.A transportadora cadastrada no idworks (em Fornecedores com tipo Transportadora).
OrigemVem direto do XML/JSON do pedido.Cadastro próprio da operação.
FormatoTexto livre (depende do canal).Seletor — escolhe da lista cadastrada.
Aceita itens novos?Sim — campo permite digitar livremente (Adicionar).Não — só transportadoras cadastradas.

A função do DE-PARA é amarrar um ao outro: integração + transportadora do canal → transportadora interna + regras.

Como adicionar um novo DE-PARA?​

Clique em Adicionar no topo da tela. O modal abre dividido em dois blocos:

Lado esquerdo — identificadores do canal:

  1. Integração — selecione o canal de venda. A lista mostra apenas integrações ativas.
  2. Transportadora canal — selecione na lista (carregada do canal escolhido). Se a transportadora ainda não aparece na lista, clique em Adicionar no rodapé do seletor, digite o nome e ele é incluído.

Lado direito — configurações para a transportadora:

  1. Transportadora — selecione a transportadora cadastrada no idworks. Obrigatório quando o Tipo de cotação for Modalidade.
  2. Modo frete — escolha CIF (frete por conta do remetente — empresa), FOB (frete por conta do destinatário — cliente), Por conta de terceiros, etc. Esse valor é repassado para a NF.
  3. Status final pedido — quando preenchido, o pedido que chegar com essa combinação vai direto para esse status (em vez do status padrão da operação). Útil para criar exceções (ex.: pedidos do flex já chegam em Aguardando expedição).
  4. Armazém — armazém de onde os itens vão sair quando o pedido chegar dessa combinação.
  5. Tipo de cotação — Leilão de frete ou Modalidade (veja a próxima pergunta).
  6. Modalidade transportadora — quando Tipo de cotação = Modalidade, escolha qual.
  7. Preferência na cotação — usado pelo leilão de frete (quando aplicável).
  8. Critério de desempate — usado pelo leilão de frete quando há empate de valor entre transportadoras candidatas.

Clique em Salvar. O DE-PARA passa a valer para pedidos chegando a partir desse momento.

Pré-requisito: privilégio Criar hub transportadora.

Para que servem os campos extras (Modo frete, Status final, Armazém)?​

Esses campos definem como o pedido será tratado quando chega com essa combinação:

CampoO que define
Modo freteQuem paga o frete (CIF/FOB/etc.). Informação fiscal — vai para a NF e é usada em cálculos de imposto.
Status final pedidoSubstitui o status padrão para pedidos dessa combinação. Útil quando o canal entrega pedidos já "prontos para expedição" e a operação não precisa passar pelo fluxo normal.
ArmazémDe qual armazém os itens devem sair quando o pedido chega. Útil em operações multi-armazém onde cada combinação canal+transportadora atende um CD específico.

Quando deixados em branco, o sistema usa o padrão da empresa (configurado em outros pontos: Modo frete padrão, status inicial padrão, armazém padrão).

O que é Tipo de cotação (Modalidade vs. Prazo)?​

O Tipo de cotação define como o sistema decide a transportadora do pedido quando esse DE-PARA for aplicado:

TipoComo funcionaQuando usar
(em branco)Nenhuma disputa roda — o pedido usa direto a Transportadora e a Modalidade transportadora informadas neste DE-PARA.Operações com transportadora única ou contrato fixo, sem concorrência entre transportadoras.
ModalidadeO sistema disputa entre as transportadoras cadastradas na Modalidade transportadora informada e pode substituir a transportadora deste DE-PARA pela vencedora, conforme a Preferência na cotação.Operações com mais de uma transportadora concorrendo dentro da mesma modalidade.
PrazoO sistema disputa entre todas as transportadoras candidatas (sem restringir por modalidade), mas só quando o pedido já tem uma data estimada de entrega — escolhe entre as que conseguem cumprir esse prazo.Operações com concorrência entre transportadoras de modalidades diferentes, priorizando quem cumpre o prazo estimado.

Quando você escolhe Modalidade, o campo Transportadora fica desabilitado (o sistema decide entre as transportadoras da modalidade informada). Quando escolhe Prazo, o campo Modalidade transportadora fica desabilitado (o sistema decide entre todas as transportadoras candidatas, priorizando quem cumpre o prazo estimado). Deixando em branco, os dois campos continuam editáveis e a transportadora informada não entra em disputa.

Para que servem Preferência na cotação e Critério de desempate?​

Aplicam-se ao Leilão de frete:

  • Preferência na cotação — define como o sistema escolhe a transportadora vencedora entre as candidatas (menor valor, menor prazo, prazo+valor combinado, ranking customizado, etc.).
  • Critério de desempate — quando duas (ou mais) transportadoras empatam na Preferência principal, qual o critério secundário para resolver o empate.

Os valores possíveis dependem do cadastro de Tipos de Cotação da empresa. Para operações simples, deixar em branco usa o padrão. Para operações complexas com vários contratos, preencha cuidadosamente para o leilão de frete entregar o resultado esperado.

Como editar ou remover um DE-PARA?​

  • Editar — clique no ícone Editar (lápis) na linha. Modal abre com todos os campos preenchidos.
  • Remover — clique no ícone Remover (lixeira). Janela de confirmação com o nome (Integração - Transportadora canal) aparece — confirme.

Ao salvar, com Transportadora preenchida, o sistema só recusa a gravação com a mensagem "DE-PARA já existe para mesma integração com mesmo código(canal) e transportadora." quando existe outra regra com a mesma Integração, Transportadora canal e Transportadora. A regra que você está editando não conta como duplicata dela mesma, então dá para ajustar Modo frete, Status final pedido, Armazém e as demais configurações sem mexer na combinação.

Pré-requisitos: privilégios Editar hub transportadora e Deletar hub transportadora.

Como adicionar uma transportadora que ainda não está na lista?​

No campo Transportadora canal, abra o seletor e role até o final — há um campo de Digite... com botão Adicionar. Digite o nome exato que o canal usa, clique em Adicionar e ele entra na lista (selecionado automaticamente para você salvar).

Esse cadastro fica local ao DE-PARA — quando outros pedidos chegarem com o mesmo nome, o seletor já listará. Não é o mesmo que cadastrar uma transportadora nova no idworks (que é feito em Fornecedores).

Quando preciso preencher Status final pedido?​

Use o Status final pedido quando os pedidos da combinação canal+transportadora precisam pular etapas do fluxo padrão. Exemplos típicos:

  • Pedidos do Mercado Livre Flex — já chegam separados, embalados e prontos para coleta; o DE-PARA pode definir Status final = Aguardando expedição para pular Picking e Packing.
  • Pedidos de retirada na loja — podem chegar direto como Aguardando retirada sem passar pelo fluxo de envio.
  • Pedidos com fulfillment Mercado Envíos Full — podem chegar como Fulfillment para serem ignorados pelo CD da empresa.

Para fluxos normais (separação + packing + romaneio), deixe em branco — o sistema usa o status padrão.

Por que alguns campos ficam desabilitados conforme o Tipo de cotação?​

A tela aplica uma regra de exclusão mútua entre Transportadora e Modalidade transportadora:

  • Tipo de cotação = Modalidade (1) — o campo Transportadora fica desabilitado, porque o sistema escolherá automaticamente entre as transportadoras candidatas.
  • Tipo de cotação = Prazo (2) — o campo Modalidade transportadora fica desabilitado, porque o sistema disputa entre transportadoras de qualquer modalidade, filtrando por quem cumpre o prazo estimado.
  • Tipo de cotação em branco — nenhum campo fica desabilitado: a transportadora e a modalidade informadas neste DE-PARA valem como estão, sem disputa entre transportadoras.

Faz sentido: você está escolhendo um caminho de decisão — Modalidade e Prazo deixam o sistema decidir entre candidatas (cada um com seu próprio filtro), enquanto deixar em branco fixa a transportadora e a modalidade informadas. Os campos do outro caminho ficam desabilitados para evitar configuração inconsistente.

O que muda para o usuário restrito a centros de distribuição?​

Quando o usuário tem um ou mais CDs vinculados na aba Centro de Distribuição da ficha dele (veja Usuários), a tela DE-PARA Transportadora passa a respeitar esse vínculo pelo Armazém de cada regra:

  • Lista — aparecem as regras cujo Armazém é de um CD liberado para ele e as regras com Armazém em branco (que valem para todos os CDs). Regras com armazém de outro CD, ou com armazém que não pertence a nenhum CD, não aparecem.
  • Adicionar — ele precisa escolher no campo Armazém um armazém de um CD liberado. Se salvar com o Armazém em branco, ou com armazém de outro CD ou sem CD, o sistema recusa a gravação.
  • Editar — vale o mesmo: a regra precisa ser de um armazém de CD liberado, e o Armazém salvo também. Não dá para mover a regra para um armazém de outro CD nem deixar o Armazém em branco.
  • Remover — só as regras de armazém de CD liberado.
  • Regras com Armazém em branco — ele as vê na lista, mas não consegue editar nem remover. Como valem para todos os CDs, essas regras ficam com quem não tem restrição de CD.

Mensagens que o sistema mostra quando recusa:

AçãoSituaçãoMensagem
Adicionar ou salvar uma ediçãoArmazém em branco"Regra sem armazém vale para todos os centros de distribuição, escolha um armazém do seu centro de distribuição"
Adicionar ou salvar uma ediçãoArmazém de outro CD ou sem CD"Sem acesso ao centro de distribuição informado"
EditarRegra com Armazém em branco"Regra sem armazém vale para todos os centros de distribuição, só um usuário sem restrição pode alterá-la"
EditarRegra de armazém de outro CD ou sem CD"de/para transportadora não existe"
RemoverRegra com Armazém em branco"Regra sem armazém vale para todos os centros de distribuição, só um usuário sem restrição pode apagá-la"
RemoverRegra de armazém de outro CD ou sem CD"IDHubCarrier não existe"

O usuário sem CD vinculado continua vendo e alterando todas as regras, como antes. A restrição soma-se aos privilégios da tela: ter Editar hub transportadora não libera uma regra de outro CD.

Boas práticas para o DE-PARA de transportadora​

Um DE-PARA bem montado evita pedido com transportadora em branco, etiqueta que não imprime e prazo de entrega errado. Recomendações:

  • Cadastre o DE-PARA antes de começar a vender pelo canal. Sem a amarração, os pedidos chegam com a transportadora em branco e alguém precisa atribuir uma por uma — o que trava a emissão de etiqueta e o cálculo de prazo.
  • Use o mesmo nome exato que o canal informa em Transportadora canal. O sistema casa pelo texto que vem do pedido; um nome diferente do que o canal envia faz a amarração não pegar.
  • Defina o Armazém de saída em operações com mais de um CD. Assim cada combinação canal + transportadora já sai do depósito certo, sem o operador precisar redirecionar o pedido depois.
  • Deixe as regras com Armazém em branco a cargo de quem não tem restrição de CD. Elas valem para todos os CDs, e o usuário restrito a CDs não consegue criá-las, editá-las nem removê-las.
  • Use Status final pedido para os fluxos que pulam etapas (Flex, retirada, Full). Pedidos que já chegam prontos para coleta podem ir direto para "Aguardando expedição" e poupar o time de passar por separação e packing à toa.
  • Confira o Modo frete (CIF/FOB) — ele vai para a nota fiscal. É informação fiscal; preencher errado gera divergência na NF e no cálculo de imposto.
  • Deixe Tipo de cotação em branco quando a transportadora é fixa (contrato único); escolha Modalidade ou Prazo quando há concorrência entre transportadoras. Modalidade restringe a disputa a uma modalidade específica; Prazo abre a disputa para qualquer transportadora capaz de cumprir o prazo estimado do pedido.

Resumo de parametrizações​

A tela Hub Transportadora não tem parametrizações próprias. As configurações de cada transportadora (modalidade, gateway, cubagem, prazo, leilão de frete, e-mail de coleta etc.) ficam no cadastro da própria transportadora em Financeiro → Fornecedores, na aba Config. Transportadora — não em chave de empresa.

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.

PrivilégioLibera
Visualizar hub transportadoraAcesso à tela e à lista.
Criar hub transportadoraBotão Adicionar.
Editar hub transportadoraÍcone Editar (lápis) na linha.
Deletar hub transportadoraÍcone Remover (lixeira) na linha.
Última atualização em