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
- O que é a tela DE-PARA Transportadora?
- Por que preciso fazer esse DE-PARA?
- Qual a diferença entre Transportadora canal e Transportadora (idworks)?
Cadastro e edição
- Como adicionar um novo DE-PARA?
- Para que servem os campos extras (Modo frete, Status final, Armazém)?
- O que é Tipo de cotação (Leilão de frete vs. Modalidade)?
- Para que servem Preferência na cotação e Critério de desempate?
- Como editar ou remover um DE-PARA?
Regras de negócio
- Como adicionar uma transportadora que ainda não está na lista?
- Quando preciso preencher Status final pedido?
- Por que alguns campos ficam desabilitados conforme o Tipo de cotação?
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 canal | Transportadora (idworks) | |
|---|---|---|
| O que é | O identificador da transportadora no canal de venda. | A transportadora cadastrada no idworks (em Fornecedores com tipo Transportadora). |
| Origem | Vem direto do XML/JSON do pedido. | Cadastro próprio da operação. |
| Formato | Texto 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:
- Integração — selecione o canal de venda. A lista mostra apenas integrações ativas.
- 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:
- Transportadora — selecione a transportadora cadastrada no idworks. Obrigatório quando o Tipo de cotação for Modalidade.
- 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.
- 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).
- Armazém — armazém de onde os itens vão sair quando o pedido chegar dessa combinação.
- Tipo de cotação — Leilão de frete ou Modalidade (veja a próxima pergunta).
- Modalidade transportadora — quando Tipo de cotação = Modalidade, escolha qual.
- Preferência na cotação — usado pelo leilão de frete (quando aplicável).
- 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:
| Campo | O que define |
|---|---|
| Modo frete | Quem paga o frete (CIF/FOB/etc.). Informação fiscal — vai para a NF e é usada em cálculos de imposto. |
| Status final pedido | Substitui 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ém | De 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 (Leilão de frete vs. Modalidade)?
O Tipo de cotação define como o sistema decide o valor do frete quando esse DE-PARA for aplicado a um pedido:
| Tipo | Como funciona | Quando usar |
|---|---|---|
| Leilão de frete | O sistema roda a simulação de frete (em Logística → Simulação Frete) considerando todas as transportadoras com leilão ativo, e escolhe o melhor candidato com base na Preferência na cotação e no Critério de desempate. | Operações com várias transportadoras competindo por preço e prazo. |
| Modalidade | O sistema usa a transportadora informada no campo Transportadora e a modalidade específica do contrato (PAC, SEDEX, expresso, etc.) preenchida em Modalidade transportadora. | Operações com transportadora única ou contrato fixo. |
Quando você escolhe Leilão de frete, os campos Transportadora e Modalidade ficam desabilitados (o sistema decide). Quando escolhe Modalidade, os campos Preferência na cotação e Critério de desempate ficam menos relevantes (mas continuam editáveis).
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.
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:
- Tipo de cotação = Leilão de frete (1) — os campos Transportadora e o seletor relacionado ficam desabilitados, porque o sistema escolherá automaticamente.
- Tipo de cotação = Modalidade (2) — o campo Modalidade transportadora fica desabilitado, porque a transportadora informada já implica a modalidade do contrato dela.
Faz sentido: você está escolhendo um caminho de decisão — leilão decide tudo, ou modalidade fixa a transportadora. Os campos do outro caminho ficam ocultos para evitar configuração inconsistente.
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égio | Libera |
|---|---|
| Visualizar hub transportadora | Acesso à tela e à lista. |
| Criar hub transportadora | Botão Adicionar. |
| Editar hub transportadora | Ícone Editar (lápis) na linha. |
| Deletar hub transportadora | Ícone Remover (lixeira) na linha. |