文档中心 > API类目 > 新零售供应链API

alibaba.ascp.industry.supplier.logistics.push.order (揽配装服务商推单接口)

揽配装服务商推单接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
supplier_logistics_create_request SupplierLogisticsCreateRequest 必须 请求对象
  • └ total_volume
  • String
  • 必须
  • 200000
  • 包裹总体积,单位cm3
  • receiver
  • ContactInfo
  • 必须
  • 收货人信息
  • └ area
  • String
  • 必须
  • 余杭区
  • └ address
  • String
  • 必须
  • 五常街道001号
  • 详细地址
  • └ province
  • String
  • 必须
  • 浙江省
  • └ city
  • String
  • 必须
  • 杭州市
  • └ contact
  • String
  • 必须
  • 张三
  • 姓名
  • └ mobile
  • String
  • 必须
  • 15005781234
  • 电话
  • └ trade_code
  • String
  • 可选
  • 12345678
  • 交易单号
  • └ remark
  • String
  • 可选
  • xxxx
  • 备注
  • package_list
  • PackageInfo []
  • 必须
  • {}
  • 包裹信息
  • └ volume
  • String
  • 可选
  • 1000000
  • 包裹体积,单位cm3
  • └ pack_num
  • Number
  • 必须
  • 2
  • 包裹数量
  • └ weight
  • String
  • 必须
  • 50
  • 包裹重量,单位kg
  • └ remark
  • String
  • 可选
  • xxx
  • 包裹备注
  • └ pack_name
  • String
  • 必须
  • 衣架
  • 包裹名称
  • └ pack_mail_no
  • String
  • 必须
  • SF00001
  • 包裹运单号
  • └ order_channel
  • Number
  • 可选
  • 1
  • 1-淘宝/天猫 2-其它 3-抖音 4-拼多多 5-京东 6-唯品会 默认1
  • └ seller_order_code
  • String
  • 必须
  • ERP001
  • 商家单号
  • └ is_secret
  • Boolean
  • 必须
  • false
  • 默认为false;false-明文、true-密文;非淘必须为明文
  • └ feature
  • String
  • 可选
  • {"a":"b"}
  • 扩展字段
  • sender
  • ContactInfo
  • 必须
  • 发货人信息
  • └ area
  • String
  • 必须
  • 余杭区
  • └ address
  • String
  • 必须
  • 五常街道xx
  • 详细地址
  • └ province
  • String
  • 必须
  • 浙江省
  • └ city
  • String
  • 必须
  • 杭州市
  • └ contact
  • String
  • 必须
  • 张三
  • 姓名
  • └ mobile
  • String
  • 必须
  • 15005781234
  • 电话
  • └ total_weight
  • String
  • 必须
  • 50
  • 包裹总重量,单位kg
  • └ total_settle_weight
  • String
  • 必须
  • 60
  • 包裹总计费重量,单位kg
  • └ task_id
  • String
  • 必须
  • 12345
  • 商家发起请求id 用于幂等
  • └ oa_id
  • String
  • 可选
  • 321312312
  • 获取隐私小号
  • └ cp_code
  • String
  • 必须
  • DB
  • cp编码

响应参数

名称 类型 示例值 描述
result BaseResult 推单结果
  • result
  • SupplierLogisticsCreateRst
  • 返回结果具体对象
  • └ wds_coordination_order_id
  • String
  • BFC001
  • 接单单号
  • └ feature
  • String
  • {"a":"b"}
  • 扩展字段
  • └ msg
  • String
  • "调用成功"
  • 通常用于success的信息提示
  • └ success
  • Boolean
  • true
  • 请求是否成功
  • └ error_code
  • String
  • ERROR_001
  • 通常用于success为false时的页面错误码
  • └ biz_exception
  • Boolean
  • false
  • 是否为业务异常
  • └ error_msg
  • String
  • 系统错误
  • 通常用于success为false时的页面错误信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaAscpIndustrySupplierLogisticsPushOrderRequest req = new AlibabaAscpIndustrySupplierLogisticsPushOrderRequest();
AlibabaAscpIndustrySupplierLogisticsPushOrderRequest.SupplierLogisticsCreateRequest obj1 = new AlibabaAscpIndustrySupplierLogisticsPushOrderRequest.SupplierLogisticsCreateRequest();
obj1.setTotalVolume("200000");
AlibabaAscpIndustrySupplierLogisticsPushOrderRequest.ContactInfo obj2 = new AlibabaAscpIndustrySupplierLogisticsPushOrderRequest.ContactInfo();
obj2.setArea("余杭区");
obj2.setAddress("五常街道001号");
obj2.setProvince("浙江省");
obj2.setCity("杭州市");
obj2.setContact("张三");
obj2.setMobile("15005781234");
obj1.setReceiver(obj2);
obj1.setTradeCode("12345678");
obj1.setRemark("xxxx");
List<AlibabaAscpIndustrySupplierLogisticsPushOrderRequest.PackageInfo> list4 = new ArrayList<AlibabaAscpIndustrySupplierLogisticsPushOrderRequest.PackageInfo>();
AlibabaAscpIndustrySupplierLogisticsPushOrderRequest.PackageInfo obj5 = new AlibabaAscpIndustrySupplierLogisticsPushOrderRequest.PackageInfo();
list4.add(obj5);
obj5.setVolume("1000000");
obj5.setPackNum(2L);
obj5.setWeight("50");
obj5.setRemark("xxx");
obj5.setPackName("衣架");
obj5.setPackMailNo("SF00001");
obj1.setPackageList(list4);
obj1.setOrderChannel(1L);
obj1.setSellerOrderCode("ERP001");
obj1.setIsSecret(false);
obj1.setFeature("{\"a\":\"b\"}");
AlibabaAscpIndustrySupplierLogisticsPushOrderRequest.ContactInfo obj6 = new AlibabaAscpIndustrySupplierLogisticsPushOrderRequest.ContactInfo();
obj6.setArea("余杭区");
obj6.setAddress("五常街道xx");
obj6.setProvince("浙江省");
obj6.setCity("杭州市");
obj6.setContact("张三");
obj6.setMobile("15005781234");
obj1.setSender(obj6);
obj1.setTotalWeight("50");
obj1.setTotalSettleWeight("60");
obj1.setTaskId("12345");
obj1.setOaId("321312312");
obj1.setCpCode("DB");
req.setSupplierLogisticsCreateRequest(obj1);
AlibabaAscpIndustrySupplierLogisticsPushOrderResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_ascp_industry_supplier_logistics_push_order_response>
    <result>
        <result>
            <wds_coordination_order_id>BFC001</wds_coordination_order_id>
            <feature>{&quot;a&quot;:&quot;b&quot;}</feature>
        </result>
        <msg>&quot;调用成功&quot;</msg>
        <success>true</success>
        <error_code>ERROR_001</error_code>
        <biz_exception>false</biz_exception>
        <error_msg>系统错误</error_msg>
    </result>
</alibaba_ascp_industry_supplier_logistics_push_order_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部