[IMPORTANTE] Nova Funcionalidade de Cancelamento Parcial de Pedidos via Open API [Shopee-ID:1603] #74

New Shopee's Openapi Announcement (ID: 1603)

Olá desenvolvedores,
Esse anúncio é uma atualização do anúncio desse link. Por favor, considerar informações desse anúncio atual como oficiais. 

Gostaríamos de reforçar uma atualização no fluxo de cancelamento de pedidos na Shopee Open Platform com a introdução do Cancelamento Parcial de Pedidos TURBO (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).

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 Logística Integrada.**
Atualizações na Open API
Para suportar o novo fluxo, as seguintes APIs foram atualizadas:

1. v2.order.get_order_detailPassa 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:

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_requested_qty- cancelled_qty- return_requested_qty- returned_qty

2. v2.order.get_package_detailPassa a disponibilizar também os campos: can_full_cancel_order, can_partial_cancel_order e  buyer_preference_for_partial_cancellation.

3. v2.order.cancel_orderPassa a suportar o cancelamento parcial de itens e quantidades específicas por meio de partial_cancel_item_list.

4. v2.order.get_estimate_cancel_valueNova 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_package_detail- v2.order.cancel_order- v2.order.get_estimate_cancel_value
FAQ com dúvidas de parceiros : https://docs.google.com/document/d/1zMZeYGQdZ3XehGAu0PF9J9wHjA0Ac-52/edit?usp=sharing&ouid=106903337167965073020&rtpof=true&sd=true
Em caso de dúvidas técnicas, acione nossa equipe por meio da Plataforma de Tickets da Open Platform.
Atenciosamente,Shopee Open Platform Team

Announcement URL: https://open.shopee.com/announcements/1603

@junie-agent Please review the API changes described above. Focus ONLY on major updates such as adding new endpoints or removing/taking legacy APIs offline. You can safely ignore any other changes regarding request/response parameters or fields. Update the PHP code and create a new PR for review. Close issue if nothing changes applied.