Referência da API · Orçamentos
Buscar Orçamento por ID do Pedido
- Método
- GET
- Rota
-
/partnerBudgetsByPartnerOrder/:partnerOrderId - URL base
https://ws.autorei.net- Parâmetros de rota
:partnerOrderId- Token
- Exige token Bearer
Abre esta requisição na documentação pública da API, a fonte oficial da referência.
Descrição
Retorna os orçamentos que originaram um pedido. Use quando receber um pedido e precisar rastrear de qual cotação ele veio, o preço e o prazo que você informou no orçamento estão aqui.
Parâmetros de Rota
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
partnerOrderId |
integer | Sim | Id do pedido, não do orçamento. É o id dos endpoints de Pedidos, e o mesmo valor que aparece em partnerOrderId no orçamento. |
Regras de negócio
A resposta é uma lista
Um pedido pode ter nascido de mais de um orçamento, um por item cotado. Espere um array mesmo quando houver só um.
Resposta · 200
Array com um objeto por orçamento. Todos vêm com os campos de orçamento respondido preenchidos, já que geraram pedido.
| Campo | Tipo | Descrição |
|---|---|---|
id |
integer | Id do orçamento. |
active |
boolean | Se o orçamento está ativo. |
quantity |
integer | Quantidade que o cliente pediu. |
dateCreated |
string | Data e hora da solicitação, em UTC. |
product.name |
string | Nome do produto na CWS. |
product.manufacturer |
string | Nome do fabricante. |
product.mfrPartCode |
string | Código do produto no fabricante. |
product.composition |
string | UNITARY, PAIR, KIT, WARRANTY ou SET. |
product.imageSet.baseUrl · availableSizes · paths |
- | Raiz, tamanhos (pp, p, m, g, gg, full) e caminhos das imagens do produto. |
customer.city · customer.state |
string | Cidade e UF do cliente. |
customer.type |
string | PF ou PJ. |
formNotification.formNotificationId |
integer | Id da solicitação que originou o orçamento. |
formNotification.formNotificationCustomAttributes |
array | Campos extras do formulário: name, description, value. Vem [] quando não há. |
stock.price · stock.leadTime · stock.partnerPartCode |
- | Só em orçamento já respondido. O que você informou na resposta. |
price |
number | Só em orçamento já respondido. Mesmo valor de stock.price. |
priceFormats.value · priceFormats.mask |
string | Só em orçamento já respondido. O preço com duas casas ("1250.00") e já com a máscara de moeda ("R$1250.00"). |
leadTime |
integer | Só em orçamento já respondido. Mesmo valor de stock.leadTime. |
partnerPartCode |
string | Só em orçamento já respondido. Mesmo valor de stock.partnerPartCode. |
partnerInternalPartCode |
string | Só em orçamento já respondido. Código interno do estoque criado. |
partnerOrderId |
integer | Só quando o orçamento virou pedido. Id do pedido, use nos endpoints de Pedidos. |
O preço, o prazo e o código do produto aparecem em dois lugares no orçamento respondido: dentro de stock e também na raiz do objeto. São o mesmo valor, leia de onde preferir, e não trate a raiz como um segundo dado.
Erros
| Código | Quando |
|---|---|
| 404 | O pedido não tem orçamento vinculado, o id não existe, ou o pedido é de outra loja. A mesma resposta nos três casos, sem corpo. |
| 401 | Token ausente, malformado ou expirado. |
Exemplo de requisição
curl --request GET 'https://ws.autorei.net/partnerBudgetsByPartnerOrder/:partnerOrderId' \
--header 'Authorization: Bearer {{access_token}}' Respostas de exemplo
200Sucesso: o orçamento que originou o pedido
[
{
"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",
"partnerOrderId": 900201,
"formNotification": {
"formNotificationId": 4480901,
"formNotificationCustomAttributes": []
}
}
] Usado em
- Casos de usoIntegração ERP: o caminho típico pela API
- Casos de usoCompras B2B e suprimentos: o caminho típico pela API
- Casos de usoVenda assistida e balcão: o caminho típico pela API
Endpoints relacionados
Gerado a partir da coleção pública da API, publicada em 04/09/2026: api-docs.cws.digital.