2.submitAppointment - YCS EXPRESS

服务能力：提交预委任信息
请求地址：host:/submitAppointment
请求方式：POST

Header 请求参数（用于token校验）:

参数名	示例值
token	4e411a926e7a33ca9d04cd1942ac54a2

Body 请求参数：

参数名	描述	是否必填	数据类型	字段长度
packageNo	分提单号包裹包/订单号	是	String	15
realname	用户真实姓名繁体中文	是	String	35
phone	用户手机号码建议格式：0开头+9位数字	是	String	20
id	用户身份证号码台湾身份证号码格式是10码，第1码是英文字母	否	String	20
packageWeight	包裹重量	否	Number	5
goodsPrice	商品货值	否	Number	7
goodsPriceCurrency	商品货值币种如：TWD	是	String	3
items	包裹详情	是	Object
goodsName	商品名称	是	String	100
goodsNumber	商品数量	是	Number	5
goodsUnitPrice	商品单价	是	Number	7
请求示例：

{
    "packageNo": "TEST102301203",
    "realname": "张三",
    "phone": "0985532043",
    "id": "A123456789",
    "packageWeight": 0.9,
    "goodsPrice": 190,
    "goodsPriceCurrency": "TWD",
    "items": [
        {
            "goodsName": "无线蓝牙耳机",
            "goodsNumber": 2,
            "goodsUnitPrice": 45
        },
        {
            "goodsName": "Type-C 数据线",
            "goodsNumber": 5,
            "goodsUnitPrice": 12
        },
        {
            "goodsName": "手机保护壳",
            "goodsNumber": 1,
            "goodsUnitPrice": 40
        }
    ]
}

响应字段说明：

字段名	描述	数据类型
success	true 或者 false	Boolean
code	200：成功其他：失败	Integer
message	请求返回信息	String
requestTime	委任数据提交时间	String
requestId	请求ID	String
data		Object
packageNo	分提单号包裹包/订单号	String
realname	用户真实姓名	String
phone	用户电话	String
id	用户身份证号码	String
packageWeight	包裹重量	Number
goodsPrice	商品货值	Number
goodsPriceCurrency	商品货值币种如：String	是
items	包裹详情	Object
goodsName	商品名称	String
goodsNumber	商品数量	Number
goodsUnitPrice	商品单价	Number

成功返回示例：

{
    "success": true,
    "code": 200,
    "message": "success",
    "requestTime": "2025-12-02 09:23:02",
    "requestId": "656db3a31d512291",
    "data": {
        "packageNo": "TEST102301203",
        "realname": "张三",
        "phone": "0985532043",
        "id": "",
        "packageWeight": 0.9,
        "goodsPrice": 190,
        "goodsPriceCurrency": "TWD",
        "items": [
            {
                "goodsName": "无线蓝牙耳机",
                "goodsNumber": 2,
                "goodsUnitPrice": 45
            },
            {
                "goodsName": "Type-C 数据线",
                "goodsNumber": 5,
                "goodsUnitPrice": 12
            },
            {
                "goodsName": "手机保护壳",
                "goodsNumber": 1,
                "goodsUnitPrice": 40
            }
        ]
    }
}

错误代码说明：

错误代码	错误描述
1001	Token验证错误，请检查传入的Token是否正确
1002	请求参数数据结构错误，请检测后重新传入
1003	传入参数长度不符合要求
1004	接口异常

错误返回示例：

{
    "success": false,
    "code": 1003,
    "message": "用户手机号码长度错误，建议格式：0开头+9位数字",
    "requestId": "65e9822db66d1299"
}