店配作業 #

出貨確認 #

進行店配訂單的出貨確認。

Endpoint URL: https://tw.scm.yahooapis.com/scmapi/api/StoreDelivery/ConfirmOrders
HTTP Method: POST

Request Body #

ConfirmOrders #

顯示訂單相關資訊的內容。ConfirmOrders 的結構分別說明如下：

OrderCode：訂單編號
PackageNo：第幾個包裝

資料型態: Array

OrderCode #

訂單編號。
資料型態: String
必填: 是

PackageNo #

第幾個包裝。
資料型態: Integer
必填: 是
說明：
同買家不同訂單編號欲包裝再一起可以使用相同的PackageNo，即會產生同樣的出貨單號，但必須是相同的收件門市。
若設定不同的PackageNo，則會產生不同的出貨單號。

Request/Response Sample #

POST Request

POST /scmapi/api/StoreDelivery/ConfirmOrders

[
  {
    "OrderCode": "RM2407170000460",
    "PackageNo": 1
  },
  {
    "OrderCode": "RM2407160000082",
    "PackageNo": 2
  }
]

POST Response（成功案例）

{
    "ResponseCode": "00000",
    "ResponseMessage": "成功",
    "SuccessfulCount": 2,
    "FailedCount": 0,
    "SuccessfulOrders": [
        {
            "PackageNo": 1,
            "ShipmentNo": "M836000021117",
            "BarCode": "836M836000021117",
            "FirstBarcode": "836M836000021117",
            "RoutingBarcode": "1AA08",
            "PickupEShopBarcode": "836047910",
            "PickupCodBarcode": "0170000910120031",
            "PickupLogisticCode": "183600047017000093",
            "LogisticCode": "18360004701700009",
            "LogisticCheckSum": "3",
            "QrCode": "B1||                  ||         ||                  ||               ||183600047017000093||2||019316||1AA08|| 0||0||836047910||0170000910120031||             ||          ",
            "StoreEquimentId": "0",
            "StoreRegion": "北",
            "StoreRoute": "AA",
            "StoreRouteTrim": "08",
            "ReturnPeriod": "週三",
            "ReturnType": "宅配通",
            "MobilePhone": "333",
            "ConvenienceStoreId": "F55247",
            "ConvenienceStoreName": "光復車站店",
            "OrderInformation": "5041244430050",
            "LogisticOrderNumber": "04701700009",
            "DistributionCenter": "DRE",
            "CustomerInformation": "(02)7723-8585 / tw.buy.yahoo.com",
            "Remark": "請收款結帳",
            "OfficialName": "雅虎購物",
            "ShipDate": "2024-09-12T00:00:00+08:00",
            "OrderCodes": [
                "RM2407170000460"
            ],
            "ChildShopcode": "0050"
        },
        {
            "PackageNo": 2,
            "ShipmentNo": "40001069",
            "BarCode": "833077823A5340001069",
            "ShipDate": "2024-09-12T00:00:00+08:00",
            "OrderCodes": [
                "RM2407160000082"
            ],
            "ChildShopcode": "A53"
        }
    ],
    "FailedOrders": []
}

POST Response（失敗案例）

{
    "ResponseCode": "00001",
    "ResponseMessage": "訂單有錯誤",
    "SuccessfulCount": 0,
    "FailedCount": 1,
    "SuccessfulOrders": [],
    "FailedOrders": [
        {
            "PackageNo": 1,
            "FailedCode": 2131,
            "FailedMessage": "訂單的收件門市資訊不一致",
            "OrderCodes": [
                "RM2407220000203",
                "RM2407170000464"
            ]
        }
    ]
}

Response Elements #

若操作成功，API 會回傳 HTTP 200 response。並以 JSON 格式回傳完整的出貨狀態包含失敗的顯示訊息。

ResponseCode #

回覆出貨狀態代碼。
資料型態: String
說明：

00000：出貨成功
00001：出貨部份失敗，細節請見FailedOrders
99999：出貨失敗，細節請見FailedOrders

ResponseMessage #

回覆出貨狀態成功與否訊息。
資料型態: String
說明：對應ResponseCode

成功
訂單有錯誤
失敗

SuccessfulCount #

成功筆數。
資料型態: Integer

FailedCount #

失敗筆數。
資料型態: Integer

SuccessfulOrders(7-11) #

顯示各訂單的出貨成功的相關資訊

PackageNo：第幾個包裝
ShipmentNo：出貨單號
BarCode：託運單號一維條碼標籤
ShipDate：出貨日期
OrderCodes：訂單編號
ChildShopcode：超商子代碼

資料型態: Array

PackageNo #

第幾個包裝。
資料型態: Integer

ShipmentNo #

出貨單號。
資料型態: String

BarCode #

託運單號一維條碼標籤。
資料型態: String

ShipDate #

出貨日期。
資料型態: dateTime
說明: 時間格式為

yyyy-mm-ddThh:mm:ss
ex. 2024-01-20T00:00:00

OrderCodes #

訂單編號。
資料型態: String Array

ChildShopcode #

超商子代碼。
資料型態: String

SuccessfulOrders(Fami) #

顯示各訂單的出貨成功的相關資訊

PackageNo：第幾個包裝
ShipmentNo：出貨單號
BarCode：託運單號一維條碼標籤
FirstBarcode：一段標（母代碼 + 配送編號）
RoutingBarcode：僅全家物流交寄回覆該欄位資料『理貨條碼(5)』
PickupEShopBarcode：僅全家物流交寄回覆該欄位資料『取貨條碼ㄧ(9)』
PickupCodBarcode：僅全家物流交寄回覆該欄位資料『取貨條碼二(16)』
PickupLogisticCode：僅全家物流交寄回覆該欄位資料『取件物流碼(18)』
LogisticCode：僅全家物流交寄回覆該欄位資料『物流編號(17)』
LogisticCheckSum：僅全家物流交寄回覆該欄位資料『物流檢核碼(1)』
QrCode：僅全家物流交寄回覆該欄位資料『QR Code的內容』
StoreEquimentId：門市設備代碼
StoreRegion：門市區域
StoreRoute：理貨路線
StoreRouteTrim：理貨路順
ReturnPeriod：退貨週期
ReturnType：退貨方式
MobilePhone：取貨人末3碼
ConvenienceStoreId：取貨店號
ConvenienceStoreName：取貨門市
OrderInformation：訂單資料（一起買序號+超商子代碼）
LogisticOrderNumber：日翊訂單編號
DistributionCenter：大物流代碼，固定為DRE
CustomerInformation：客服專線『(02)7723-8585 / tw.buy.yahoo.com』
Remark：收款備註
OfficialName：官網名稱，固定為『雅虎購物』
ShipDate：出貨日期
OrderCodes：訂單編號
ChildShopcode：超商子代碼

資料型態: Array

購物中心新版標籤-對應轉出資訊

圖片連結

PackageNo #

第幾個包裝。
資料型態: Integer

ShipmentNo #

出貨單號。
資料型態: String

BarCode #

託運單號一維條碼標籤。
資料型態: String

FirstBarcode #

一段標:母代碼 + 配送編號。
資料型態: String

RoutingBarcode #

僅全家物流交寄回覆該欄位資料『理貨條碼(5)』。
資料型態: String

PickupEShopBarcode #

僅全家物流交寄回覆該欄位資料『取貨條碼ㄧ(9)』。
資料型態: String

PickupCodBarcode #

僅全家物流交寄回覆該欄位資料『取貨條碼二(16)』。
資料型態: String

PickupLogisticCode #

僅全家物流交寄回覆該欄位資料『取件物流碼(18)』。
資料型態: String

LogisticCode #

僅全家物流交寄回覆該欄位資料『物流編號(17)』。
資料型態: String

LogisticCheckSum #

僅全家物流交寄回覆該欄位資料『物流檢核碼(1)』。
資料型態: String

QrCode #

僅全家物流交寄回覆該欄位資料『QR Code的內容』。
資料型態: String

StoreEquimentId #

門市設備代碼。
資料型態: String

StoreRegion #

門市區域。
資料型態: String

StoreRoute #

理貨路線。
資料型態: String

StoreRouteTrim #

理貨路順。
資料型態: String

ReturnPeriod #

退貨週期。
資料型態: String

ReturnType #

退貨方式。
資料型態: String

MobilePhone #

取貨人末3碼。
資料型態: String

ConvenienceStoreId #

取貨店號。
資料型態: String

ConvenienceStoreName #

取貨門市。
資料型態: String

OrderInformation #

訂單資料(一起買序號+超商子代碼)。
資料型態: String

LogisticOrderNumber #

日翊訂單編號。
資料型態: String

DistributionCenter #

大物流代碼，固定為DRE。
資料型態: String

CustomerInformation #

客服專線:(02)7723-8585 / tw.buy.yahoo.com。
資料型態: String

Remark #

收款備註:『請收款結帳』因為是『取貨付款』要標註為請收款結帳。
資料型態: String

OfficialName #

官網名稱，固定為『雅虎購物』。
資料型態: String

ShipDate #

出貨日期。
資料型態: dateTime
說明: 時間格式為

yyyy-mm-ddThh:mm:ss
ex. 2024-01-20T00:00:00

OrderCodes #

訂單編號。
資料型態: String Array

ChildShopcode #

超商子代碼。
資料型態: String

FailedOrders #

顯示各訂單的出貨失敗的相關資訊

PackageNo：第幾個包裝
FailedCode：錯誤代碼
FailedMessage：錯誤訊息
OrderCodes：訂單編號

資料型態: Array

PackageNo #

第幾個包裝。
資料型態: Integer

FailedCode #

錯誤代碼。
資料型態: Integer
說明：請見FailedCode對應表

FailedMessage #

錯誤訊息。
資料型態: String
說明：請見FailedCode對應表

OrderCodes #

訂單編號。
資料型態: String Array

FailedCode對應表 #

FailedCode	FailedMessage
2121	部分訂單不屬於此交易序號
2122	訂單總金額需大於0
2123	請勿傳入物流服務費
2124	部分訂單已出貨，請再確認
2125	部分訂單已取消，請再確認
2126	無法取得店家超商母/子代碼
2127	無法取得店家資料
2128	部分訂單無法出貨
2129	門市關轉OR店號轉換，請隔日再試行出貨
2130	部分訂單不存在
2131	訂單的收件門市資訊不一致
2132	部分訂單的主配件非SCM
2133	訂單總金額超過限制
2134	部分訂單含有未結案異動單
2135	訂單收件人資訊不一致
2912	其他錯誤