Pular para o conteúdo
platform
PT EN

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=5 offset=0
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

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

Endpoints relacionados

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