描述

运费测算创建退件单

路径

HTTP Verb	URL
POST	/api/supplier-service/v1/b2c/createReturnOrder

请求头样例

代码块

POST /api/supplier-service/v1/b2b/poList
Host: http://cfs-qa.etowertech.com/
Content-Type: application/json
Accept: application/json
Authorization:WallTech etotest8xkIIphLnbkjRACNj4P:pc9H97D-_b2_TSCVvNj81A
X-WallTech-Date:Tue, 02 Aug 2022 06:43:37 GMT

...

请求字段

字段名数据类型最大长度必填

字段名	数据类型	最大长度	必填	描述
warehouseCode	String	50	M	仓库代码
countryreferenceNo	String	250	M	国家二字代码（CN, US ...）	state订单参考号
originalOrderNo	String	50	MO	州（省）原始订单号
cityeta	StringDate		50O	M预计到达时间
城市returnReason	district	String	50200	MO	区退件原因
postCoderemark	String	30200	MO	邮编备注
parcelListexpressNoList	Array	20	M	包裹列表

parceList参数

parcelWeightDecimal

描述

O

包裹重量（productList为空时必填）

跟踪号列表（服务为“线下服务”时，跟踪号必填，非线下服务时，跟踪号填写无效）

parcelLength

isNeedConfirm

Decimal

Boolean

O

包裹长（productList为空时必填）

是否“确认”同步到海外仓,默认为“true”

parcelWidth

itemList

Decimal

Array

O

M

包裹宽（productList为空时必填）

商品列表

parcelHeight

serviceName

Decimal

String

O

M

包裹高（productList为空时必填）

退件服务名称

productList

senderAddress

Array

Object

O

M

包裹下商品列表（包裹长，宽，高，重量任一为空时必填，使用商品实际长宽高重量计算出包裹长宽高）

发件人地址

productList参数

字段名	数据类型	最大长度	必填	描述
sku	String	50	M	商品编码
productQty	Integer		M	商品数量

...

handleType

...

Short

...

theme	Eclipse
linenumbers	true
collapse	true

...

{
    "warehouseCode": "CATESTWH",
    "country": "CN",
    "state": "四川省",
    "city": "广元市",
    "district": "利州区",
    "postCode": "123432",
    "parcelList": [
        {
            "parcelWeight": 1,
            "parcelLength": 3,
            "parcelWidth": 4,
            "parcelHeight": 5,
            "productList": [
                {
                    "sku": "SKG",
                    "productQty": 2
                },
                {
                    "sku": "Red wine",
                    "productQty": 1
                }
            ]
        },
        {
            "parcelWeight": null,
            "parcelLength": null,
            "parcelWidth": null,
            "parcelHeight": null,
            "productList": [
                {
                    "sku": "SKG",
                    "productQty": 2
                },
                {
                    "sku": "Red wine",
                    "productQty": 1
                }
            ]
        },
        {
            "parcelWeight": 2,
            "parcelLength": 3,
            "parcelWidth": 4,
            "parcelHeight": 5,
            "productList": []
        }
    ]
}

...

M

处理方式；0=重新上架；1=退回国内；2=不良品；3=销毁；4=待检查；5=换标；6=产品升级

senderAddress参数

字段名	数据类型	最大长度	必填	描述

channelName

contactName

String

服务名称

255

channelId

M

Long

联系人姓名

服务id

contactPhone

lastMileBillingWeight

String

Decimal

255

派送费计费重量

M

feeItemList

联系人电话

Array

contantEmail

费用列表

String

...

255

字段名

O

数据类型

联系人邮箱

最大长度

companyName

描述

String

costTypecostTypeName

255

Integer费用类型（1：出库处理费（Outbound Handling Fee）；8：尾程运费（Last Mile Fee））

O	联系人公司
country	String	2

费用名称

M

billingWeight

国家二字码

Decimal

state

计费重量

String

fee

128

Decimal

费用金额

currency

O	州(省)
city	String	128

币种

M

feeDetailList

城市

Array

district

费用明细

String

...

128

字段名

O

数据类型

区

最大长度

postcode

描述

String

costTypeName

32

String

O

费用名称（中文）

邮编

costTypeNameEn

addressLine1

String

费用名称（英文）

512

fee

M

Decimal

地址1

费用金额

addressLine2

currency

String

512

币种

O

discount

地址2

Integer

addressLine3

折扣（%Off）

String

zoneItemName

512

String

O

费用分区

地址3

...

请求样例

代码块

theme	Eclipse
linenumbers	true
collapse	true

{
    "codereferenceNo": "0openApi-xmx-001",
    "datawarehouseCode": [
        {
            "channelName": "TEST PUROLATOR GROUND""CATESTWH",
            "feeItemList": [
                {
                    "billingWeight": "",
               "originalOrderNo": "C15487240411000002O",
    "costType": 8,
                    "costTypeNameeta": "Last Mile Fee",
                    "currency": "CAD",
                    "discount": 0,
                    "fee": 67.400,
         2025-12-02 23:59:59",
          "feeDetailList": [
                        {
                            "costTypeName": "尾程基本运费",
                       "returnReason": "退件原因",
    "costTypeNameEnremark": "Last Mile Basic Fee",
                       备注",
    "currencyisNeedConfirm": "CADtrue",
                       
    "discountexpressNoList": "",[
                            "fee": 67.40000000,
   "qw",
                        "zoneItemName": ""
           "as"
            }
                    ]
                }
            ]
        },
        {
            "channelName": "易仓下单专用服务（勿动）",
            "feeItemList": [
       "itemList": [
        {
     
              "billingWeightsku": "TEST2024011602",
       
            "costTypeproductQty": 8,
       1,
            "costTypeNamehandleType": "Last Mile Fee",1
        }
           "currency": "CAD",
            ],
       "discountserviceName": 0,
                    "fee": 191.370,
               "ServiceNameTest",
    "feeDetailListsenderAddress": [
                        {
                            "costTypeName"contactName": "尾程基本运费联系人电话",
                   
        "costTypeNameEncontactPhone": "Last Mile Basic Fee联系人电话",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 67.40000000,
                            "zoneItemName": ""
                        },
                        {
 "contactEmail": "test9@qq.com",
                          "costTypeName"companyName": "偏远地区附加费联系人公司",
        
                   "costTypeNameEn"country": "Remote Area SurchargeCN",
            
               "currency"state": "CAD省",
     
                      "discount"city": "城市",
                            "fee": 19.0000000,
                            "zoneItemName": ""
                        },
                        {
                            "costTypeName": "燃油附加费",
          "district": "区",
                 "costTypeNameEn"postCode": "Fuel Surcharge邮编",
                            "currency"addressLine1": "CAD地址1",
                   
        "discountaddressLine2": "地址2",

                           "fee": 8.64000000000000,
                            "zoneItemName": ""
    "addressLine3": "地址3"
                   },
                        {
                            "costTypeName": "安全管理费",
                            "costTypeNameEn": "Security Surcharge",
          
                 "currency": "CAD",
                            "discount": "",
                            "fee": 13.48000000000000,
                            "zoneItemName": ""
                        },
                        {
                       }

响应字段

字段名	数据类型	最大长度	描述
referenceNo	String	50	订单参考号
orderNo	String	50	订单系统单号

响应样例

代码块

linenumbers	true
collapse	true

{
    "costTypeNamecode": "其它附加费",
                            "costTypeNameEn": "Other Surcharge",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 20.22000000000000,
                            "zoneItemName": ""
                        },
                        {
                            "costTypeName": "住宅地址附加费",
                            "costTypeNameEn": "Residential Surcharge",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 26.96000000000000,
                            "zoneItemName": ""
                        },
                        {
       0",
    "data": {
                    "costTypeName"orderNo": "电池附加费R15487241218000003O",
                            "costTypeNameEn": "Battery Surcharge",
                            "currency": "CAD",
                            "discount": "",
                            "fee": 33.70000000000000,
                            "zoneItemName": ""
                        },
                        {
                            "costTypeName": "保险",
                            "costTypeNameEn": "Insurance Fee",
                       "referenceNo": "openApi-xmx-001"
    },
    "errors": "",
    "message": "",
    "currencymessageId": "CAD",
                            "discount"success": ""true,

                           "fee": 1.970,
                            "zoneItemName": ""
                        }
                    ]
                }
            ]
        },
        {
     "warnList": ""
}

代码块

linenumbers	true
collapse	true

{
      "channelNamecode": "卡派（测试）0005",
       
    "feeItemListdata": []
        },
        {
            "channelName": "OFFLINE_PICKUP_EXPRESS",
  
         "feeItemListerrors": []
      
 },         {
            "channelNamecode": "OFFLINE_PICKUP_TRUCK600224",
            "feeItemListmessage": []
        },
        {
            "channelName": "MINXI_C",
            "feeItemList": []"Client Reference No are duplicate"
        }
    ],
    "errorsmessage": "",
    "message": "paramter error",
    "messageId": "",
    "success": truefalse,
    "warnList": ""
}

页面树结构

版本比较

旧版本 1

新版本当前版本

标识

描述

路径

请求头样例

请求字段

请求样例

响应字段

响应样例

页面树结构

页面历史

版本比较

旧版本 1

新版本 当前版本

标识

描述

路径

请求头样例

请求字段

请求样例

响应字段

响应样例

新版本当前版本