三方作業 #

分包出貨-包裝確認 #

• 針對同一收件人&收件地址因為超材，無法在同一個包裝單序號使用。
• 該API與既有的三方物流Gorup不同，請務必確認:ThirdPartyLogistics。
• 由response可以得到單一商品對應的單號:OrderSubCode":"RS2203240006792"。

Endpoint URL: https://tw.scm.yahooapis.com/scmapi/api/ThirdPartyLogistics/ConfirmPacked
HTTP Method: POST

Request Body #

OrdersToPack #

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

• OrderCode：訂單編號
• OrderSubCode：訂購子單編號
• PackageNo：第幾個包裝
• DeliveryType：物流方式

資料型態: Object Array

OrderCode #

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

OrderSubCode #

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

PackageNo #

第幾個包裝。
資料型態: Integer
必填: 是
說明：
同買家不同訂單編號欲包裝再一起可以使用相同的PackageNo，即會產生同樣的出貨單號。
若設定不同的PackageNo，則會產生不同的出貨單號。
如果訂購子單編號需要分開包裝，可以設定不同的PackageNo即產生不同的出貨單號。
但分開包裝時，DeliveryType必須為相同否則無法產生貨運單。

DeliveryType #

物流方式。
資料型態: Integer
必填: 是
說明：

• DeliveryType= 1『宅配』
• DeliveryType= 2『小包』
• DeliveryType= 3『大型商品』

Request/Response Sample #

{
  "OrdersToPack": [
    {
      "OrderCode": "RM2406040002256",
      "OrderSubCode": "RS2406040005665",
      "PackageNo": 1,
      "DeliveryType": 1
    },
    {
      "OrderCode": "RM2406040002256",
      "OrderSubCode": "RS2406040005666",
      "PackageNo": 1,
      "DeliveryType": 1
    },
    {
      "OrderCode": "RM2406040002256",
      "OrderSubCode": "RS2406040005667",
      "PackageNo": 2,
      "DeliveryType": 1
    },
    {
      "OrderCode": "RM2406040002258",
      "OrderSubCode": "RS2406040005669",
      "PackageNo": 1,
      "DeliveryType": 1
    }
  ]
}

{
    "ResponseCode": "00000",
    "ResponseMessage": "成功",
    "PackResults": [
        {
            "PackageNo": 1,
            "PackageSerialNo": 21491,
            "ShipmentNo": "1000004073",
            "BarCode": "1000004073",
            "Code2": " 11",
            "Code3": "",
            "Code4": "",
            "Code5": "",
            "QRCode": "^011000000^",
            "MDCode1": "",
            "MDCode2": "",
            "MDCode3": "",
            "TransporterId": 4,
            "LocationOfficeId": " 11",
            "LocationOfficeName": "",
            "Orders": [
                "RM2406040002256",
                "RM2406040002258"
            ],
            "OrderSubCodes": [
                "RS2406040005665",
                "RS2406040005666",
                "RS2406040005669"
            ],
            "IsSuccess": true,
            "FailureType": 0,
            "FailureMessage": "成功"
        },
        {
            "PackageNo": 2,
            "PackageSerialNo": 21492,
            "ShipmentNo": "1000004084",
            "BarCode": "1000004084",
            "Code2": " 11",
            "Code3": "",
            "Code4": "",
            "Code5": "",
            "QRCode": "^011000000^",
            "MDCode1": "",
            "MDCode2": "",
            "MDCode3": "",
            "TransporterId": 4,
            "LocationOfficeId": " 11",
            "LocationOfficeName": "",
            "Orders": [
                "RM2406040002256"
            ],
            "OrderSubCodes": [
                "RS2406040005667"
            ],
            "IsSuccess": true,
            "FailureType": 0,
            "FailureMessage": "成功"
        }
    ],
    "PackedSuccessCount": 2,
    "PackedFailureCount": 0
}

Response Elements #

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

ResponseCode #

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

• 00000：出貨成功
• 00001：出貨部份失敗，細節請見FailureType對應表
• 99999：出貨失敗，細節請見FailureType對應表

ResponseMessage #

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

• 成功
• 訂單有錯誤
• 失敗

PackResults #

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

• PackageNo：第幾個包裝
• PackageSerialNo：包裝序號
• ShipmentNo：託運單號
• BarCode：託運單號一維條碼標籤
• Code2：到著碼到著簡碼（新竹物流專用）
• Code3：到著碼衛星區（新竹物流專用）
• Code4：到著碼註區（新竹物流專用）
• Code5：到著碼疊區（新竹物流專用）
• QRCode：QR Code集貨註區（新竹物流專用）
• MDCode1：MD到著碼衛星區（新竹物流專用）
• MDCode2：MD到著碼註區（新竹物流專用）
• MDCode3：MD到著碼疊區（新竹物流專用）
• TransporterId：貨運商代碼
• LocationOfficeId：到貨區碼
• LocationOfficeName：到貨區碼名稱
• Orders：訂單編號
• OrderSubCodes：訂購子單編號
• IsSuccess：是否成功包裝
• FailureType：錯誤類型
• FailureMessage：錯誤訊息

資料型態: Object Array

各物流商標籤範例 #

• 2023新竹物流-三方物流新版標籤格式
• 台灣宅配通-三方物流貨運單格式
• 黑貓(統一宅急便)-三方物流貨運單格式

PackageNo #

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

PackageSerialNo #

包裝序號。
資料型態: Integer

ShipmentNo #

託運單號。
資料型態: String

BarCode #

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

Code2 #

到著碼到著簡碼（新竹物流專用）。
資料型態: String
說明：此為新竹物流專用條碼，非新竹物流會顯示空值。

Code3 #

到著碼衛星區（新竹物流專用）。
資料型態: String
說明：此為新竹物流專用條碼，非新竹物流會顯示空值。

Code4 #

到著碼註區（新竹物流專用）。
資料型態: String
說明：此為新竹物流專用條碼，非新竹物流會顯示空值。

Code5 #

到著碼疊區（新竹物流專用）。
資料型態: String
說明：此為新竹物流專用條碼，非新竹物流會顯示空值。

QRCode #

QR Code集貨註區（新竹物流專用）。
資料型態: String
說明：此為新竹物流專用條碼，非新竹物流會顯示空值。

MDCode1 #

MD到著碼衛星區（新竹物流專用）。
資料型態: String
說明：此為新竹物流專用欄位，非新竹物流會顯示空值。

MDCode2 #

MD到著碼註區（新竹物流專用）。
資料型態: String
說明：此為新竹物流專用欄位，非新竹物流會顯示空值。

MDCode3 #

MD到著碼疊區（新竹物流專用）。
資料型態: String
說明：此為新竹物流專用欄位，非新竹物流會顯示空值。

TransporterId #

貨運商代碼。
資料型態: Integer
說明：此為物流商代碼，會對應出貨物流商查詢的ShipperId欄位。

LocationOfficeId #

到貨區碼。
資料型態: String
說明：此為新竹物流專用欄位，非新竹物流會顯示0或空值。

LocationOfficeName #

到貨區碼名稱。
資料型態: String
說明：此為新竹物流專用欄位，非新竹物流會顯示空值。

Orders #

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

OrderSubCodes #

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

IsSuccess #

是否成功包裝。
資料型態: Boolean

FailureType #

錯誤類型。
資料型態: Integer
說明：請見FailureType對應表

FailureMessage #

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

PackedSuccessCount #

包裝成功筆數。
資料型態: Integer

PackedFailureCount #

包裝失敗筆數。
資料型態: Integer

FailureType對應表 #