# v1

Conjunto de recursos para acompanhar e administrar operações relacionadas a vendas - esses recursos incluem retornar os vendedores, retornar a venda por id, atualizar uma venda por id, retornar as vendas por filtro, criar uma nova venda, retornar o PDF de uma venda, excluir vendas em lote e retornar os itens de uma venda  pelo id da venda

## Retornar os vendedores

 - [GET /v1/venda/vendedores](https://developers.contaazul.com/docs/sales-apis-openapi/v1/listvendedores.md): Retorna a lista de vendedores cadastrados na Conta Azul. Útil quando você precisa atribuir um vendedor a uma venda ou exibir opções de vendedores em sua interface.

## Retornar a venda por id

 - [GET /v1/venda/{id}](https://developers.contaazul.com/docs/sales-apis-openapi/v1/getvendabyid.md): Recupera os detalhes de uma venda específica por ID (pode ser UUID ou id legado). Útil quando quiser exibir ou sincronizar todos os dados de uma venda específica.

## Atualizar uma venda por id

 - [PUT /v1/venda/{id}](https://developers.contaazul.com/docs/sales-apis-openapi/v1/editsale.md): Permite atualizar uma venda existente. Útil se sua aplicação permite editar vendas depois que foram criadas no ERP.

## Retornar as vendas por filtro

 - [GET /v1/venda/busca](https://developers.contaazul.com/docs/sales-apis-openapi/v1/searchvendas.md): Retorna as vendas filtradas, podendo fazer uso de parâmetros de consulta como data inicial/final, cliente, situação, tipos de venda, IDs de produtos, IDs de categorias, paginação, entre outros. Use esse endpoint para construir telas de listagem, dashboards ou relatórios de vendas.

## Criar uma nova venda

 - [POST /v1/venda](https://developers.contaazul.com/docs/sales-apis-openapi/v1/createvenda.md): Cria uma nova venda no sistema da Conta Azul. Ideal para registrar vendas vindas de sistemas externos diretamente no ERP da Conta Azul.

## Retornar o PDF de uma venda

 - [GET /v1/venda/{id}/imprimir](https://developers.contaazul.com/docs/sales-apis-openapi/v1/printvendapdf.md): Gera e retorna um PDF da venda identificada pelo ID. Use quando precisar mostrar ao usuário ou armazenar uma versão impressa da venda.

## Excluir vendas em lote

 - [POST /v1/venda/exclusao-lote](https://developers.contaazul.com/docs/sales-apis-openapi/v1/deletevendasbatch.md): Permite excluir várias vendas de uma vez. Útil para excluir em lote vendas de forma automatizada. Útil durante sincronizações ou processos de limpeza de dados.

## Retornar os itens de uma venda pelo id da venda

 - [GET /v1/venda/{id_venda}/itens](https://developers.contaazul.com/docs/sales-apis-openapi/v1/getvendaitens.md): Retorna a lista de itens de uma venda, dado o ID da venda. Use para exibir um detalhe da venda (todos produtos/serviços) ou para sincronizar os itens da venda para outros sistemas.

## Retornar o próximo número de venda disponível

 - [GET /v1/venda/proximo-numero](https://developers.contaazul.com/docs/sales-apis-openapi/v1/getnextvendanumber.md): Retorna o próximo número de venda disponível, segundo a numeração usada no ERP da Conta Azul. Pode ser usado antes de criar uma venda para garantir que você está usando uma sequência de número válida/nova.