Referência da API · Orçamentos
Listar Orçamentos Pendentes
- Método
- GET
- Rota
-
/partnerBudgets/pending - URL base
https://ws.autorei.net- Parâmetros de consulta do exemplo
limit=5offset=0- Token
- Exige token Bearer
Abre esta requisição na documentação pública da API, a fonte oficial da referência.
Descrição
Lista as solicitações de orçamento em aberto para a sua loja, pedidos de cotação que clientes fizeram para produtos que você vende e que ainda não foram respondidos. Cada item traz o produto, a quantidade pedida e a praça do cliente, que é o que você precisa para precificar.
Parâmetros de Consulta
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
limit |
integer | Não | Orçamentos por página. Padrão 5, teto 50, valor acima disso é reduzido para 50, sem erro. |
offset |
integer | Não | Orçamento inicial da página. Padrão 0. |
customerType |
string | Não | Filtra pelo tipo de cliente: PF ou PJ. Omitido, traz os dois. |
Regras de negócio
Sem orçamentos pendentes, a resposta é 422
Quando não há nada a responder, a resposta é 422 com a mensagem Não existem orçamentos pendentes. É também o que você recebe quando o offset passa do último orçamento.
Resposta · 200
Array com um objeto por orçamento pendente.
| Campo | Tipo | Descrição |
|---|---|---|
id |
integer | Id do orçamento. É o que você usa para responder ou recusar. |
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 |
string | Raiz das imagens do produto. |
product.imageSet.availableSizes |
array | Tamanhos disponíveis: pp, p, m, g, gg, full. |
product.imageSet.paths |
array | Caminhos das imagens. Monte a URL com baseUrl + tamanho + caminho. |
customer.city · customer.state |
string | Cidade e UF do cliente, é a praça que define frete e ICMS na sua cotação. |
customer.type |
string | PF ou PJ. |
formNotification.formNotificationId |
integer | Id da solicitação que originou o orçamento. |
formNotification.formNotificationCustomAttributes |
array | Campos extras que o cliente preencheu no formulário: name, description e value. Vem [] quando não há. |
Erros
| Código | Quando |
|---|---|
| 422 | Não há orçamento pendente (Não existem orçamentos pendentes.), ou customerType fora de PF/PJ. |
| 401 | Token ausente, malformado ou expirado. |
Exemplo de requisição
curl --request GET 'https://ws.autorei.net/partnerBudgets/pending?limit=5&offset=0' \
--header 'Authorization: Bearer {{access_token}}' Respostas de exemplo
200Sucesso: dois orçamentos pendentes
[
{
"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"
]
}
},
"quantity": 5,
"customer": {
"city": "São Paulo",
"state": "SP",
"type": "PF"
},
"dateCreated": "2026-09-01T13:42:07Z",
"formNotification": {
"formNotificationId": 4480901,
"formNotificationCustomAttributes": []
}
},
{
"id": 4480102,
"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"
]
}
},
"quantity": 1,
"customer": {
"city": "São Paulo",
"state": "SP",
"type": "PJ"
},
"dateCreated": "2026-09-01T13:42:07Z",
"formNotification": {
"formNotificationId": 4480902,
"formNotificationCustomAttributes": []
}
}
] Usado em
- Casos de usoIntegração ERP: o caminho típico pela API
- Casos de usoPortal B2B próprio: o caminho típico pela API
- Casos de usoMarketplace B2B: 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
- Comece por aquiPaginação e limites
Endpoints relacionados
Gerado a partir da coleção pública da API, publicada em 04/09/2026: api-docs.cws.digital.