中邮海外仓 - cpws

更新日志

首页 > API > 开发者必读 > 更新日志

2015年5月12日

新建API对接资料。

2015年7月8日

createOrder, modifyOrder 接口，增加forceVerify属性，用于强制审核。

2015年8月5日

新建getOrderByRefCode 接口。

2016年4月28日

新建入库单增加transit_type字段。
getOrderByCode接口支持参考编号请求

2016年11月14日

getProductInventory接口增加stocking字段

2020年5月28日

新建getWarehouseOfAge 接口。

2020年6月18日

新建getReturnOrders 接口。

请求公共参数

序号	参数	类型	必填项	描述
1	appToken	String	√	API密钥
2	appKey	String	√	API标识
3	language	String		错误信息语言(zh_CN、en_US)
4	service	String	√	接口方法，参考接口方法列表
5	paramsJson	String		请求的数据内容，json格式

response公共参数

参数	类型	必填项	描述
ask	string	√	响应标志，Success表示成功，Failure表示失败
message	String	√	消息提示
error	object		错误信息

error格式

参数	类型	必填项	描述
errMessage	string	√	错误信息内
errCode	String	√	错误码

pagination格式

参数	类型	必填项	描述
pageSize	string	√	分页大小
page	String	√	当前页

service：getCountry

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>{"pageSize":"1","page":1}</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>getCountry</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>           <response>{"ask":"Success","message":"Success","pagination":{"page":"1","pageSize":"1"},"count":"260","nextPage":"true","data":[{"country_code":"AF","country_name":"阿富汗","country_name_en":"AFGHANISTAN"}]}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
pageSize	Int	Option	每页数据长度，不传值表示查询所有
page	Int	Option	当前页，不传值表示查询所有

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
pagination	Object	参考pagination格式
count	Int	总数量
nextPage	String	是否有下一页,true表示有，false表示没有
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
country_code	string	国家/地区二字码
country_name	string	国家/地区中文名
country_name_en	string	国家/地区英文名

service：getRegion

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>{"pageSize":"1","page":1}</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>getRegion</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>			<response>{"ask":"Success","message":"Success","pagination":{"page":"1","pageSize":"1"},"count":"3408","nextPage":"true","data":[{"region_id":"1","parent_region_id":"0","region_name":"中国","region_level":"0"}]}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
pageSize	Int	Option	每页数据长度，不传值表示查询所有
page	Int	Option	当前页，不传值表示查询所有

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
pagination	Object	参考pagination格式
count	Int	总数量
nextPage	String	是否有下一页,true表示有，false表示没有
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
region_id	Int	区域ID
parent_region_id	Int	父区域关联ID
region_name	string	区域名称
region_level	Int	区域级别,0中国，1省，2市，3区/县

service：getWarehouse

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>{"pageSize":"1","page":1}</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>getWarehouse</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>			<response>{"ask":"Success","message":"Success","pagination":{"page":"1","pageSize":"1"},"count":"12","nextPage":"true","data":[{"warehouse_code":"USEA","country_code":"US","warehouse_name":"美东仓库"}]}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
pageSize	Int	Option	每页数据长度，不传值表示查询所有
page	Int	Option	当前页，不传值表示查询所有

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
pagination	Object	参考pagination格式
count	Int	总数量
nextPage	String	是否有下一页,true表示有，false表示没有
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
warehouse_code	string	仓库代码
warehouse_name	string	仓库名称
country_code	string	仓库所在国家/地区二字码

service：getShippingMethod

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ec="http://www.example.org/Ec/">
                           <soapenv:Header/>
                           <soapenv:Body>
                              <ec:callService>
                                 <!--Optional:-->
                                 <paramsJson>{"warehouseCode":"USEA","fl_warehousecode":"CNTC "}</paramsJson>
                                 <appToken>appToken</appToken>
                                 <appKey>appKey</appKey>
                                 <service>getShippingMethod</service>
                              </ec:callService>
                           </soapenv:Body>
                        </soapenv:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>
                                    <response>{"ask":"Success","message":"","data":[{"code":"FEDEX-PACKAGE-B","name_en":"FEDEX-大货(商业地址)","name":"FEDEX-Package-Business","type":"2","sm_is_signature":"1","warehouse_code":"USEA","fl_warehouse_code":"CNTC","sp_code":"FEDEX"},{"code":"FEDEX_SMART","name_en":"SMRAT_POST","name":"SMART_POST","type":"2","sm_is_signature":"0","warehouse_code":"USEA","fl_warehouse_code":"CNTC","sp_code":"FEDEX"},{"code":"UPS-US-E","name_en":"UPS美国蓝单","name":"UPS-US-Expedited","type":"2","sm_is_signature":"0","warehouse_code":"USEA","fl_warehouse_code":"CNTC","sp_code":"UPS"},{"code":"USP-US-S","name_en":"UPS美国红单","name":"UPS-US-Saver","type":"2","sm_is_signature":"1","warehouse_code":"USEA","fl_warehouse_code":"CNTC","sp_code":"UPS"},{"code":"WULIU002","name_en":"物流测试002","name":"物流测试002","type":"2","sm_is_signature":"0","warehouse_code":"USEA","fl_warehouse_code":"CNTC","sp_code":"FEDEX"}]}
                                    </response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
warehouseCode	string	Option	尾程仓库代码
fl_warehousecode	string	Option	头程仓库代码

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
code	string	运输方式代码
name	string	运输方式中文名称
name_en	string	运输方式英文名称
warehouse_code	string	尾程仓库代码
fl_warehouse_code	string	头程仓库代码

service：getCategory

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>{"pageSize":"1","page":1}</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>getCategory</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml


<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>
                                    <response>{"ask":"Success","message":"","data":[{"code":"FEDEX-PACKAGE-B","name_en":"FEDEX-大货(商业地址)","name":"FEDEX-Package-Business","type":"2","sm_is_signature":"1","warehouse_code":"USEA","fl_warehouse_code":"CNTC","sp_code":"FEDEX"},{"code":"FEDEX_SMART","name_en":"SMRAT_POST","name":"SMART_POST","type":"2","sm_is_signature":"0","warehouse_code":"USEA","fl_warehouse_code":"CNTC","sp_code":"FEDEX"},{"code":"UPS-US-E","name_en":"UPS美国蓝单","name":"UPS-US-Expedited","type":"2","sm_is_signature":"0","warehouse_code":"USEA","fl_warehouse_code":"CNTC","sp_code":"UPS"},{"code":"USP-US-S","name_en":"UPS美国红单","name":"UPS-US-Saver","type":"2","sm_is_signature":"1","warehouse_code":"USEA","fl_warehouse_code":"CNTC","sp_code":"UPS"},{"code":"WULIU002","name_en":"物流测试002","name":"物流测试002","type":"2","sm_is_signature":"0","warehouse_code":"USEA","fl_warehouse_code":"CNTC","sp_code":"FEDEX"}]}
                                    </response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
pageSize	Int	Option	每页数据长度，不传值表示查询所有
page	Int	Option	当前页，不传值表示查询所有

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
pagination	Object	参考pagination格式
count	Int	总数量
nextPage	String	是否有下一页,true表示有，false表示没有
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
category_id	Int	品类ID
parent_category_id	string	品类父ID
category_name	string	品类中文名
category_name_en	string	品类英文名
category_level	Int	品类级别

service：getAccount

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>getAccount</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>			<response>{"ask":"Success","message":"Success","data":{"company_code":"100002","company_name":"Name","account_balance":"20468.400","freeze_amount":"0.000","currency":"RMB"}}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
company_code	string	公司代码
company_name	string	公司名称
account_balance	string	账户可用金额
freeze_amount	string	账户冻结金额
currency	string	币种

service：createProduct

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>			<paramsJson>{"product_sku":"EA140512114042","reference_no":"EA140512114042","product_title":"EA140512114042","product_weight":"0.35","product_length":"29.70","product_width":"21.00","product_height":"4","contain_battery":"0","product_declared_value":"30","product_declared_name":"EA140512114042","cat_lang":"en","cat_id_level0":"400001","cat_id_level1":"500013","cat_id_level2":"600109","verify":"1","hs_code":"code123","warning_qty":"10","product_url":"http://www.demo.com","is_brand":"Y","product_brand":"DEMO","product_model":"无","product_material":"测试","product_transaction_unit":"测试"}</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>createProduct</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>			<response>{"ask":"Success","message":"Success","product_sku":"EA140512114042"}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
product_sku	string(40)	Require	SKU
reference_no	string(25)	Option	客户参考代码
product_title	string(255)	Require	产品标题
product_weight	float	Require	重量，单位KG
product_length	float	Require	长，单位CM
product_width	float	Require	宽，单位CM
product_height	float	Require	高，单位CM
contain_battery	int	Require	是否含电池，0不含，1含电池
product_declared_value	float	Require	申报价值，币种为USD
product_declared_name	string(50)	Require	申报名称 (英文)
product_declared_name_zh	string(150)	Option	申报名称 (中文)
cat_lang	string	Option	品类语言，zh中文，en英文，默认为en
cat_id_level0	int	Option	一级品类
cat_id_level1	int	Option	二级品类
cat_id_level2	int	Require	三级品类
verify	int	Option	不传或者传0，创建草稿产品，传1，创建正式产品默认为0，产品审核通过之后，不可编辑
hs_code	int(10)	Require	海关编码
country_code	string(50)	Require	进口国,国家/地区简称,多个参数用英文逗号隔开,可填写AU,CZ,ES,FR,IT,RU,GB,US
product_classify	int	Option	商品类型(默认为1) 1普通商品，2FBA商品
product_url	string	Required	商品链接
is_brand	string	Required	是否品牌必填，填写Y或N
product_brand	string	Option	品牌名称当商品为品牌商品时必填
product_model	string	Required	型号
product_material	string	Required	材质
product_transaction_unit	string	Required	成交单位(英文)
sku_map	string(40)	Require	商品映射编码客户开启商品映射权限之后，可编辑

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
product_sku	String	SKU
Error	Object	参考Error格式

service：modifyProduct

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>			<paramsJson>{"product_sku":"EA140512114640","reference_no":"EA140512114640","product_title":"EA140512114640","product_weight":"0.35","product_length":"29.70","product_width":"21.00","product_height":"4","contain_battery":"0","product_declared_value":"50","product_declared_name":"EA140512114640","cat_lang":"en","cat_id_level0":"400001","cat_id_level1":"500013","cat_id_level2":"600109","verify":"1","product_url":"http://www.demo.com","is_brand":"Y","product_brand":"DEMO","product_model":"无","product_material":"测试","product_transaction_unit":"测试"}
                                    </paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>modifyProduct</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>			<response>{"ask":"Success","message":"Success","product_sku":"EA140512114640"}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
product_sku	string(40)	Require	SKU
reference_no	string(25)	Option	客户参考代码
product_title	string(255)	Require	产品标题
product_weight	float	Require	重量，单位KG
product_length	float	Require	长，单位CM
product_width	float	Require	宽，单位CM
product_height	float	Require	高，单位CM
contain_battery	int	Require	是否含电池，0不含，1含电池
product_declared_value	float	Require	申报价值，币种为USD
product_declared_name	string(50)	Require	申报名称 (英文)
product_declared_name_zh	string(150)	Option	申报名称 (中文)
cat_lang	string	Option	品类语言，zh中文，en英文，默认为en
cat_id_level0	int	Option	一级品类
cat_id_level1	int	Option	二级品类
cat_id_level2	int	Require	三级品类
verify	int	Option	不传或者传0，创建草稿产品，传1，创建正式产品默认为0，产品审核通过之后，不可编辑
hs_code	int(10)	Require	海关编码
country_code	string(50)	Require	进口国,国家/地区简称,多个参数用英文逗号隔开,可填写AU,CZ,ES,FR,IT,RU,GB,US
product_classify	int	Option	商品类型(默认为1) 1普通商品，2FBA商品
product_url	string	Required	商品链接
is_brand	string	Required	是否品牌必填，填写Y或N
product_brand	string	Option	品牌名称当商品为品牌商品时必填
product_model	string	Required	型号
product_material	string	Required	材质
product_transaction_unit	string	Required	成交单位(英文)
sku_map	string(40)	Require	商品映射编码客户开启商品映射权限之后，可编辑

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
product_sku	String	SKU
Error	Object	参考Error格式

service：creaetProductImportCountry

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>
                                        {"data":[{"product_sku":"EA140512114042","country_code":"US,GB"}]}
                                    </paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>createProductImportCountry</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>			<response>{"ask":"Success","message":"Success","product_sku":"EA140512114640"}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
data	Object(100)	Require	对象数组
product_sku	string(40)	Require	SKU
country_code	string(50)	Require	国家/地区简称,多个参数用英文逗号隔开,可填写AU,CZ,ES,FR,IT,RU,GB,US

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
product_sku	String	SKU
Error	Object	参考Error格式

service：getProductList

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>			<paramsJson>{"pageSize":"10","page":1,"product_sku":"","product_sku_arr":["EA14051211404212","EA110"]}</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>getProductList</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>			<response>{"ask":"Success","message":"Success","pagination":{"page":"1","pageSize":"10"},"nextPage":"flase","count":"2","data":[{"product_sku":"00001","reference_no":"100001","product_title":"手机模型","product_status":"1","product_length":"8.00","product_width":"6.00","product_height":"10.00","product_weight":"0.300","product_declared_value":"10.00","product_declared_name":"dasd","product_add_time":"2014-05-05
            01:47:24","product_modify_time":"0000-00-00 00:00:00","contain_battery":"0","cat_id_level0":"400003","cat_id_level 1":"500024","cat_id_level 2":"600161","cat_lang":"zh"}]}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
pageSize	Int	Option	每页数据长度，不传值表示查询所有
page	Int	Option	当前页，不传值表示查询所有
product_sku	string	Option	SKU
product_sku_arr	Object	Option	多个SKU,数组格式

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
pagination	Object	参考pagination格式
count	Int	总数量
nextPage	String	是否有下一页,true表示有，false表示没有
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
product_sku	string	SKU
reference_no	string	客户参考代码
product_status	string	产品状态 X:废弃 D:草稿 S:可用
product_title	string	产品标题
product_weight	float	重量，单位KG
product_length	float	长，单位CM
product_width	float	宽，单位CM
product_height	float	高，单位CM
contain_battery	int	是否含电池，0不含，1含电池
product_declared_value	float	申报价值，币种为USD
product_declared_name	string	申报名称 (英文)
cat_lang	string	品类语言，zh中文，en英文，默认为en
cat_id_level0	int	一级品类
cat_id_level1	int	二级品类
cat_id_level2	int	三级品类
product_add_time	date	添加时间
product_modify_time	date	修改时间
sku_map	Object	商品对应的映射（返回数组类型）

service：productSkuPrint

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>{"print_size":"1","print_code":"1","product_sku_arr":["EA14051211404212","EA110"]}</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>productSkuPrint</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>
                                    <response>{"ask":"Success","Error":{"errorMessage":"","errCode":""},"data":{"label_image":"base64","image_type":"2"}}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
print_size	Int	Require	打印尺寸（1：6020，2：7030，3：100*30）
print_code	Int	Require	打印编码(1：产品名称，2：made in china，3：1和2，4：都不选)
product_sku_arr	Array	Require	SKU(一次不能超过300个)

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
Error	Object	参考Error格式
data	Object	数据内容

data参数

参数名	数据类型	说明
label_image	string	返回图片
image_type	Int	图片类型 1：png，2：pdf

service：getProductMaterial

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>{"pageSize":1,"page":1}</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>getProductMaterial</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>
                                    <response>{"ask":"Success","message":"Success","pagination":{"page":"1","pageSize":"1"},"count":"2","nextPage":"true","data":[{"material_val": "aaa"},{"material_val": "bbb"}]}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
pageSize	Int	Option	每页数据长度，不传值表示查询所有
page	Int	Option	当前页，不传值表示查询所有

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
pagination	Object	参考pagination格式
count	Int	总数量
nextPage	String	是否有下一页,true表示有，false表示没有
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
material	string	材质值

service：getProductTransactionUnit

请求xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>{"pageSize":1,"page":1}</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>getProductTransactionUnit</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>
                                    <response>{"ask":"Success","message":"Success","pagination":{"page":"1","pageSize":"1"},"count":"2","nextPage":"true","data":[{"en_name": "aaa", "zh_name": "aaa"},{"en_name": "bbb", "zh_name": "bbb"}]}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
pageSize	Int	Option	每页数据长度，不传值表示查询所有
page	Int	Option	当前页，不传值表示查询所有

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
pagination	Object	参考pagination格式
count	Int	总数量
nextPage	String	是否有下一页,true表示有，false表示没有
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
en_name	string	成交单位英文值
zh_name	string	成交单位中文值

service：createAsn

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callService>			<paramsJson>{ "reference_no": "2016061702", "transit_type":"1",   "warehouse_code": "USEA","tracking_number": "126654","receiving_desc": "","eta_date": "2016-06-20", "contacter": "kimi", "contact_phone": "0755", "verify": "0", "items": [ {"product_sku": "7001", "quantity": "10", "box_no": "1"  }, { "product_sku": "7002","quantity": "15", "box_no": "1" }], "street":"street"}	</paramsJson>
									<appToken>appToken</appToken>
									<appKey>appKey</appKey>
									<service>createAsn</service>
								</ns1:callService>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callServiceResponse>			<response>{"ask":"Success","message":"Success","receiving_code":"RV100002-140512-0001"}</response>
								</ns1:callServiceResponse>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
reference_no	string(32)	Require	入库单参考号
transit_type	Int	Option	0：中转代发；1：自发头程
income_type	Int	Option	交货方式，0自送，1揽收
warehouse_code	string	Require	目的仓
transit_warehouse_code	string	Require	交货仓，交货方式为自送时，必填
shipping_method	string	Option	运输方式，交货方式为自送时，必填
receiving_shipping_type	string	Require	交货方式：0：空运(默认)，2：快递 3：铁运，4：海运整柜，5：海运散货
tracking_number	string(64)	Option	跟踪号，交货方式为自送时，必填
receiving_desc	string(500)	Option	入库单描述
eta_date	date	Require	预计到达日期
verify	Int	Option	是否审核,0新建不审核(草稿状态)，1新建并审核，默认为0，审核通过之后，不可编辑
is_box_product	int	Option	是否仓库装箱商品 1否2是，默认为否，为2时items参数需要新增参数
items	Object	Require	入库单明细

items参数

参数名	数据类型	是否必填	说明
product_sku	string	Require	SKU
quantity	int	Require	数量
box_no	int	Require	箱号
fba_product_code	string	Option	FBA商品编码
fba_box_no	string	Option	箱唛号，is_box_product=2时为必填

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
receiving_code	String	系统生成的入库单号
Error	Object	参考Error格式

service：modifyAsn

请求xml

					<?xml version="1.0" encoding="UTF-8"?>
					<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
						<SOAP-ENV:Body>
							<ns1:callService>
								<paramsJson>	{ "receiving_code": "RV000011-160617-0006", "reference_no": "2016061702", "transit_type":"1",   "warehouse_code": "USEA","tracking_number": "126654","receiving_desc": "","eda_date": "2016-06-20", "contacter": "kimi", "contact_phone": "0755", "verify": "0", "items": [ {"product_sku": "7001", "quantity": "10", "box_no": "1"  }, { "product_sku": "7002","quantity": "15", "box_no": "1" }], "street":"street"}
								</paramsJson>
								<appToken>appToken</appToken>
								<appKey>appKey</appKey>
								<service>modifyAsn</service>
							</ns1:callService>
						</SOAP-ENV:Body>
					</SOAP-ENV:Envelope>

响应xml

					<?xml version="1.0" encoding="UTF-8"?>
					<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
						<SOAP-ENV:Body>
							<ns1:callServiceResponse>
								<response>{"ask":"Failure","message":"入库单[RV100002-140509-0008]不可编辑","receiving_code":"RV100002-140509-0008","Error":{"errMessage":"入库单[RV100002-140509-0008]不可编辑","errCode":"0"}}
								</response>
							</ns1:callServiceResponse>
						</SOAP-ENV:Body>
					</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
receiving_code	string	Require	入库单号
reference_no	string(32)	Require	入库单参考号
transit_type	Int	Option	0：中转代发；1：自发头程
income_type	Int	Option	交货方式，0自送，1揽收
warehouse_code	string	Require	目的仓
transit_warehouse_code	string	Require	交货仓，交货方式为自送时，必填
shipping_method	string	Option	运输方式，交货方式为自送时，必填
receiving_shipping_type	string	Require	交货方式：0：空运(默认)，2：快递 3：铁运，4：海运整柜，5：海运散货
tracking_number	string(64)	Option	跟踪号，交货方式为自送时，必填
receiving_desc	string(500)	Option	入库单描述
eta_date	date	Require	预计到达日期
verify	Int	Option	是否审核,0新建不审核(草稿状态)，1新建并审核，默认为0，审核通过之后，不可编辑
is_box_product	int	Option	是否仓库装箱商品 1否2是，默认为否，为2时items参数需要新增参数
items	Object	Require	入库单明细

items参数

参数名	数据类型	是否必填	说明
product_sku	string	Require	SKU
quantity	int	Require	数量
box_no	int	Require	箱号
fba_product_code	string	Option	FBA商品编码
fba_box_no	string	Option	箱唛号，is_box_product=2时为必填

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
receiving_code	String	系统生成的入库单号
Error	Object	参考Error格式

service：getAsnList

请求xml

					<?xml version="1.0" encoding="UTF-8"?>
					<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
						<SOAP-ENV:Body>
							<ns1:callService>
								<paramsJson>{ "pageSize": "1", "page": 1, "receiving_code": "", "receiving_code_arr": ["RV000011-160617-0006","RV000011-160617-0005"] }</paramsJson>
								<appToken>appToken</appToken>
								<appKey>appKey</appKey>
								<service>getAsnList</service>
							</ns1:callService>
						</SOAP-ENV:Body>
					</SOAP-ENV:Envelope>

响应xml

					<?xml version="1.0" encoding="UTF-8"?>
					<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
						<SOAP-ENV:Body>
							<ns1:callServiceResponse>			<response>{"ask":"Success","message":"","pagination":{"page":"1","pageSize":"1"},"nextPage":"true","count":"2","data":[{"receiving_code":"RV000011-160617-0005","income_type":"0","shipping_method":"","tracking_number":"126654","reference_no":"2016061711","warehouse_code":"USEA","transit_warehouse_code":"USEA","receiving_status":"C","receiving_desc":"","receiving_add_time":"2016-06-17 14:58:56","receiving_modify_time":"2016-06-17 14:58:56","eta_date":"0000-00-00","region_id_level0":"","region_id_level1":"","region_id_level2":"","street":"","contacter":"","contact_phone":"","box_total":"1","sku_total":"25","sku_species":"2","items":[{"product_sku":"7001","quantity":"10","box_no":"1","package_type":"ow","received_qty":"0","putaway_qty":"0","fba_product_code":""},{"product_sku":"7002","quantity":"15","box_no":"1","package_type":"ow","received_qty":"0","putaway_qty":"0","fba_product_code":""}]}]}</response>
							</ns1:callServiceResponse>
						</SOAP-ENV:Body>
					</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
pageSize	Int	Require	每页数据长度，最大值为20
page	Int	Require	当前页
receiving_code	string	Option	入库单号
receiving_code_arr	Object	Option	多个入库单号,数组格式
create_date_from	date	Option	创建开始日期
create_date_to	date	Option	创建结束日期
modify_date_from	date	Option	修改开始时间
modify_date_to	date	Option	修改结束时间

（注传入了入库单号已入库单为准时间参数无效）

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
pagination	Object	参考pagination格式
count	Int	总数量
nextPage	String	是否有下一页,true表示有，false表示没有
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
receiving_code	string	入库单号
reference_no	string	入库单参考号
income_type	Int	交货方式，0自送，1揽收
warehouse_code	string	目的仓库
transit_warehouse_code	string	交货仓库
shipping_method	string	运输方式
tracking_number	string	跟踪号
receiving_status	string	跟入库单状态 C:新建 W:头程在途 P:头程收货中 Z:转运中 G:目的仓库收货中 F:目的仓收货完成 X:废弃踪号
receiving_desc	string	入库单说明
eta_date	date	预计到达日期
receiving_add_time	date	创建日期
receiving_modify_time	date	修改日期
box_total	int	总箱数
sku_total	int	产品总数
sku_species	int	SKU种类
items	Object	入库单明细

items参数

参数名	数据类型	说明
product_sku	string	SKU
quantity	int	数量
box_no	int	箱号
fba_product_code	string	FBA商品编码
package_type	string	包装类型
received_qty	int	收货数量
putaway_qty	int	上架数量

service：getProductInventory

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callService>			<paramsJson>{"pageSize":"1","page":1,"product_sku":"","product_sku_arr":[],"warehouse_code":"USEA","warehouse_code_arr":[]}</paramsJson>
									<appToken>appToken</appToken>
									<appKey>appKey</appKey>
									<service>getProductInventory</service>
								</ns1:callService>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callServiceResponse>			<response>{"ask":"Success","message":"Success","nextPage":"true","pagination":{"page":"1","pageSize":"1"},"count":"137","data":[{"product_barcode":"000011-TEST150810002","product_sku":"TEST150810002","warehouse_code":"USEA","onway":"1482","pending":"31","sellable":"10335","unsellable":"0","reserved":"10","shipped":"18","sold_shared":"0","product_sales_value":"0.00","warehouse_desc":"美东仓库"}]}</response>
								</ns1:callServiceResponse>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
pageSize	Int	Require	每页数据长度，最大值为100
page	Int	Require	当前页
product_sku	string	Option	SKU
product_sku_arr	Object	Option	多个SKU,数组格式
warehouse_code	string	Option	仓库代码
warehouse_code_arr	Object	Option	多个仓库代码,数组格式

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
pagination	Object	参考pagination格式
count	Int	总数量
nextPage	String	是否有下一页,true表示有，false表示没有
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
product_sku	string	SKU
warehouse_code	string	仓库代码
onway	int	在途数量
pending	int	待上架数量
sellable	int	可售数量
unsellable	int	不合格数量
reserved	int	待出库数量
shipped	int	历史出库数量
product_barcode	string	商品条码（客户代码-商品编码）
sold_shared	int	已销售的共享数量
product_sales_value	int	商品销售价值
warehouse_desc	int	仓库描述

service：createOrder

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callService>
									<paramsJson>
										{"reference_no":"20160617004","platform":"EBAY","shipping_method":"FEDEX-SMALLPARCEL","warehouse_code":"USEA","country_code":"US","province":"FL","city":"Miami","address1":"248 5TH AVE W","address2":"","address3":"","zipcode":"33178","order_desc":"订单备注","doorplate":"","name":"Katiuska Mora","phone":"786 837 4933","email":"","verify":0,"forceVerify":0,"is_signature":0,"items":[{"product_sku":"00853","quantity":1,"op_ref_tnx":"12454","op_ref_item_id":"78945"}],"fileToUpload":"data:application/msword;base64,UEsDBAoAAAAAAIdO4kAAAAAAAAAA..."} </paramsJson>
									<appToken>appToken</appToken>
									<appKey>appKey</appKey>
									<service>createOrder</service>
								</ns1:callService>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callServiceResponse>			<response>{"ask":"Success","message":"Success","order_code":"000011-160617-0001"}</response>
								</ns1:callServiceResponse>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
reference_no	string(32)	Require	订单参考号(建议使用平台单号)
platform	string	Option	平台， EBAY, AMAZON, WISH, ALIEXPRESS OTHER 默认OTHER
shipping_method	string(32)	Option	配送方式，参考getShippingMethod
order_desc	string(512)	Option	备注
warehouse_code	string	Require	配送仓库，参考getWarehouse
country_code	string	Require	收件人国家/地区，参考getCountry
province	string(64)	Require	省
city	string(32)	Require	城市
address1	string(216)	Require	地址1
address2	string(216)	Require	地址2
zipcode	string(64)	Require	邮编
doorplate	string(32)	Option	门牌号
name	string(128)	Require	收件人姓名
phone	string(64)	Require	收件人联系方式
email	string(64)	Option	收件人邮箱
verify	Int	Option	是否审核,0新建不审核(草稿状态)，1新建并审核，默认为0，审核通过之后，不可编辑
is_signature	int	Option	签名服务 1：签名服务 0:b不选择签名服务, 不填默认为0
is_insurance	int	Option	保险服务, 不填为0
insurance_value	int	Option	保额, 不填为0
fba_shipment_id	string	Option	FBA Shipment ID
fba_shipment_id_suffix	int	Option	FBA Shipment ID后缀 1:是 0:否, 不填默认为1
fba_shipment_id_create_time	string	Option	FBA Shipment ID创建时间
box_qty	int	Option	箱数
is_box_product	int	Option	是否仓库装箱商品 1否2是，默认为否，为2时items参数需要更换
ioss_code	string(100)	Option	IOSS号码 ①所有从欧盟境外进入欧盟境内且销售价格≤150EUR的B2C包裹，在平台代扣代缴后，卖家将会获得IOSS号码。 ②DPD国际件非必填，但是若未填则仍需使用DDU的付税模式且只能发以下7个国家：Germany, France, Netherlands, Ireland, Spain, Austria & Italy。 ③Hermes国际非必填，但是若未填则仍需使用DDU的付税模式且只能发Ireland and the Netherlands。 ④发往北爱尔兰的包裹暂时不需要IOSS。
sender_vat	string(100)	Option	发件人VAT ①DPD国际件暂时非必填。 ②hermes国际件暂时非必填。
sender_eori	string(100)	Option	发件人EORI ①DPD国际件必填。 ②hermes国际件必填。
recipient_vat	string(100)	Option	收件人VAT ①DPD国际发B2C包裹，则收件人的VAT暂时非必填；DPD国际发B2B包裹，则收件人的VAT必填。 ②hermes国际件暂时非必填。
recipient_eori	string(100)	Option	收件人EORI ①DPD国际发B2C包裹，则收件人的VAT暂时非必填；DPD国际发B2B包裹，则收件人的VAT必填。 ②hermes国际暂时非必填。
pid_number	string(100)	Option	PID号码 ①该号码为收件人的身份证号码。 ②发往西班牙（150€以上）意大利的DPD国际件需必填，其他国家暂时非必填。
items	Object	Require	订单明细
fileToUpload	string(base64)	Option	data:application/msword;base64,UEsDBAo......

items参数

参数名	数据类型	是否必填	说明
product_sku	string	Require	SKU
quantity	int	Require	数量
fba_product_code	string	Option	FBA商品编码
op_ref_tnx	string	Option	Transaction ID(明细ID)
op_ref_item_id	string	Option	Item ID(挂单Id)
box_no	string	Option	箱唛号，装箱列表接口获取,is_box_product=2时为必填
fba_box_label	string	Option	FBA箱唛号

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
order_code	String	系统生成的订单号
Error	Object	参考Error格式

service：modifyOrder

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callService>			<paramsJson>{"order_code":"000011-160617-0001","reference_no":"20160617004","platform":"EBAY","shipping_method":"FEDEX-SMALLPARCEL","order_desc":"订单备注","warehouse_code":"USEA","country_code":"US","province":"FL","city":"Miami","address1":"248 5TH AVE W","address2":"","address3":"","zipcode":"33178","doorplate":"","name":"Katiuska Mora","phone":"786 837 4933","email":"","verify":0,"forceVerify":0,"is_signature":0,"is_insurance":"1","insurance_value":"20", "is_shipping_method_not_allow_update":"0","items":[{"product_sku":"00853","quantity":1,"op_ref_tnx":"12454","op_ref_item_id":"78945"}],"fileToUpload":"data:application/msword;base64,UEsDBAoAAAAAAIdO4kAAAAAAAAAA..."} </paramsJson>
									<appToken>appToken</appToken>
									<appKey>appKey</appKey>
									<service>modifyOrder</service>
								</ns1:callService>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callServiceResponse>
							<response>{"ask":"Success","message":"Success","order_code":"000011-160617-0001"}</response>
								</ns1:callServiceResponse>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
order_code	string	Require	订单号
reference_no	string(32)	Require	订单参考号(建议使用平台单号)
order_desc	string(512)	Require	订单备注
platform	string	Option	平台， EBAY, AMAZON, WISH, ALIEXPRESS OTHER 默认OTHER
shipping_method	string(32)	Option	配送方式，参考getShippingMethod
warehouse_code	string	Require	配送仓库，参考getWarehouse
country_code	string	Require	收件人国家/地区，参考getCountry
province	string(64)	Require	省
city	string(32)	Require	城市
address1	string(216)	Require	地址1
address2	string(216)	Require	地址2
zipcode	string(64)	Require	邮编
doorplate	string(32)	Option	门牌号
name	string(128)	Require	收件人姓名
phone	string(64)	Require	收件人联系方式
email	string(64)	Option	收件人邮箱
verify	Int	Option	是否审核,0新建不审核(草稿状态)，1新建并审核，默认为0，审核通过之后，不可编辑
is_signature	int	Option	签名服务 1：签名服务 0:b不选择签名服务, 不填默认为0
is_insurance	int	Option	保险服务, 不填为0
insurance_value	int	Option	保额, 不填为0
fba_shipment_id	string	Option	FBA Shipment ID
fba_shipment_id_suffix	int	Option	FBA Shipment ID后缀 1:是 0:否, 不填默认为1
fba_shipment_id_create_time	string	Option	FBA Shipment ID创建时间
box_qty	int	Option	箱数
is_box_product	int	Option	是否仓库装箱商品 1否2是，默认为否，为2时items参数需要更换
ioss_code	string(100)	Option	IOSS号码 ①所有从欧盟境外进入欧盟境内且销售价格≤150EUR的B2C包裹，在平台代扣代缴后，卖家将会获得IOSS号码。 ②DPD国际件非必填，但是若未填则仍需使用DDU的付税模式且只能发以下7个国家：Germany, France, Netherlands, Ireland, Spain, Austria & Italy。 ③Hermes国际非必填，但是若未填则仍需使用DDU的付税模式且只能发Ireland and the Netherlands。 ④发往北爱尔兰的包裹暂时不需要IOSS。
sender_vat	string(100)	Option	发件人VAT ①DPD国际件暂时非必填。 ②hermes国际件暂时非必填。
sender_eori	string(100)	Option	发件人EORI ①DPD国际件必填。 ②hermes国际件必填。
recipient_vat	string(100)	Option	收件人VAT ①DPD国际发B2C包裹，则收件人的VAT暂时非必填；DPD国际发B2B包裹，则收件人的VAT必填。 ②hermes国际件暂时非必填。
recipient_eori	string(100)	Option	收件人EORI ①DPD国际发B2C包裹，则收件人的VAT暂时非必填；DPD国际发B2B包裹，则收件人的VAT必填。 ②hermes国际暂时非必填。
pid_number	string(100)	Option	PID号码 ①该号码为收件人的身份证号码。 ②发往西班牙（150€以上）意大利的DPD国际件需必填，其他国家暂时非必填。
items	Object	Require	订单明细
fileToUpload	string(base64)	Option	data:application/msword;base64,UEsDBAo......

items参数

参数名	数据类型	是否必填	说明
product_sku	string	Require	SKU
quantity	int	Require	数量
fba_product_code	string	Option	FBA商品编码
op_ref_tnx	string	Option	Transaction ID(明细ID)
op_ref_item_id	string	Option	Item ID(挂单Id)
box_no	string	Option	箱唛号，装箱列表接口获取,is_box_product=2时为必填
fba_box_label	string	Option	FBA箱唛号

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
order_code	String	系统生成的订单号
Error	Object	参考Error格式

service：getOrderByCode

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/"><SOAP-ENV:Body><ns1:callService><paramsJson>{"order_code":"100057-141014-0001"}</paramsJson><appToken>xxxx</appToken><appKey>xxxx</appKey><service>getOrderByCode</service></ns1:callService></SOAP-ENV:Body></SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/"><SOAP-ENV:Body><ns1:callServiceResponse><response>{"ask":"Success","message":"","data":{"order_code":"100057-141014-0001","reference_no":"","platform":"AMAZON","order_status":"4","shipping_method":"UPS","tracking_no":"1ZA6A7320398417929","warehouse_code":"USPA","order_weight":"2.2650","order_desc":"","date_create":"2014-10-14 00:53:57","date_release":"2014-10-14 00:54:13","date_shipping":"2014-10-14 01:42:31","date_modify":"2014-10-14 00:54:13","consignee_country_code":"US","consignee_country_name":"UNITED STATES ","consignee_state":"PA","consignee_city":"york","consignee_district":"","consignee_address1":"805 priority road","consignee_address2":"","consignee_address3":"","consigne_zipcode":"17404","consignee_doorplate":"","consignee_company":"","consignee_name":"eva","consignee_phone":"1234567890","consignee_email":"","fee_details":{"totalFee":"78.800","SHIPPING":"66.800","OPF":"6.000","FSC":"0.000","RSF":"0.000","WHF":"0.000","DT":"0.000","OTF":"0.000"},"items":[{"product_sku":"TEST1012","quantity":"1"},{"product_sku":"TEST1012BIG1","quantity":"1"}]}}</response></ns1:callServiceResponse></SOAP-ENV:Body></SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
order_code	string	Require	订单号

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
order_code	string	订单号
reference_no	string	客户参考号
platform	string	平台
order_status	string	订单状态 C:待发货审核 W:待发货 D:已发货 H:暂存 N:异常订单 P:问题件 X:废弃
shipping_method	string	配送方式
tracking_no	string	跟踪号
warehouse_code	string	配送仓库代码
order_weight	float	订单重量
order_desc	string	订单说明
date_create	datetime	创建时间
date_release	datetime	审核时间
date_shipping	datetime	出库时间
date_modify	datetime	修改时间
consignee_country_code	string	收件人国家/地区二字码
consignee_country_name	string	收件人国家/地区
consignee_state	string	省
consignee_city	string	城市
consignee_district	string	区域
consignee_address1	string	地址1
consignee_address2	string	地址2
consigne_zipcode	string	邮编
consignee_doorplate	string	门牌号
consignee_company	string	公司
consignee_name	string	收件人姓名
consignee_phone	string	收件人电话
consignee_email	string	收件人邮箱
items	Object	订单明细
fee_details	Object	订单费用
orderBoxInfo	Object	一票多箱装箱明细，一票一箱则返回空

items参数

参数名	数据类型	说明
product_sku	string	SKU
quantity	int	数量

fee_details参数

参数名	数据类型	说明
totalFee	float	总费用
SHIPPING	float	运输费
OPF	float	操作费用
FSC	float	燃油附加费
DT	float	关税
RSF	float	挂号
WHF	float	仓租
OTF	float	其它费用

service：getOrderByRefCode

请求xml

						?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/"><SOAP-ENV:Body><ns1:callService><paramsJson>{"reference_no":"12341113"}}</paramsJson><appToken>xxxx</appToken><appKey>xxxx</appKey><service>getOrderByRefCode</service></ns1:callService></SOAP-ENV:Body></SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/"><SOAP-ENV:Body><ns1:callServiceResponse><response>{"ask":"Success","message":"","data":{"order_code":"000011-160607-0020","reference_no":"12341113","platform":"OTHER","order_status":"W","shipping_method":"FEDEX-LARGEPARCEL","tracking_no":"74899992140426746941","warehouse_code":"USEA","order_weight":"0.0000","order_desc":"测试的单3","date_create":"2016-06-07 16:47:57","date_release":"2016-06-07 16:50:37","date_shipping":"","date_modify":"2016-06-07 16:50:37","consignee_country_code":"US","consignee_country_name":"UNITED STATES ","consignee_state":"IA","consignee_city":"CRESCO","consignee_district":"","consignee_address1":"248 5TH AVE W","consignee_address2":"","consignee_address3":"","consigne_zipcode":"52136-1255","consignee_doorplate":"","consignee_company":"","consignee_name":"kadjka3","consignee_phone":"","consignee_email":"","fee_details":{"totalFee":"51.263","SHIPPING":"28.000","OPF":"0.000","FSC":"1.263","RSF":"0.000","WHF":"0.000","DT":"0.000","OTF":"22.000"},"items":[{"product_sku":"00852","quantity":"1"}]}}</response></ns1:callServiceResponse></SOAP-ENV:Body></SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
reference_no	string	Require	参考号,仅返回有效订单数据

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
order_code	string	订单号
reference_no	string	客户参考号
platform	string	平台
order_status	string	订单状态 C:待发货审核 W:待发货 D:已发货 H:暂存 N:异常订单 P:问题件 X:废弃
shipping_method	string	配送方式
tracking_no	string	跟踪号
warehouse_code	string	配送仓库代码
order_weight	float	订单重量
order_desc	string	订单说明
date_create	datetime	创建时间
date_release	datetime	审核时间
date_shipping	datetime	出库时间
date_modify	datetime	修改时间
consignee_country_code	string	收件人国家/地区二字码
consignee_country_name	string	收件人国家/地区
consignee_state	string	省
consignee_city	string	城市
consignee_district	string	区域
consignee_address1	string	地址1
consignee_address2	string	地址2
consigne_zipcode	string	邮编
consignee_doorplate	string	门牌号
consignee_company	string	公司
consignee_name	string	收件人姓名
consignee_phone	string	收件人电话
consignee_email	string	收件人邮箱
items	Object	订单明细
fee_details	Object	订单费用
orderBoxInfo	Object	一票多箱装箱明细，一票一箱则返回空

items参数

参数名	数据类型	说明
product_sku	string	SKU
quantity	int	数量

fee_details参数

参数名	数据类型	说明
totalFee	float	总费用
SHIPPING	float	运输费
OPF	float	操作费用
FSC	float	燃油附加费
DT	float	关税
RSF	float	挂号
WHF	float	仓租
OTF	float	其它费用

service：getOrderList

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callService>			<paramsJson>{"pageSize":"1","page":"1","order_code":"","order_code_arr":[],"create_date_from":"","create_date_to":"","modify_date_to":""}</paramsJson>
									<appToken>appToken</appToken>
									<appKey>appKey</appKey>
									<service>getOrderList</service>
								</ns1:callService>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callServiceResponse>			<response>{"ask":"Success","message":"","pagination":{"page":"1","pageSize":"1"},"nextPage":"true","count":"115","data":[{"company_code":"100002","order_code":"0686140412-0001","refrence_no":"M-20140412-001","platform":"ALIEXPRESS","order_status":"4","shipping_method":"A6","shipping_method_no":"RF601112795SG","warehouse_id":"1","warehouse_code":"HRBW","order_weight":"0.3100","order_desc":"","date_create":"2014-04-12
										11:19:05","date_release":"2014-04-12 13:34:13","date_shipping":"2014-04-14 10:34:02","date_modify":"2014-04-12				13:34:13","consignee_country_code":"RU","consignee_country_name":"RUSSIA","consignee_state":"jklhjlkj","consignee_city":"kjlkj","consignee_street1":"hkjhjkhjk","consignee_street2":"","consignee_street3":"","consignee_district":"","consigne_zipcode":"800600","consignee_doorplate":"","consignee_company":"","consignee_name":"kjlkjk","consignee_phone":"186649857042","consignee_email":"","fee_summery":{"order_code":"0686140412-0001","shipping_method":"RUSTON-3C","country_code":"RU","order_weight":"0.500","ship_cost":"96.000","op_cost":"0.000","fuel_cost":"0.000","register_cost":"0.000","warehouse_cost":"0.000","tariff_cost":"0.000","incidental_cost":"0.000"},"order_fee":[{"type":"shipping","amount":"96.000","currency_code":"RMB"}],"items":[{"product_id":"3385","product_sku":"M-001","quantity":"1"}]}]}</response>
								</ns1:callServiceResponse>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
pageSize	Int	Require	每页数据长度，最大值100
page	Int	Require	当前页
order_code	string	Option	订单号
order_code_arr	Object	Option	多个订单号,数组格式
shipping_method	string	Option	运输方式代码
create_date_from	datetime	Option	订单创建开始时间，格式YYYY-MM-DD HH:II:SS 订单号传值时，该参数无效
create_date_to	datetime	Option	订单创建结束时间，格式YYYY-MM-DD HH:II:SS 订单号传值时，该参数无效
modify_date_from	datetime	Option	订单修改开始时间，格式YYYY-MM-DD HH:II:SS 订单号传值时，该参数无效
modify_date_to	datetime	Option	订单修改结束时间，格式YYYY-MM-DD HH:II:SS 订单号传值时，该参数无效
date_shipping_from	datetime	Option	订单物流开始时间，格式YYYY-MM-DD HH:II:SS 订单号传值时，该参数无效
date_shipping_to	datetime	Option	订单物流结束时间，格式YYYY-MM-DD HH:II:SS 订单号传值时，该参数无效
Order_status	datetime	String	订单状态 C:待发货审核 W:待发货 D:已发货 H:暂存 N:异常订单 P:问题件 X:废弃

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
pagination	Object	参考pagination格式
count	Int	总数量
nextPage	String	是否有下一页,true表示有，false表示没有
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
order_code	string	订单号
reference_no	string	客户参考号
platform	string	平台
order_status	string	订单状态 C:待发货审核 W:待发货 D:已发货 H:暂存 N:异常订单 P:问题件 X:废弃
shipping_method	string	配送方式
tracking_no	string	跟踪号
warehouse_code	string	配送仓库代码
order_weight	float	订单重量
order_desc	string	订单说明
date_create	datetime	创建时间
date_release	datetime	审核时间
date_shipping	datetime	出库时间
date_modify	datetime	修改时间
consignee_country_code	string	收件人国家/地区二字码
consignee_country_name	string	收件人国家/地区
consignee_state	string	省
consignee_city	string	城市
consignee_district	string	区域
consignee_address1	string	地址1
consignee_address2	string	地址2
consigne_zipcode	string	邮编
consignee_doorplate	string	门牌号
consignee_company	string	公司
consignee_name	string	收件人姓名
consignee_phone	string	收件人电话
consignee_email	string	收件人邮箱
items	Object	订单明细
fee_details	Object	订单费用
orderBoxInfo	Object	一票多箱装箱明细，一票一箱则返回空

items参数

参数名	数据类型	说明
product_sku	string	SKU
quantity	int	数量

fee_details参数

参数名	数据类型	说明
totalFee	float	总费用
SHIPPING	float	运输费
OPF	float	操作费用
FSC	float	燃油附加费
DT	float	关税
RSF	float	挂号
WHF	float	仓租
OTF	float	其它费用

service：getCalculateFee

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callService>
                                    <paramsJson>{"warehouse_code":"USEA","country_code":"US","shipping_method":"USPS-LWPARCEL","weight":"0.2","postcode":"84737"}</paramsJson>
									<appToken>appToken</appToken>
									<appKey>appKey</appKey>
									<service>getCalculateFee </service>
								</ns1:callService>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callServiceResponse>
                                    <response>{"ask":"Success","message":"","data":[{"sm_code":"MORKRM","totalAmount":71.846,"aging":0,"feeDetail":[{"ft_code":"shipping","amount":"70.346","currency_code":"RMB","ft_name":"运输费"},{"ft_code":"LLF","amount":"1.500","currency_code":"RMB","ft_name":"超长费"}],"sm_delivery_time_min":"3","sm_delivery_time_max":"3","sm_name_cn":"MORKRM","sm_name":"MORKRM","ask":"Success","message":"Success"}]}</response>
								</ns1:callServiceResponse>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
warehouse_code	stringstring	Require	发货仓库代码
country_code	string	Require	目的国家/地区代码
shipping_method	string	Require	配送方式
postcode	string	Option	邮政编码
type	int	Require	查询类型，type=1时为重量查询方式，type=2时为sku查询方式
weight	float	Require	包裹重量，type=1时必填
length	float	Option	包裹长
width	float	Option	包裹宽
height	float	Option	包裹高
pieces	int	Option	订单内件数
sku	Object	Option	type=2时，sku对象必填,可多维，例：sku[{"product_barcode":"000028-MTLL","quantity":1}]
product_barcode	string	Require	产品名称，所属sku参数
quantity	int	Require	数量，所属sku参数

response参数

参数名	数据类型	说明
ask	string	Success查询成功，Failure查询错误
message	string	返回信息
data	object	数据内容

data参数

参数名	数据类型	说明
totalFee	float	总费用
SHIPPING	float	运输费
OPF	float	操作费用
FSC	float	燃油附加费
DT	float	关税
RSF	float	挂号
WHF	float	仓租
OTF	float	其它费用
LLSC	float	超长附加费
LLF	float	超长费
LOC	float	超长超大费
ODAR	float	偏远费
ODASR	float	超偏远费
WHOSCOW	float	仓储操作附加费按重量
WHOSCOP	float	仓储操作附加费按件数
OWF	float	超重费

service：batchGetCalculateFee

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callService>
                                    <paramsJson>{"warehouse_code":"USEA","country_code":"US","shipping_method":"USPS-LWPARCEL,FEDEX-SMALLPARCEL,FEDEX_GROUND,FEDEX-EVSPM","weight":"0.2","postcode":"84737"}</paramsJson>
									<appToken>appToken</appToken>
									<appKey>appKey</appKey>
									<service>batchGetCalculateFee</service>
								</ns1:callService>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
						<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
							<SOAP-ENV:Body>
								<ns1:callServiceResponse>
                                <response>{"ask":"Success","message":"","data":[{"shipping_method":"USPS-LWPARCEL","ask":"Failure","Error":{"errCode":10203026,"errMessage":"未找到价格方案"},"data":{"aging":""}},{"shipping_method":"FEDEX-SMALLPARCEL","ask":"Success","data":{"SHIPPING":1.1,"OPF":0,"FSC":0,"DT":0,"RSF":0,"WHF":0,"OTF":0,"RDF":0,"totalFee":2.6,"LLSC":0,"LLF":1.5,"LOC":0,"ODAR":0,"ODASR":0,"WHOSCOW":0,"WHOSCOP":0,"OWF":0,"aging":""}},{"shipping_method":"FEDEX_GROUND","ask":"Success","data":{"SHIPPING":30,"OPF":0,"FSC":0,"DT":0,"RSF":0,"WHF":0,"OTF":0,"RDF":0,"totalFee":31.5,"LLSC":0,"LLF":1.5,"LOC":0,"ODAR":0,"ODASR":0,"WHOSCOW":0,"WHOSCOP":0,"OWF":0,"aging":""}},{"shipping_method":"FEDEX-EVSPM","ask":"Failure","Error":{"errCode":10203026,"errMessage":"未找到价格方案"},"data":{"aging":""}}]}</response>
								</ns1:callServiceResponse>
							</SOAP-ENV:Body>
						</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
warehouse_code	String	Require	发货仓库代码
country_code	string	Require	目的国家/地区代码
shipping_method	string	Require	配送方式(多个以逗号隔开，最多15个)
postcode	string	Option	邮政编码
weight	float	Require	包裹重量
length	float	Option	包裹长
width	float	Option	包裹宽
height	float	Option	包裹高
pieces	int	Option	订单内件数

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data参数(二维数组)

参数名	数据类型	说明
shipping_method	String	配送方式
ask	String	运算结果，Success表示成功，Failure表示失败
Error	Object	参考Error格式
data	Object	数据内容，ask为Success才返回
├─totalFee	float	总费用
├─SHIPPING	float	运输费
├─OPF	float	操作费用
├─FSC	float	燃油附加费
├─DT	float	关税
├─RSF	float	挂号
├─WHF	float	仓租
├─OTF	float	其它费用
├─LLSC	float	超长附加费
├─LLF	float	超长费
├─LOC	float	超长超大费
├─ODAR	float	偏远费
├─ODASR	├─float	超偏远费
├─WHOSCOW	float	仓储操作附加费按重量
├─WHOSCOP	float	仓储操作附加费按件数
├─OWF	float	超重费

service： verifyAddressInfo

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
                                           xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>
                                        {"address":{"oab_firstname":"DRGE","oab_company":"","oab_street_address1":"7501 Ida Ave
N.","oab_street_address2":"","oab_state":"FL","oab_city":"Lehigh
Acres","oab_postcode":"33971","country_code":"US","oab_phone":"DGS2596"},"shipping_meth
od":"FEDEX-3-DAY"}</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>asnSkuPrint</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>
                                    <response>{"ask":"Success","message":"","data":"","IsResidential":false}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
address	object	Require	地址信息
shipping_method	string	Require	配送方式

address 参数

参数名	数据类型	是否必填	说明
oab_firstname	string	Require	收件人名字
oab_company	string	option	收件人姓
oab_street_address1	string	Require	收件人地址 1
oab_state	string	option	州
oab_city	string	Require	城市
oab_postcode	string	Require	邮编
country_code	string	Require	国家/地区简称
oab_phone	string	option	联系电话
oab_street_address2	string	option	地址 2

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
address	Object	校验后的地址信息
Error	Object	参考Error格式

data 参数

参数名	数据类型	说明
oab_firstname	string	收件人名字
oab_company	string	公司
oab_street_address1	string	地址 1
oab_state	string	州
oab_city	string	城市
oab_postcode	string	邮编
country_code	string	国家/地区简称
oab_phone	string	联系电话
oab_street_address2	string	地址 2
is_residential	string	0-非住宅，1-住宅

service：asnSkuPrint

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
                                           xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>{"receiving_code": "RV000010-170822-0045", "print_size": "1","print_code": "1", "product_barcode_arr":["000010-SHOUCHIJI003","000010-SHOUCHIJI004"] }</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>asnSkuPrint</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>
                                    <response>{"ask":"Success","Error":{"errorMessage":"","errCode":""},"data":{"label_image":"base64","image_type":"2"}}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
receiving_code	string	Option	入库单号
print_size	Int	Require	打印尺寸（1：6020，2：7030， 3：100*30）
print_code	Int	Require	打印编码(1：产品名称，2：made in china，3：1 和 2，4：都不选)
product_barcode_arr	Array	Option	SKU(一次不能超过 50 个)

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data 参数

参数名	数据类型	说明
label_image	string	返回图片
image_type	Int	图片类型 1：png，2：pdf

service：printReceivingInfo

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
                                           xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>{"receiving_code": "RV000028-170822-0045", "print_size": "1","print_type": "1", "receiving_box_no_arr": ["1","2"] }</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>printReceivingInfo</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>
                                    <response>{"ask":"Success","Error":{"errorMessage":"","errCode":""},"data":{"label_image":"base64","image_type":"2"}}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
receiving_code	string	Option	入库单号
print_size	Int	Require	打印尺寸（1：6020，2：7030， 3：100*30）
print_type	Int	Require	打印编码(1：产品名称，2：made in china，3：1 和 2，4：都不选)
product_barcode_arr	Array	Option	SKU(一次不能超过 50 个)

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data 参数

参数名	数据类型	说明
label_iamge	string	返回图片
image_type	Int	图片类型 1：png，2：pdf

service：getWarehouseOfAge

请求xml

						<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
                                           xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callService>
                                    <paramsJson>{"warehouse": "USEA","product_barcode": "000028-20121202002", "part_time": "181-360","dateFor":"2020-04-01 09:05:05","dateTo":"2020-05-30 18:05:05" }</paramsJson>
                                    <appToken>appToken</appToken>
                                    <appKey>appKey</appKey>
                                    <service>getWarehouseOfAge</service>
                                </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

						<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>
                                    <response>{"ask":"Success","Error":{"errorMessage":"","errCode":""},"data":{"product_barcode":"000028-20121202002","receiving_code":"RV000028-180202-0001","ib_quantity":"20000","ib_add_time":"2019-05-13 09:17:12","ib_update_time":"2020-05-13 18:20:20","age":366,"product_title":"iphone","warehouse_desc":"美东仓库","warehouse_code":"USEA","ageGroup":">360","ig_name":"手机与配件"}}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
warehouse	string	Require	仓库名称
product_barcode	string	Option	产品代码
product_title	string	Option	产品名称
part_time_start	int	Option	库龄分段开始时间(单位天)
part_time_end	int	Option	库龄分段结束时间(单位天)
dateFor	string	Option	上架开始时间
dateTo	string	Option	上架结束时间

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data 参数

参数名	数据类型	说明
product_barcode	string	产品代码
receiving_code	string	入库单号
ib_quantity	string	可用数量
ib_add_time	string	上架时间
ib_update_time	string	更新时间
age	int	库龄
product_title	string	产品名称
warehouse_desc	string	仓库名称
warehouse_code	string	仓库代码
ageGroup	string	库龄分段
ig_name	string	品类名称

service：createAfterReturnOrder

请求xml

                        <?xml version="1.0" encoding="utf-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                        <SOAP-ENV:Body>
                            <ns1:callService>
                                <paramsJson>{"order_code": "G591-170914-0009","is_verify": "1","ref_no": "565656ss","logistics": "0","is_auth":"0","warehouse_code": "USWE","courier": "TJDX-XF","tracking_no": "sss","ro_desc": "gdfgdfg","photo_no":10,"op_quantity": [{"product_barcode": "BZD123456","num": 1}]}</paramsJson>
                                <appToken>7cd679ff689e3eeffa4a77d4e93670d2</appToken>
                                <appKey>bb7c538e566ca6ad8f462a9cb153bac6</appKey>
                                <service>createAfterReturnOrder</service>
                            </ns1:callService>
                        </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                                <?xml version="1.0" encoding="UTF-8"?>
                                <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                                    <SOAP-ENV:Body>
                                        <ns1:callServiceResponse>
                                            <response>{"ask":"Success","message":"Success","asro_code":"RG591-170916-0040","tracking_no":"787748373502"}</response>
                                        </ns1:callServiceResponse>
                                    </SOAP-ENV:Body>
                                </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
order_code	string	Require	订单号
ref_no	string		参考号
is_verify	string		是否审核 0-否 1-是
logistics	string	Require	派送方式 0代选，1自选
warehouse_code	string	Require	退件收货仓库
courier	string	Require	物流产品（代选物流必须填写）
tracking_no	string	Require	跟踪号(自选物流必须填写)
is_auth	string		是否授权 0 未授权1 授权默认授权
photo_no	Int		拍照数量
ro_desc	string		退件原因
op_quantity	Object	Require	退件产品明细

op_quantity参数

参数名	数据类型	是否必填	说明
product_barcode	string	Require	产品编码
num	int	Require	数量

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
Asro_code	String	系统生成的售后单号
Error	Object	参考Error格式

service：updateAfterReturnOrder

请求xml

    <?xml version="1.0" encoding="utf-8"?>
    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callService>
            <paramsJson>{"return_code": "RG296-170916-0001","logistics":"0","is_auth": "1","warehouse_code": "USEA","courier": "TJDX-XF","tracking_no": "","photo_no":4,"ro_desc": "测试接口","op_quantity": [{"product_barcode": "SKU8945421522","num":2}]}</paramsJson>
            <appToken>fb178604c152295c3e4a6a467cd31ed8</appToken>
            <appKey>003d7d1a5070ce2660af15b0e394c8b0</appKey>
            <service>updateAfterReturnOrder</service>
        </ns1:callService>
    </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

响应xml

    <?xml version="1.0" encoding="UTF-8"?>
    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
        <SOAP-ENV:Body>
            <ns1:callServiceResponse>
                <response>{"ask":"Success","message":"Success","asro_code":"RG296-170916-0001"}</response>
            </ns1:callServiceResponse>
        </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
return_code	string	Require	退件号
logistics	string	Require	派送方式 0代选，1自选
warehouse_code	string	Require	退件收货仓库
courier	string	Require	物流产品（代选物流必须填写）
tracking_no	string	Require	跟踪号(自选物流必须填写)
is_auth	string		是否授权 0 未授权1 授权默认授权
photo_no	Int		拍照数量
ro_desc	string		退件原因
op_quantity	Object	Require	退件产品明细

op_quantity参数

参数名	数据类型	是否必填	说明
product_barcode	string	Require	产品编码
num	int	Require	数量

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
Asro_code	String	售后单号
Error	Object	参考Error格式

service：returnAfterOrderDiscard

请求xml

    <?xml version="1.0" encoding="utf-8"?>
    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callService>
            <paramsJson>{"ro_code":"RG591-170916-0031","new_desc":"退件原因"}</paramsJson>
            <appToken>7cd679ff689e3eeffa4a77d4e93670d2</appToken>
            <appKey>bb7c538e566ca6ad8f462a9cb153bac6</appKey>
            <service>returnAfterOrderDiscard</service>
        </ns1:callService>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

响应xml

    <?xml version="1.0" encoding="UTF-8"?>
    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
        <SOAP-ENV:Body><ns1:callServiceResponse><response>{"ask":"Success","message":"Success","result":"1"}</response>
            </ns1:callServiceResponse>
        </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
ro_code	string	Require	退件号
new_desc	string		退件原因

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
result	String	1表示成功，2表示失败
Error	Object	参考Error格式

service：getAfterReturnOrders

请求xml

                        <?xml version="1.0" encoding="utf-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                        <SOAP-ENV:Body>
                            <ns1:callService>
                                <paramsJson>{"pageSize": "2","startTime": "2017-09-12 11:00:00","endTime": "2017-11-13 10:08:00","asroStatus": "","cassType": "","asroCodes": "","currentPage": "3","tracking_no":"","order_code":"000028-230506-0000","reference_no":""}</paramsJson>
                                <appToken>fb178604c152295c3e4a6a467cd31ed8</appToken>
                                <appKey>d823f75b368d59046a00ff9de1970cb3</appKey>
                                <service>getAfterReturnOrders</service>
                            </ns1:callService>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                        <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                    <response>
                                        {"ask":"Success","message":"Success","pagination":{"page":3,"pageSize":2},"data":[{"asro_code":"RG562-171019-0001","reference_no":"","asro_status":"2","cass_type":"1","asro_add_time":"2017-10-19 09:58:59","asro_putaway_time":null,"asro_audit_time":"2017-10-19 10:01:04","warehouse_code":"USEA","sm_code":"TUIJIANZIXUAN","sm_type":"1","tracking_no":"GZ10086","asro_reason":"","product_detail":[{"product_barcode":"G562-2017_1","quantity":1,"sellable_qty":0,"unsellable_qty":0,"pas_codes":["SHM20171019000001"]}],"is_auth":"0"}],"Error":{"errCode":"","errMessage":""},"count":"5","nextPage":"false"}
                                    </response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
pageSize	string	Require	每页数据长度, 最大值100
currentPage	string	Require	当前页
startTime	string		创建时间
endTime	string		结束时间
asroStatus	string		退件状态（0-待审核,1-待处理,2-待确认,3-已确认,4-收货完成,5-处理完成,6-废弃,7-销毁）
cassType	string		退件类型 0-服务商退件，1-客户退件，2-未预报退件
asroCodes	string		退件单号
reference_no	string		参考号
order_code	string		关联订单号
tracking_no	string		跟踪号

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
asro_code	string	退件单号
reference_no	string	参考号
asro_status	string	退件状态
cass_type	string	退件类型0-服务商退件，1-客户退件，2-未预报退件
asro_add_time	string	创建时间
asro_audit_time	string	审核时间
asro_putaway_time	string	上架完成时间
warehouse_code	string	退件收货仓库
sm_type	string	派送方式 0-代选物流，1-自选物流
tracking_no	string	跟踪号
asro_reason	string	退件原因
is_auth	string	0-未授权，1-授权
product_detail	Object	退件产品明细

product_detail参数

参数名	数据类型	说明
product_barcode	string	产品编号
quantity	Int	退件数量
sellable_qty	Int	良品数量
unsellable_qty	Int	不良品数量
return_replacement_sku	string	换标产品代码
ro_pd_quantity	Int	上架数量
destruction_qty	Int	销毁数量
pas_codes	Object	售后码集合

service：searchReturnOrder

请求xml

                    <?xml version="1.0" encoding="utf-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                        <SOAP-ENV:Body>
                            <ns1:callService>
                                <paramsJson>{"asroCodes":"RG562-170828-0006","tracking_no":"","order_code":"000028-230506-0000","reference_no":""}</paramsJson>
                                <appToken>fb178604c152295c3e4a6a467cd31ed8</appToken>
                                <appKey>d823f75b368d59046a00ff9de1970cb3</appKey>
                                <service>searchReturnOrder</service>
                            </ns1:callService>
                        </SOAP-ENV:Body>
                    </SOAP-ENV:Envelope>

响应xml

                    <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>
                                    <response>{"ask":"Success","message":"Success","data":[{"asro_code":"RG562-170828-0006","reference_no":"ck009","asro_status":"3","cass_type":"1","asro_add_time":"2017-08-28 16:19:02","asro_putaway_time":null,"asro_audit_time":null,"warehouse_code":"USEA","sm_code":"FEDEXG-RETURN","sm_type":"2","tracking_no":"OT20170828011","asro_reason":"测试","product_detail":[{"product_barcode":"G562-2017_1","quantity":2,"sellable_qty":0,"unsellable_qty":0,"pas_codes":["SHM20170828000011","SHM20170828000012"]},{"product_barcode":"G562-2017_2","quantity":3,"sellable_qty":0,"unsellable_qty":0,"pas_codes":["SHM20170828000013","SHM20170828000014","SHM20170828000015"]}],"is_auth":"0"}]}</response>
                                </ns1:callServiceResponse>
                            </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	说明
reference_no	string	参考号
asroCodes	string	退件单号
order_code	string	关联订单号
tracking_no	string	跟踪号
以上参数四选一

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
asro_code	string	退件单号
reference_no	string	参考号
asro_status	string	退件状态（0-待审核,1-待处理,2-待确认,3-已确认,4-收货完成,5-处理完成,6-废弃,7-销毁）
cass_type	string	退件类型0-服务商退件，1-客户退件，2-未预报退件
asro_add_time	string	创建时间
asro_audit_time	string	审核时间
asro_putaway_time	string	上架完成时间
warehouse_code	string	退件收货仓库
sm_type	string	派送方式 0-代选物流，1-自选物流
tracking_no	string	跟踪号
asro_reason	string	退件原因
is_auth	string	0-未授权，1-授权
product_detail	Object	退件产品明细

product_detail参数

参数名	数据类型	说明
product_barcode	string	产品编号
quantity	Int	退件数量
sellable_qty	Int	良品数量
unsellable_qty	Int	不良品数量
return_replacement_sku	string	换标产品代码
ro_pd_quantity	Int	上架数量
destruction_qty	Int	销毁数量
pas_codes	Object	售后码集合

service：getReturnOrders

请求xml

                    <?xml version="1.0" encoding="utf-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                        <SOAP-ENV:Body>
                            <ns1:callService>
                                <paramsJson>{"ro_process_type":"1","ro_create_type": "1", "warehouse": "USEA","ro_status":"1","refrence_no_platform":"000028-160920-0011","ro_code":"R000028-170613-0001","tracking_number":"61299992140447224620","dateFor":"2020-06-02","dateTo":"2020-06-05" }</paramsJson>
                                <appToken>fb178604c152295c3e4a6a467cd31ed8</appToken>
                                <appKey>003d7d1a5070ce2660af15b0e394c8b0</appKey>
                                <service>getReturnOrders</service>
                            </ns1:callService>
                        </SOAP-ENV:Body>
                    </SOAP-ENV:Envelope>

响应xml

                    <?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                            <SOAP-ENV:Body>
                                <ns1:callServiceResponse>
                                    <response>{"ask":"Success","message":"Success","total":"51","data":[{"refrence_no_platform":"000028-170719-0004","ro_add_time":"2017-08-18 15:10:12","ro_desc":"买家退货","tracking_number":"74899992140457698189","ro_code":"R000028-170818-0001","ro_first_shelve_time":"2017-08-20 20:10:46","ro_receiving_time":"2017-08-18 15:10:46","type_name":"买家退件","warehouse":"USEA","status_name":"收货完成","process_type_name":"退件入库","product":[{"product_barcode":"000028-20161009","rop_quantity":"1","received_qty":"1","quantity_unsellable":"1","ro_pd_quantity":"0"}]}]}}</response>
                                </ns1:callServiceResponse></SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
warehouse	string	option	收货仓库
ro_process_type	string	option	处理方式(:0：未指定，1：退件入库)
ro_create_type	string	option	退件类型（0：买家退件，1：服务商退件）
ro_status	string	option	退件状态（0：已作废，1：待确认，2：待处理，3：到货异常，4：收货完成，5：上架完成）
refrence_no_platform	string	option	订单号
ro_code	string	option	退件单号
tracking_number	string	option	跟踪号
dateFor	string	option	创建开始时间
dateTo	string	option	创建结束时间

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
refrence_no_platform	string	订单号
warehouse	string	仓库
ro_code	string	退件单号
tracking_number	string	跟踪号
status_name	string	状态
type_name	string	退件类型
process_type_name	string	处理方式
ro_add_time	string	添加时间
ro_receiving_time	string	收货时间
ro_first_shelve_time	string	上架时间
ro_desc	string	备注
product	string	产品数据内容

product参数

参数名	数据类型	说明
product_barcode	string	产品代码
rop_quantity	string	数量
received_qty	string	实收数量
quantity_unsellable	string	不良品数量
ro_pd_quantity	string	上架数量

service：dealAfterOrderProduct

请求xml

                    <?xml version="1.0" encoding="utf-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                        <SOAP-ENV:Body>
                            <ns1:callService>
                                <paramsJson>{"asro_code":"RG562-171026-0001","ref_no": "ck00259","pas_codes": [{"pas_code": "SHM20171026000003","product_type": "0","deal_type": "0","new_sku":"G562-13548743318"}]}</paramsJson>
                                <appToken>fb178604c152295c3e4a6a467cd31ed8</appToken>
                                <appKey>003d7d1a5070ce2660af15b0e394c8b0</appKey>
                                <service>dealAfterOrderProduct</service>
                            </ns1:callService>
                        </SOAP-ENV:Body>
                    </SOAP-ENV:Envelope>

响应xml

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

paramsJson参数

参数名	数据类型	是否必填	说明
ref_no	string	Require	参考号
asro_code	string	Require	退件单号
pas_codes	object	Require	需要处理的售后码
退件号(退件号/参考号二选一,退件号不为空时，以退件号为准),处理时，该订单下所有的售后码都需要处理

pas_codes参数

参数名	数据类型	说明
pas_code	string	售后码
product_type	string	产品类型：0-良品，1-不良品
deal_type	string	处理方式0-重新上架（良品） 1- 销毁（不良品） 2-不良品上架（不良品）
new_sku	string	新sku

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
Error	Object	参考Error格式

service：getFbaPlanOrderList

请求xml

                        <?xml version="1.0" encoding="utf-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                        <SOAP-ENV:Body>
                            <ns1:callService>
                                <paramsJson>{"page":1,"pageSize":1,"order_status_type":"order","search_key":"JH-000028-230227-0000"}</paramsJson>
                                <appToken>7cd679ff689e3eeffa4a77d4e93670d2</appToken>
                                <appKey>bb7c538e566ca6ad8f462a9cb153bac6</appKey>
                                <service>getFbaPlanOrderList</service>
                            </ns1:callService>
                        </SOAP-ENV:Body>
                        </SOAP-ENV:Envelope>

响应xml

                                    <?xml version="1.0" encoding="UTF-8"?>
                                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
                                        <SOAP-ENV:Body>
                                            <ns1:callServiceResponse>
                                                <response>
                                                    {"ask":"Success","message":"Success","error":{"errorMessage":"","errCode":""},"data":[{"fpo_id":"100000216","fba_plan_order_code":"JH-000028-230227-0000","customer_id":"1","customer_code":"000028","reference_no":"987654111","warehouse_id":"1","dest_warehouse":"FBA","is_mark":"1","mark_type":"2","order_type":"1","order_status":"6","order_fee":"0.000","update_time":"2023-03-23 15:05:09","abnormal_status":"0","abnormal_cause":"","cut_order_cause":"取消订单","abnormal_cause_time":null,"cut_order_cause_time":"2023-03-23 15:05:09","create_time":"2023-02-27 15:50:37","submit_time":"2023-02-27 15:54:14","create_type":"0","order_product":[{"fpop_id":"100000328","fba_plan_order_code":"JH-000028-230227-0000","product_id":"1040797","op_category":"400001","product_barcode":"000028-ZZZ","fnsku":"ASDASDASD1234","product_name":"ZZZ","product_name_en":"ZZZ","qty":"3","mark_qty":"3","length":"29.70","width":"21.00","height":"4.00","weight":"0.35","declared_value":"30.00"},{"fpop_id":"100000329","fba_plan_order_code":"JH-000028-230227-0000","product_id":"1040793","op_category":"400005","product_barcode":"000028-WAIXINGREN","fnsku":"213213ASFAS3216","product_name":"WAIXINGREN","product_name_en":"WAIXINGREN","qty":"3","mark_qty":"3","length":"28.00","width":"15.00","height":"15.00","weight":"15.00","declared_value":"999.00"}],"order_box":[],"warehouse_code":"USEA","order_status_text":"废弃"}],"total":"1"}
                                                </response>
                                            </ns1:callServiceResponse>
                                        </SOAP-ENV:Body>
                                    </SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
page	int	option	分页页码，默认1
pageSize	int	option	每页数量，默认20
order_status_type	string	option	查询类型【'order'=>计划单号,'reference_no'=>参考号,'sku'=>商品编码,'box'=>箱唛号】
search_key	string	option	查询传值
order_status	string	option	订单状态【1待审核、2待装箱、3待作业、4已完成、5异常、6废弃】
warehouse_code	string	option	仓库代码
is_mark	string	option	换标服务 1是2否
mark_type	string	option	换标要求 2外箱3内箱
create_time_for	string	option	大于创建时间
create_time_to	string	option	小于创建时间

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
error	Object	参考Error格式

data参数

参数名	数据类型	说明
fpo_id	int	计划单ID
fba_plan_order_code	string	计划单号
customer_code	string	客户代码
reference_no	string	参考号
warehouse_code	int	仓库ID
warehouse_code	string	仓库代码
is_mark	string	换标服务 1是2否
mark_type	string	换标要求 2外箱3内箱
order_status	string	FBA计划单状态【1待审核、2待装箱、3待作业、4已完成、5异常、6废弃】
order_status_text	string	FBA计划单状态
abnormal_status	string	标记异常 0否1是
abnormal_cause	string	异常原因
abnormal_cause_time	string	标记异常时间
create_type	int	0手动创建，1api创建
order_product	object	计划单产品信息

order_product参数

参数名	数据类型	说明
fba_plan_order_code	string	所属计划单号
product_id	int	产品ID
op_category	int	产品分类ID
product_barcode	string	产品SKU
fnsku	string	fnsku
product_name	string	产品名称
product_name_en	string	产品英文名
qty	int	产品数量
mark_qty	int	换标数量
length	string	长
width	string	宽
height	string	高
weight	string	重
declared_value	string	产品价值

service：createFbaPlanOrder

请求xml

<?xml version="1.0" encoding="UTF-8"?>
    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
<SOAP-ENV:Body>
<ns1:callService>
    <paramsJson>{"warehouse_code":"USEA","dest_warehouse":"FBA","is_mark":1,"mark_type":3,"verify":1,"items":[{"sku" : "ZZZ","fnsku":"ABC123","num":1,"mark_num":1},{"sku":"WAIXINGREN","fnsku":"ABC1234","num":1,"mark_num":1}]}</paramsJson>
<appToken>c4052abf94ce8dcbe64f49641b7f2e17</appToken>
<appKey>3a7d9d1dc4c853295d530d1b6e134138</appKey>
<service>createFbaPlanOrder</service>
</ns1:callService>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

响应xml

<?xml version="1.0" encoding="UTF-8"?>
    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>
                {"ask":"Success","message":"Success","error":{"errorMessage":"","errCode":""},"verify_ask":"Success","verify_message":"Success","data":{"fba_plan_order_code":"JH-000028-230323-0013"}}
            </response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
warehouse_code	string	Require	仓库代码
dest_warehouse	string	Require	目的仓库，当前仅FBA仓
is_mark	string	Require	换标服务 1是2否
mark_type	string	Require	换标要求 2外箱3内箱
verify	string	Option	是否审核 0否1是
items	Object	Require	计划单产品SKU明细

items参数

参数名	数据类型	是否必填	说明
sku	string	Require	产品编码
fnsku	string	Require	FNSKU,如果换标服务is_mark为1时,fnsku为必填
num	int	Require	数量
mark_num	int	Require	换标数量

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
error	Object	参考Error格式

data参数

参数名	数据类型	说明
fba_plan_order_code	string	计划单号

service：modifyFbaPlanOrder

请求xml

<?xml version="1.0" encoding="UTF-8"?>
    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
<SOAP-ENV:Body>
<ns1:callService>
    <paramsJson>{"fba_plan_order_code":"JH-000028-230327-0003","warehouse_code":"USEA","dest_warehouse":"FBA","is_mark":1,"mark_type":3,"items":[{"sku" : "ZZZ","fnsku" : "ABC1234","num" : 2,"mark_num" : 2}]}</paramsJson>
<appToken>c4052abf94ce8dcbe64f49641b7f2e17</appToken>
<appKey>3a7d9d1dc4c853295d530d1b6e134138</appKey>
<service>modifyFbaPlanOrder</service>
</ns1:callService>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

响应xml

<?xml version="1.0" encoding="UTF-8"?>
    <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>
                {"ask":"Success","message":"Success","error":{"errorMessage":"","errCode":""},"data":{"fba_plan_order_code":"JH-000028-230327-0003"}}
            </response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
fba_plan_order_code	string	Require	计划单号
warehouse_code	string	Require	仓库代码
dest_warehouse	string	Require	目的仓库，当前仅FBA仓
is_mark	string	Require	换标服务 1是2否
mark_type	string	Require	换标要求 2外箱3内箱
items	Object	Require	计划单产品SKU明细

items参数

参数名	数据类型	是否必填	说明
sku	string	Require	产品编码
fnsku	string	Require	FNSKU,如果换标服务is_mark为1时,fnsku为必填
num	int	Require	数量
mark_num	int	Require	换标数量

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
error	Object	参考Error格式

data参数

参数名	数据类型	说明
fba_plan_order_code	string	计划单号

service：cancelFbaPlanOrder

请求xml

<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
<SOAP-ENV:Body>
<ns1:callService>
    <paramsJson>{"fba_plan_order_code":"JH-000028-230227-0000","reason":"取消订单"}</paramsJson>
<appToken>c4052abf94ce8dcbe64f49641b7f2e17</appToken>
<appKey>3a7d9d1dc4c853295d530d1b6e134138</appKey>
<service>cancelFbaPlanOrder</service>
</ns1:callService>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

响应xml

<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>
                {"ask":"Success","message":"Success","error":{"errorMessage":"","errCode":""},"data":{"fba_plan_order_code":"JH-000028-230327-0002"}}
            </response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
fba_plan_order_code	string	Require	计划单号
reason	string	Require	取消原因

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
fba_plan_order_code	string	计划单号

service：getFbaPlanBoxList

请求xml

<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
<SOAP-ENV:Body>
<ns1:callService>
    <paramsJson>{"page":1,"pageSize":1,"order_status_type":"order","search_key":"JH-000028-230227-0000"}</paramsJson>
<appToken>c4052abf94ce8dcbe64f49641b7f2e17</appToken>
<appKey>3a7d9d1dc4c853295d530d1b6e134138</appKey>
<service>getFbaPlanOrderList</service>
</ns1:callService>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

响应xml

<?xml version="1.0" encoding="UTF-8"?>
                        <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/Ec/">
    <SOAP-ENV:Body>
        <ns1:callServiceResponse>
            <response>
                {"ask":"Success","message":"Success","error":{"errorMessage":"","errCode":""},"data":[{"fpo_id":"100000321","fba_plan_order_code":"JH-000028-230327-0002","customer_id":"1","customer_code":"000028","reference_no":"","warehouse_id":"1","dest_warehouse":"FBA","is_mark":"1","mark_type":"3","order_type":"1","order_status":"6","order_fee":"0.000","update_time":"2023-03-27 16:52:45","abnormal_status":"0","abnormal_cause":"","cut_order_cause":"取消订单","abnormal_cause_time":null,"cut_order_cause_time":"2023-03-27 16:52:45","create_time":"2023-03-27 16:43:08","submit_time":"2023-03-27 16:43:08","create_type":"1","order_product":[{"fpop_id":"100000512","fba_plan_order_code":"JH-000028-230327-0002","product_id":"1040797","op_category":"400001","product_barcode":"000028-ZZZ","fnsku":"ABC123","product_name":"ZZZ","product_name_en":"ZZZ","qty":"1","mark_qty":"1","length":"29.70","width":"21.00","height":"4.00","weight":"0.35","declared_value":"30.00"},{"fpop_id":"100000513","fba_plan_order_code":"JH-000028-230327-0002","product_id":"1040793","op_category":"400005","product_barcode":"000028-WAIXINGREN","fnsku":"ABC1234","product_name":"WAIXINGREN","product_name_en":"WAIXINGREN","qty":"1","mark_qty":"1","length":"28.00","width":"15.00","height":"15.00","weight":"15.00","declared_value":"999.00"}],"order_box":[],"warehouse_code":"USEA","order_status_text":"废弃"}],"total":"1"}
            </response>
        </ns1:callServiceResponse>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

paramsJson参数

参数名	数据类型	是否必填	说明
page	int	option	分页页码，默认1
pageSize	int	option	每页数量，默认20
order_status_type	string	option	查询类型【'order'=>计划单号,'relation_order_code'=>关联单号,'sku'=>商品编码,'box'=>箱唛号】
search_key	string	option	查询传值
order_status	string	option	箱唛状态【1待暂存 2已暂存 3已预占 4已出库】
warehouse_code	string	option	仓库代码
is_mark	string	option	换标服务 1是2否
mark_type	string	option	换标要求 2外箱3内箱
create_time_for	string	option	大于创建时间
create_time_to	string	option	小于创建时间

response参数

参数名	数据类型	说明
ask	string	参考response公共参数
message	string	参考response公共参数
data	Object	数据内容
Error	Object	参考Error格式

data参数

参数名	数据类型	说明
fba_plan_order_code	string	计划单号
box_no	string	箱唛号
ts_code	string	暂存编码
length	string	长
width	string	宽
height	string	高
weight	string	重
op_status	string	箱唛状态【1待暂存 2已暂存 3已预占 4已出库】
customer_code	string	客户编码
relation_order_code	string	关联单号
box_create_time	string	箱唛创建时间
box_allot_time	string	箱唛分配时间
box_finish_time	string	箱唛完成暂存时间
box_finish_time	string	箱唛完成暂存时间
box_out_time	string	箱唛出库时间
box_detail	object	箱唛装箱详情信息

box_detail参数

参数名	数据类型	说明
product_barcode	string	产品编号
qty	int	产品数量
fnsku	int	换标编码fnsku
product	object	对应产品信息

product参数

参数名	数据类型	说明
fba_plan_order_code	string	所属计划单号
product_id	int	产品ID
op_category	int	产品分类ID
product_barcode	string	产品SKU
fnsku	string	fnsku
product_name	string	产品名称
product_name_en	string	产品英文名
qty	int	产品数量
mark_qty	int	换标数量
length	string	长
width	string	宽
height	string	高
weight	string	重
declared_value	string	产品价值