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 endpoints, 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

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 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, Configurações → Tipo Pedido, e (opcional) Configurações → Status Pedido.
IdentificaçãoIntegração + Armazém canal (string/ID 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, dropshipping, full, hub regional) e cada combinação pode exigir tipo de pedido diferente (venda direta, transferência, dropshipping, 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 o 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.

O memória rápida tem TTL de 7 dias — alterações nesta tela atualizam o cache imediatamente.

Como criar um novo mapeamento DE-PARA?​

  1. Acesse Integrações → 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 Configurações → Tipo Pedido.
  • Status pedido (opcional) com Permite criação direta habilitado — em Configurações → Status Pedido.

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 do dropdown, 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 o 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 o 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, dropshipping).
  • 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.
  • Marketplaces de dropshipping — pedidos já roteados para o fornecedor podem entrar direto como Aguardando fornecedor.

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

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.
Configurações → Tipo PedidoCadastra os tipos de pedido (venda, transferência, dropshipping, etc.).
Configurações → Status PedidoDefine quais status do pedido permitem criação direta — apenas eles aparecem no campo Status final pedido.

O memória rápida interno é mantido 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.