API — Compras e estoque
OpenAPI: packages/openapi/openapi.v1.yaml
Prefixos: /purchasing/*, /warehouses, /warehouse-accesses, /stock/*
Atualizado: 2026-09-13
Endpoints principais de compras (requisição → cotação → pedido → entrada NF) e estoque físico.
Impressão do pedido de compra com marca d'água é feita no frontend (não há rota dedicada de print).
Requisições de compra
| Method |
Path |
Permissão |
Descrição |
| GET |
/purchasing/purchase-requests |
purchasing.request.read |
Listar |
| POST |
/purchasing/purchase-requests |
purchasing.request.create |
Criar |
| GET |
/purchasing/purchase-requests/{id} |
purchasing.request.read |
Detalhe |
| PATCH |
/purchasing/purchase-requests/{id} |
purchasing.request.update |
Atualizar |
| POST |
/purchasing/purchase-requests/{id}/deny |
purchasing.request.deny |
Negar |
| POST |
/purchasing/purchase-requests/{id}/cancel |
purchasing.request.cancel |
Cancelar |
| GET |
/purchasing/purchase-requests/{id}/history |
purchasing.audit.read | purchasing.request.read |
Auditoria |
Pedidos de compra
| Method |
Path |
Permissão |
Descrição |
| GET |
/purchasing/purchase-orders |
purchasing.order.read |
Listar |
| POST |
/purchasing/purchase-orders |
purchasing.order.create |
Criar (pode vincular requisição) |
| GET |
/purchasing/purchase-orders/{id} |
purchasing.order.read |
Detalhe |
| PATCH |
/purchasing/purchase-orders/{id} |
purchasing.order.update |
Atualizar |
| POST |
/purchasing/purchase-orders/{id}/release |
purchasing.order.release |
Liberar (aprovador) |
| POST |
/purchasing/purchase-orders/{id}/cancel |
purchasing.order.cancel |
Cancelar |
| GET |
/purchasing/purchase-orders/{id}/history |
purchasing.audit.read | purchasing.order.read |
Auditoria |
Cotações
| Method |
Path |
Permissão |
Descrição |
| GET |
/purchasing/quotations |
purchasing.quotation.read |
Listar |
| POST |
/purchasing/quotations |
purchasing.quotation.create |
Criar |
| GET |
/purchasing/quotations/{id} |
purchasing.quotation.read |
Detalhe |
| PATCH |
/purchasing/quotations/{id} |
purchasing.quotation.update |
Atualizar |
| POST |
/purchasing/quotations/{id}/open |
purchasing.quotation.update |
Abrir cotação |
| POST |
/purchasing/quotations/{id}/suppliers |
purchasing.quotation.invite |
Convidar fornecedores |
| POST |
/purchasing/quotations/{id}/proposals |
purchasing.quotation.proposal |
Registrar proposta |
| GET |
/purchasing/quotations/{id}/comparative-map |
purchasing.quotation.analyze | purchasing.quotation.read |
Mapa comparativo |
| POST |
/purchasing/quotations/{id}/winners |
purchasing.quotation.select_winner |
Definir vencedores |
| POST |
/purchasing/quotations/{id}/approve |
purchasing.quotation.approve |
Aprovar |
| POST |
/purchasing/quotations/{id}/reject |
purchasing.quotation.reject |
Rejeitar |
| POST |
/purchasing/quotations/{id}/cancel |
purchasing.quotation.cancel |
Cancelar |
| POST |
/purchasing/quotations/{id}/generate-orders |
purchasing.quotation.generate_order |
Gerar pedidos |
| GET |
/purchasing/quotations/{id}/history |
purchasing.quotation.audit | purchasing.quotation.read | purchasing.audit.read |
Auditoria |
Entrada de NF (manual / XML)
| Method |
Path |
Permissão |
Descrição |
| GET |
/purchasing/purchase-invoices |
purchasing.invoice.read |
Listar |
| POST |
/purchasing/purchase-invoices |
purchasing.invoice.create |
Criar manual |
| POST |
/purchasing/purchase-invoices/import-xml |
purchasing.invoice.import_xml |
Importar XML arquivo |
| GET |
/purchasing/purchase-invoices/{id} |
purchasing.invoice.read |
Detalhe |
| PATCH |
/purchasing/purchase-invoices/{id} |
purchasing.invoice.update |
Atualizar |
| POST |
/purchasing/purchase-invoices/{id}/confer |
purchasing.invoice.read |
Conferência |
| POST |
/purchasing/purchase-invoices/{id}/confirm |
purchasing.invoice.confirm |
Confirmar (estoque + AP) |
| POST |
/purchasing/purchase-invoices/{id}/reverse |
purchasing.invoice.reverse |
Estornar |
| GET |
/purchasing/purchase-invoices/{id}/history |
purchasing.audit.read | purchasing.invoice.read |
Auditoria |
Condições de pagamento e parâmetros
| Method |
Path |
Permissão |
Descrição |
| GET |
/purchasing/payment-conditions |
purchasing.payment_condition.read | purchasing.order.read | purchasing.invoice.read |
Listar condições |
| POST |
/purchasing/payment-conditions |
purchasing.payment_condition.create |
Criar |
| GET |
/purchasing/payment-conditions/{id} |
purchasing.payment_condition.read | … |
Detalhe |
| PATCH |
/purchasing/payment-conditions/{id} |
purchasing.payment_condition.update |
Atualizar |
| GET |
/purchasing/approvers |
purchasing.settings.read |
Aprovadores / limites |
| POST |
/purchasing/approvers |
purchasing.settings.update |
Criar aprovador |
| PATCH |
/purchasing/approvers/{id} |
purchasing.settings.update |
Atualizar |
| DELETE |
/purchasing/approvers/{id} |
purchasing.settings.update |
Remover |
Almoxarifados e acesso
| Method |
Path |
Permissão |
Descrição |
| GET |
/warehouses |
inventory.warehouse.read |
Listar |
| POST |
/warehouses |
inventory.warehouse.create |
Criar |
| GET |
/warehouses/{id} |
inventory.warehouse.read |
Detalhe |
| PATCH |
/warehouses/{id} |
inventory.warehouse.update |
Atualizar |
| GET |
/warehouse-accesses |
inventory.access.read |
Listar acessos |
| POST |
/warehouse-accesses |
inventory.access.update |
Conceder |
| PATCH |
/warehouse-accesses/{id} |
inventory.access.update |
Atualizar |
| DELETE |
/warehouse-accesses/{id} |
inventory.access.update |
Revogar |
Saldos, movimentos, transferências e inventário
| Method |
Path |
Permissão |
Descrição |
| GET |
/stock/balances |
inventory.stock.read |
Saldos (kardex na UI usa este conjunto) |
| GET |
/stock/movements |
inventory.stock.read |
Listar movimentos |
| POST |
/stock/movements |
inventory.stock.create |
Entrada/saída |
| POST |
/stock/movements/{id}/reverse |
inventory.stock.reverse |
Estornar movimento |
| GET |
/stock/transfers |
inventory.stock.read |
Listar transferências |
| POST |
/stock/transfers |
inventory.stock.transfer |
Criar |
| GET |
/stock/transfers/{id} |
inventory.stock.read |
Detalhe |
| PATCH |
/stock/transfers/{id} |
inventory.stock.transfer |
Atualizar |
| POST |
/stock/transfers/{id}/confirm |
inventory.stock.transfer |
Confirmar |
| POST |
/stock/transfers/{id}/cancel |
inventory.stock.transfer |
Cancelar |
| GET |
/stock/inventories |
inventory.inventory.read |
Listar inventários |
| POST |
/stock/inventories |
inventory.inventory.create |
Abrir inventário |
| GET |
/stock/inventories/{id} |
inventory.inventory.read |
Detalhe |
| POST |
/stock/inventories/{id}/count |
inventory.inventory.count |
Contagem |
| POST |
/stock/inventories/{id}/review |
inventory.inventory.review |
Revisão |
| POST |
/stock/inventories/{id}/close |
inventory.inventory.close |
Fechar |
| POST |
/stock/inventories/{id}/cancel |
inventory.inventory.create |
Cancelar |
Ver também
Referências