# Produtos

A API de Produtos (Inventário) da Conta Azul tem como objetivo permitir que sistemas externos gerenciem o catálogo de produtos de forma automatizada, desde a criação ou alteração dos itens, até sua listagem, detalhamento e desativação. Isso facilita a integração com e-commerce, ERPs, marketplaces e outros sistemas 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:

Produtos: [https://ajuda.contaazul.com/hc/pt-br/sections/19716513113997-Cadastro-de-produtos](https://ajuda.contaazul.com/hc/pt-br/sections/19716513113997-Cadastro-de-produtos)


Version: v1

## Servers

```
https://api-v2.contaazul.com
```

## Security

### BearerAuth

Digite **'Bearer <JWT>'**, onde JWT é o access_token recebido no login (passo 2 do fluxo de autenticação).

Type: apiKey
In: header
Name: Authorization

## Download OpenAPI description

[Produtos](https://developers.contaazul.com/_bundle/open-api-docs/open-api-inventory.yaml)

## v1

Operações relacionadas a produtos

### Retornar os produtos por filtro

 - [GET /v1/produtos](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/retornarlistagemdeprodutos.md): Permite listar os produtos cadastrados, com suporte a filtros como página, tamanho, busca por nome, sku ou ean, status ("ativo", "inativo") e ordenação.

### Criar um novo produto

 - [POST /v1/produtos](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/criarproduto.md): Permite criar um novo produto, informando dados como nome, código interno, unidade de medida, categoria, preço, estoque inicial, entre outros parâmetros. Ideal para automatizar o cadastro de itens novos no sistema.

### Retornar as categorias por filtro

 - [GET /v1/produtos/categorias](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/retornarcategoriasdeprodutos.md): Permite listar categorias de produtos cadastradas na Conta Azul, com paginação e filtro por texto. Útil para validar categoria na criação de produtos.

### Retornar os cests por filtro

 - [GET /v1/produtos/cest](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/retornarcests.md): Retorna códigos CEST (Código Especificador da Substituição Tributária) usados para questões fiscais, com filtro por texto e paginação. Importante para definir a tributação correta de produtos no ERP.

### Retornar as categorias de e-commerce por filtro

 - [GET /v1/produtos/ecommerce-categorias](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/retornarcategoriasdeecommercedeprodutos.md): Retorna categorias específicas para e-commerce (não necessariamente as mesmas categorias internas), permite filtro por descrição. Útil para integrar categorização de produtos entre seu sistema e Conta Azul.

### Retornar as marcas de ecommerce por filtro

 - [GET /v1/produtos/ecommerce-marcas](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/retornarmarcasecommerce.md): Busca marcas usadas no contexto de e-commerce, com paginação, ordenação e filtro por nome. Permite sincronizar marcas entre sistema de vendas online e Conta Azul.

### Retornar os ncms por filtro

 - [GET /v1/produtos/ncm](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/retornarncms.md): Retorna códigos NCM (Nomenclatura Comum do Mercosul), com filtro por texto e paginação. Necessário para classificação fiscal de produtos.

### Retornar as unidades de medida por filtro

 - [GET /v1/produtos/unidades-medida](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/retornarunidadesdemedida.md): Retorna as unidades de medida possíveis para produtos, com paginação e busca por descrição. Essencial para definir medidas fiscais (peso, volume, etc.) ou unidades de estoque.

### Retornar o produto por id

 - [GET /v1/produtos/{id}](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/retornarprodutoporid.md): Traz todos os detalhes de um produto específico (estoque, fiscal, e-commerce, variações, pesos, unidades, etc.). Ideal para consultar dados completos antes de exibir para usuário ou para sincronização.

### Deletar produto por id

 - [DELETE /v1/produtos/{id}](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/deletarprodutoporid.md): Remove o produto correspondente ao Id. Use para excluir produtos que não são mais necessários ou foram removidos do catálogo.

### Atualizar parcialmente um produto por id

 - [PATCH /v1/produtos/{id}](https://developers.contaazul.com/open-api-docs/open-api-inventory/v1/atualizarprodutoparcialmente.md): Permite atualizar apenas alguns campos de um produto (nome, EAN, SKU, NCM, peso, valor de venda, unidade de medida, etc.). É útil para ajustes pontuais sem precisar reenviar o objeto completo do produto.