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. Marca Criar pedido = Sim/Não conforme o status do pedido no canal — se aquele status do canal gera pedido no idworks ou 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 status atual no canal é um status que gera pedido no idworks: Sim ou Não. Ela olha só o status do canal; não confere vínculo de SKU nem de/para — esses problemas aparecem na hora de criar o pedido, na mensagem de retorno. A coluna pode vir vazia quando o status do canal não está cadastrado no idworks; nesse caso o + não fica amarelo, mas a criação é recusada com a mesma mensagem de status (exceto no Bling).

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

Quando a linha 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). Se o + estiver em amarelo, o status do canal indica que não gera pedido — veja Por que o botão "Criar Pedido" aparece em amarelo ou desabilitado?.
  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 ainda estão 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ó ficam de fora as linhas que já têm pedido. Antes de começar, o sistema separa apenas as linhas que já têm Pedido gerado; a janela mostra quantas foram ignoradas, o motivo e alguns dos números de pedido (ex.: "2 linha(s) foram ignoradas: já possuem pedido gerado (123, 456)"). Se todas as selecionadas já têm pedido, a janela nem abre — com uma linha só, o aviso diz "Pedido origem X já gerou o pedido Y — não é possível gerar outro.".
  • Linhas com Criar pedido = Não também são enviadas. Quem decide é o sistema, na hora de criar: se o status do canal não permitir, a linha volta com Atenção e o motivo aparece na coluna Resultado ("Status atual do pedido no canal de vendas não permite criar pedido. Status: ..."). Veja as exceções em Por que o botão "Criar Pedido" aparece em amarelo ou desabilitado?.
  • 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 o botão "Criar Pedido" aparece em amarelo ou desabilitado?​

O + de Criar Pedido não fica mais travado pelo status do canal. Quando a coluna Criar pedido está Não, o + continua clicável, mas aparece em amarelo; passando o mouse, a dica avisa "Criar Pedido — status "" indica que não gera pedido; o servidor valida na hora", com o nome do status (ex.: "Pago") no lugar do marcador.

Ao clicar, quem decide é o sistema:

  • Cria o pedido mesmo assim quando o status do canal é de reserva de estoque ou quando a integração é o Bling.
  • Recusa nos demais casos, com a mensagem "Status atual do pedido no canal de vendas não permite criar pedido. Status: ...", que mostra qual status está barrando.

Se a recusa vier por outro motivo (SKU não vinculado, falta de de/para de armazém, transportadora ou pagamento), a mensagem de retorno diz qual é — resolva pela expansão da linha ou pelas telas de DE-PARA e tente de novo.

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.
Criar DE-PARA (setas)A criação do pedido parou por falta de um de/para (armazém, transportadora, tipo de pagamento etc.). Cadastra o mapeamento sem sair da tela — veja Como o sistema decide o armazém, tipo de pedido e tipo de pagamento?.Não aparece para quem não tem privilégio de criação de nenhum DE-PARA. Não depende do vínculo do item.

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. Criar DE-PARA exige o privilégio de criação de cada tipo de DE-PARA.

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 reflete apenas o status atual do pedido no canal: Não quando aquele status não gera pedido no idworks — por exemplo, um pedido cancelado no canal. Ela não indica falta de vínculo de SKU nem de de/para; esses problemas aparecem como mensagem quando você tenta criar o pedido.

O que fazer com uma linha em Não:

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".

Criar o DE-PARA a partir do pedido

Quando a criação para por falta de um mapeamento (ex.: "Pedido não tem de/para de armazém"), dá para cadastrá-lo direto daqui, sem abrir a tela de DE-PARA:

  1. Clique na seta de expansão da linha e, no card do item, no botão Criar DE-PARA (ícone de setas).
  2. Na janela Criar DE-PARA, escolha o tipo: DE-PARA Armazéns, DE-PARA Transportadora, DE-PARA Marcas, DE-PARA Variações, DE-PARA Categorias, DE-PARA Adquirentes, DE-PARA Tipo Pagamento ou DE-PARA Pol. Comercial (o formulário abre com o título Criar DE-PARA ). Só aparecem os tipos que o seu perfil pode criar.
  3. Abre o mesmo formulário da tela DE-PARA daquele tipo, já com a Integração do pedido e a conta preenchidas. Os demais campos — inclusive o código do canal (o lado DE) — você informa como na tela de DE-PARA. Use Voltar para escolher outro tipo.
  4. Clique em Salvar. Aparece "DE-PARA criado.".

A janela só grava o mapeamento: o pedido não é criado nem reprocessado automaticamente. Depois de salvar, clique em Criar Pedido na linha para tentar de novo.

Pré-requisito: privilégio de criação do DE-PARA escolhido (o mesmo que libera o cadastro na tela daquele DE-PARA).

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. O vínculo Anúncio↔SKU é obrigatório sempre. Hub Estoque (armazém), Hub Pagamento e Hub Transportadora (transportadora) só travam a criação quando a parametrização Validar se pedido integrado possui de/para antes de criar está ligada. Sem o de/para de Hub Política Comercial, o pedido usa o tipo de pedido padrão. Se faltar um de/para, o botão Criar DE-PARA no item do pedido cadastra o mapeamento sem sair da tela.
  • 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 o vínculo de SKU (e, com a validação de de/para ligada, sem os de/para de armazém, transportadora e pagamento), a criação do pedido para com a mensagem do que falta.

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