---
title: "Obter dados de estoque de um produto"
method: GET
path: "/v1/estoque/produtos/{codigoProduto}"
tags: ["Estoque"]
---

# Obter dados de estoque de um produto

`GET /v1/estoque/produtos/{codigoProduto}`

- Este serviço verifica apenas o estoque registrado no ERP Sankhya, sem considerar o estoque do WMS.
- Ele leva em conta apenas o estoque próprio da empresa, ignorando produtos armazenados por terceiros ou produtos de terceiros armazenados na empresa.
- Além disso, a API só retorna informações sobre produtos que tiveram movimentação de estoque (entrada ou saída). Caso um produto tenha sido cadastrado, mas nunca tenha tido movimentação, ele não aparecerá na resposta da API, em vez de retornar um valor "estoque = zero".
- Versão mínima requirida do Sankhya Om para utilizar essa API: 4.34

## Path parameters

- `codigoProduto` integer, required

## Response `200`

Operação bem sucedida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.

- EstoqueResponseSingle
  - `codigo` integer
  - `tipo` string
  - `mensagem` string
  - `estoque` Estoque[]
    - `codigoProduto` integer, required — Este abributo indica o "código do produto" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "Produto" (CODPROD). Para saber mais, clique [aqui](https://developer.sankhya.com.br/reference/get_loadrecords).
    - `codigoEmpresa` integer, required — Este abributo indica o "código da empresa" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "Empresa" (CODEMP). Para saber mais, clique [aqui](https://developer.sankhya.com.br/reference/get_loadrecords).
    - `codigoLocal` integer, required — Este atributo indica o "código do local de estoque" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "LocalEstoque" (CODLOCAL). Para saber mais, clique [aqui](https://developer.sankhya.com.br/reference/get_loadrecords).
    - `controle` string — Indica o controle utilizado no respectivo produto. No SankhyaOm, o controle é essencial para a gestão de estoque e pode incluir características como voltagem, sabor, tamanho, cor, entre outros. Por exemplo, para um produto controlado por cor, o valor "verde" seria uma informação esperada.
    - `estoque` number, required — Este abributo retorna o estoque disponível para o produto (considerando os demais abributos: empresa, local e controle).

## Other responses

- `400` — Informações Inválidas. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `401` — Não autenticado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `403` — Autenticação inválida. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `404` — Dados não encontrados. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `500` — Erro interno no servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `501` — Não implementado. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `502` — Retorno inválido do servidor. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `503` — Serviço indisponível no momento. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.
- `504` — Tempo de execução excedido. Clique [aqui](https://developer.sankhya.com.br/reference/c%C3%B3digos-de-retorno-da-api) para mais detalhes.

---

[API](https://skmtc.dev/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.dev/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/revisions/0a3e81ca6195/schema)