[Importante] Atualizações na Open API

资料正文

§1 [Importante] Atualizações na Open API

Olá Desenvolvedor,

Por favor, confira as mudanças que foram realizadas na Open API já em produção desde 06 de fevereiro de 2026:

§2 1. Adição das métricas "Saturday Shipment” e “Preparation Time PS”.

1. Adição das métricas "Saturday Shipment” e “Preparation Time PS”.

Para melhorar a experiência de compra em nossa plataforma e garantir uma maior agilidade na entrega com menor sobrecarga logística após os finais de semana, a Shopee encoraja seus Vendedores Indicados a oferecerem a opção de envio aos sábados e incluiu a métrica de Saturday Shipment como um importante critério de avaliação para a categoria.

Além disso, os Vendedores Indicados brasileiros também passam a contar com um indicador próprio de tempo de preparação de pacotes que reflete as lógicas locais, o “Preparation Time PS" (enquanto outros países mantém a métrica existente "Preparation Time")

Caso seus vendedores tenham dúvidas sobre as diferenças entre as métricas locais e globais, por favor os direcionem para o Suporte ao Vendedor Shopee para maiores detalhes.

As seguintes alterações foram realizadas para suportar as mudanças acima descritas:

a. O parâmetro de resposta para v2.account_health.get_shop_performance foi atualizado para incluir 2032: Saturday Shipment e 2033: Preparation Time PS:

Métrica	metric_id	metric_name	partner_metric_id
Saturday Shipment	2032	saturday_shipment_rate	0
Preparation Time PS	2033	preparation_time_ps	0

b. O parâmetro de requisição para v2.account_health.get_metric_source_detail passou a incluir os metric_id 2032: Saturday Shipment e 2033: Preparation Time PS.

i. Chamadas com metric_id 2032: Saturday Shipment inclui um novo parâmetro de resposta “saturday_shipment_list” para detalhes de pedidos enviados aos sábados.

ii. Chamadas com metric_id 2033: Preparation Time PS manterão o parâmetro de resposta original apt_order_list com as mesmas configurações.

Nome	Tipo	Descrição
saturday_shipment_list	object[]	Affected Parcels for Saturday Shipment Supported metric_id: 2032: Saturday Shipment
order_sn	string	Order SN
order_create_time	timestamp	Order Paid Time
arrange_pick_up_time	timestamp	Seller arrange pick up time
actual_pick_up_time	timestamp	Courier actual pick up time
preparation_days	float	Preparation Days
shipping_channel	string	Logistics Company
first_mile_type	string	First mile shipping type. Applicable values: Pickup Drop off
first_mile_tracking_no	string	First Mile Tracking Number

APIs relacionadas:

v2.account_health.get_shop_performance v2.account_health.get_metric_source_detail

§3 2. Apenas BR: Payment API - Novo campo “discount_pix”

2. Apenas BR: Payment API - Novo campo “discount_pix”

Para aumentar nossa competitividade e prover uma experiência de compra consistente, a Shopee agora exibe os descontos oferecidos por pagamentos com PIX por toda a Jornada do Usuário, um novo campo “discount_pix” foi incluído nas APIs relacionadas a pagamentos.

New Response Field	Description
order_income > buyer_payment_info > discount_pix	The discount provided via PIX. (Applicable only for the BR region)

APIs relacionadas：

v2.payment.get_escrow_detail

v2.payment.get_escrow_detail_batch