# Contratos

A API de Contratos tem como objetivo automatizar a gestão de vendas recorrentes, sejam elas de produtos ou serviços. Por meio dessa funcionalidade, é possível criar contratos que geram automaticamente as vendas conforme a periodicidade configurada, garantindo maior eficiência operacional e redução de processos manuais. Esta API oferece endpoints que permitem criar, consultar o próximo número de contratos e consultar, possibilitando a integração direta com sistemas externos para controle e acompanhamento das recorrências.

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

**Controle de contratos recorrentes:**  
[https://ajuda.contaazul.com/hc/pt-br/sections/19712815184781-Controle-de-contratos-recorrentes](https://ajuda.contaazul.com/hc/pt-br/sections/19712815184781-Controle-de-contratos-recorrentes)


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

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

## v1

Conjunto de recursos para acompanhar e administrar operações  relacionadas a contratos - esses recursos incluem criar um novo contrato e retornar os contratos por filtro

### Criar um novo contrato

 - [POST /v1/contratos](https://developers.contaazul.com/docs/contracts-apis-openapi/v1/criarcontrato.md): Permite criar um novo contrato, definindo as informações necessárias para configuração da recorrência, como período, produtos/serviços vinculados e demais parâmetros do contrato.

### Retornar os contratos por filtro

 - [GET /v1/contratos](https://developers.contaazul.com/docs/contracts-apis-openapi/v1/listarcontratos.md): Permite consultar contratos existentes, com suporte a filtros que facilitam a busca e a gestão dos contratos criados (ex. por cliente, data, status, entre outros).

### Retornar o próximo número do contrato disponível

 - [GET /v1/contratos/proximo-numero](https://developers.contaazul.com/docs/contracts-apis-openapi/v1/getnextcontractnumber.md): Permite consultar o próximo número de contrato a ser utilizado no momento da criação.