快工助手跨境电商知识与商机助手

[IMPORTANTE] Validação do Endereço de Coleta

Shopee 官方资料 · Shopee Open Platform 变更通知(Announcements) · 适合开发者

stable本次发布有变化全部展示

来自 Shopee 官方资料快照 ·

打开官方原文 ↗
  1. 当前资料结构化阅读页
  2. 固定快照已留存,可追溯
  3. 官方原文可核对
查看技术与溯源信息
平台 / profile
Shopee / profile.shopee.announcements
语言
pt-BR
发布版本
cn-20260909-2
标签
zhuge/sourceplatform/shopeeaudience/developercategory/announcementtopic/apitopic/brazil-openapi-updatestopic/changelogtopic/developer

资料正文

§1 [IMPORTANTE] Validação do Endereço de Coleta

Olá desenvolvedor,

Temos registrado um aumento nos casos de organização de envio em que o endereço do vendedor enviado não é registrado como endereço de coleta. Gostaríamos de relembrar o fluxo correto para as operações de fluxo logístico para organização de envio onde há a coleta de itens (pickup): 1. A Shopee habilita os canais de envio possíveis para o vendedor

  1. Para verificar o canal logístico habilitado em cada loja basta chamar o endpoint v2.logistics.get_channel_list

  2. O vendedor deve definir o canal logístico para cada item de acordo com o que foi liberado para ele pela Shopee

A) Para habilitar/desabilitar os canais de envio do produto: v2.product.add_item ou v2.product.update_item usando os parâmetros dentro de logistic_info

  1. O vendedor recebe o pedido já com o canal de envio selecionado pelo comprador.

  2. Para saber se é preciso informar a NF-e para um pedido antes de fazer a organização de envio (ship_order), você pode usar a chamada v2.order.get_order_list com o param "order_status": "INVOICE_PENDING"

A) Para informar a NF-e use a chamada v2.order.add_invoice_data

B) Para conferir os dados da NF-e que já foram enviados: v2.order.get_order_detail com o param "response_optional_fields": "invoice_data" e verificar o parâmetro "invoice_data"

C) Nos casos em que for necessário, a NF-e deve ser informada antes da chamada v2.logistics.ship_order

  1. Dependendo do canal de envio selecionado pelo comprador, o vendedor irá postar o pacote ou esperar a coleta. Para saber se é coleta (pickup) ou postagem (dropoff) utilize o endpoint v2.logistics.get_shipping_parameter:

A) Caso o info_needed for vazio, o pedido será postagem ("dropoff": []) e a organização de envio deve ser realizada apenas com o order_sn:

Ex: {

"order_sn":"XXXXXXXXXXXXX",

"dropoff":{

}

B) Caso o info_needed contenha "pickup": ["address_id","pickup_time_id"], é uma coleta e será necessário informar um address_id onde o campo address_flag contenha o marcador pickup_address e um pickup_time_id das listas fornecidas pelo endpoint v2.logistics.get_shipping_parameter

Ex: {

"order_sn":"XXXXXXXXXXXXX",

"pickup":{

"address_id": ##########,

"pickup_time_id": ##########

}

  1. Depois disso, para obter o código de rastreio basta chamar o endpoint: v2.logistics.get_tracking_number;

Caso ainda tenha dúvidas, estamos disponíveis via Plataforma de Tickets.

Atenciosamente,

#