修改面单

接口方法

  • modifyShipment

请求方式：

  • POST

请求示例:

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://www.example.org/">
    <SOAP-ENV:Body>
        <ns1:callService>
            <paramsJson>
                {
                  "order_code":"YB-AK-19110400003",
                  "warehouse_code":"OWN",
                  "shipping_method":"US_FEDEX_GROUND",
                  "order_desc":"test-api",
                  "length":"15.50",
                  "width":"10.00",
                  "height":"5.00",
                  "weight":"12.50",
                  "sender_address":{
                    "country_code":"US",
                    "province":"CT",
                    "city":"TRUMBULL",
                    "address1":"53 NORTH ST",
                    "zipcode":"142970",
                    "first_name":"tester",
                    "last_name":"pak",
                    "phone":"123456789"
                  },
                  "receiver_address":{
                  "receiver_warehouse_code":"WPLA",
                    "country_code":"US",
                    "province":"CT",
                    "city":"TRUMBULL",
                    "address1":"53 NORTH ST",
                    "zipcode":"142970",
                    "first_name":"tester",
                    "last_name":"pak",
                    "phone":"123456789"}
                }
            </paramsJson>
            <appToken>appToken</appToken>
            <appKey>appKey</appKey>
            <service>modifyShipment</service>
            </ns1:callService>
        </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>

请求参数:

参数 类型 是否必填 说明 长度限制
order_code String 是 面单号 30
shipping_method String 否 物流渠道，参考getShippingMethod（获取物流渠道） 20
warehouse_code String 否 配送仓库，参考getWarehouse（获取仓库列表） 20
is_signature int 否 签名服务: 0:否 1:是
is_insurance int 否 保险服务: 0:否 1:是（需物流渠道支持）
declared_value double 否 保险金额/申报价值（当保险服务为1是时，必填），两位小数
remark String 否 备注 200
sender_address Object 否 发件人信息, 配送仓库=OWN时，此参数必填，为其他仓库时，忽略此参数，直接用系统中的仓库地址（详见address参数）
receiver_address Object 否 收件人信息（详见address参数）
verify int 否 是否提交,0新建不提交(草稿状态)，1新建并提交， 默认为0
length String 否 包裹长（保留2位小数）
width String 否 包裹宽（保留2位小数）
height String 否 包裹高（保留2位小数）
weight String 否 包裹重（保留2位小数）
packageQuantity int 否 包裹数量（物流渠道是”FEDEX-WMT”必填）
return_warehouse_code String 否 指定退货地址（系统预录地址，使用前请先在【OMS系统-面单地址管理】新增指定退货地址，仅限UPS渠道正向业务使用，非UPS渠道不适用）

address参数:

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

返回结果示例：

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

返回参数：

参数 类型 说明
ask String 返回结果，Success表示请求成功，Failure表示请求失败
message String 返回信息
nextPage boolean true 有下一页，false 没有下一页
Error Object 参考Error格式
作者：WesternPost  创建时间：2021-07-02 23:58
最后编辑：丁亚琦  更新时间：2024-07-18 20:07