文档中心 > API类目 > 天猫供应链

alibaba.dchain.aoxiang.industry.waybill.create (服务商开运单)

服务商开运单

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
tms_order_create_request TmsOrderCreateRequest 必须 服务商开单
  • └ seller_id
  • String
  • 必须
  • sellerUserId
  • 商家id
  • └ trade_code
  • String
  • 可选
  • TP3289473286582
  • 交易单号
  • └ out_biz_code
  • String
  • 必须
  • OT1639205668
  • 外部单号
  • └ seller_order_code
  • String
  • 可选
  • xxx
  • 商家单号
  • └ tms_service_type
  • Number
  • 必须
  • 0
  • 服务类型 (0: “干支装一体”1: “不安装配送到家”2:“不安装配送到楼下”3: “自提”)
  • └ cp_code
  • String
  • 必须
  • YUELU
  • 服务商code
  • └ creator
  • String
  • 必须
  • xx
  • 创建者
  • └ feature
  • String
  • 可选
  • {}
  • 扩展信息
  • └ remark
  • String
  • 可选
  • xxx
  • 备注
  • └ bill_pic
  • String
  • 可选
  • xxx
  • 底单图片(多个url以逗号分开)
  • └ advance
  • Boolean
  • 可选
  • false
  • 是否预开单
  • └ gather
  • Boolean
  • 可选
  • false
  • 是否拼单
  • └ gather_num
  • Number
  • 可选
  • 2
  • 拼几单
  • └ request_time
  • Number
  • 必须
  • 1639205668000
  • 业务请求时间戳
  • └ request_id
  • String
  • 必须
  • 12678461246
  • 业务请求ID,用于幂等
  • └ industry
  • String
  • 必须
  • home_improvement
  • 行业标(家装固定值,home_improvement)
  • rdc_create_dto
  • OrderRdcCreate
  • 必须
  • {}
  • 收货分拨信息
  • └ province
  • String
  • 必须
  • 浙江省
  • └ city
  • String
  • 可选
  • 杭州市
  • └ area
  • String
  • 可选
  • 西湖区
  • └ town
  • String
  • 可选
  • 街道
  • 街道
  • └ detail_address
  • String
  • 必须
  • 文一西路288号
  • 详细地址
  • sender_create_dto
  • OrderSenderCreate
  • 必须
  • {}
  • 发货人信息
  • └ name
  • String
  • 必须
  • name
  • 联系人姓名
  • └ mobile
  • String
  • 必须
  • 12842184512
  • 联系人手机
  • └ province
  • String
  • 必须
  • 浙江省
  • └ city
  • String
  • 可选
  • 杭州市
  • └ area
  • String
  • 可选
  • 西湖区
  • └ town
  • String
  • 可选
  • 五常街道
  • 街道
  • └ detail_address
  • String
  • 必须
  • 文一西路288号
  • 详细地址
  • receiver_create_dto
  • OrderSenderCreate
  • 必须
  • {}
  • 收货人信息
  • └ name
  • String
  • 必须
  • xx
  • 联系人姓名
  • └ mobile
  • String
  • 必须
  • 15722292810
  • 联系人电话
  • └ province
  • String
  • 必须
  • 浙江省
  • └ city
  • String
  • 可选
  • 杭州市
  • └ area
  • String
  • 可选
  • 西湖区
  • └ town
  • String
  • 可选
  • 街道
  • 街道
  • └ detail_address
  • String
  • 必须
  • 文一西路288号
  • 详细地址
  • item_create_dto_list
  • OrderReceiverCreate []
  • 必须
  • []
  • 货品信息
  • └ volume
  • String
  • 必须
  • 1
  • 体积,单位mm3
  • └ leaf_cat_id
  • String
  • 必须
  • 500038
  • 叶子类目ID
  • └ item_name
  • String
  • 必须
  • 货品名称
  • 货品名称
  • └ quantity
  • Number
  • 必须
  • 20
  • 货品数量
  • └ pack_num
  • Number
  • 必须
  • 20
  • 包裹数量
  • └ feature
  • String
  • 可选
  • {}
  • 扩展字段
  • └ weight
  • String
  • 可选
  • 1
  • 重量
  • └ property
  • String
  • 可选
  • soft
  • 货品类型( soft:软体,plate:版式)
  • └ assemble_type
  • String
  • 可选
  • whole_install
  • 安装类型( whole_install:整装, part_install:组装)

响应参数

名称 类型 示例值 描述
tms_order_create_response TopResponse 返回结构体
  • └ code
  • String
  • 200
  • 响应码
  • └ message
  • String
  • message
  • 响应信息
  • └ success
  • Boolean
  • true
  • 调用是否成功
  • data
  • TmsOrderCreateResponse
  • xx
  • 喵师傅运单号
  • └ biz_exception
  • Boolean
  • false
  • 是否为业务异常在流程中心场景下使用
  • └ code
  • String
  • RELATED_ORDER_CODE_EXIST
  • 业务错误码
  • └ data
  • String
  • MSF039890248
  • 业务数据
  • └ message
  • String
  • 外部单号已存在!
  • 业务响应信息
  • └ success
  • Boolean
  • false
  • 业务调用是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaDchainAoxiangIndustryWaybillCreateRequest req = new AlibabaDchainAoxiangIndustryWaybillCreateRequest();
AlibabaDchainAoxiangIndustryWaybillCreateRequest.TmsOrderCreateRequest obj1 = new AlibabaDchainAoxiangIndustryWaybillCreateRequest.TmsOrderCreateRequest();
obj1.setSellerId("sellerUserId");
obj1.setTradeCode("TP3289473286582");
obj1.setOutBizCode("OT1639205668");
obj1.setSellerOrderCode("xxx");
obj1.setTmsServiceType(0L);
obj1.setCpCode("YUELU");
obj1.setCreator("xx");
obj1.setFeature("{}");
obj1.setRemark("xxx");
obj1.setBillPic("xxx");
obj1.setAdvance(false);
obj1.setGather(false);
obj1.setGatherNum(2L);
obj1.setRequestTime(1639205668000L);
obj1.setRequestId("12678461246");
obj1.setIndustry("home_improvement");
AlibabaDchainAoxiangIndustryWaybillCreateRequest.OrderRdcCreate obj2 = new AlibabaDchainAoxiangIndustryWaybillCreateRequest.OrderRdcCreate();
obj2.setProvince("浙江省");
obj2.setCity("杭州市");
obj2.setArea("西湖区");
obj2.setTown("街道");
obj2.setDetailAddress("文一西路288号");
obj1.setRdcCreateDto(obj2);
AlibabaDchainAoxiangIndustryWaybillCreateRequest.OrderSenderCreate obj3 = new AlibabaDchainAoxiangIndustryWaybillCreateRequest.OrderSenderCreate();
obj3.setName("name");
obj3.setMobile("12842184512");
obj3.setProvince("浙江省");
obj3.setCity("杭州市");
obj3.setArea("西湖区");
obj3.setTown("五常街道");
obj3.setDetailAddress("文一西路288号");
obj1.setSenderCreateDto(obj3);
AlibabaDchainAoxiangIndustryWaybillCreateRequest.OrderSenderCreate obj4 = new AlibabaDchainAoxiangIndustryWaybillCreateRequest.OrderSenderCreate();
obj4.setName("xx");
obj4.setMobile("15722292810");
obj4.setProvince("浙江省");
obj4.setCity("杭州市");
obj4.setArea("西湖区");
obj4.setTown("街道");
obj4.setDetailAddress("文一西路288号");
obj1.setReceiverCreateDto(obj4);
List<AlibabaDchainAoxiangIndustryWaybillCreateRequest.OrderReceiverCreate> list6 = new ArrayList<AlibabaDchainAoxiangIndustryWaybillCreateRequest.OrderReceiverCreate>();
AlibabaDchainAoxiangIndustryWaybillCreateRequest.OrderReceiverCreate obj7 = new AlibabaDchainAoxiangIndustryWaybillCreateRequest.OrderReceiverCreate();
list6.add(obj7);
obj7.setVolume("1");
obj7.setLeafCatId("500038");
obj7.setItemName("货品名称");
obj7.setQuantity(20L);
obj7.setPackNum(20L);
obj7.setFeature("{}");
obj7.setWeight("1");
obj7.setProperty("soft");
obj7.setAssembleType("whole_install");
obj1.setItemCreateDtoList(list6);
req.setTmsOrderCreateRequest(obj1);
AlibabaDchainAoxiangIndustryWaybillCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_dchain_aoxiang_industry_waybill_create_response>
    <tms_order_create_response>
        <code>200</code>
        <message>message</message>
        <success>true</success>
        <data>
            <biz_exception>false</biz_exception>
            <code>RELATED_ORDER_CODE_EXIST</code>
            <data>MSF039890248</data>
            <message>外部单号已存在!</message>
            <success>false</success>
        </data>
    </tms_order_create_response>
</alibaba_dchain_aoxiang_industry_waybill_create_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

返回
顶部