创建订单

场景说明

创建订单接口针对于创建订单、同步问题件、取消订单重新创建、查询订单信息场景做了适配，仅支持以下场景且幂等逻辑仅支持50个小时！ 1.创建订单（参考号在我们系统不存在或者都是已取消状态） 2.同步问题件(请求参数幂等,第二次重复调用创单接口时,走同步问题件的逻辑) 3.取消订单-重新创建(请求参数不幂等时，且当前参考号订单状态为问题件时，先取消参考号原有的问题件，再走重新创建的逻辑) 4.查询订单信息(请求参数幂等，且当前参考号订单状态为预报走查询详情逻辑)

接口名

{域名}/api/svc/createOrder

请求方式

POST

参数名	是否必填	类型	说明
Authorization	是	string	授权码：访问授权 Token

请求参数

参数名	二级参数名	是否必填	类型	说明
reference_no	-	是	string	参考号(客户单号),长度不得超过35位
sm_code	-	是	string	物流产品代码, 可咨询服务商或使用getUserInfo查询
remark		否	string	订单备注信息长度不得超过35位
oa_firstname		是	string	收件人姓名长度不能小于3位，并且长度不能大于35位
oa_company		否	string	收件人公司长度不得超过35位
oa_street_address1		是	string	收件人地址1 长度不得超过35位
oa_street_address2		否	string	收件人地址2 长度不得超过35位
oa_postcode		是	string	收件人邮编 5-4格式邮编,邮编长度最短5位数,最长10位数
oa_state		是	string	收件人州需要填写两位简称,只能为大写二字编码
oa_city		是	string	收件人城市长度最短1位数，最长30位数
oa_country		是	string	收件人国家要求固定值US
oa_telphone		是	string	收件人电话 10-15位之间
is_more_box		是	integer	包裹类型:固定值，请传1
signature_service		否	string	签名服务:是否需要签名服务：ASS为成人签名，DSS 为直接签名 ISS 为间接签名，不需要可以不传该字段
pick_up		否	integer	是否提货 1：是，0：否，不传默认为否, 传1（是）需要物流产品支持，物流产品不支持传1(是)也无效
weight_unit_type		否	integer	包裹单位类型: 1-英制(INCH/LBS) 2-公制(CM/KG) 默认为2
label_custom_type		否	String	自定义面单打印类型: 1为都打印 2为打印参考号 3为仅仅打印备注默认为1
mailing_date		否	string	发货日期格式为yyyy-MM-dd
label_image_format		否	string	面单格式: PDF、ZPL(打印机格式) 默认为PDF
has_ups_label_cropped		否	string	UPS面单是否裁剪,true为裁剪,false为不裁剪不传默认为true
generate_gx_event		否	string	是否生成gx预报轨迹不传默认为true
box_list		是	array	包裹信息
-box_list	box_length	是	number	长最多支持两位小数, '超过两位小数则截取前两位小数'
-box_list	box_width	是	number	宽最多支持两位小数, '超过两位小数则截取前两位小数'
-box_list	box_height	是	number	高最多支持两位小数, '超过两位小数则截取前两位小数'
-box_list	box_actual_weight	是	number	重量最多支持三位小数
-box_list	sku	否	string	sku, 如果sku没有填,则取订单备注信息的值
-box_list	cn_name	否	string	中文名称
-box_list	eng_name	否	string	英文名称
-box_list	apply_company	否	string	申报单位
-box_list	apply_number	否	number	申报数量
-box_list	apply_unit_price	否	number	申报单价
-box_list	apply_unit_weight	否	number	申报单重
-box_list	good_detail	否	string	配货信息
-box_list	customs_code	否	string	海关编码
-box_list	sale_url	否	string	销售链接
-box_list	cn_material	否	string	中文材质
-box_list	eng_material	否	string	英文材质
-box_list	produce_country	否	string	生产国家
-box_list	remark	否	string	包裹备注
shipper_address		是	object	发件人信息, 发件人信息必须与我司备案信息完全一致, 发件人信息与发件人编码同时存在时，以发件人信息为准
-shipper_address	shipper_name	是	string	发件人姓名,长度最短3位数,最长35位数
-shipper_address	shipper_company	否	string	发件人公司，长度最长35位数
-shipper_address	shipper_telphone	是	string	发件人电话， 10-15位之间
-shipper_address	shipper_country	是	string	发件人国家，要求固定值US
-shipper_address	shipper_state_province	是	string	发件人州, 只能为大写二字编码
-shipper_address	shipper_city	是	string	发件人城市, 长度最短1位数，最长30位数
-shipper_address	shipper_address1	是	string	发件人地址1,长度不得超过35位
-shipper_address	shipper_address2	否	string	发件人地址2,长度不得超过35位
-shipper_address	shipper_postal_code	是	string	发件人邮编, 长度最短5位数,最长10位数
shipper_code		是	string	发件人编码, 发件人信息与发件人编码同时存在时，以发件人信息为准
return_address		否	object	退件地址信息
-return_address	street_address	是	string	退件信息-街道地址
-return_address	secondary_address	是	string	退件信息-街道地址2
-return_address	zip_code_and_plus4	是	string	退件信息-邮政编码-扩展邮编,如果有扩展邮编则用 - 拼接在后面，比如：75115-2500
-return_address	city	是	string	退件信息-城市
-return_address	state	是	string	退件信息-州
-return_address	first_name	是	string	退件信息-联系人名字
-return_address	last_name	否	string	退件信息-联系人姓氏
-return_address	phone	否	string	退件信息-联系人电话

输入示例（body）


{
    "reference_no": "string",
    "sm_code": "string",
    "remark": "string",
    "oa_firstname": "string",
    "oa_company": "string",
    "oa_street_address1": "string",
    "oa_street_address2": "string",
    "oa_postcode": "string",
    "oa_state": "string",
    "oa_city": "string",
    "oa_country": "string",
    "oa_telphone": "string",
    "is_more_box": 1,
    "signature_service": "string",
    "weight_unit_type": 2,
    "label_custom_type": "1",
    "mailing_date": "2025-06-17",
    "label_image_format": "PDF",
    "has_ups_label_cropped": "false",
    "generate_gx_event": "false",
    "box_list": [
        {
            "box_length": 0,
            "box_width": 0,
            "box_height": 0,
            "box_actual_weight": 0,
            "sku": "111",
            "cn_name": "",
            "eng_name": "",
            "apply_company": "",
             "apply_number": 0,
             "apply_unit_price": 0,
             "apply_unit_weight": 0,
             "good_detail": "",
             "customs_code": "",
             "sale_url": "",
             "cn_material": "",
             "eng_material": "",
             "produce_country": "",
             "remark": ""
        }
    ],
    "shipper_address": {
        "shipper_name": "string",
        "shipper_company": "string",
        "shipper_telphone": "string",
        "shipper_country": "string",
        "shipper_state_province": "string",
        "shipper_city": "string",
        "shipper_address1": "string",
        "shipper_address2": "string",
        "shipper_postal_code": "string"
    },
    "return_address": {
        "street_address": "string",
        "secondary_address": "string",
        "zip_code_and_plus4": "string",
        "city": "string",
        "state": "string",
        "first_name": "string",
        "last_name": "string",
        "phone": "string"
  },
    "shipper_code": "string"
}

返回参数

参数名	二级参数名	是否必填	类型	说明
code	-	是	string	响应码，200-成功
result	-	是	object	响应结果
msg	-	是	string	响应消息
-result	order_code	是	string	响应结果
-result	fee	是	array	费用信息
-result.fee	ft_code	是	string	费用英文名称
-result.fee	amount	是	string	金额
-result.fee	currency_code	是	string	币种
-result.fee	ft_name	是	string	费用中文名称
-result	fee_detail	是	array	费用详情
-result.fee_detail	ft_code	是	string	费用英文名称
-result.fee_detail	amount	是	string	金额
-result.fee_detail	tracking_number	是	string	物流单号
-result.fee_detail	box_code	是	string	箱号
-result.fee_detail	currency_code	是	string	币种
-result.fee_detail	ft_name	是	string	费用中文名称
-result	labels	是	array	面单信息, 为空时代表没有生产物流信息，需要异步获取
-result.labels	tracking_number	是	string	物流单号
-result.labels	tracking_number2	否	string	物流单号 UPS MI时产品返回USPS单号，其余产品不返回
-result.labels	label_url	是	string	面单URL链接
-result.labels	context	是	string	创建订单面单格式为ZPL时，才会返回该值
-result.labels	file_type	是	string	面单类型
-result	merge_label	是	string	合并面单

输出示例

{
    "code": 200,
    "result": {
        "order_code": "XXXXXX",
        "fee": [
            {
                "ft_code": "shipping",
                "amount": "4.00",
                "currency_code": "USD",
                "ft_name": "运费"
            },
            {
                "ft_code": "FSC",
                "amount": "0.04",
                "currency_code": "USD",
                "ft_name": "燃油附加费"
            }
        ],
        "fee_detail": [
            {
                "ft_code": "shipping",
                "amount": "1.00",
                "tracking_number": "XXXX",
                "box_code": "XXXXXX-1",
                "currency_code": "USD",
                "ft_name": "运费"
            },
            {
                "ft_code": "FSC",
                "amount": "0.01",
                "tracking_number": "XXXX",
                "box_code": "XXXXXX-1",
                "currency_code": "USD",
                "ft_name": "燃油附加费"
            },
            {
                "ft_code": "shipping",
                "amount": "1.00",
                "tracking_number": "XXXX",
                "box_code": "XXXXXX-2",
                "currency_code": "USD",
                "ft_name": "运费"
            },
            {
                "ft_code": "FSC",
                "amount": "0.01",
                "tracking_number": "XXXX",
                "box_code": "XXXXXX-2",
                "currency_code": "USD",
                "ft_name": "燃油附加费"
            },
            {
                "ft_code": "shipping",
                "amount": "1.00",
                "tracking_number": "XXXX",
                "box_code": "XXXXXX-3",
                "currency_code": "USD",
                "ft_name": "运费"
            },
            {
                "ft_code": "FSC",
                "amount": "0.01",
                "tracking_number": "XXXX",
                "box_code": "XXXXXX-3",
                "currency_code": "USD",
                "ft_name": "燃油附加费"
            },
            {
                "ft_code": "shipping",
                "amount": "1.00",
                "tracking_number": "",
                "box_code": "XXXXXX-4",
                "currency_code": "USD",
                "ft_name": "运费"
            },
            {
                "ft_code": "FSC",
                "amount": "0.01",
                "tracking_number": "",
                "box_code": "XXXXXX-4",
                "currency_code": "USD",
                "ft_name": "燃油附加费"
            }
        ],
        "labels": [
            {
                "tracking_number": "XXXX",
                "tracking_number2": "XXXX",
                "label_url": "http://XXXX.pdf",
                "file_type": "pdf",
                "context": ""
            },
            {
                "tracking_number": "XXXX",
                "tracking_number2": "XXXX",
                "label_url": "http://XXXX.pdf",
                "file_type": "pdf",
                "context": ""
            },
            {
                "tracking_number": "XXXX",
                "tracking_number2": "XXXX",
                "label_url": "http://XXXX.pdf",
                "file_type": "pdf",
                 "context": ""
            },
            {
                "tracking_number": "XXXX",
                "tracking_number2": "XXXX",
                "label_url": "http://XXXX.pdf",
                "file_type": "pdf",
                "context": ""
            }
        ],
        "merge_label": "http://XXXX.pdf"
    },
    "msg": "Success"
}