Pular para o conteúdo principal

Pedidos Integrados

A tela Pedidos Integrados — também chamada de Hub Pedidos — é a área de staging onde aparecem todos os pedidos brutos importados dos canais de venda (Mercado Livre, Magalu, Shopee, Tray Commerce, etc.) antes de virarem pedidos efetivos no idworks. Cada linha é um pacote/pedido vindo do canal com seus dados completos (cliente, itens, pagamentos, frete, UTM tracking) — junto com a indicação se está apto a virar pedido interno, qual o status no canal, qual o status do pedido idworks (quando já existir), e o status da NF.

A tela é o ponto de orquestração da integração: importação automática pelo canal → vinculação de SKUs faltantes → criação manual ou automática do pedido idworks → reprocessamento quando algo dá errado → exclusão de pedidos órfãos. Cada linha tem três identificadores importantes: Pedido origem (código do canal), ID pacote (identificador único do pacote no canal) e Pedido (número do pedido idworks após criação).

Esta tela não tem parametrizações próprias específicas em Configurações → Parametrizações — a tela consome regras configuradas em outras telas (Hub Estoque, Hub Pagamento, integração específica de cada canal) para decidir como cada pedido entra.

Índice​

Conceito

Criação de pedido

Vinculação de SKU

Reprocessamento

Busca e gestão

Regras de negócio

Boas práticas

Referência rápida

O que é a tela Pedidos Integrados?​

É a tela onde aparecem todos os pedidos importados dos canais de venda antes (ou no momento de) virarem pedidos efetivos no idworks. Funciona como uma "caixa de entrada" — cada linha é um pedido bruto do canal, com seus dados completos. A partir daqui o time cria o pedido idworks (manual ou automático), vincula SKUs faltantes, reprocessa quando há erro, e acompanha o ciclo completo desde a captura até a finalização.

📍 Onde: menu lateral → Integrações → Pedidos Integrados.

Como os pedidos chegam aqui?​

O sistema mantém integração ativa com cada canal de venda configurado em Configurações → Integrações. Para cada integração, periodicamente (varia por canal) um worker do idworks:

  1. Consulta a API do canal por novos pedidos.
  2. Para cada pedido encontrado, cria uma linha aqui com os dados do canal (cliente, itens, valores, frete, UTM, etc.).
  3. Avalia automaticamente se está apto a virar pedido idworks (todos os SKUs mapeados, dados completos) — marca Criar pedido = Sim/Não.
  4. Quando configurado para criação automática, dispara a criação do pedido idworks imediatamente.
  5. Quando não, deixa a linha esperando ação manual do operador.

A frequência de pull e a regra "criação automática × manual" são configuradas por canal em Configurações → Integrações.

Qual a diferença entre Pedido origem, ID pacote e Pedido?​

Cada linha pode ter três identificadores diferentes:

  • Pedido origem — código do pedido no canal de venda (ex.: MLB2000123456 no Mercado Livre, 123456789 no Magalu). É como o comprador vê o pedido dele no app do canal.
  • ID pacote — identificador único do pacote no canal (alguns canais agrupam vários pedidos em um pacote para envio). Pode ser igual ao Pedido origem ou diferente.
  • Pedido — número do pedido criado no idworks após a criação. Começa vazio e é preenchido depois que o pedido é efetivamente criado (manual ou automático).

A linha existe a partir do momento que o canal envia o pacote, então Pedido origem e ID pacote já vêm preenchidos. Pedido aparece depois.

O que significam as colunas de status (Status, Status ped., Status NF, Criar pedido)?​

Três colunas independentes de status + uma coluna indicativa:

  • Status — situação no canal (Pago, Enviado, Entregue, Cancelado pelo comprador, etc.). Atualiza conforme o canal informa.
  • Status ped. — status do pedido idworks após criação (Aberto, Em separação, Faturado, Cancelado, etc.). Vazio enquanto o pedido idworks ainda não foi criado.
  • Status NF — status da nota fiscal do pedido idworks. Vazio enquanto não há NF.
  • Criar pedido — indica se o sistema considera que a linha está apta a virar pedido idworks: Sim quando tudo bate (SKUs mapeados, cliente OK, payments resolvidos), Não seguido de explicação quando há algum bloqueio.

Como criar o pedido idworks a partir de uma linha?​

Quando a linha tem Criar pedido = Sim e ainda não tem Pedido preenchido:

  1. Clique no ícone + na coluna Ações da linha (ou abra o detalhe expandido para conferir os itens primeiro).
  2. O sistema dispara um worker que cria o pedido idworks com:
    • Cliente (criando o cadastro se não existir).
    • Endereço de entrega.
    • Itens (com SKUs locais vinculados, conforme Hub Estoque e mapeamentos).
    • Pagamentos (com tipo conforme Hub Pagamento).
    • Frete com transportadora mapeada.
    • UTM tracking (utm_source, utm_medium, utm_campaign).
  3. Após criar, a coluna Pedido mostra o número idworks gerado e a linha fica editável (abre a tela de Pedido em duplo clique).

Pré-requisito: privilégio Criar Pedido.

Como criar vários pedidos de uma vez?​

Quando várias linhas estão prontas (Criar pedido = Sim e sem Pedido), não é preciso clicar linha por linha:

  1. Marque as linhas (caixa de seleção à esquerda).
  2. Clique em Criar Pedidos no topo.
  3. Confira a lista de linhas na janela e clique de novo em Criar Pedidos para começar.
  4. Acompanhe a barra de progresso e a coluna Situação de cada linha — Pendente, Processando, Sucesso ou Atenção —, com o retorno do sistema na coluna Resultado. A janela mostra também Pedido, Integração, Pedido origem e Status (mais a coluna Conta, quando a empresa tem mais de uma).
  5. Ao terminar, clique em Fechar. A lista é atualizada sozinha com os pedidos criados.

Pontos importantes:

  • Só entram as linhas aptas. Antes de começar, o sistema descarta as linhas que já têm Pedido e as que estão com Criar pedido = Não; um aviso mostra quantas foram ignoradas ("N linha(s) foram ignoradas (já possuem pedido ou status não permite criação)"). Se nenhuma das selecionadas puder virar pedido, aparece "Nenhum dos pedidos selecionados pode gerar pedido no momento" e a janela nem abre.
  • Uma linha por vez. O processamento é sequencial, para não disparar várias criações simultâneas no mesmo canal.
  • Dá para interromper. Enquanto roda, o botão Parar encerra o lote — a linha em andamento termina e as seguintes ficam sem processar. Só é possível fechar a janela depois que o lote parar.
  • Linhas que voltarem com Atenção continuam na lista; leia o Resultado e trate o motivo (vínculo de SKU, de/para faltando) antes de tentar de novo.

Como criar um pedido manualmente quando o canal não enviou?​

Casos onde o webhook do canal falhou ou o pedido sumiu na integração:

  1. Clique em Novo Pedido Integração no topo.
  2. Na janela:
    • * Conta (quando há mais de uma).
    • * Integração — qual canal.
    • * Pedido origem — código do pedido no canal (texto livre).
    • ID remessa — somente para Mercado Livre OnSite (tipo de integração 1). Para outros canais, fica oculto.
  3. Clique em Salvar.

O sistema faz um pull explícito do canal usando o Pedido origem e cria a linha aqui, depois (se configurado) cria o pedido idworks automaticamente. Útil para "puxar" pedidos pontuais que ficaram para trás.

Pré-requisito: privilégio Criar Pedido.

Por que algumas linhas têm o botão "Criar Pedido" desabilitado?​

Quando a coluna Criar pedido está Não, o sistema bloqueia a criação porque detectou algum problema. As causas mais comuns:

  • SKU não vinculado — um ou mais itens do pacote não têm SKU local mapeado. Use a expansão da linha (clique na seta) para vincular antes (veja a próxima seção).
  • Cliente sem documento — alguns canais não enviam CPF/CNPJ; o sistema bloqueia se a empresa exige documento obrigatório.
  • Mapeamento de armazém ausente — o armazém canal não está mapeado em Hub Estoque.
  • Tipo de pagamento não mapeado — código de pagamento do canal não está em Hub Pagamento.
  • Pedido cancelado no canal antes da importação — o canal cancelou; o sistema vê e não cria.

A explicação do motivo geralmente aparece na descrição do "Não" (ex.: "Não — SKU não mapeado: cód. canal X"). Passando o mouse sobre o + desabilitado, aparece também o aviso "Pedido no status «status atual» não permite criação", indicando qual status do canal está barrando.

Enquanto uma ação da linha está em andamento (criar, reprocessar ou remover), os outros ícones daquela linha ficam desabilitados com o aviso "Aguarde a ação em execução". É proteção contra clique duplo e contra duas ações concorrentes no mesmo pedido — espere terminar e os ícones voltam.

Como vinculo um SKU local a um anúncio do canal?​

Clique na seta de expansão da linha: cada item do pacote vira um card, com os dados que o canal mandou e, à direita, os botões de vínculo. Qual usar depende do que falta:

BotãoQuando usarFica indisponível quando
Vincular SKU pedido (lápis)O item já traz o anúncio, só falta dizer qual SKU do seu cadastro ele é. Abre a busca por código, nome, código de barras, saldo e tipo do produto.O item já tem SKU vinculado.
Criar anúncio (+)O anúncio ainda não existe no idworks. Cria o anúncio e já amarra o SKU escolhido ao item do pedido.O item já tem SKU ou já tem anúncio.
Vincular anúncio existente (corrente)O anúncio já existe no idworks, mas não estava amarrado a esse item. Busque por Nome, Cód. anúncio ou Cód. variação dentro da mesma integração do pedido; quando o anúncio tem mais de uma variação, escolha também a Variação antes de confirmar em Vincular.O item já tem SKU vinculado.
Vincular Manualmente (botão azul)O item já tem anúncio, mas nenhuma variação dele foi amarrada a SKU. Abre a tela de vinculação do anúncio para amarrar variação a variação.Só aparece quando o item tem anúncio e ainda não tem SKU.

Depois de vincular, use Criar Pedido na linha — agora a criação encontra o SKU certo.

Pré-requisito: privilégio Criar Anúncio para Criar anúncio, Vincular anúncio existente e Vincular Manualmente. Vincular SKU pedido fica disponível para quem já enxerga a tela.

Por que aparece "Anúncio/variação não vinculado" no log ao criar o pedido?​

Mensagem "Anúncio/variação não vinculado: MLB-do-anúncio <-> ID-da-variação" vista em Configurações → Integrações → Log Integrações quando o sistema tenta criar o pedido idworks. Significa que o anúncio pai (o MLB... do Mercado Livre, por exemplo) está vinculado ao seu catálogo, mas a variação específica que o comprador escolheu (a cor, o tamanho, o sabor) não tem mapeamento para nenhum SKU local.

A pista está no formato da mensagem: o lado esquerdo da seta é o código do anúncio no canal; o lado direito é o código da variação no canal. Algumas mensagens chegam só com o lado direito (<->variation_id) — significa que nem o anúncio pai tem vínculo. As duas situações bloqueiam a criação do pedido, mas têm causas e correções diferentes.

Por que acontece:

  • Você publicou o anúncio com algumas variações; depois, no painel do canal (não pelo idworks), adicionou uma variação nova (uma cor, um tamanho) — essa nova variação não foi avisada ao idworks e nunca foi mapeada para um SKU local. O primeiro pedido daquela variação cai aqui.
  • O anúncio é de catálogo ou foi vinculado manualmente e a operação só amarrou o "produto" sem amarrar as variações, uma a uma.
  • A variação no canal foi substituída por outra (o canal trocou o variation_id por algum motivo) e o mapeamento antigo apontou para o nada.

Como resolver:

  1. Localize a linha em Hub → Pedidos Integrados e clique na seta de expansão. Os itens do pacote aparecem com o status do vínculo de cada um.
  2. Clique em Vincular no item sinalizado — abre a busca de SKU local. Escolha o SKU correto (a cor/tamanho que o comprador pediu).
  3. Se o lado esquerdo do erro estiver com o MLB preenchido mas a variação faltando, você também pode abrir o anúncio em Hub → Anúncios → editar → aba Variações e amarrar todas as variações de uma vez (mais rápido quando o anúncio tem várias variações órfãs).
  4. Se o lado esquerdo veio vazio (<->variation_id), o anúncio pai precisa ser vinculado primeiro — em Hub → Anúncios → Vincular Anúncio → informe o código do anúncio no canal e o produto local; depois volte aqui e vincule a variação.
  5. Volte para a linha em Hub → Pedidos Integrados e clique em Criar Pedido. Os próximos pedidos da mesma variação já não vão cair no erro.

Quando aparecem muitas variações órfãs do mesmo anúncio, é sinal de que alguém criou variações direto no canal. Vale combinar com a operação: ou tudo passa a ser editado pelo idworks (e o canal recebe via Sincronizar), ou faz parte da rotina abrir o anúncio depois de cada edição no painel e vincular as variações novas.

Por que aparece "Pedido já foi criado com IDOrder N" no log?​

Mensagem "Pedido já foi criado com IDOrder N" (onde N é o número do pedido no idworks). Não é erro — é a resposta defensiva do sistema quando algo dispara a criação de novo de um pedido que já existe no idworks. Acontece especialmente em três situações:

  • Você usou Reprocessar em uma linha que já tem Pedido preenchido (a coluna mostra o número do pedido idworks).
  • O canal reenviou a notificação do mesmo pedido (Mercado Livre faz isso quando o status muda) e o sistema processou de novo.
  • Dois usuários clicaram em Criar Pedido quase ao mesmo tempo, ou houve um clique duplo.

A mensagem aparece, mas nada foi duplicado — o número do pedido informado é o que já existia. É proteção contra criar dois pedidos idworks para o mesmo pedido do canal (o que geraria estoque, NF e financeiro em duplicidade).

Como resolver: nada a fazer. Se você quer atualizar os dados do pedido idworks com os dados frescos do canal, abra o pedido em Vendas → Pedidos e use o reprocessamento dentro da tela do pedido (ou ajuste manualmente o que precisa). O fluxo da tela Pedidos Integrados é "criar" — depois de criado, ela se torna apenas espelho.

Por que preciso vincular antes de criar o pedido?​

O pedido idworks precisa de SKU local para:

  • Baixar saldo do estoque correto.
  • Calcular custos do produto.
  • Aplicar plano de contas e tributação.
  • Gerar a NF-e com o produto certo.

Sem SKU, o sistema não tem como criar o pedido — falharia em tempo de execução. Por isso, a expansão da linha mostra explicitamente os itens sem vínculo e o operador precisa resolver antes de criar.

Como reprocessar uma linha isolada?​

Quando há suspeita que os dados da linha estão desatualizados ou faltam (canal mudou algo, integração truncou o pull, etc.):

  1. Na linha, clique no ícone de recarregar na coluna Ações.
  2. O sistema dispara o worker que faz pull novamente do canal usando o Pedido origem.
  3. A linha é atualizada com os dados frescos do canal.
  4. Se a linha já tinha Pedido preenchido (já criou o pedido idworks), o reprocess não recria — só atualiza os dados da linha.

Pré-requisito: privilégio Reprocessar Pedido.

Como reprocessar várias linhas em massa?​

  1. Marque as linhas (caixa de seleção à esquerda).
  2. Clique em Reprocessar no topo.
  3. Confira a lista na janela Reprocessar pedidos e clique de novo em Reprocessar para começar.
  4. Acompanhe a barra de progresso e a coluna Situação de cada linha — Pendente, Processando, Sucesso ou Atenção —, com o retorno do sistema na coluna Resultado. A janela mostra também Pedido, Integração, Pedido origem e Status (mais a coluna Conta, quando a empresa tem mais de uma).
  5. Linhas que já têm Pedido preenchido são puladas: entram como Sucesso com o resultado "Pedido já existente", sem consultar o canal.
  6. Se precisar interromper, clique em Parar — a linha em andamento termina e as seguintes ficam sem processar.
  7. Ao final, clique em Fechar. A lista é atualizada sozinha.

Útil quando uma integração teve falha por horas e várias linhas ficaram incompletas — o reprocessamento em massa força nova consulta para todas.

O que muda entre reprocessar e excluir + esperar nova importação?​

ReprocessarExcluir + esperar
TempoImediato.Depende do próximo pull (minutos a horas).
O que fazAtualiza dados da linha.Apaga a linha; canal cria de novo no próximo pull.
Pedido idworks existenteMantém (não toca no pedido).A nova linha não recria o pedido — vai criar uma segunda linha duplicada.
Quando usarLinha incompleta, dados truncados.Linha errada que precisa ser removida do staging (sem pedido idworks ainda).

Boa prática: prefira reprocessar. Excluir só quando a linha está claramente errada e ainda não virou pedido.

Como buscar e filtrar pedidos integrados?​

A tela tem busca rápida no topo + filtros avançados na gaveta.

Busca rápida (campo de busca grande no toolbar): aceita ID do pedido idworks, Pedido origem, ID pacote, nome do cliente, documento do cliente ou e-mail do cliente — o sistema procura nessas colunas simultaneamente.

Filtros avançados (gaveta de filtros): Conta, Integração, Status (canal), Status pedido, Status NF, intervalos de datas (criação, canal, estimada de entrega/expedição), cliente, transportadora, faixa de valor.

A tabela tem 30+ colunas disponíveis (muitas ocultas por padrão) — use o seletor de colunas no canto direito da tabela para mostrar/ocultar.

Como visualizar o pedido diretamente no canal?​

Cada linha tem o ícone Visualizar Pedido Canal na coluna Ações. Clicando, abre o pedido diretamente no painel do canal de venda (Mercado Livre, Magalu, etc.) em nova aba. Útil para conferir:

  • Como o comprador vê o pedido.
  • Status atual no canal (pode estar mais atualizado que o idworks).
  • Mensagens do comprador no histórico do pedido (perguntas, reclamações que não viraram tela própria ainda).

Pré-requisito: privilégio Visualizar pedidos HUB.

Como abrir um pedido já criado no idworks?​

Linhas com Pedido preenchido têm o ícone Editar (lápis) na coluna Ações. Clicando, abre a tela de Pedidos do idworks em nova aba, focada naquele pedido específico. Também é possível dar duplo clique na linha (mesmo efeito).

A tela de Pedidos do idworks tem outro conjunto de privilégios (Visualizar Pedido, Editar Pedido) — sem eles a navegação não funciona.

Como excluir uma ou várias linhas?​

A exclusão só é permitida em linhas que ainda não viraram pedido idworks (Pedido vazio). Para uma linha com pedido criado, a exclusão deve ser feita na tela de Pedidos (com seus próprios privilégios e regras).

  • Uma: ícone de lixeira na linha (disabled quando há Pedido) → confirme.
  • Várias em massa: marque as linhas, Mais Ações → Remover Selecionados → confirme.

A exclusão aqui apaga apenas a linha de staging — o canal continua tendo o pedido lá; se o pull rodar de novo, a linha vai voltar. Para evitar a reentrada, cancele o pedido no canal antes.

Pré-requisito: privilégio Deletar Pedido (privilégio compartilhado com a tela de Pedidos).

Como removo pedidos Full, de revenda ou antigos que não preciso faturar?​

É uma situação muito comum: a aba Pendentes de Integração acumula pedidos que você não vai faturar — pedidos Full (o próprio canal estoca e entrega), pedidos de revenda de produtos que são de outro fornecedor, ou pedidos antigos que já foram resolvidos antes de você usar o idworks. Você não precisa criar o pedido, vincular anúncio e depois gerar devolução só para limpar a lista.

Como limpar a lista

  1. Localize os pedidos (use a busca por Pedido origem ou os filtros por Integração e Status).
  2. Confira que a coluna Pedido está vazia — só linhas que ainda não viraram pedido idworks podem ser removidas aqui.
  3. Marque as linhas e use Mais Ações → Remover Selecionados (ou o ícone de remover na linha) e confirme. Veja o detalhe em Como excluir uma ou várias linhas?.

Não adianta tentar mudar o status para "Deletado" ou "Cancelado" — isso não tira o pedido da aba. O caminho certo é a ação de remover descrita acima.

Se aparecer "o status não permite criar pedido"

Isso costuma acontecer com pedidos que já foram cancelados no canal (ou estão em uma situação que o canal não permite virar pedido). Não há o que faturar: se você não precisa deles, basta removê-los da lista pelo passo acima.

Pedidos Full: resolva na origem para não voltarem

Se você não envia os pedidos Full (o canal cuida da estocagem e da entrega) e não quer mais vê-los aqui, desligue a importação deles na própria integração: Configurações → Integrações → (canal) → Configurar parâmetros → grupo Integração de Vendas → desligue "Incluir pedidos fulfillment". Com isso, os novos pedidos Full daquele canal deixam de entrar (disponível em Mercado Livre, Amazon, Magalu, Shopee e Temu). Os pedidos Full que já estão na lista você remove pelo passo acima.

Atenção: só dá para remover por aqui as linhas sem pedido idworks criado. Se o pedido já foi criado (a coluna Pedido tem número), o cancelamento é feito na tela de Pedidos — veja Por que não consigo excluir uma linha?.

Como exportar a lista?​

Disponível no menu Mais Ações → Exportar Dados — gera uma planilha Excel com todas as colunas visíveis da linha atual (respeitando filtros aplicados). Útil para reconciliação financeira mensal ou relatórios para a contabilidade.

Pré-requisito: privilégio Exportar pedidos HUB.

Por que algumas linhas ficam com "Criar pedido = Não"?​

A coluna Criar pedido indica se a linha está apta a virar pedido idworks. Os motivos mais comuns para "Não":

MotivoCausaComo resolver
SKU não mapeadoItem do pacote não tem SKU local.Vincular o SKU pela expansão da linha.
Armazém canal não mapeadoFalta DE-PARA em Hub Estoque.Cadastrar o mapeamento em Hub Estoque.
Tipo de pagamento não mapeadoFalta DE-PARA em Hub Pagamento.Cadastrar em Hub Pagamento.
Cliente sem documento obrigatórioCanal não enviou CPF/CNPJ.Editar dados do cliente manualmente.
Pedido cancelado no canalComprador cancelou antes do pull.Excluir a linha (não tem ação a fazer).
Falha no parse dos dadosResposta do canal truncada.Reprocessar a linha.

Após resolver, clique em Reprocessar ou direto em Criar Pedido se o status já mudou para Sim.

Por que não consigo excluir uma linha?​

A exclusão fica desabilitada (ícone de lixeira em cinza) quando a linha já tem Pedido preenchido (criou o pedido idworks). Motivo: a linha está ancorada ao pedido idworks, e apagar geraria inconsistência:

  • O pedido idworks ainda existe, com itens e estoque movimentado.
  • A integração perderia a referência entre a linha de staging e o pedido criado.
  • Reprocessamentos futuros não saberiam que o pedido já existe e poderiam duplicar.

Para apagar um pedido que já foi criado, use a tela Pedidos (que cancela o pedido idworks corretamente, revertendo estoque, contas, etc.). A linha aqui permanece, mas com Pedido vazio (cancelado).

Como o sistema decide o armazém, tipo de pedido e tipo de pagamento?​

Quando o pedido é criado a partir desta tela, o sistema consulta os DE-PARAs para resolver:

  1. Armazém + tipo de pedido + status final — consulta Hub Estoque com o código de armazém canal. Sem mapeamento, a criação para com "Pedido não tem de/para de armazém".
  2. Tipo de pagamento — consulta Hub Pagamento com o código de pagamento canal. Sem mapeamento, falha ou usa um tipo genérico (varia por canal).
  3. Transportadora — usa o código de transportadora informado pelo canal, mapeado em Hub Transportadora (outra tela DE-PARA). Veja abaixo a exceção da transportadora do cadastro do cliente.
  4. Política comercial — consulta Hub Política Comercial para descobrir qual política aplicar (afeta tributação).
  5. Marca e Categoria do SKU — já resolvidos quando o anúncio foi vinculado ao SKU local.

Garantir que esses 5 mapeamentos estão corretos é a chave para uma integração rodando "no piloto automático".

Quando a validação de de/para está desligada

A parametrização Validar se pedido integrado possui de/para antes de criar (Configurações → Parametrizações → Integração de Vendas) manda o sistema exigir os mapeamentos antes de criar o pedido. Com ela desligada e sem de/para de armazém, o sistema não trava: usa o armazém padrão da empresa (o mesmo armazém entra como origem e destino do pedido). Se a empresa também não tiver armazém padrão, a criação para com "Pedido não tem de/para de armazém e empresa não possui armazém padrão configurado." — nesse caso, defina o armazém padrão em Logística → Armazéns ou cadastre o de/para em Hub Estoque.

O sistema pode usar a transportadora do cadastro do cliente em vez da que veio do canal?​

Sim, e é uma parametrização por integração — disponível hoje em Vtex e Shopify.

Ligue Priorizar transportadora cadastro cliente em Configurações → Parametrizações → Integração de Vendas (ou pelo caminho Configurações → Integrações → (canal) → Configurar parâmetros → Integração de Vendas). Com ela ativa, na hora de criar o pedido o sistema:

  1. Procura o cliente do pedido pelo CPF/CNPJ no seu cadastro.
  2. Se o cliente já existe e tem transportadora preenchida na ficha dele, usa essa transportadora no pedido — ignorando a que o canal mandou.
  3. Se o cliente é novo (está sendo criado agora) ou não tem transportadora na ficha, o sistema volta ao caminho normal: a transportadora vem do de/para em Hub Transportadora.

Um efeito colateral importante: quando a transportadora do cliente é aplicada, o sistema não bloqueia mais o pedido com "Pedido não tem de/para de transportadora" — porque a transportadora já foi resolvida pelo cadastro. É o comportamento esperado para operações B2B/atacado, em que cada cliente tem transportadora fixa combinada em contrato e o canal manda sempre a mesma opção genérica.

Cuidado ao ligar: se o cadastro do cliente tem uma transportadora antiga ou errada, ela passa a valer para todos os pedidos novos daquele cliente. Revise as fichas antes de ativar.

O que acontece quando reprocesso uma linha que já virou pedido?​

O reprocesso não recria o pedido idworks. Apenas:

  • Atualiza os dados da linha de staging com os valores frescos do canal.
  • Pode atualizar Status canal, Status NF, Status pedido (cores e indicadores).
  • Não toca no pedido idworks (que continua com seus itens, status próprio, NF, etc.).

Se você reprocessa uma linha com Pedido preenchido e quer reforçar a sincronização do pedido (puxar novos eventos, atualizar status), a operação tradicional é feita na tela de Pedidos — não aqui.

Por que um pedido fica parado em "Aguardando importação de pedidos do pacote"?​

Alguns canais — o Mercado Livre principalmente — deixam o comprador juntar vários anúncios numa única compra/envio. Esses pedidos chegam agrupados sob o mesmo ID pacote. Para montar um único pedido idworks com todos os itens (com uma só NF e um só envio), o sistema espera todos os pedidos daquele pacote chegarem antes de criar o pedido. Enquanto falta algum, a linha fica com o status Aguardando importação de pedidos do pacote e ainda não recebe número na coluna Pedido.

Isso é comportamento normal, não é erro: o sistema está evitando criar um pedido pela metade (parte dos itens agora, o resto depois).

O que fazer:

  1. Em geral, espere. Assim que o último pedido do pacote for importado (costuma ser questão de minutos), o sistema consolida tudo e cria o pedido idworks sozinho — a coluna Pedido passa a mostrar o número.
  2. Para acompanhar, filtre ou busque pelo ID pacote e veja todas as linhas daquele pacote e quantas ainda faltam chegar.
  3. Se ficar parado muito tempo (o canal não enviou o restante, ou uma linha veio incompleta), reprocesse a linha: clique no ícone de reload para o sistema consultar o canal de novo. Veja Como reprocessar uma linha isolada?.
  4. Não adianta clicar em Criar Pedido com o pacote incompleto — o pedido só é criado quando o pacote fecha.

Por que pedidos da Shopee demoram a entrar com "pedido não possui prazo de expedição"?​

Na Shopee, o idworks só cria o pedido depois que o canal informa a data estimada de expedição (o prazo que você tem para postar). Em algumas modalidades de entrega — Shopee Xpress, Shopee Xpress CPF, SPX Entrega Rápida, Shopee Entrega Direta e Entrega Turbo — a Shopee às vezes demora para liberar essa data, e o pedido fica retido com a mensagem "pedido não possui prazo de expedição" no Log Integrações. Em geral a data chega em minutos e o pedido entra sozinho na tentativa seguinte.

Se a sua operação não pode esperar, ligue Permitir criar pedido sem data estimada expedição em Configurações → Parametrizações → Integração de Vendas (na integração da Shopee). Com a opção ativa, o pedido é criado mesmo sem a data — o campo de prazo de expedição fica em branco no pedido e você acompanha o prazo pelo painel da Shopee.

Só está disponível para a Shopee. Nos demais canais o prazo de expedição não bloqueia a criação do pedido dessa forma.

Boas práticas para os pedidos integrados​

Uma integração bem cuidada mantém os pedidos virando pedido idworks "no piloto automático" e evita estoque errado, NF duplicada e linha presa no staging. Recomendações:

  • Deixe os cinco mapeamentos prontos antes de esperar pedido entrar. Anúncio↔SKU, Hub Estoque (armazém), Hub Pagamento, Hub Política Comercial e Hub Transportadora (transportadora) são o que mantém a linha em Criar pedido = Sim — falta de qualquer um trava a criação.
  • Vincule o SKU faltante antes de clicar em Criar Pedido. Sem SKU local o pedido falharia ao baixar estoque e gerar a NF; resolva o vínculo pela expansão da linha e só então crie.
  • Prefira Reprocessar a excluir e esperar. Reprocessar atualiza a linha na hora; excluir uma linha que já virou pedido cria uma segunda linha duplicada no próximo pull.
  • Não recrie pedido que já existe. O aviso "Pedido já foi criado com IDOrder N" é proteção — para atualizar o pedido, vá em Vendas → Pedidos, não force a criação aqui.
  • Tenha paciência com pacotes do Mercado Livre. Quando a linha está Aguardando importação de pedidos do pacote, espere o pacote fechar — criar pela metade geraria pedido incompleto.
  • Desligue na origem os pedidos que você não fatura. Pedidos Full podem ser desativados em Configurações → Integrações → (canal) → Configurar parâmetros → Integração de Vendas → "Incluir pedidos fulfillment", para não voltarem a entrar a cada pull.
  • Limpe o staging só pelas linhas sem pedido. Pedidos antigos, de revenda ou cancelados no canal saem por Mais Ações → Remover Selecionados — mudar status para "Cancelado" não tira a linha da lista.

Resumo de parametrizações​

Esta tela não tem parametrizações próprias específicas. O comportamento é determinado pelas seguintes telas relacionadas:

Onde configurarO que define
Configurações → IntegraçõesQuais canais fazem pull de pedidos, frequência, modo de criação (manual × automático).
Integrações → Hub EstoqueMapeamento de armazém canal → armazém interno + tipo de pedido + status final.
Integrações → Hub PagamentoMapeamento de tipo de pagamento canal → tipo de pagamento interno.
Integrações → Hub Política ComercialMapeamento de política comercial canal → política interna.
Integrações → Hub TransportadoraMapeamento de transportadora canal → transportadora interna.
Integrações → AnúnciosVinculação anúncio canal → SKU local.

Sem esses mapeamentos básicos, a maioria dos pedidos fica em "Criar pedido = Não" e exige intervenção manual.

Parametrizações da integração que mudam a criação do pedido

Ficam em Configurações → Parametrizações → Integração de Vendas (ou em Configurações → Integrações → (canal) → Configurar parâmetros → Integração de Vendas) e valem por canal:

ParametrizaçãoSubmenuO que muda quando ativada
Validar se pedido integrado possui de/para antes de criarIntegração de VendasExige de/para de armazém, transportadora, tipo de pedido e tipo de pagamento antes de criar. Desligada, o sistema usa o armazém padrão da empresa quando falta o de/para de armazém. Vale para todos os canais.
Validar se pedido integrado possui armazém no de/para de transportadoraIntegração de VendasExige que o de/para de transportadora tenha armazém definido. Vale para todos os canais.
Priorizar transportadora cadastro clienteIntegração de VendasUsa a transportadora da ficha do cliente (quando ele já tem cadastro) no lugar da que veio do canal. Disponível em Vtex e Shopify.
Permitir criar pedido sem data estimada expediçãoIntegração de VendasCria o pedido mesmo quando o canal ainda não liberou a data estimada de expedição. Disponível na Shopee.
Incluir pedidos fulfillmentIntegração de VendasImporta (ou deixa de importar) os pedidos Full do canal. Disponível em Mercado Livre, Amazon, Magalu, Shopee e Temu.
Habilitar geração automática de transferência entre CDsIntegração de VendasGera transferência automática entre CDs quando nenhum CD sozinho atende o pedido inteiro. Exige preencher também Armazéns para somar quantidade. Disponível na Vtex.

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 pedidos HUBAcesso à tela e à lista.
Exportar pedidos HUBBotão Exportar Dados no menu Mais Ações.
Reprocessar PedidoBotão Reprocessar (individual e em massa).
Visualizar mensagem pedidos HUBAcesso à aba de mensagens internas do pedido (quando aplicável).
Enviar mensagem pedidos HUBEnvio de mensagens ao canal a partir do detalhe do pedido.
Última atualização em