[IMPORTANTE] Order Throttling: Como identificar pedido temporariamente pendente

Olá desenvolvedores,

Durante períodos de alta demanda, como grandes campanhas, alguns pedidos pagos podem permanecer temporariamente pendentes devido ao Order Throttling. Esse é um comportamento esperado da plataforma para otimizar o processamento dos pedidos.

Após esse período, o Ship By Date (ship_by_date), retornado pela API get_order_detail, será calculado automaticamente e o pedido seguirá seu processamento normal.

Para ajudar na identificação desses pedidos, recomendamos as seguintes opções:

Opção 1 – Verificar ship_by_date e logistics_status

Utilize a API get_order_detail e verifique os seguintes campos:

1 - ship_by_date = null

2 - logistics_status = LOGISTICS_NOT_START

Quando ambos os parâmetros forem retornados com esses valores, o pedido pode estar temporariamente em Order Throttling.

Opção 2 – Consultar pending_terms

A API get_order_detail também retorna o campo pending_terms.

Quando o valor ARRANGE_SHIPMENT_PENDING for retornado, significa que o pedido estar temporariamente em Order Throttling

Opção 3 – Monitorar os Push Mechanisms (Webhooks)

Monitore os seguintes Push Mechanisms:

1 - order_status_push

2- package_fulfillment_status_push

Caso o pedido já tenha recebido o Order Status = READY_TO_SHIP, mas o Package Fulfillment Status Push (com logistics_status = LOGISTIC_READY) ainda não tenha sido enviado, o pedido pode estar temporariamente em Order Throttling.

Os sellers não precisam realizar nenhuma ação nem se preocupar com esses pedidos. O Order Throttling não afeta as vendas do seller nem o prazo de envio.

Estamos avaliando melhorias para oferecer uma forma ainda mais simples e direta de identificar esse cenário no futuro.

Agradecemos a compreensão,

Shopee Open Platform