# Vendas

A API de Vendas (v1) permite que sistemas externos integrem funcionalidades de vendas diretamente com o ERP da Conta Azul. Com ela, é possível criar, atualizar, consultar e excluir vendas, bem como recuperar informações detalhadas sobre os itens das vendas e gerar documentos associados, como PDFs de vendas.

Se desejar aprofundar o entendimento das regras de negócio aplicadas pelo ERP, recomendamos, de forma opcional a consulta à nossa Central de Ajuda:

[https://ajuda.contaazul.com/hc/pt-br/sections/19712754054285-Controle-de-vendas](https://ajuda.contaazul.com/hc/pt-br/sections/19712754054285-Controle-de-vendas)


Version: v1

## Servers

Servidor de produção
```
https://api-v2.contaazul.com
```

## Security

### BearerAuth

Token de autorização Bearer JWT

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Vendas](https://developers.contaazul.com/_bundle/docs/sales-apis-openapi.yaml)

## 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.