> For the complete documentation index, see [llms.txt](https://changelog.maino.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://changelog.maino.com.br/api-reference-maino/20.-tabelas-de-venda.md).

# 20. 🏷️ Tabelas De Venda

**Consulta de tabelas de venda** Listagem das tabelas de venda cadastradas para o usuário autenticado — usadas para aplicar preços e condições comerciais diferenciadas a clientes e produtos. A tabela de venda vinculada a um stakeholder também aparece na consulta de stakeholder (seção "Clientes, Fornecedores e Transportadoras"). **Funcionalidades:**

* Listagem paginada das tabelas de venda cadastradas

## Lista tabelas de venda

> \*\*Lista tabelas de venda\*\*\
> \
> Retorna as tabelas de venda cadastradas para o usuário autenticado, ordenadas\
> por código, com paginação de 20 registros por página. Os itens de preço fixo\
> de cada tabela ficam em \`GET /negocios/tabela\_de\_vendas/{tabela\_de\_venda\_id}/itens\`.\
> \
> \*\*Parâmetros disponíveis:\*\*\
> \- \`page\`: número da página (padrão: 1; 20 registros por página fixo)

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"20. 🏷️ Tabelas de Venda","description":"**Consulta de tabelas de venda**\nListagem das tabelas de venda cadastradas para o usuário autenticado — usadas para\naplicar preços e condições comerciais diferenciadas a clientes e produtos. A tabela\nde venda vinculada a um stakeholder também aparece na consulta de stakeholder\n(seção \"Clientes, Fornecedores e Transportadoras\").\n**Funcionalidades:**\n- Listagem paginada das tabelas de venda cadastradas"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/negocios/tabela_de_vendas":{"get":{"summary":"Lista tabelas de venda","tags":["20. 🏷️ Tabelas de Venda"],"description":"**Lista tabelas de venda**\n\nRetorna as tabelas de venda cadastradas para o usuário autenticado, ordenadas\npor código, com paginação de 20 registros por página. Os itens de preço fixo\nde cada tabela ficam em `GET /negocios/tabela_de_vendas/{tabela_de_venda_id}/itens`.\n\n**Parâmetros disponíveis:**\n- `page`: número da página (padrão: 1; 20 registros por página fixo)","parameters":[{"name":"page","in":"query","description":"Número da página (padrão: 1; 20 registros por página)","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Lista de tabelas de venda","content":{"application/json":{"schema":{"type":"object","properties":{"tabela_de_vendas":{"type":"array","description":"Lista das tabelas de venda","items":{"type":"object","properties":{"id":{"type":"integer","description":"ID da tabela de venda"},"codigo":{"type":"string","description":"Código da tabela de venda"},"descricao":{"type":"string","nullable":true,"description":"Descrição da tabela de venda"},"fator":{"type":"number","nullable":true,"description":"Fator multiplicador calculado a partir da porcentagem e do tipo de fator"},"porcentagem":{"type":"number","nullable":true,"description":"Porcentagem de acréscimo ou desconto"},"tipo_de_fator":{"type":"string","nullable":true,"enum":["acrescimo","desconto",null],"description":"Se a porcentagem representa acréscimo ou desconto"},"tipo_de_fator_descricao":{"type":"string","nullable":true,"description":"Descrição legível do tipo de fator"},"tipo_de_calculo":{"type":"string","nullable":true,"enum":["fator_sobre_custo_medio","fator_sobre_custo_de_saida",null],"description":"Preço de referência no estoque usado como base do cálculo"},"tipo_de_calculo_descricao":{"type":"string","nullable":true,"description":"Descrição legível do tipo de cálculo"},"tipo_de_tabela":{"type":"string","enum":["normal","fixa"],"description":"Se a tabela é normal (percentual) ou fixa (preço por produto)"},"tipo_de_tabela_descricao":{"type":"string","description":"Descrição legível do tipo de tabela"},"exibe_no_catalogo_em_pdf":{"type":"boolean","description":"Se a tabela é exibida no catálogo em PDF"},"tabela_parente":{"type":"object","nullable":true,"description":"Tabela base sobre a qual o acréscimo/desconto é aplicado, quando houver","properties":{"id":{"type":"integer","description":"ID da tabela base"},"codigo":{"type":"string","description":"Código da tabela base"}}}}}},"pagination":{"type":"object","properties":{"total":{"type":"integer","description":"Total de registros"},"current_page":{"type":"integer","description":"Página atual"},"per_page":{"type":"integer","description":"Registros por página"},"previous_page":{"type":"string","nullable":true,"description":"URL da página anterior"},"next_page":{"type":"string","nullable":true,"description":"URL da próxima página"}}}}}}}},"401":{"description":"Chave de API inválida ou ausente","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```

## Lista itens de uma tabela de venda

> \*\*Lista itens de uma tabela de venda\*\*\
> \
> Retorna os itens de preço fixo por produto de uma tabela de venda do usuário\
> autenticado, ordenados por ID, com paginação de 50 registros por página.\
> \
> \*\*Parâmetros disponíveis:\*\*\
> \- \`page\`: número da página (padrão: 1; 50 registros por página fixo)

```json
{"openapi":"3.0.1","info":{"title":"Mainô API","version":"v2.0"},"tags":[{"name":"20. 🏷️ Tabelas de Venda","description":"**Consulta de tabelas de venda**\nListagem das tabelas de venda cadastradas para o usuário autenticado — usadas para\naplicar preços e condições comerciais diferenciadas a clientes e produtos. A tabela\nde venda vinculada a um stakeholder também aparece na consulta de stakeholder\n(seção \"Clientes, Fornecedores e Transportadoras\").\n**Funcionalidades:**\n- Listagem paginada das tabelas de venda cadastradas"}],"servers":[{"url":"https://api.maino.com.br/api/v2","description":"Servidor de Produção"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"**Token JWT de Autenticação**\nToken obtido através do endpoint `/authentication`.\n**Formato:** `Bearer {seu_token_jwt}`\n**Exemplo:** `Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...`\n**Validade:** Sem expiração"}}},"paths":{"/negocios/tabela_de_vendas/{tabela_de_venda_id}/itens":{"get":{"summary":"Lista itens de uma tabela de venda","tags":["20. 🏷️ Tabelas de Venda"],"description":"**Lista itens de uma tabela de venda**\n\nRetorna os itens de preço fixo por produto de uma tabela de venda do usuário\nautenticado, ordenados por ID, com paginação de 50 registros por página.\n\n**Parâmetros disponíveis:**\n- `page`: número da página (padrão: 1; 50 registros por página fixo)","parameters":[{"name":"page","in":"query","description":"Número da página (padrão: 1; 50 registros por página)","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Lista de itens da tabela de venda","content":{"application/json":{"schema":{"type":"object","properties":{"itens":{"type":"array","description":"Itens da tabela (preço fixo por produto)","items":{"type":"object","properties":{"id":{"type":"string","description":"ID do item (uuid)"},"produto_estoque_id":{"type":"integer","description":"ID do produto vinculado"},"produto_codigo":{"type":"string","nullable":true,"description":"Código do produto"},"produto_descricao":{"type":"string","nullable":true,"description":"Descrição do produto"},"pu":{"type":"string","description":"Preço unitário fixado para o produto nesta tabela (decimal como string)"}}}},"pagination":{"type":"object","properties":{"total":{"type":"integer","description":"Total de registros"},"current_page":{"type":"integer","description":"Página atual"},"per_page":{"type":"integer","description":"Registros por página"},"previous_page":{"type":"string","nullable":true,"description":"URL da página anterior"},"next_page":{"type":"string","nullable":true,"description":"URL da próxima página"}}}}}}}},"401":{"description":"Chave de API inválida ou ausente","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}},"404":{"description":"Tabela de venda não encontrada para o usuário autenticado","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}
```
