Pular para o conteúdo
platform
PT EN

Referência da API · Orçamentos

Responder Orçamento

Método
PUT
Rota
/partnerBudgets/:id
URL base
https://ws.autorei.net
Parâmetros de rota
:id
Token
Exige token Bearer
Testar no Postman

Abre esta requisição na documentação pública da API, a fonte oficial da referência.

Descrição

Responde um orçamento pendente: você informa o preço, o prazo de entrega e o seu código do produto, e a CWS cria o estoque correspondente e apresenta a sua oferta ao cliente.

Parâmetros de Rota

Parâmetro Tipo Obrigatório Descrição
id integer Sim Id do orçamento, como veio em id na listagem de pendentes.

Corpo da Requisição (JSON)

Campo Tipo Obrigatório Descrição
price number Sim Preço unitário da sua oferta. Mínimo 0,01, não é possível ofertar zero.
leadTime integer Sim Prazo de entrega em dias, de 0 a 99. 0 significa pronta-entrega.
partnerPartCode string Sim Código do produto no seu catálogo. Não pode ser vazio.

Regras de negócio

Responder cria o estoque do produto

A resposta não é só uma cotação: a CWS grava um estoque com o preço, o prazo e o código que você informou, na quantidade que o cliente pediu, e vincula esse estoque ao orçamento. É por isso que partnerPartCode é obrigatório, é o código pelo qual você vai reconhecer o item quando o pedido chegar.

O estoque nasce no seu primeiro depósito

O estoque criado é associado ao primeiro depósito da sua loja, não a um depósito de sua escolha, esta rota não recebe warehouseId.

Um orçamento se responde uma vez

Orçamento que já tem resposta é recusado com Orcamento já respondido.

A cotação fecha no quinto orçamento respondido

A solicitação do cliente aceita respostas de vários parceiros. Na primeira resposta o cliente é avisado de que encontrou o produto; a partir da quinta, a solicitação é encerrada e os orçamentos ainda não respondidos são descartados.

Resposta · 200

O orçamento, agora com os campos de orçamento respondido preenchidos. A resposta traz também o cabeçalho Location com a URL do orçamento.

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
422 Campo obrigatório ausente ou fora da faixa (price abaixo de 0,01, leadTime fora de 0-99, partnerPartCode vazio), orçamento já respondido (Orcamento já respondido), ou orçamento inexistente / de outra loja (Orcamento não encontrado). O motivo vem na mensagem.
401 Token ausente, malformado ou expirado.

Exemplo de requisição

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"
}'

Respostas de exemplo

200Sucesso: orçamento respondido

{
  "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": []
  }
}

Usado em

Endpoints relacionados

← Ver o grupo: Orçamentos

Gerado a partir da coleção pública da API, publicada em 04/09/2026: api-docs.cws.digital.