创建退货单 POST v1/returnOrder

创建退货单

POST http://openapi.ck1info.com/v1/returnOrder

接口说明: 创建退货单
Http 200 - 订单创建成功
Http 400 - 提交的数据有误，请检查

输入参数

Body Parameters

名称	类型	格式要求	是否必须	描述	示例值
ShipToAddress	AddressWithContact	None.		收件人信息
ReceivingWarehouseCode	string	长度: 0 ~ 20		收货仓库代码（和收件人信息二选一）	NJ
PackageId	string	满足正则: ^[a-zA-Z0-9\-_]*$ 长度: 0 ~ 50	必须	包裹Id(第三方系统自定义Id，客户+包裹Id 具有唯一性)	SMT23015236489
ServiceCode	string	长度: 0 ~ 30	必须	发货服务代码	CUE
Sender	AddressWithContact	None.	必须	发件人信息
Weight	decimal number	None.	必须	重量(g) [取值是向上取整的]	600
Length	decimal number	浮点数格式: 8,2		长(cm)	25
Width	decimal number	浮点数格式: 8,2		宽(cm)	10
Height	decimal number	浮点数格式: 8,2		高(cm)	20
Skus	Collection of ReturnSkuObject	None.	必须	SKU列表
SalesPlatform	string	None.		销售平台	Ebay
Custom	string	长度: 0 ~ 1000		客户自定义，可以用于打印在地址标签Custom区域	bag-red
Remark	string	长度: 0 ~ 1000		备注；	remark

输入参数的json形式

{
  "ShipToAddress": {
    "Contact": "sample string 1",
    "Phone": "sample string 2",
    "Email": "sample string 3",
    "Country": "sample string 4",
    "Province": "sample string 5",
    "City": "sample string 6",
    "Street1": "sample string 7",
    "Street2": "sample string 8",
    "Postcode": "sample string 9"
  },
  "ReceivingWarehouseCode": "sample string 1",
  "PackageId": "sample string 2",
  "ServiceCode": "sample string 3",
  "Sender": {
    "Contact": "sample string 1",
    "Phone": "sample string 2",
    "Email": "sample string 3",
    "Country": "sample string 4",
    "Province": "sample string 5",
    "City": "sample string 6",
    "Street1": "sample string 7",
    "Street2": "sample string 8",
    "Postcode": "sample string 9"
  },
  "Weight": 4,
  "Length": 5,
  "Width": 6,
  "Height": 7,
  "Skus": [
    {
      "Sku": "sample string 1",
      "Quantity": 2,
      "Weight": 3,
      "NewDeclareValue": {
        "Value": 1,
        "Currency": "sample string 2"
      },
      "DeclareNameEn": "sample string 4",
      "DeclareNameCn": "sample string 5",
      "ProductName": "sample string 6",
      "Price": 7,
      "HsCode": "sample string 8",
      "SaleURL": "sample string 9"
    },
    {
      "Sku": "sample string 1",
      "Quantity": 2,
      "Weight": 3,
      "NewDeclareValue": {
        "Value": 1,
        "Currency": "sample string 2"
      },
      "DeclareNameEn": "sample string 4",
      "DeclareNameCn": "sample string 5",
      "ProductName": "sample string 6",
      "Price": 7,
      "HsCode": "sample string 8",
      "SaleURL": "sample string 9"
    }
  ],
  "SalesPlatform": "sample string 8",
  "Custom": "sample string 9",
  "Remark": "sample string 10"
}

返回结果

名称	类型	格式要求	描述	示例值
PackageId	string	None.	出库包裹ID	SMT23015236489
Ck1PackageId	string	None.	处理号	EUU20160808TST00001
HandleStatus	DirectExpressOrderStatus	None.	处理状态	Submitted
TrackingNumber	string	None.	跟踪号	T024963157
IsFinalTrackingNumber	boolean	None.	是否是最终跟踪号，部分渠道是到仓后才会有最终跟踪号的	true
ShippingProvider	string	None.	承运商	DHL
CreateFailedReason	UnShippedReason	None.	创建失败原因
ShippingCosts	Collection of ShippingCost	None.	费用列表
HasRemoteFee	boolean	None.	是否产生偏远地区费用

返回结果的json形式

{
  "PackageId": "sample string 1",
  "Ck1PackageId": "sample string 2",
  "HandleStatus": "Initial",
  "TrackingNumber": "sample string 3",
  "IsFinalTrackingNumber": true,
  "ShippingProvider": "sample string 5",
  "CreateFailedReason": {
    "ReasonCode": "sample string 1",
    "ReasonText": "sample string 2",
    "ExtendMessage": "sample string 3"
  },
  "ShippingCosts": [
    {
      "Money": 1,
      "Currency": "sample string 2",
      "Type": "None",
      "Remark": "sample string 3"
    },
    {
      "Money": 1,
      "Currency": "sample string 2",
      "Type": "None",
      "Remark": "sample string 3"
    }
  ],
  "HasRemoteFee": true
}

在线测试工具