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 (Modalidade vs. Prazo)?
- 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?
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 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 (Modalidade vs. Prazo)?
O Tipo de cotação define como o sistema decide a transportadora do pedido quando esse DE-PARA for aplicado:
| Tipo | Como funciona | Quando 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. |
| Modalidade | O 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. |
| Prazo | O 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.
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 ocultos para evitar configuração inconsistente.
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.
- 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 Cadastro → 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é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. |