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

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 + (PlusOutlined) 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 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 (botão azul + no topo).
  2. No modal:
    • * 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").

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

Quando um item do pacote chega sem SKU local mapeado, há três caminhos:

  1. Pela expansão da linha: clique na seta de expansão → cards de cada item aparecem → botão Vincular ou Vincular Manualmente ao lado do item sem SKU.
  2. Vincular abre busca por nome/código de SKU local — o operador escolhe o SKU certo e o sistema grava o mapeamento em HubAdvertisement (vinculação anúncio↔SKU).
  3. Vincular Manualmente abre um modal especial (OfferLinker) para casos em que o anúncio precisa ser cadastrado primeiro no idworks (tela de Anúncios).

Após vincular, o operador clica em Criar Pedido e a integração consegue criar o pedido idworks com o SKU correto.

Pré-requisito: privilégio Criar Anúncio (oferta).

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 reload (ReloadOutlined) 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 (botão visível quando há linhas selecionadas).
  3. Aparece uma barra de progresso ("0/N", "Pedidos Criados: X", "Atenção: Y").
  4. O sistema processa uma linha por vez, mostrando o avanço.
  5. Linhas que já têm Pedido preenchido são puladas (contadas como sucesso direto, sem ação no canal).
  6. Ao final, clique em Fechar.

Útil quando uma integração teve falha por horas e várias linhas ficaram incompletas — o bulk reprocess 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 (SelectOutlined) 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 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, falha com "Armazém canal não mapeado".
  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 Carriers (outra tela DE-PARA).
  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".

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.

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

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.