退貨單確認

三方作業 #

退貨單確認 #

進行三方訂單的退貨單確認。

Endpoint URL: https://tw.scm.yahooapis.com/scmapi/api/ThirdPartyDelivery/ConfirmReturnOrders
HTTP Method: POST

Request Body #

ReturnCodes #

退貨單號。
資料型態: String Array
必填: 是

Request/Response Sample #

POST /scmapi/api/ThirdPartyDelivery/ConfirmReturnOrders

{
  "ReturnCodes": [
    "2024072600001R",
    "2024072600002R",
    "2024072600003R",
    "2024072600004R"
  ]
}

{
    "ResponseMessage": "成功",
    "SuccessfulCount": 4,
    "FailedCount": 0,
    "SuccessfulReturnGoods": [
        {
            "ReturnCode": "2024072600001R",
            "ReturnSerialNumber": 1967289,
            "FailMessage": ""
        },
        {
            "ReturnCode": "2024072600002R",
            "ReturnSerialNumber": 1967290,
            "FailMessage": ""
        },
        {
            "ReturnCode": "2024072600003R",
            "ReturnSerialNumber": 1967291,
            "FailMessage": ""
        },
        {
            "ReturnCode": "2024072600004R",
            "ReturnSerialNumber": 1967292,
            "FailMessage": ""
        }
    ],
    "FailedReturnGoods": []
}

{
  "ResponseMessage": "成功",
  "SuccessfulCount": 0,
  "FailedCount": 3,
  "SuccessfulReturnGoods": [],
  "FailedReturnGoods": [
    {
      "ReturnCode": "2024061700007R",
      "ReturnSerialNumber": 1967266,
      "FailMessage": "退貨結案失敗"
    },
    {
      "ReturnCode": "2024061700008R",
      "ReturnSerialNumber": 1967267,
      "FailMessage": "退貨結案失敗"
    },
    {
      "ReturnCode": "2024061700016R",
      "ReturnSerialNumber": 1967275,
      "FailMessage": "退貨結案失敗"
    }
  ]
}

Response Elements #

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

ResponseMessage #

回覆API執行成功與否訊息。
資料型態: String
說明：僅顯示API執行狀況, 若有失敗的狀況則在下方顯示FailedReturnGoods顯示

SuccessfulCount #

執行退貨確認成功的筆數。
資料型態: Integer

FailedCount #

執行退貨確認失敗的筆數。
資料型態: Integer

SuccessfulReturnGoods #

執行退貨確認成功的退貨單細節

  • ReturnCode：退貨單編號
  • ReturnSerialNumber：退貨單序號
  • FailMessage：錯誤訊息

資料型態: Array

ReturnCode #

退貨單編號。
資料型態: String

ReturnSerialNumber #

退貨單序號。
資料型態: Integer

FailMessage #

錯誤訊息。
資料型態: String

FailedReturnGoods #

執行退貨確認失敗的退貨單細節

  • ReturnCode：退貨單編號
  • ReturnSerialNumber：退貨單序號
  • FailMessage：錯誤訊息

資料型態: Array

ReturnCode #

退貨單編號。
資料型態: String

ReturnSerialNumber #

退貨單序號。
資料型態: Integer

FailMessage #

錯誤訊息。
資料型態: String