来自 Shopee 官方资料快照 ·
- 当前资料结构化阅读页
- 固定快照已留存，可追溯
- 官方原文可核对
资料正文
§1 [IMPORTANTE] Nova Funcionalidade de Cancelamento Parcial de Pedidos via Open API
Olá desenvolvedores,
Gostaríamos de anunciar uma atualização no fluxo de cancelamento de pedidos na Shopee Open Platform com a introdução do Cancelamento Parcial de Pedidos (Partial Cancellation) a partir de 28/09.
Com essa atualização, sellers poderão cancelar itens ou quantidades específicas de um pedido elegível devido a Out of Stock (OOS), enquanto os demais itens continuam normalmente no processo de envio. O Partial Cancellation é aplicável apenas ao motivo de cancelamento Out of Stock (OOS).
§2 Cancelamento Parcial de Pedidos
Cancelamento Parcial de Pedidos
Para pedidos elegíveis, o seller poderá selecionar os itens ou quantidades que estão Out of Stock para cancelamento. A operação será realizada em nível de item, modelo e quantidade, permitindo que somente os itens indisponíveis sejam cancelados. A disponibilidade da funcionalidade dependerá das regras de elegibilidade e configurações aplicáveis a cada canal. No Brasil, a solução só estará disponível para canais Turbo.
§3 Atualizações na Open API
Atualizações na Open API
Para suportar o novo fluxo, as seguintes APIs foram atualizadas:
- v2.order.get_order_detail
Passa a disponibilizar informações sobre a elegibilidade para cancelamento parcial do pedido, a preferência do comprador para itens indisponíveis e as quantidades ativas, canceladas ou em processo de cancelamento/Return/Refund. Foram adicionados os novos campos:
| Nome do campo | Descrição |
|---|---|
| can_full_cancel_order | Indica se o pedido pode ser cancelado integralmente. |
| can_partial_cancel_order | Indica se o pedido pode ser parcialmente cancelado. |
| buyer_preference_for_partial_cancellation | Indica a preferência do comprador para tratamento de itens OOS. |
Além disso, outros novos parâmetros foram adicionados para fornecer informações mais detalhadas sobre as quantidades de cada item_list: - active_qty
- cancel_request_qty
- cancelled_qty
- return_request_qty
- returned_qty
- v2.order.get_package_detail
Passa a disponibilizar também os campos: can_full_cancel_order, can_partial_cancel_order e buyer_preference_for_partial_cancellation.
- v2.order.cancel_order
Passa a suportar o cancelamento parcial de itens e quantidades específicas por meio de partial_cancel_item_list.
- v2.order.get_estimate_cancel_value
Nova API para consultar o valor estimado do cancelamento parcial antes da execução do cancelamento.
Para a descrição completa e especificação de cada parâmetro, consulte as documentações abaixo: API's relacionadas: - v2.order.get_order_detail
- v2.order.get_estimate_cancel_value
Em caso de dúvidas técnicas, acione nossa equipe por meio da Plataforma de Tickets da Open Platform.
Atenciosamente,
Shopee Open Platform Team