Skip to content
platform
EN PT

API reference · Quotes

Answer Quote

Method
PUT
Route
/partnerBudgets/:id
Base URL
https://ws.autorei.net
Path parameters
:id
Token
Requires Bearer token
Test in Postman

Opens this request in the public API documentation, the official source of the reference.

Description

Answers a pending quote: you provide the price, the delivery lead time and your product code, and CWS creates the corresponding inventory record and presents your offer to the customer.

Path Parameters

Parameter Type Required Description
id integer Yes Quote id, as it came back in id in the pending list.

Request Body (JSON)

Field Type Required Description
price number Yes Unit price of your offer. Minimum 0.01 — you cannot offer zero.
leadTime integer Yes Delivery lead time in days, from 0 to 99. 0 means ready for immediate delivery.
partnerPartCode string Yes Product code in your catalog. It cannot be empty.

Business rules

Answering creates the product inventory

The answer is not just a quotation: CWS saves an inventory record with the price, lead time and code you provided, in the quantity the customer requested, and links that inventory to the quote. That is why partnerPartCode is required — it is the code by which you will recognize the item when the order arrives.

The inventory is created in your first warehouse

The inventory created is associated with the first warehouse of your store, not a warehouse of your choosing — this route does not receive warehouseId.

A quote is answered once

A quote that already has an answer is rejected with Orcamento já respondido.

The quotation closes at the fifth answered quote

The customer's request accepts answers from several partners. On the first answer the customer is notified that the product was found; from the fifth on, the request is closed and the quotes not yet answered are discarded.

Response · 200

The quote, now with the answered-quote fields filled in. The response also carries the Location header with the quote URL.

Field Type Description
id integer Quote id.
active boolean Whether the quote is active.
quantity integer Quantity the customer requested.
dateCreated string Date and time of the request, in UTC.
product.name string Product name in CWS.
product.manufacturer string Manufacturer name.
product.mfrPartCode string Product code at the manufacturer.
product.composition string UNITARY, PAIR, KIT, WARRANTY or SET.
product.imageSet.baseUrl · availableSizes · paths — Root, sizes (pp, p, m, g, gg, full) and paths of the product images.
customer.city · customer.state string Customer city and state (UF).
customer.type string PF or PJ.
formNotification.formNotificationId integer Id of the request that originated the quote.
formNotification.formNotificationCustomAttributes array Extra form fields: name, description, value. Comes as [] when there are none.
stock.price · stock.leadTime · stock.partnerPartCode — Only on an already-answered quote. What you provided in the response.
price number Only on an already-answered quote. Same value as stock.price.
priceFormats.value · priceFormats.mask string Only on an already-answered quote. The price with two decimal places ("1250.00") and already with the currency mask ("R$1250.00").
leadTime integer Only on an already-answered quote. Same value as stock.leadTime.
partnerPartCode string Only on an already-answered quote. Same value as stock.partnerPartCode.
partnerInternalPartCode string Only on an already-answered quote. Internal code of the inventory record created.
partnerOrderId integer Only when the quote became an order. Order id — use it in the Orders endpoints.

The price, the lead time and the product code appear in two places on the answered quote: inside stock and also at the root of the object. They are the same value — read from whichever you prefer, and do not treat the root as a second piece of data.

Errors

Code When
422 Required field missing or out of range (price below 0.01, leadTime outside 0-99, empty partnerPartCode), quote already answered (Orcamento já respondido), or quote nonexistent / from another store (Orcamento não encontrado). The reason comes in the message.
401 Token missing, malformed or expired.

Example request

curl --request PUT 'https://ws.autorei.net/partnerBudgets/:id' \
  --header 'Authorization: Bearer {{access_token}}' \
  --header 'Content-Type: application/json' \
  --data '{
  "price": 1250.0,
  "leadTime": 7,
  "partnerPartCode": "SKU-A-001"
}'

Example responses

200Success — quote answered

{
  "id": 4480101,
  "active": true,
  "product": {
    "name": "Kit Embreagem Completo - Linha Pesada",
    "manufacturer": "Fabricante Exemplo",
    "mfrPartCode": "FE-500101",
    "composition": "UNITARY",
    "imageSet": {
      "baseUrl": "https://images.lojaexemplo.cws.digital/produtos",
      "availableSizes": [
        "pp",
        "p",
        "m",
        "g",
        "gg",
        "full"
      ],
      "paths": [
        "/50/01/kit-embreagem-completo-500101-1756992000000.jpg"
      ]
    }
  },
  "stock": {
    "price": 1250,
    "leadTime": 7,
    "partnerPartCode": "SKU-A-001"
  },
  "quantity": 5,
  "customer": {
    "city": "São Paulo",
    "state": "SP",
    "type": "PF"
  },
  "dateCreated": "2026-09-01T13:42:07Z",
  "price": 1250,
  "priceFormats": {
    "value": "1250.00",
    "mask": "R$1250.00"
  },
  "leadTime": 7,
  "partnerPartCode": "SKU-A-001",
  "partnerInternalPartCode": "SKU-A-001",
  "formNotification": {
    "formNotificationId": 4480901,
    "formNotificationCustomAttributes": []
  }
}

Used in

Related endpoints

← See the group: Quotes

Generated from the public API collection, published on 2026-09-04: api-docs.cws.digital.