创建面单退货
接口方法
请求方式:
请求示例:
<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格式 |
作者:黄天文 创建时间:2024-01-17 22:19
最后编辑:黄天文 更新时间:2024-10-25 04:36