---
title: "Obter preços vinculados a um produto e uma tabela de preço"
method: GET
path: "/v1/precos/tabela/{codigoTabela}"
tags: ["Preços"]
---

# Obter preços vinculados a um produto e uma tabela de preço

`GET /v1/precos/tabela/{codigoTabela}`

Este serviço retorna os preços de todos os produtos vinculados à tabela de preços enviada no contexto. Vale ressaltar que cada produto x tabela de preços pode possuir mais de um preço, pois o produto pode ter volume alternativo, variação de preço por local de armazenamento e também preço variado por controle (ex.: sabor, cor, tamanho, etc.). Este serviço retorna até 50 registros por página.

## Path parameters

- `codigoTabela` integer, required

## Query parameters

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

- RetornoPrecosProdutoTabela
  - `codigo` integer
  - `tipo` string
  - `mensagem` string
  - `page` integer
  - `numeroRegistros` integer
  - `temMaisRegistros` boolean
  - `precos` PrecosProdutoTabela[]
    - `codigoProduto` integer, required — Informe neste atributo 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)
    - `codigoLocalEstoque` integer — Código do Local de Estoque para o produto desejado. Quando este atributo é informado, o serviço retornará apenas os preços definidos para o local especificado. Caso não seja enviado, o serviço retornará todos os preços disponíveis para o produto, independentemente do local. Necessário quando existe controle de preços por local de estoque. Essa informação deve ser obtida previamente pela entidade "Estoque" (CODLOCAL). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords)
    - `controle` string — Insira neste campo o "controle" correspondente. Quando este atributo é informado, o serviço retornará apenas os preços definidos para o controle especificado. Caso não seja enviado, o serviço retornará todos os preços disponíveis para o produto, independentemente do controle. No SankhyaOm, o controle é essencial para a gestão de estoque/preços 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. Certifique-se de obter esses dados previamente através das entidades "Produto" ou "Estoque". Veja como funciona controle adicional de estoque em nossa ajuda [clicando aqui](https://ajuda.sankhya.com.br/hc/pt-br/articles/360045112113-Cadastro-de-Produtos#sub-abacontroleadicional). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords)
    - `unidade` string — Informe neste atributo a "unidade de medida" disponível no SankhyaOm. Quando este atributo é informado, o serviço retornará apenas os preços definidos para a unidade especificada. Caso não seja enviado, o serviço retornará todos os preços disponíveis para o produto, independentemente da unidade. Essa informação é facilmente acessível através da nossa API, na entidade "Produto" ou "UnidadeAlternativa" (CODVOL). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords)
    - `codigoTabela` number — Informe neste atributo o "código da tabela de preços" disponível no SankhyaOm. Esse código é facilmente acessível através da nossa API, na entidade "TabelaPreco" (CODTAB). Para saber mais, [clique aqui](https://developer.sankhya.com.br/reference/get_loadrecords)
    - `valor` number, required

## 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.net/sankhya/apis/api-sankhya.md) · [All operations](https://skmtc.net/sankhya/apis/api-sankhya/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sankhya/api-sankhya/revisions/0a3e81ca6195/schema)