文档中心 > API类目 > 闲鱼电商SAAS

alibaba.logistics.idlefish.ship.order.create.list (闲鱼寄件单批量创建)

闲鱼寄件超商 ISV 批量创建寄件单,本期不合单,创单不回运单号

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
idle_fish_ship_order_create_request IdleFishShipOrderCreateRequest 可选 闲鱼寄件单批量创建请求
  • └ merchant_type
  • Number
  • 必须
  • 1
  • 商家类型。本期仅 1(B 卖),传 2(C 卖)返回 isv.merchant-type-not-supported
  • └ service_type
  • Number
  • 必须
  • 1001
  • 寄件服务类型,平台颁发。本期仅 1001(闲鱼大盘申通寄件 3PL),其余值返回 isv.ship-service-type-not-supported
  • order_list
  • IdleFishShipOrderCreateItem []
  • 必须
  • 寄件单列表,上限 20 个,超限做请求级拒绝
  • └ out_trade_id_list
  • String []
  • 必须
  • 1234567890
  • 闲鱼交易单 ID 列表,至少 1 个。本期不合单,多于 1 个做请求级拒绝
  • sender
  • IdleFishShipContactDto
  • 必须
  • 寄件人及地址
  • └ name
  • String
  • 必须
  • 张三
  • 姓名,不超过 32 个字,不能全为表情符号
  • └ mobile_phone
  • String
  • 必须
  • 13800000000
  • 手机 / 座机,不少于 4 位。收件人支持隐私号(11 位小号 + 分隔符 + 4 位分机号)
  • └ prov_name
  • String
  • 必须
  • 浙江省
  • 省名称
  • └ city_name
  • String
  • 可选
  • 杭州市
  • 市名称,与 district_name 至少传一个
  • └ district_name
  • String
  • 可选
  • 余杭区
  • 区 / 县名称,与 city_name 至少传一个
  • └ town_name
  • String
  • 可选
  • 五常街道
  • 街道 / 镇,有就传
  • └ detail_address
  • String
  • 必须
  • 文一西路969号
  • 详细地址,只写街道以下部分,不得含省市区街道。硬上限 150 字,建议不超过 120 字
  • receiver
  • IdleFishShipContactDto
  • 必须
  • 收件人及地址
  • └ name
  • String
  • 必须
  • 张三
  • 姓名,不超过 32 个字,不能全为表情符号
  • └ mobile_phone
  • String
  • 必须
  • 13800000000
  • 手机 / 座机,不少于 4 位。收件人支持隐私号(11 位小号 + 分隔符 + 4 位分机号)
  • └ prov_name
  • String
  • 必须
  • 浙江省
  • 省名称
  • └ city_name
  • String
  • 可选
  • 杭州市
  • 市名称,与 district_name 至少传一个
  • └ district_name
  • String
  • 可选
  • 余杭区
  • 区 / 县名称,与 city_name 至少传一个
  • └ town_name
  • String
  • 可选
  • 五常街道
  • 街道 / 镇,有就传
  • └ detail_address
  • String
  • 必须
  • 文一西路969号
  • 详细地址,只写街道以下部分,不得含省市区街道。硬上限 150 字,建议不超过 120 字

响应参数

名称 类型 示例值 描述
result IdleFishShipOrderCreateResult 返回结果
  • └ success
  • Boolean
  • true
  • 是否成功。仅全部成功为 true,部分成功为 false,实际结果以 data.success_num 为准
  • └ error_code
  • String
  • isv.invalid-parameter
  • 错误码,失败时返回。请求级拒绝时是唯一原因,逐单失败时取第一个失败单
  • └ error_msg
  • String
  • 参数错误
  • 错误信息,请按错误码判断,不要匹配文案
  • data
  • IdleFishShipOrderCreateData
  • 创单业务数据,请求级拒绝时为空
  • └ success_num
  • Number
  • 1
  • 创单成功数量
  • └ fail_num
  • Number
  • 0
  • 创单失败数量
  • order_result_list
  • IdleFishShipOrderCreateResultItem []
  • 逐单结果,与请求 order_list 等长同序,只重试失败单
  • └ success
  • Boolean
  • true
  • 该单是否创单成功
  • └ out_trade_id_list
  • String []
  • 1234567890
  • 回传请求中的闲鱼交易单 ID
  • └ order_id
  • String
  • 22648510111421501
  • 寄件单号,创单成功时返回。不回运单号,需后续调查单接口获取
  • └ error_code
  • String
  • isv.invalid-parameter
  • 该单失败错误码
  • └ error_msg
  • String
  • 参数错误
  • 该单失败描述

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaLogisticsIdlefishShipOrderCreateListRequest req = new AlibabaLogisticsIdlefishShipOrderCreateListRequest();
AlibabaLogisticsIdlefishShipOrderCreateListRequest.IdleFishShipOrderCreateRequest obj1 = new AlibabaLogisticsIdlefishShipOrderCreateListRequest.IdleFishShipOrderCreateRequest();
obj1.setMerchantType(1L);
obj1.setServiceType(1001L);
List<AlibabaLogisticsIdlefishShipOrderCreateListRequest.IdleFishShipOrderCreateItem> list3 = new ArrayList<AlibabaLogisticsIdlefishShipOrderCreateListRequest.IdleFishShipOrderCreateItem>();
AlibabaLogisticsIdlefishShipOrderCreateListRequest.IdleFishShipOrderCreateItem obj4 = new AlibabaLogisticsIdlefishShipOrderCreateListRequest.IdleFishShipOrderCreateItem();
list3.add(obj4);
obj4.setOutTradeIdList("1234567890");
AlibabaLogisticsIdlefishShipOrderCreateListRequest.IdleFishShipContactDto obj6 = new AlibabaLogisticsIdlefishShipOrderCreateListRequest.IdleFishShipContactDto();
obj6.setName("张三");
obj6.setMobilePhone("13800000000");
obj6.setProvName("浙江省");
obj6.setCityName("杭州市");
obj6.setDistrictName("余杭区");
obj6.setTownName("五常街道");
obj6.setDetailAddress("文一西路969号");
list5.setSender(obj6);
AlibabaLogisticsIdlefishShipOrderCreateListRequest.IdleFishShipContactDto obj8 = new AlibabaLogisticsIdlefishShipOrderCreateListRequest.IdleFishShipContactDto();
obj8.setName("张三");
obj8.setMobilePhone("13800000000");
obj8.setProvName("浙江省");
obj8.setCityName("杭州市");
obj8.setDistrictName("余杭区");
obj8.setTownName("五常街道");
obj8.setDetailAddress("文一西路969号");
list7.setReceiver(obj8);
obj1.setOrderList(list3);
req.setIdleFishShipOrderCreateRequest(obj1);
AlibabaLogisticsIdlefishShipOrderCreateListResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_logistics_idlefish_ship_order_create_list_response>
    <result>
        <success>true</success>
        <error_code>isv.invalid-parameter</error_code>
        <error_msg>参数错误</error_msg>
        <data>
            <success_num>1</success_num>
            <fail_num>0</fail_num>
            <order_result_list>
                <idle_fish_ship_order_create_result_item>
                    <success>true</success>
                    <out_trade_id_list>
                        <string>1234567890</string>
                    </out_trade_id_list>
                    <order_id>22648510111421501</order_id>
                    <error_code>isv.invalid-parameter</error_code>
                    <error_msg>参数错误</error_msg>
                </idle_fish_ship_order_create_result_item>
            </order_result_list>
        </data>
    </result>
</alibaba_logistics_idlefish_ship_order_create_list_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

返回
顶部