[TW] Significant updates on "sender_real_name" field usage for order shipments

[TW] Significant updates on "sender_real_name" field usage for order shipments

Dear Developer,

This announcement is to inform you of an upcoming update to the order shipment process regarding the “sender_real_name” field.

Scope of Impact

● TW local sellers

● C2C orders for the following logistic channel

○ 30005 (7-11)

○ 30015 (蝦皮店到店)

○ 30017 (店到家宅配 - 標準包裹)

○ 30019 (蝦皮店到店 - 隔日到貨)

○ 30029 (蝦皮店到店 - 無包裝隔日到)

○ 30030 (店到家宅配 - 大型包裹)

Summary of Changes

To simplify the shipping process, the "Sender Real Name" will now be automatically retrieved from the seller's "Default Return Store Setting Data". Manual input during the shipment API call will no longer be required.

● The following APIs will stop returning “sender_real_name” within the “dropoff” object:

○ v2.logistics.get_shipping_parameter

○ v2.logistics.get_mass_shipping_parameter

Response example after effective date

{
    "error": "",
    "message": "",
    "response": {
        "info_needed": {
            "dropoff": []
        },
        "dropoff": {
            "branch_list": null
        }
    },
    "request_id": "e3e3e7f3449e7897aca1e0b268995e01:01000306d0b99c9a:000000ee0d052250"
}

● You no longer need to include “sender_real_name” field when calling following APIs:

○ v2.logistics.ship_order

○ v2.logistics.mass_ship_order

Request example after effective date

{
    "order_sn": "260301QQY0WASP",
    "dropoff": {}
}

Effective date

Note: To ensure system stability, this update will be gradually rolled out at the shop level. Please make sure to call the “v2.logistics.get_shipping_parameter” or “v2.logistics.get_mass_shipping_parameter” API for each order to obtain the “info_needed” field information. The rollout timeline details are as follows:

● April 13-19, 2026：Gradual Rollout Period

● April 20, 2026：Full Release

開發者您好，

此公告旨在通知您，關於訂單出貨流程中 “sender_real_name” 欄位的 API 呼叫邏輯將進行異動。

影響範圍

● TW local 賣家

● 以下物流選項的門市交寄類型訂單

○ 30005 (7-11)

○ 30015 (蝦皮店到店)

○ 30017 (店到家宅配 - 標準包裹)

○ 30019 (蝦皮店到店 - 隔日到貨)

○ 30029 (蝦皮店到店 - 無包裝隔日到)

○ 30030 (店到家宅配 - 大型包裹)

變更重點摘要

為簡化出貨流程，本次系統更新後，上述物流渠道訂單的「賣家真實姓名」將改為自動抓取賣家後台的「預設退貨門市設定資料」。開發者在呼叫出貨 API 時，無需再手動輸入此欄位。

● 以下 API 的 Response 中，”dropoff” 類型將不再返回 “sender_real_name” 參數：

○ v2.logistics.get_shipping_parameter

○ v2.logistics.get_mass_shipping_parameter

變更後的 Response 範例

{
    "error": "",
    "message": "",
    "response": {
        "info_needed": {
            "dropoff": []
        },
        "dropoff": {
            "branch_list": null
        }
    },
    "request_id": "e3e3e7f3449e7897aca1e0b268995e01:01000306d0b99c9a:000000ee0d052250"
}

● 在呼叫以下 API 時，您不再需要於 Request 中使用 “sender_real_name” 參數：

○ v2.logistics.ship_order

○ v2.logistics.mass_ship_order

變更後的 Request 範例

{
    "order_sn": "260301QQY0WASP",
    "dropoff": {}
}

生效日期

請注意：為確保系統穩定性，本次更新將以賣場維度採用灰度上線，請確保您針對每個訂單呼叫 “v2.logistics.get_shipping_parameter” 或 “v2.logistics.get_mass_shipping_parameter” API 以取得 “info_needed" 欄位資訊，以下為上線時間細節：

● 2026 年 04 月 13 日 到 19 日：灰度上線期間

● 2026 年 04 月 20 日：全量上線