Compras e fornecedores

Ordens de compra, receção pela guia, e a dívida ao fornecedor.

Fecha o outro lado do stock: a mercadoria entra por aqui, com o preço real que veio na guia e não o que estava acordado. A divergência não bloqueia nada: regista-se, alimenta o custo médio, e sai no relatório de variação de preço, que é onde se vê o fornecedor que aumenta sem avisar.

O que a licença destranca#

Este módulo exige a funcionalidade compras na licença. Sem ela, as rotas dele respondem 403 e o menu não o mostra.

Precisa de: armazem. Sem eles, este módulo não faz o que promete.

Aproveita: contabilidade. Sem eles funciona, e faz menos.

Não se instala sem: armazem. É a ordem de arranque, e não a lista comercial.

O que se consegue ver a acontecer#

• Uma receção parcial mantém a ordem aberta para o remanescente
• O preço real pode divergir do acordado, e a diferença fica registada
• Uma linha marcada como imobilizado dá origem à ficha do bem, ligada à receção
• Um duplo clique não dá entrada duas vezes: a receção é idempotente
• A conta corrente do fornecedor mostra o que se deve e desde quando

Os 41 endpoints#

Saem da árvore de rotas montada, que é a mesma que serve os pedidos. A referência completa, com corpos e respostas, está em /api.

Método	Caminho	O que faz
POST	/api/v1/compras/alcadas	Põe ou muda o limite de autorização de uma pessoa
POST	/api/v1/compras/cotacoes	Pede preço a vários fornecedores
GET	/api/v1/compras/cotacoes/:id	Mostra uma cotação com as respostas
GET	/api/v1/compras/cotacoes/:id/comparar	A tabela lado a lado das respostas
POST	/api/v1/compras/cotacoes/:id/escolher	Marca o vencedor, com o motivo
POST	/api/v1/compras/cotacoes/:id/respostas	Guarda o que um fornecedor respondeu
POST	/api/v1/compras/faturas	Regista a fatura que o fornecedor mandou
GET	/api/v1/compras/faturas/:id	Mostra uma fatura de fornecedor
POST	/api/v1/compras/faturas/:id/conciliar	A conciliação a três: ordem, receção e fatura
GET	/api/v1/compras/faturas/a-vencer	O que se tem de pagar nos próximos dias
GET	/api/v1/compras/fornecedores	Lista os fornecedores
POST	/api/v1/compras/fornecedores	Cria um fornecedor
DELETE	/api/v1/compras/fornecedores/:id	Inativa um fornecedor
GET	/api/v1/compras/fornecedores/:id	Mostra um fornecedor
PUT	/api/v1/compras/fornecedores/:id	Atualiza um fornecedor
POST	/api/v1/compras/fornecedores/:id/avaliacoes	Avalia um fornecedor em prazo, qualidade e preço
GET	/api/v1/compras/fornecedores/:id/extrato	Conta corrente do fornecedor
GET	/api/v1/compras/fornecedores/:id/nota	A média das avaliações de um fornecedor
POST	/api/v1/compras/fornecedores/:id/pagamentos	Lança um pagamento ou uma nota de crédito
GET	/api/v1/compras/ordens	Lista as ordens de compra
POST	/api/v1/compras/ordens	Cria uma ordem de compra em rascunho
GET	/api/v1/compras/ordens/:id	Mostra uma ordem com as linhas
PUT	/api/v1/compras/ordens/:id	Atualiza uma ordem
POST	/api/v1/compras/ordens/:id/cancelar	Cancela a ordem
GET	/api/v1/compras/ordens/:id/custo-real	Quanto a mercadoria custou de verdade
POST	/api/v1/compras/ordens/:id/custos	Lança um custo de importação na ordem
POST	/api/v1/compras/ordens/:id/enviar	Marca a ordem como enviada ao fornecedor
POST	/api/v1/compras/ordens/:id/fechar	Fecha a ordem como recebida, com o que faltar por receber
GET	/api/v1/compras/ordens/:id/pdf	Nota de encomenda em PDF
POST	/api/v1/compras/ordens/:id/receber	Dá entrada da mercadoria
GET	/api/v1/compras/rececoes	Lista as receções
GET	/api/v1/compras/rececoes/:id	Mostra uma receção com as linhas
GET	/api/v1/compras/relatorios/por-fornecedor	Compras por fornecedor no período
GET	/api/v1/compras/relatorios/prazo-entrega	Prazo de entrega real contra o acordado
GET	/api/v1/compras/relatorios/produtos-mais-comprados	Produtos mais comprados no período
GET	/api/v1/compras/relatorios/variacao-preco	Variação entre o preço acordado e o preço recebido
POST	/api/v1/compras/requisicoes	Abre um pedido interno de compra
GET	/api/v1/compras/requisicoes/:id	Mostra uma requisição com as linhas
POST	/api/v1/compras/requisicoes/:id/aprovar	Autoriza a despesa, dentro da alçada
POST	/api/v1/compras/requisicoes/:id/recusar	Nega a despesa, com o motivo
POST	/api/v1/compras/requisicoes/:id/submeter	Manda a requisição para quem autoriza