Referência da API · Pedidos · Gestão loja
Atualizar Lead Time dos Itens
- Método
- PUT
- Rota
-
/partnerOrders/:id/partnerOrderLines - URL base
https://ws.autorei.net- Parâmetros de rota
:id- Token
- Exige token Bearer
Abre esta requisição na documentação pública da API, a fonte oficial da referência.
Descrição
Informa o prazo de preparo dos itens que ficaram com o prazo sob consulta. É este envio que libera o pedido para o pagamento: respondidos os prazos, o cliente é avisado de que o pedido está disponível.
Os itens pendentes estão em Listar Itens com Lead Time Sob Consulta.
Parâmetros de Rota
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id |
integer | Sim | Id do pedido do parceiro (partnerOrderId). |
Corpo da Requisição (JSON)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
partnerOrderLineList |
array | Sim | Os itens do pedido que estão com prazo pendente. |
partnerOrderLineList[].id |
integer | Sim | Id da linha do pedido, o campo id da consulta, e o deliveries[].products[].partnerOrderLineId do detalhe do pedido. |
partnerOrderLineList[].leadTime |
integer | Sim | Prazo de preparo do item, em dias. Maior que zero. |
Regras de negócio
Todos os itens pendentes, de uma vez
A requisição precisa trazer todos os itens do pedido que estão com o prazo pendente. Faltando um, nada é gravado e a resposta é 422. Não existe envio parcial: consulte a lista, responda a lista inteira.
O pedido precisa estar esperando o prazo
Só aceita pedido que nasceu com prazo sob consulta e que ainda não teve os prazos respondidos. Respondido uma vez, o prazo não se edita de novo por aqui.
O status precisa permitir
O pedido precisa estar em PRE_ORDER, AWAITING_PAYMENT ou PAYMENT_APPROVED. Em qualquer outro status a atualização é recusada.
O que a resposta ao prazo dispara
Gravados os prazos, três coisas acontecem de uma vez: o prazo de preparo da entrega passa a somar o maior prazo informado, e, em lojas configuradas para isso, o prazo de frete também soma; o pedido é marcado como respondido; e o cliente é notificado de que o pedido está disponível para pagamento.
Resposta · 200
Array com as linhas do pedido, já com os prazos gravados.
| Campo | Descrição |
|---|---|
id |
Id da linha do pedido. |
quantity |
Quantidade total do item. |
leadTime |
Prazo de preparo gravado, em dias. |
salePrice · realSalePrice · defaultPrice |
Preços da linha. |
stock |
Estoque de origem do item. |
partnerOrder |
Id do pedido do parceiro. |
customerType · couponId |
Tipo de cliente da linha e cupom aplicado, quando houver. |
taxes |
Impostos da linha, quando houver: taxPurpose, taxPurposeId, st, ipi, icms, pis, cofins, totalTax. |
Erros
| Código | Quando |
|---|---|
| 400 | O corpo não é um JSON válido. O detalhe vem em error. |
| 422 | O pedido não é seu; não é um pedido de prazo sob consulta ou os prazos já foram respondidos; o status não permite a atualização; algum item veio sem id ou sem leadTime; ou faltou algum dos itens pendentes. O motivo vem em message. |
| 401 | Token ausente, malformado ou expirado. |
Exemplo de requisição
curl --request PUT 'https://ws.autorei.net/partnerOrders/:id/partnerOrderLines' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'Content-Type: application/json' \
--data '{
"partnerOrderLineList": [
{
"id": 4490101,
"leadTime": 5
},
{
"id": 4490102,
"leadTime": 3
}
]
}' Respostas de exemplo
200Sucesso: prazos informados
[
{
"id": 4490101,
"quantity": 2,
"leadTime": 5,
"salePrice": 149.9,
"realSalePrice": 149.9,
"defaultPrice": 159.9,
"stock": 4410001,
"partnerOrder": 900201,
"customerType": "pf",
"couponId": null
},
{
"id": 4490102,
"quantity": 1,
"leadTime": 3,
"salePrice": 89.9,
"realSalePrice": 89.9,
"defaultPrice": 89.9,
"stock": 4410002,
"partnerOrder": 900201,
"customerType": "pf",
"couponId": null
}
] 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
Endpoints relacionados
Gerado a partir da coleção pública da API, publicada em 04/09/2026: api-docs.cws.digital.