---
updatedAt: 2026-05-27T07:01:03.000Z
agentTools:
projectIndex: https://open-api.docs.shoplineapp.com/llms.txt
---
# Update Delivery Option(Store Pickup)'s Store Information
To update a delivery option(store pickup)'s store information.
更新一個為什門市自取的送貨方式的門市資訊。
# OpenAPI definition
```json
{
"info": {
"title": "SHOPLINE Open API",
"version": "2.348.2",
"description": "Welcome to the shopline open-api developer hub. You'll find comprehensive guides and documentation to help you start working with shopline open-api as quickly as possible, as well as support if you get stuck. Let's jump right in!"
},
"servers": [
{
"url": "https://open.shopline.io/v1",
"description": "Production"
}
],
"openapi": "3.0.0",
"security": [
{
"bearerAuth": []
}
],
"components": {
"securitySchemes": {
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT"
}
},
"schemas": {
"Translatable": {
"type": "object",
"properties": {
"en": {
"type": "string",
"description": "Merchant defined English name
店家定義英文名稱"
},
"zh-hant": {
"type": "string",
"description": "Merchant defined Traditional Chinese name
店家定義繁體中文名稱"
},
"zh-cn": {
"type": "string",
"description": "Merchant defined Simplified Chinese name
店家定義簡體中文名稱"
},
"vi": {
"type": "string",
"description": "Merchant defined Vietnamese name
店家定義越南文名稱"
},
"ms": {
"type": "string",
"description": "Merchant defined Malaysian name
店家定義馬來西亞文名稱"
},
"ja": {
"type": "string",
"description": "Merchant defined Japanese name
店家定義日文名稱"
},
"th": {
"type": "string",
"description": "Merchant defined Thai name
店家定義泰文名稱"
},
"id": {
"type": "string",
"description": "Merchant defined Indian name
店家定義印度文名稱"
},
"de": {
"type": "string",
"description": "Merchant defined Deutsch name
店家定義德文名稱"
},
"fr": {
"type": "string",
"description": "Merchant defined France name
店家定義法文名稱"
}
}
},
"Money": {
"type": "object",
"properties": {
"cents": {
"type": "integer"
},
"currency_symbol": {
"type": "string"
},
"currency_iso": {
"type": "string"
},
"label": {
"type": "string"
},
"dollars": {
"type": "number"
}
},
"example": {
"cents": 999999999,
"currency_symbol": "NT$",
"currency_iso": "TWD",
"label": "NT$999,999,999",
"dollars": 999999999
}
},
"DeliveryOption": {
"type": "object",
"properties": {
"id": {
"description": "Delivery Option ID
送貨方式ID",
"type": "string",
"example": "58d25b6201cda3475300002b"
},
"status": {
"description": "Delivery Option Status
送貨方式狀態
-
Status allows:
active 啟用中
draft 隱藏",
"type": "string",
"enum": [
"active",
"draft"
],
"example": "active"
},
"name_translations": {
"allOf": [
{
"$ref": "#/components/schemas/Translatable"
},
{
"description": "Delivery Option Name
送貨方式名稱",
"example": {
"zh-hant": "面交取貨"
}
}
]
},
"requires_customer_address": {
"type": "boolean",
"description": "Requires Customer Address
需要顧客提供地址"
},
"show_description_on_checkout": {
"type": "boolean",
"description": "Display description on the checkout page
在結帳頁面上顯示送貨方式簡介"
},
"description_translations": {
"allOf": [
{
"$ref": "#/components/schemas/Translatable"
},
{
"description": "Delivery Option Description
送貨方式簡介"
}
]
},
"delivery_time_description_translations": {
"allOf": [
{
"$ref": "#/components/schemas/Translatable"
},
{
"description": "Description of Delivery Time
到貨時間說明"
}
]
},
"fee_type": {
"description": "Fee Type
收費模式
-
Fee type allow:
flat
flat_weight
subtotal
item_count
* sl_logistic ",
"type": "string",
"enum": [
"flat",
"flat_weight",
"subtotal",
"item_count",
"sl_logistic"
],
"example": "flat"
},
"form_fields": {
"description": "",
"type": "array",
"items": {
"type": "object"
}
},
"region_type": {
"description": "Delivery Option Code
送貨方式代碼
store_pickup: 門市自取
custom: 自訂
sfexpress: 順豐速運
tw_711_nopay: 7-11 取貨不付款 (C2C)
tw_711_pay: 7-11 取貨付款 (C2C)
tw_711_b2c_nopay: 7-11 取貨不付款 (B2C)
tw_711_b2c_pay: 7-11 取貨付款 (B2C)
emap_only_711: 7-11 超商取貨 (純地圖)
tw_simple_711: 7-11 取貨 (無串接)
cross_border_711_store_pick_up: 7-11 跨境門市取貨不付款
cross_border_711_home_delivery: 7-11 跨境宅配
tw_simple_familymart: 全家取貨 (無串接)
tw_ezship: ezship 超商取貨付款
711_return_nopay: 7-11 退貨便 (C2B)
tw_fm_b2c_nopay: 全家 取貨不付款 (B2C)
tw_fm_b2c_pay: 全家 取貨付款 (B2C)
tw_fm_c2c_nopay: 全家 取貨不付款 (C2C)
tw_fm_c2c_pay: 全家 取貨付款 (C2C)
emap_only_fm: 全家超商取貨 (純地圖)
hk_sfplus: Zeek斑馬快送
hk_integrated_sfexpress: 順豐速運 (串接)
hk_integrated_sf_pickup: 順豐速運 (串接)
hk_pakpobox: Alfred 智能櫃
tw_tcat_roomtemp: 黑貓宅配 - 常溫
tw_tcat_roomtemp_cod: 黑貓宅配 - 常溫 (貨到付款)
tw_tcat_refrigerated: 黑貓宅配 - 冷藏
tw_tcat_refrigerated_cod: 黑貓宅配 - 冷藏 (貨到付款)
tw_tcat_frozen: 黑貓宅配 - 冷凍
tw_tcat_frozen_cod: 黑貓宅配 - 冷凍 (貨到付款)
custom_return: 自訂退貨
ninja_van: Ninja Van - 需取件
sl_logistics_fmt_freeze_pay: 全家 冷凍取貨付款 (B2C)
sl_logistics_fmt_freeze_nopay: 全家 冷凍取貨不付款 (B2C)
sl_logistics_ninjavan: Ninja Van (經由 SL logistics)
sl_logistics_ninjavan_cod: Ninja Van 貨到付款 (經由 SL logistics)
sl_logistics_kerry_th_nd: Kerry ND（經由 SL logistics）
sl_logistics_kerry_th_nd_cod: Kerry ND 貨到付款（經由 SL logistics）
sl_logistics_kerry_th_2d: Kerry 宅配（標準）
sl_logistics_kerry_th_2d_cod: Kerry 宅配 - 貨到付款（標準）
sl_logistics_kerry_th_3d: Kerry 3D（經由 SL logistics）
sl_logistics_kerry_th_3d_cod: Kerry 3D 貨到付款（經由 SL logistics）
sl_logistics_yto_home: 中國 - 台灣物流專線宅配（標準 - 普貨）
sl_logistics_yto_home_cod: 中國 - 台灣物流專線宅配- 貨到付款（標準 - 普貨）
sl_logistics_yto_store: 中國 - 台灣物流專線超取 - 取貨不付款（標準 - 普貨）
sl_logistics_yto_store_cod: 中國 - 台灣物流專線超取 - 取貨付款（標準 - 普貨）
sl_logistics_yto_special_home: 中國 - 台灣物流專線宅配（標準 - 特貨）
sl_logistics_yto_special_home_cod: 中國 - 台灣物流專線宅配- 貨到付款（標準 - 特貨）
sl_logistics_yto_special_store: 中國 - 台灣物流專線超取 - 取貨不付款（標準 - 特貨）
sl_logistics_yto_special_store_cod: 中國 - 台灣物流專線超取 - 取貨付款（標準 - 特貨）
",
"type": "string",
"example": "custom"
},
"delivery_type": {
"type": "string",
"example": "custom"
},
"excluded_payment_ids": {
"description": "Excluded Payment Method IDs
該送貨方式排除的付款方式ID",
"type": "array",
"items": {
"type": "string"
},
"example": [
"5de88dbdce10df002ad927e0"
]
},
"config_data": {
"description": "Configuration Data
物流設置資訊",
"type": "object",
"properties": {
"support_cod": {
"type": "boolean",
"description": "Support Cash on Delivery (COD)
支持代收貨款 (COD)",
"example": false
},
"lead_time": {
"type": "integer",
"maximum": 30,
"description": "Lead Time (no more than 30 days)
預估備貨天數（最多30天）"
},
"max_lead_time": {
"type": "integer",
"minimum": 1,
"description": "Selectable day length (from lead time)
備貨期後可指定的天數長度"
},
"excluded_weekdays": {
"type": "array",
"description": "Sunday=0; Monday=1",
"items": {
"type": "integer",
"enum": [
0,
1,
2,
3,
4,
5,
6
]
}
},
"excluded_dates": {
"type": "array",
"items": {
"type": "string"
},
"example": [
"2021/01/31"
]
},
"delivery_time_required": {
"type": "boolean",
"description": "Specified Timeslot (Enabled: Customers can set up estimated delivery arrival time in case no receiver at home.)
出貨訂單需指定時段 (啟用功能：可以設定商品到貨的時間，避免無人收貨的情況。)"
},
"specific_delivery_time_translations": {
"allOf": [
{
"$ref": "#/components/schemas/Translatable"
},
{
"description": "Specified Timeslot Name
出貨訂單指定時段名稱",
"example": {
"en": "09:00AM - 12:00 PM",
"zh-hant": "上午09:00 - 下午12:00"
}
}
]
},
"delivery_target_area": {
"type": "string",
"description": "For Taiwan only. You can set whether Main area or Outlying Island delivery service
台灣地區可進階設定本島/外島的配送區域
localOnly: Main Area delivery service 提供本島配送
outlyingIslandOnly: Outlying Island delivery service 提供外島配送
all: all of the above 以上皆是
",
"enum": [
"localOnly",
"outlyingIslandOnly",
"all"
]
}
}
},
"supported_countries": {
"description": "Supported Countries
可支援配送區域",
"type": "array",
"items": {
"type": "string"
},
"example": [
"TW"
]
},
"delivery_rates": {
"description": "Delivery Fee
運費",
"type": "array",
"items": {
"type": "object",
"properties": {
"countries": {
"type": "array",
"items": {
"type": "string",
"example": [
"CN",
"HK"
]
},
"description": "Shipping Countries/ Regions
配送國家／地區
* means rest of the world 所有未被選取的國家／地區"
},
"rate_limit": {
"description": "weight(kg). -1 for infinity. Please supply -1 if delivery_type = flat.
重量(kg)。-1 代表無限。如 fee_type 為 flat ，請輸入 -1。"
},
"fee": {
"allOf": [
{
"$ref": "#/components/schemas/Money"
},
{
"description": "Customer Orders Total Sum
運費"
}
]
}
}
},
"example": [
{
"countries": [
"CN",
"HK"
],
"rate_limit": -1,
"fee": {
"cents": 0,
"currency_symbol": "HK$",
"currency_iso": "HKD",
"label": "",
"dollars": 0
}
}
]
},
"approved": {
"description": "true 設定且已審核
false 未設定或未審核通過",
"type": "boolean",
"example": "true/false"
},
"support_cod": {
"description": "Support COD payment
支援 COD 付款
allows:
true 設定且已審核
false 未設定或未審核通過",
"type": "boolean",
"example": "true/false"
},
"support_non_cod": {
"description": "Support non COD payment
支援 非 COD 付款
allows:
true 設定且已審核
false 未設定或未審核通過",
"type": "boolean",
"example": "true/false"
},
"store_pickup_option": {
"description": "For delivery option type as store_pickup, it shows the information of the stores.
物流類別為門市自取的送貨方式可用，顯示門市資訊。",
"type": "object",
"example": {
"config_option": {
"dropdown_fields_v2": {
"en": [
{
"field": "level_1",
"label": "City"
},
{
"field": "level_2",
"label": "Region"
},
{
"field": "level_3",
"label": "Street"
}
],
"zh-hant": [
{
"field": "level_1",
"label": "城市"
},
{
"field": "level_2",
"label": "地區"
},
{
"field": "level_3",
"label": "街道"
}
]
},
"level_fields": [
"level_1",
"level_2",
"level_3"
]
},
"addresses": [
{
"name_translations": {
"en": "Hong Kong",
"zh-hant": "香港"
},
"level": "level_1",
"next_level": [
{
"name_translations": {
"en": "Hong Kong Island",
"zh-hant": "香港島"
},
"level": "level_2",
"next_level": [
{
"name_translations": {
"en": "Sheung Wan",
"zh-hant": "上環"
},
"level": "level_3",
"next_level": [
{
"level": "store",
"store_name": {
"en": "SHOPLINE",
"zh-hant": "商線"
},
"store_address": {
"en": "21F, 148 Wing Lok St, Sheung Wan",
"zh-hant": "上環永樂街148號21樓"
},
"instruction": {
"en": "Business hours：Monday to Friday 10AM to 7PM",
"zh-hant": "營業時間：週一至週五 10AM-7PM"
}
}
]
}
]
}
]
}
]
}
},
"is_return": {
"description": "Is It Return Delivery
是否為退貨",
"type": "boolean",
"example": "true/false"
}
}
}
}
},
"paths": {
"/delivery_options/{id}/stores_info": {
"put": {
"summary": "Update Delivery Option(Store Pickup)'s Store Information",
"description": "To update a delivery option(store pickup)'s store information.
更新一個為什門市自取的送貨方式的門市資訊。",
"parameters": [
{
"name": "id",
"description": "Delivery Option ID
物流方式ID",
"in": "path",
"required": true,
"schema": {
"type": "string"
},
"example": "58d25b9d01cda3475300002d"
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"store_pickup_option": {
"type": "object",
"properties": {
"config_fields": {
"type": "object",
"additionalProperties": {
"description": "-> 須填入該Merchant支援的語言
en=英文 zh-hant=繁體中文 ja=日文
id=印度文 ms=馬來西亞文 zh-cn=簡體中文
fr=法文 de=德文 th=泰文
vi=越南文",
"type": "object"
},
"example": {
"en": [
{
"level_1": "City",
"level_2": "Region",
"level_3": "Street"
}
],
"zh-hant": [
{
"level_1": "城市",
"level_2": "地區",
"level_3": "街道"
}
]
}
}
}
},
"addresses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"level_1_translations": {
"allOf": [
{
"$ref": "#/components/schemas/Translatable"
},
{
"description": "Merchant defined English name for the first level of the address
出貨訂單指定時段名稱",
"example": {
"en": "Hong Kong",
"zh-hant": "香港"
}
}
]
},
"level_2_translations": {
"allOf": [
{
"$ref": "#/components/schemas/Translatable"
},
{
"description": "Merchant defined English name for the first level of the address
出貨訂單指定時段名稱",
"example": {
"en": "Hong Kong Island",
"zh-hant": "香港島"
}
}
]
},
"level_3_translations": {
"allOf": [
{
"$ref": "#/components/schemas/Translatable"
},
{
"description": "Merchant defined English name for the first level of the address
出貨訂單指定時段名稱",
"example": {
"en": "Sheung Wan",
"zh-hant": "上環"
}
}
]
},
"store_name_translations": {
"allOf": [
{
"$ref": "#/components/schemas/Translatable"
},
{
"description": "Merchant defined English name for the first level of the address
出貨訂單指定時段名稱",
"example": {
"en": "SHOPLINE",
"zh-hant": "商線"
}
}
]
},
"store_address_translations": {
"allOf": [
{
"$ref": "#/components/schemas/Translatable"
},
{
"description": "Merchant defined English name for the first level of the address
出貨訂單指定時段名稱",
"example": {
"en": "21F, 148 Wing Lok St, Sheung Wan",
"zh-hant": "上環永樂街148號21樓"
}
}
]
},
"instruction_translations": {
"allOf": [
{
"$ref": "#/components/schemas/Translatable"
},
{
"description": "Merchant defined English name for the first level of the address
出貨訂單指定時段名稱",
"example": {
"en": "Business hours：Monday to Friday 10AM to 7PM",
"zh-hant": "營業時間：週一至週五 10AM-7PM"
}
}
]
}
}
}
}
}
}
}
}
},
"tags": [
"Delivery Options"
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"delivery_option": {
"$ref": "#/components/schemas/DeliveryOption"
},
"errors": {
"type": "array",
"items": {
"type": "string",
"example": "addresses[440].instruction_translations is unmatch with merchant's supported languages [\\\"en\\\", \\\"zh-hant\\\"]"
}
}
}
}
}
}
},
"422": {
"description": "Unprocessable Entity",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "Unable to process the changes [\\\"store_pickup_option.addresses[0].level_1_translations\\\" is required]"
}
}
}
}
}
}
}
}
}
},
"tags": [
{
"name": "Delivery Options",
"description": "Operations about delivery options"
}
]
}
```