Como atualizar estoques no painel Uappi e via API

Por que gerenciar corretamente seu estoque?

O controle de estoque é essencial para o bom funcionamento da operação de qualquer loja virtual. Na Uappi, você pode fazer essa gestão de diferentes formas: manualmente no painel administrativo ou por meio da nossa API pública.

Além disso, a plataforma oferece suporte a multiestoque, permitindo controle avançado com múltiplos armazéns.

Possibilidades de controle de estoque na Uappi

A Uappi oferece uma estrutura completa de estoque, contando com:

• Monoestoque: controle de estoque centralizado, sem divisão operacional entre armazéns.
• Multiestoque com armazém central: controle com múltiplos armazéns, com operação centralizada.
• Multiestoque com split de pedidos: controle distribuído entre armazéns, com regras de prioridade e possibilidade de divisão do pedido.
• Atualização via painel administrativo
• Atualização via API Uappi

O multiestoque permite que a loja trabalhe com múltiplos armazéns, controlando estoques de forma integrada. Na configuração da plataforma, é possível escolher entre os modelos de armazém central ou split de pedidos.

Para saber mais sobre a configuração de multiestoque, acesse o conteúdo específico sobre esse recurso.
Saiba tudo sobre multiestoque

---

Atualizando estoque manualmente no painel Uappi

Você pode atualizar o estoque de um produto diretamente no painel administrativo. Para isso:

1. Acesse Produtos no menu lateral.
2. Clique no produto que deseja atualizar.
3. Vá até a aba Estoque.
4. Edite os campos necessários (estoque total, estoque mínimo, permissão de venda sem estoque, entre outros).
5. Clique em Salvar.

Se a loja usa multiestoque

Com multiestoque ativo, a atualização por armazém é feita a partir da própria aba Estoque, pela opção de alterar estoques dos armazéns (não existe uma aba chamada “Armazéns” no produto).

Nesse fluxo, é possível definir o estoque de cada armazém vinculado ao produto.

Observação:* A aba Associados serve para vincular produtos associados e não é usada para controle de estoque por armazém.*

---

Como gerenciar armazéns

O gerenciamento dos armazéns é realizado em Configurações → Armazéns. Nesse módulo é possível cadastrar novos armazéns e administrar os já existentes conforme a necessidade da operação.

Você pode:

• visualizar os armazéns cadastrados;
• criar novos armazéns;
• editar informações como código, razão social, nome fantasia, CNPJ, endereço, status e fretes vinculados;
• ativar, desativar ou excluir armazéns, de acordo com as regras da operação.

Diferença importante

Embora ambos estejam relacionados ao gerenciamento de estoque, os módulos possuem finalidades diferentes:

• Configurações → Armazéns: utilizado para o cadastro e a administração dos armazéns da loja.
• Apps → Central de estoque e Armazéns: utilizado para configurar o recurso de multiestoque, como habilitação do cálculo de frete via API e demais regras relacionadas à operação. Esse módulo não é utilizado para cadastrar armazéns.

Acesse o conteúdo específico sobre armazéns na plataforma para mais detalhes.
Configurando seu armazém e as prioridades

---

Atualizando estoque via API

A Uappi possui rotas específicas na API pública para atualização de estoques em lote. Isso é ideal para integrações com sistemas de ERP ou ferramentas de automação.

Rota recomendada

PUT /v2/products/stock-batch

Essa rota cria um lote de processamento. Após o lote ser processado, os estoques podem levar até cerca de 1 minuto para aparecerem atualizados na plataforma. O status do lote pode ser consultado pelo recurso de consulta de lotes da API.

O que você pode fazer com essa rota

• Atualizar o estoque de vários produtos ao mesmo tempo
• Identificar o produto por sku ou por idProduto / idAtributoSimples
• Informar o armazém com idArmazem (opcional; se omitido, a plataforma usa o armazém principal)
• Definir a quantidade de estoque no campo estoque

Importante:* Esta rota atualiza a quantidade de estoque (estoque). Ela não envia estoque reservado nem estoque mínimo. Reservado/disponível são calculados pela plataforma; estoque mínimo é configurado no painel.*

Exemplo por SKU

{

  “estoques”: [

    {

      “sku”: “CAMISETA-VERMELHA-P”,

      “estoque”: 20,

      “idArmazem”: 1

    }

  ]

}

Exemplo por IDs (produto e variação)

{

  “estoques”: [

    {

      “idProduto”: 10,

      “idAtributoSimples”: 1,

      “estoque”: 159,

      “idArmazem”: 2

    }

  ]

}

Campos principais

Campo	Obrigatório	Descrição
estoques	Sim	Array com os itens a    atualizar
sku	Não*	SKU do produto ou da    variação
idProduto	Não*	ID do produto
idAtributoSimples	Não*	ID do atributo simples (variação)
idArmazem	Não	ID numérico do armazém
estoque	Sim	Quantidade de estoque a gravar

* Use sku ou os identificadores idProduto/idAtributoSimples. Não envie sku junto com esses IDs na mesma linha.

Resposta de sucesso

{

  “id”: 80

}

O id retornado é o identificador do lote criado.

Para detalhes completos, consulte a documentação oficial da API v2:
https://developers.uappi.com.br/docs/uappi/api/v2/

Outra rota relacionada

Também existe a rota PUT /v2/products/stock-movements-batch, usada para registrar movimentos de estoque (entradas/saídas por quantidade), em vez de definir o estoque absoluto.

---

Dicas úteis

• Prefira a atualização em lote (stock-batch) para integrações com ERP, por melhor performance e controle de processamento.
• Valide sempre o idArmazem correto quando a loja opera com multiestoque.
• Se idArmazem não for informado, a API utiliza o armazém principal.
• Configure o estoque mínimo no painel do produto para apoiar alertas de baixo estoque / regras de Avise-me.
• Após enviar o lote, aguarde o processamento (pode levar cerca de 1 minuto) antes de validar o resultado no painel.

---

Dúvidas frequentes 

Tenho apenas um armazém. Preciso informar idArmazem na API?

Não é obrigatório. Se o campo não for enviado, a plataforma utiliza o armazém principal.

Uso multiestoque. Preciso sempre informar idArmazem?

É altamente recomendado. Sem o idArmazem, a atualização cai no armazém principal, o que pode gravar o estoque no local errado.

Posso enviar warehouse_id ou stock na requisição?

Não. Os campos corretos são idArmazem e estoque, dentro do array estoques.

Consigo atualizar estoque reservado e estoque mínimo pela rota stock-batch?

Não. A rota define apenas a quantidade em estoque. Estoque reservado/disponível são calculados pela plataforma; estoque mínimo é gerenciado no painel.

Posso usar SKU e ID do produto na mesma linha do lote?

Não. Não envie sku junto com idProduto ou idAtributoSimples no mesmo item.

A atualização pela API é imediata?

Não necessariamente. A rota cria um lote assíncrono. Após o processamento, a atualização pode levar até cerca de 1 minuto para refletir na plataforma.

A plataforma atualiza o estoque automaticamente com o ERP?

Depende da integração. Se o ERP estiver integrado à Uappi e configurado para sincronizar estoque (via API ou módulo de integração correspondente), sim. Não ocorre de forma automática para qualquer ERP apenas por existir a rota.

Onde atualizo o estoque por armazém no painel?

Na edição do produto, aba Estoque, pela opção de alterar estoques dos armazéns.

A aba Associados serve para estoque?

Não. A aba Associados é para produtos associados, não para gestão de estoque/armazém.

Existe outra forma de atualizar estoque via API além do valor absoluto?

Sim. A rota PUT /v2/products/stock-movements-batch permite enviar movimentos (quantidade positiva para entrada e negativa para saída).

Atualizado em 19/08/2026