Skip to content

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

Description

@nVuln

New Shopee's Openapi Announcement (ID: 1564)

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).

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.
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:

Campo: **can_full_cancel_order ** Descrição: Indica se o pedido pode ser cancelado integralmente.Campo: **can_partial_cancel_order **Descrição: Indica se o pedido pode ser parcialmente cancelado.Campo: **buyer_preference_for_partial_cancellation **Descrição: 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
    **
    ****2. 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.

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

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/1564


@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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions