创建面单退货

接口方法

请求方式：

请求示例:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/">
    <SOAP-ENV:Body>
        <ns1:callService>
            <paramsJson>
                {
                  "warehouse_code":"DEMO",
                  "shipping_method":"US_RETURN_UPS",
                  "reference_no":"ref_1399867101-test",
                  "reference_no2":"ref_1399867101-test2",
                  "verify":"1",
                  "order_desc":"test-api",
                  "length":"15.50",
                  "width":"10.00",
                  "height":"5.00",
                  "weight":"12.50",
                  "sender_address":{
                    "country_code":"US",
                    "province":"CT",
                    "city":"TRUMBULL",
                    "address1":"53 NORTH ST",
                    "zipcode":"142970",
                    "first_name":"tester",
                    "last_name":"pak",
                    "phone":"123456789"
                  }
                }
            </paramsJson>
            <appToken>appToken</appToken>
            <appKey>appKey</appKey>
            <service>createShipmentReturn</service>
        </ns1:callService>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

请求参数:

参数 类型 是否必填 说明 长度限制
reference_no String 是 参考编号 50
reference_no2 String 否 参考编号2 50
shipping_method String 是 物流渠道，参考getShippingMethod（获取物流渠道） 20
warehouse_code String 是 配送仓库（退货仓库为收件人） 20
is_signature int 否 签名服务: 0:否 1:是（需物流渠道支持）
is_insurance int 否 保险服务: 0:否 1:是（需物流渠道支持）
declared_value double 否 保险金额/申报价值（当保险服务为1是时，必填），两位小数
remark String 否 备注 200
sender_address Object 是 发货人信息 50
verify int 是 是否提交,0新建不提交(草稿状态)，1新建并提交， 默认为0
length String 是 包裹长（保留2位小数）
width String 是 包裹宽（保留2位小数）
height String 是 包裹高（保留2位小数）
weight String 是 包裹重（保留2位小数）

address参数:

参数 类型 是否必填 说明 长度限制
country_code String 是 收/发件人国家，参考getCountry（获取国家列表） 20
province String 是 州/省(美国的州/省参数必填，欧洲国家的不必填) 20
city String 是 城市 20
address1 String 是 地址1 (length:60) 60
address2 String 否 地址2 (length:60) 60
zipcode String 是 邮编 20
doorplate String 否 门牌号 20
company String 否 公司名 20
first_name String 是 收/发件人名 20
last_name String 否 收/发件人姓 20
phone String 否 收/发件人联系方式（收件人必填） 20
email String 否 收/发件人邮箱 20

返回结果示例：

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<SOAP-ENV:Envelope xmlns:ns1="http://www.example.org/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>
                {
                  "ask":"Success",
                  "message":"Success",
                  "nextPage":false,
                  "order_code":"YB-XX-19110400003"
                }
            </response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

返回参数：

参数 类型 说明
ask String 返回结果，Success表示请求成功，Failure表示请求失败
message String 返回信息
nextPage boolean true 有下一页，false 没有下一页
order_code String 系统生成的面单号
Error Object 参考Error格式