Pular para o conteúdo
ShopentlyLearn
Português (Brasil)

Pedidos

Leia resumos e detalhes de pedidos e atualize o estado do pedido ou do pagamento.

Operações

GETListar · Status disponíveis — Pedidos/api/v1/order-statuses

Exemplo de requisiçãoExemplo de resposta

GETListar — Pedidos/api/v1/orders

Exemplo de requisiçãoExemplo de resposta

GETObter — Pedidos/api/v1/orders/{order_id}

Exemplo de requisiçãoExemplo de resposta

PATCHAtualizar · Status do pagamento — Pedidos/api/v1/orders/{order_id}/payment-status

Exemplo de requisiçãoExemplo de resposta

PATCHAtualizar · Status — Pedidos/api/v1/orders/{order_id}/status

Exemplo de requisiçãoExemplo de resposta

Como funciona

A lista e os detalhes dos pedidos incluem delivery.dates. As datas YYYY-MM-DD são previstas e não confirmam o envio. As datas atuais têm prioridade; pedidos antigos usam a estimativa salva. Valores apagados ou desconhecidos são null. Os detalhes incluem também todas as linhas e imagens dos produtos.

Obtenha identificadores de estado válidos em /api/v1/order-statuses. O estado do pedido e o estado do pagamento usam endpoints PATCH e permissões separados. Alterar o estado de pagamento registrado não cobra um cartão nem emite um reembolso por um provedor de pagamentos.

Escritas seguras

Permissões e planos

delivery.dates: planned_dispatch_on, dispatch_timezone, estimated_delivery_from, estimated_delivery_to. Datas de envio e entrega: YYYY-MM-DD; null. Fuso horário do envio: IANA.

Pedido · Totais

Os valores e alíquotas vêm do pedido salvo, incluindo correções dos itens. Dados históricos ausentes são null e não são substituídos pelas alíquotas atuais do catálogo. Os valores continuam sendo textos decimais.

  • tax_country_code · País fiscal · Dados salvos do pedido · ISO 3166-1 alpha-2; null.
  • lines[].unit_* · Uma unidade · Antes dos descontos; lines[].original_total_* · Antes dos descontos; lines[].total_* · Após os descontos.
  • lines[].discount_* · Descontos; manual_discount · Desconto manual; percentage "10" = 10%.
  • delivery.net / tax / gross · Após os descontos; delivery.original_* · Antes dos descontos; delivery.discount_* · Descontos.
  • tax_rate: "0.23" = 23%; "0" ≠ null. Desconhecido: null; zero conhecido: 0.
  • totals · Totais; tax_breakdown.groups · Grupos fiscais; Imposto não atribuído = order.tax − Σ groups.tax; ±.

A lista retorna resumos. Obtenha GET /api/v1/orders/{order_id} para cada resultado para exportar o detalhamento financeiro completo. As tentativas GET são limitadas e respeitam Retry-After. A exportação por data de criação não sincroniza correções posteriores.

payment.amount é o total do pedido. O status do pagamento não determina valores pagos, reembolsados ou pendentes.

Esquemas de dados

Guias

Exportar pedidos