Referência da API · Pedidos · Gestão loja
Listar Pedidos da Loja
- Método
- GET
- Rota
-
/partnerOrders/list - 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 os pedidos em que a sua loja é a fornecedora, os que você recebeu para atender, do mais recente para o mais antigo, com paginação e filtros.
A resposta é compacta: nove campos por pedido, o suficiente para montar uma fila de atendimento. O conteúdo completo vem em Buscar Detalhes do Pedido.
Parâmetros de Consulta
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
limit |
integer | Não | Pedidos por página. Default 5, teto 25. Acima do teto, vale o teto. |
offset |
integer | Não | Quantos pedidos pular. Default 0. |
status |
string | Não | Filtra por status. Pode ser repetido para trazer mais de um: ?status=READY&status=SHIPPED. Sem o parâmetro, vêm todos. |
createdFrom |
datetime | Não | Criados a partir desta data, inclusive. ISO-8601: 2026-09-01T00:00:00Z. |
createdTo |
datetime | Não | Criados até esta data, inclusive. |
updatedFrom |
datetime | Não | Alterados a partir desta data, inclusive. |
updatedTo |
datetime | Não | Alterados até esta data, inclusive. |
Os valores de status: PRE_ORDER · AWAITING_PAYMENT · PAYMENT_APPROVED · WITHOUT_CREDIT_LIMIT · READY · SHIPPED · DELIVERED · COMPLETED · CANCELED · STRAYED · RETURNED · STORE_PAYMENT.
Resposta · 200
Array de pedidos, ordenado por data de criação, do mais recente para o mais antigo. Os nove campos vêm sempre.
| Campo | Descrição |
|---|---|
id |
Id do pedido do parceiro (partnerOrderId). É ele que vai na rota dos demais endpoints de pedido. |
orderId |
Id do pedido do cliente, o pedido "pai". Um orderId pode ter mais de um id. |
total |
Valor total, como string já formatada em reais: "R$637,57". |
status |
Status atual do pedido. |
dateCreated · lastUpdated |
Criação e última alteração, em UTC. |
gateway |
Meio de pagamento usado. Vem null quando o pedido ainda não tem pagamento. |
partner.partnerName · partner.partnerDocument |
Nome e documento do parceiro fornecedor. |
customer.customerName · customer.customerDocument |
Nome e documento do cliente. |
Sem resultado, a resposta é um array vazio.
Erros
| Código | Quando |
|---|---|
| 401 | Token ausente, malformado ou expirado. |
Exemplo de requisição
curl --request GET 'https://ws.autorei.net/partnerOrders/list?limit=5&offset=0' \
--header 'Authorization: Bearer {{access_token}}' Respostas de exemplo
200Sucesso: dois pedidos
[
{
"id": 900201,
"orderId": 900100,
"total": "R$637,57",
"status": "PAYMENT_APPROVED",
"dateCreated": "2026-09-02T11:04:18Z",
"lastUpdated": "2026-09-02T11:12:40Z",
"gateway": "GATEWAY_DE_PAGAMENTO",
"partner": {
"partnerName": "Loja Exemplo",
"partnerDocument": "30.424.972/0001-74"
},
"customer": {
"customerName": "Ana Paula Ribeiro",
"customerDocument": "700.413.648-56"
}
},
{
"id": 900202,
"orderId": 900101,
"total": "R$81,64",
"status": "AWAITING_PAYMENT",
"dateCreated": "2026-09-01T13:26:05Z",
"lastUpdated": "2026-09-01T13:27:26Z",
"gateway": null,
"partner": {
"partnerName": "Loja Exemplo",
"partnerDocument": "30.424.972/0001-74"
},
"customer": {
"customerName": "Ana Paula Ribeiro",
"customerDocument": "700.413.648-56"
}
}
] 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 usoVarejo complexo e B2B2C: 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
- Webhooks e eventosWebhook de pedidos
- 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.