Abrir cotação

Um item, o volume, o preço-alvo e os fornecedores convidados. A proposta inicial de cada fornecedor é opcional e, quando vem, já entra como a primeira rodada.

corpo da requisição

itemDescriptionstringobrigatório: Item cotado.
quantitynumberobrigatório: Volume da cotação.
unitLabelstringopcional: Unidade do volume. Padrão unidade.
targetPricenumberobrigatório: Preço-alvo por unidade.
lastBuyPricenumber | nullopcional: Preço da última compra, para medir a economia.
suppliersarrayobrigatório: De 1 a 10 fornecedores com nome, CNPJ opcional e proposta inicial opcional.

erros deste endpoint

401not_authenticatedA chave não veio, não existe mais ou foi revogada.
403not_allowedA chave não tem manage_purchases.
422invalid_inputUm campo não passou na validação; fields aponta qual.
422purchase_quote_needs_supplierA cotação precisa de pelo menos um fornecedor, com nome.

curl https://api.goprumo.com.br/functions/v1/api/v1/purchase-quotes \
  -X POST \
  -H "Authorization: Bearer $PRUMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
       "itemDescription": "Papel A4 75g, resma",
       "quantity": 120,
       "unitLabel": "resma",
       "targetPrice": 22,
       "lastBuyPrice": 24.9,
       "suppliers": [
         {
           "name": "Nordeste Papelaria",
           "cnpj": "98765432000198",
           "value": 24.9
         }
       ]
     }'

console

pré-visualização local

200 OKA cotação criada.exemplo

{
  "data": {
    "itemDescription": "Papel A4 75g, resma",
    "quantity": 120,
    "targetPrice": 22,
    "unitLabel": "resma",
    "lastBuyPrice": 24.9
  }
}