# Referência da API

> Todas as operações da API v1, por recurso, com parâmetros, respostas e exemplos.

URL: https://precificador3d.com.br/docs/api/referencia

Endereço base: `https://api.precificador3d.com.br/v1`. JSON em UTF-8, dinheiro em **centavos** (inteiro), datas em ISO 8601 com fuso e ids em UUID. Gerado do contrato OpenAPI 3.1 ([openapi.yaml](https://precificador3d.com.br/docs/api/openapi.yaml)).

### Conta

Diagnóstico da chave e da conta.

- `GET /saude`: [Verificar se a API está no ar](https://precificador3d.com.br/docs/api/referencia/saude.md)
- `GET /conta`: [Ver a conta, a chave e os limites](https://precificador3d.com.br/docs/api/referencia/obter-conta.md)

### Catálogo

Produtos, variações, preços por canal e insumos.

- `GET /canais`: [Listar canais de venda](https://precificador3d.com.br/docs/api/referencia/listar-canais.md)
- `GET /produtos`: [Listar produtos com preço por canal](https://precificador3d.com.br/docs/api/referencia/listar-produtos.md)
- `GET /produtos/{id}`: [Ver um produto](https://precificador3d.com.br/docs/api/referencia/obter-produto.md)
- `GET /insumos/materiais`: [Listar materiais e cores](https://precificador3d.com.br/docs/api/referencia/listar-materiais.md)

### Estoque

Saldos de peças prontas e de insumos, e movimentos de peças.

- `GET /estoque`: [Listar saldos de peças prontas](https://precificador3d.com.br/docs/api/referencia/listar-estoque.md)
- `POST /estoque/movimentos`: [Lançar entrada, saída ou ajuste de peças](https://precificador3d.com.br/docs/api/referencia/criar-movimento-estoque.md)
- `GET /estoque-insumos`: [Listar saldos de insumos](https://precificador3d.com.br/docs/api/referencia/listar-estoque-insumos.md)

### Cotações

Leitura de cotações e criação em rascunho.

- `GET /cotacoes`: [Listar cotações](https://precificador3d.com.br/docs/api/referencia/listar-cotacoes.md)
- `POST /cotacoes`: [Criar cotação em rascunho](https://precificador3d.com.br/docs/api/referencia/criar-cotacao.md)
- `GET /cotacoes/{id}`: [Ver uma cotação](https://precificador3d.com.br/docs/api/referencia/obter-cotacao.md)
- `POST /cotacoes/{id}/status`: [Mudar o status da cotação](https://precificador3d.com.br/docs/api/referencia/mudar-status-cotacao.md)

### Produção

Pedidos de produção.

- `GET /pedidos-producao`: [Listar pedidos de produção](https://precificador3d.com.br/docs/api/referencia/listar-pedidos-producao.md)
- `POST /pedidos-producao`: [Criar pedido de produção](https://precificador3d.com.br/docs/api/referencia/criar-pedido-producao.md)
- `GET /pedidos-producao/{id}`: [Ver um pedido de produção](https://precificador3d.com.br/docs/api/referencia/obter-pedido-producao.md)

### Webhooks

Descoberta dos tipos de evento. Os endpoints são cadastrados pela tela.

- `GET /tipos-de-evento`: [Listar os tipos de evento de webhook](https://precificador3d.com.br/docs/api/referencia/listar-tipos-de-evento.md)