Pular para o conteúdo principal

Hub Estoque

A tela Hub Estoque — também conhecida como DE-PARA Armazéns — faz a ponte entre o armazém/depósito que o canal de venda externo informa em cada pedido e o armazém cadastrado no idworks que vai consumir o saldo daquele pedido. Cada linha é uma regra de tradução: quando um pedido chega da integração X com o armazém de canal Y, qual armazém interno usar para baixar o estoque, qual tipo de pedido aplicar, e (opcionalmente) qual status final colocar o pedido logo na criação.

O nome "DE-PARA" vem do conceito clássico de integração: DE = o lado externo (canal de venda) → PARA = o lado interno (ERP idworks). Diferente das demais telas DE-PARA do hub, esta tem três campos obrigatórios no lado PARA (não apenas um): Armazém + Tipo de pedido, mais o Status final como opcional. Essa complexidade extra reflete o fato de que diferentes canais/marketplaces representam pedidos com regras diferentes de armazém e fluxo de pedido. A tela é uma lista CRUD (4 privilégios) e tem proteção forte na exclusão do armazém interno: se um armazém é usado em algum mapeamento aqui, o sistema bloqueia sua exclusão no cadastro.

Esta tela não tem parametrizações próprias em Configurações → Parametrizações. Tem uma característica de performance: cada criação/edição/exclusão também grava o conjunto de mapeamentos em memória rápida (por integração, TTL 7 dias) para consulta rápida durante a importação de pedidos.

Índice​

Conceito

Cadastro e edição

Regras de negócio

Boas práticas

Referência rápida

O que é a tela Hub Estoque?​

É a tela onde você cadastra a tradução entre o armazém/depósito usado pelo canal de venda externo e o armazém interno do idworks que vai operar o pedido (baixar saldo de estoque, gerar movimentos). Cada linha responde à pergunta "quando um pedido chegar do canal X com o armazém Y, qual armazém interno consumir e qual tipo de pedido aplicar?".

📍 Onde: menu lateral → Integrações (HUB) → Hub Estoque.

O que significa "DE" e "PARA" no mapeamento?​

DE (canal externo)PARA (ERP idworks)
Origem do códigoO canal de venda (Mercado Livre, Magalu, etc.).Cadastrado em Logística → Armazéns, Financeiro → Tipo Pedido, e (opcional) Configurações → Status Pedido.
IdentificaçãoIntegração + Armazém canal (código ou identificador do armazém no canal).Estoque armazém (armazém interno), Tipo de pedido, Status final pedido (opcional).

A direção do mapeamento é sempre canal → ERP: quando um pedido chega do canal informando determinado armazém, o sistema procura nesta tela qual armazém interno + tipo de pedido + status aplicar.

Para que serve esse mapeamento na prática?​

Cada canal tem suas próprias convenções sobre armazéns/depósitos:

  • Mercado Livre Full opera com o "Full" como armazém implícito — o saldo é descontado do estoque do Meli, não do estoque local.
  • Magalu Entregas informa qual centro de distribuição vai entregar o pedido.
  • Shopee SLS divide os pedidos por hub regional.

Cada armazém de canal pode mapear para armazém interno diferente (estoque físico, full, hub regional) e cada combinação pode exigir tipo de pedido diferente (venda direta, transferência, marketplace full) — porque a contabilidade do estoque difere. Sem o DE-PARA, o sistema não saberia qual armazém usar e o pedido seria importado errado ou falharia.

Adicionalmente, o Status final pedido opcional permite que pedidos de determinada origem já entrem direto em um status diferente do padrão — útil para canais full onde o pedido já chega "vendido" sem precisar passar pelo fluxo normal de separação.

Onde o mapeamento é consumido pelo sistema?​

Principal consumo: importação de pedidos do canal. Quando um pedido chega da integração com o armazém "FULL", o sistema:

  1. Consulta a memória rápida da integração ou esta tela.
  2. Aplica o armazém interno, tipo de pedido e (se configurado) status final ao pedido.
  3. Gera os movimentos de estoque a partir do armazém correto.
  4. Se o status final está configurado e é um status que permite criação direta, pula etapas intermediárias do fluxo de pedido.

A memória rápida tem validade de 7 dias — alterações nesta tela atualizam essa memória imediatamente.

Como criar um novo mapeamento DE-PARA?​

  1. Acesse Integrações (HUB) → Hub Estoque.
  2. Clique em Novo.
  3. Preencha o lado DE (esquerda):
    • * Integração — selecione a integração.
    • * Armazém canal — código do armazém no canal (ex.: "FULL", "SP1", "01"). Escolha da lista ou digite manualmente.
  4. No lado PARA (direita):
    • * Estoque armazém — armazém interno (apenas ativos aparecem na lista).
    • * Tipo de pedido — qual tipo aplicar ao pedido importado.
    • Status final pedido — opcional. Define que o pedido já entra direto nesse status (apenas status com a opção "Permite criação direta" habilitada).
  5. Salve.

Pré-requisito: privilégio Criar hub estoque (CD).

Quais campos são obrigatórios?​

São obrigatórios:

  • Integração — qual canal de venda.
  • Armazém canal — diferente das outras telas DE-PARA do Hub, aqui o código DE é obrigatório (não pode ficar em branco).
  • Estoque armazém — qual armazém interno.
  • Tipo de pedido — qual tipo aplicar.

Opcional:

  • Status final pedido — quando preenchido, força o pedido importado a entrar direto nesse status.

Cadastros que você precisa ter antes​

  • Integração — em Configurações → Integrações.
  • Armazém ativo — em Logística → Armazéns (só armazéns ativos aparecem na lista).
  • Tipo de pedido — em Financeiro → Tipo Pedido.
  • Status pedido (opcional) com Permite criação direta habilitado — em Configurações → Status Pedido.

Quais armazéns canal já vêm sugeridos por canal?​

Para os canais que trabalham com modalidades de entrega fixas, a lista de Armazém canal já vem preenchida — basta escolher. Os demais canais mostram apenas a opção Padrão e você digita o código do armazém como o canal usa.

CanalOpções sugeridas
AmazonAmazon Padrão, Amazon Full, Onsite
MagaluMagalu Padrão, Magalu Ultra Rápido, Magalu Full
Mercado LivreNenhuma sugestão — digite o código do armazém como vem no pedido
ShopeeShopee, Shopee Entrega Direta, Shopee Fulfillment, Entrega Rápida, Entrega Direta, Entrega Turbo
SheinShein, Shein Fulfillment
Demais canaisPadrão

Entrega Turbo é a modalidade rápida da Shopee (inclui a variante Turbo SPF): os dois casos chegam no idworks como o mesmo armazém canal Entrega Turbo, então basta um mapeamento para cobrir as duas.

Shein passou a ter opções próprias — se você já tinha mapeamentos da Shein digitados manualmente, confira se o código bate com Shein ou Shein Fulfillment; caso contrário, com a parametrização Validar se pedido integrado possui de/para antes de criar ligada (Configurações → Parametrizações → Integração de Vendas), o pedido continua caindo em "Pedido não tem de/para de armazém"; desligada, o pedido entra no armazém padrão da empresa.

Como adicionar um armazém canal que não está na lista?​

  1. Com a janela aberta, clique em Armazém canal.
  2. No fim da lista, há Digite... + Adicionar.
  3. Digite o código exatamente como o canal usa e clique em Adicionar.
  4. Continue preenchendo e salve.

Como editar um mapeamento existente?​

  1. Na lista, ícone de lápis (ou duplo clique).
  2. Edite os campos.
  3. Salve.

A edição também atualiza a memória rápida automaticamente — não é necessário limpar manualmente.

Pré-requisito: privilégio Editar hub estoque (CD).

Como excluir um mapeamento?​

  1. Na lista, ícone de lixeira.
  2. Confirme.

A exclusão também atualiza a memória rápida.

Pré-requisito: privilégio Deletar hub estoque (CD).

Por que o lado PARA tem três campos obrigatórios?​

Diferente de Hub Marcas (só "Marca"), Hub Pagamento (só "Tipo pagamento") e Hub Categorias (só "Categoria"), esta tela mapeia uma combinação de regras porque o armazém de canal sozinho não é informação suficiente para criar o pedido corretamente:

  • Armazém interno decide de onde sai o estoque.
  • Tipo de pedido decide a regra fiscal, contabilidade e fluxo (venda, transferência).
  • Status final pedido (opcional) decide se o pedido pula etapas — útil para canais full onde o pedido já chega "entregue".

Sem os três bem definidos, a importação ficaria ambígua. Por isso o sistema exige preenchimento explícito de Armazém + Tipo de pedido, e oferece Status final como atalho operacional.

Para que serve o "Status final pedido" opcional?​

Útil para canais onde o pedido já chega processado pelo lado do canal:

  • Mercado Livre Full — quando o pedido vem do Full do Meli, o estoque já foi descontado e a entrega já está sendo cuidada pelo próprio Meli. O pedido pode entrar direto como Enviado ou Entregue, sem passar pelo fluxo normal de separação / packing.

Configurando o status final aqui, esses pedidos pulam etapas intermediárias e ficam no status correto desde a importação. Só status com Permite criação direta (configurável em Configurações → Status Pedido) aparecem na lista — para evitar configurações inválidas que quebrariam o fluxo do pedido.

Por que não consigo criar duas regras idênticas?​

O sistema bloqueia duplicatas na criação (POST): dois mapeamentos com a mesma combinação Integração + Armazém canal + Estoque armazém não são permitidos. A mensagem é "DE/PARA de armazém já existe".

Na edição (PUT), a duplicidade não é re-verificada — você pode (acidentalmente) deixar dois mapeamentos com a mesma combinação editando um deles. Boa prática: ao editar, garanta que a nova combinação não conflita com outra existente.

Por que não consigo excluir um armazém usado aqui?​

Diferente de outras telas DE-PARA, esta tem proteção forte do lado do armazém: quando você tenta excluir (desativar) um armazém em Logística → Armazéns que está sendo usado em algum mapeamento aqui, o sistema bloqueia com a mensagem "Armazém tem de/para de armazém e não pode ser excluído".

Para destravar:

  1. Vá em Integrações (HUB) → Hub Estoque.
  2. Filtre/identifique todos os mapeamentos que usam o armazém alvo.
  3. Exclua ou repinte os mapeamentos para outro armazém.
  4. Volte para Logística → Armazéns e exclua/desative.

Essa proteção evita que pedidos de uma integração fiquem com armazém órfão durante a importação.

O que acontece quando uma integração é excluída?​

Quando uma integração é excluída em Configurações → Integrações, todos os mapeamentos vinculados a ela são apagados automaticamente em cascata.

O que muda para o usuário restrito a centros de distribuição?​

Quando o usuário tem um ou mais CDs vinculados na aba Centro de Distribuição da ficha dele (veja Usuários), a tela Hub Estoque passa a respeitar esse vínculo pelo Estoque armazém de cada regra (o armazém interno, do lado PARA):

  • Lista — aparecem só as regras cujo Estoque armazém é de um CD liberado para ele. Regras com armazém de outro CD, ou com armazém que não pertence a nenhum CD, não aparecem.
  • Novo — o Estoque armazém precisa ser de um CD liberado. Se ele escolher armazém de outro CD ou sem CD, o sistema recusa a gravação.
  • Editar — a regra precisa ser de armazém de CD liberado, e o novo Estoque armazém também. Não dá para mover a regra para um armazém de outro CD.
  • Remover — só as regras de armazém de CD liberado.
  • Origem que já tem regra de outro CD ou de armazém sem CD — a regra de armazém de outro CD, ou de armazém que não pertence a nenhum CD, não aparece na lista dele, então a origem (Integração + Armazém canal) parece livre. Mesmo assim, ele não consegue criar uma segunda regra para essa origem, nem mover uma regra dele para ela (mudando a Integração ou o Armazém canal na edição). Duas regras na mesma origem poderiam fazer a importação de pedidos usar o armazém errado. Quem ajusta essa origem é um usuário sem restrição de CD.

Mensagens que o sistema mostra quando recusa:

AçãoSituaçãoMensagem
Adicionar ou salvar uma ediçãoEstoque armazém de outro CD ou sem CD"Sem acesso ao centro de distribuição informado"
Adicionar ou salvar uma edição que muda a origemA nova origem já tem regra com armazém de outro CD ou sem CD"Essa origem já tem de/para para um armazém de outro centro de distribuição, peça a um usuário sem restrição para ajustá-la"
EditarRegra com armazém de outro CD ou sem CD"De/para armazém não cadastrado"
RemoverRegra com armazém de outro CD ou sem CD"IDHubWarehouse não existe"

A restrição vale só para o que o usuário vê e altera na tela. A importação de pedidos continua usando todas as regras da conta, de qualquer CD.

O usuário sem CD vinculado continua vendo e alterando todas as regras, como antes. A restrição soma-se aos privilégios da tela: ter Editar hub estoque (CD) não libera uma regra de outro CD.

Boas práticas para o mapeamento de armazéns​

Um mapeamento de armazém bem feito é o que faz o pedido importado baixar o estoque do lugar certo e entrar no fluxo correto. Recomendações:

  • Cadastre armazém, tipo de pedido e (se usar) status antes de montar a regra. Os três campos do lado PARA são seletores: só armazéns ativos, tipos de pedido e status com criação direta aparecem na lista. Sem esses cadastros prontos, a regra fica incompleta.
  • Escolha o tipo de pedido conforme a origem do estoque. Venda direta e transferência têm contabilidade e fiscal diferentes — apontar o tipo errado faz o pedido entrar com a regra fiscal trocada. Combine o armazém interno com o tipo que corresponde àquela operação.
  • Use o Status final pedido para os canais full. Quando o pedido já chega vendido e enviado pelo próprio canal (Mercado Livre Full, por exemplo), defina um status de criação direta para o pedido pular separação e packing — evita o pedido travar num fluxo que ele não precisa percorrer.
  • Confira a combinação ao editar, porque a duplicidade não é re-verificada. O sistema só bloqueia regra repetida na criação; ao editar, dá para deixar duas regras idênticas sem aviso. Antes de salvar uma edição, garanta que a nova combinação não conflita com outra existente.
  • Antes de desativar um armazém, troque os mapeamentos que o usam. O sistema bloqueia a exclusão de armazém em uso aqui — identifique os mapeamentos que apontam para ele, repinte-os para outro armazém e só então desative em Logística → Armazéns.
  • Deixe com um usuário sem restrição as regras que atravessam CDs. Quem tem CD vinculado só vê, edita e remove regras de armazém do próprio CD, e não cria regra para uma origem que já tem regra de outro CD ou de armazém sem CD. Ajustes nessas origens ficam com um usuário sem CD vinculado.

Resumo de parametrizações​

Esta tela não tem parametrizações próprias em Configurações → Parametrizações. A configuração relevante vive em:

Onde configurarO que define
Configurações → IntegraçõesCadastra os canais de venda que aparecem no campo Integração.
Logística → ArmazénsCadastra os armazéns internos disponíveis. Apenas armazéns ativos aparecem na lista.
Financeiro → Tipo PedidoCadastra os tipos de pedido (venda, transferência, etc.).
Configurações → Status PedidoDefine quais status do pedido permitem criação direta — apenas eles aparecem no campo Status final pedido.

A memória rápida interna é mantida automaticamente — não precisa de configuração.

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 hub estoqueAcesso à tela, à lista e à visualização dos mapeamentos.
Criar hub estoque (CD)Botão Novo e o cadastro de um novo mapeamento.
Editar hub estoque (CD)Edição de um mapeamento existente.
Deletar hub estoque (CD)Exclusão de um mapeamento.
Última atualização em