文档中心 > API类目 > 银泰开放平台

alibaba.mos.order.logistics.create (电子面单创建接口)

商家ERP/ISV 向银泰面单系统获取电子面单单号和打印信息。 支持批量取号,一次最多5条。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
order_logistics_create_request_dto OrderLogisticsCreateRequestDTO 必须 -
  • sender
  • Sender
  • 必须
  • 发件人信息,该发送人信息需要向银泰提前报备
  • └ area
  • String
  • 必须
  • 朝阳区
  • 区域(无区的填写县级市市名)
  • └ province
  • String
  • 必须
  • 北京市
  • └ town
  • String
  • 可选
  • 高碑店乡
  • 镇/街道
  • └ city
  • String
  • 必须
  • 北京市
  • └ phone
  • String
  • 可选
  • 010100232x
  • 固定电话,手机号与固定电话必须填写其中一个
  • └ mobile
  • String
  • 可选
  • 186****1479
  • 手机号,手机号与固定电话必须填写其中一个
  • └ name
  • String
  • 必须
  • 张三
  • 发件人姓名
  • └ detail
  • String
  • 必须
  • 惠河南街****号
  • 具体地址(不包含省市区镇街道的信息)
  • packs
  • Pack []
  • 必须
  • []
  • 包裹信息,最多5个
  • └ pack_code
  • String
  • 必须
  • 1
  • 包裹号, 当前请求内唯一,用于区分具体请求记录
  • └ logistics_code
  • String
  • 必须
  • SF
  • 物流公司编码,目前支持 EMS(EMS),顺丰(SF),申通(STO), 圆通 (YTO), 中通(ZTO), 德邦(DBKD),韵达(YUNDA),丰网(FWX),极兔 (JTSD), 京东(JD)
  • └ remark
  • String
  • 可选
  • 备注
  • 备注
  • └ delivery_order_code
  • String
  • 必须
  • D20221013214135
  • 发货单号
  • pack_items
  • PackItem []
  • 必须
  • []
  • 包裹内容
  • └ quantity
  • Number
  • 必须
  • 1
  • 商品数量
  • └ name
  • String
  • 必须
  • 女装
  • 商品名称(可以非具体发货商品名称,可以使用商品分类名称),例如女装,化妆品
  • └ logistics_type
  • String
  • 可选
  • SE0141
  • 物流公司支持的快递类型,京东快递必传。例如顺丰的快运标准达(SE0141), 京东的特惠送(ed-m-0001)
  • └ attrs
  • String
  • 可选
  • {}
  • 扩展信息, JSON格式。如有特殊需求可联系业务进行扩展

响应参数

名称 类型 示例值 描述
result Result 返回结果
  • └ success
  • Boolean
  • false
  • 是否请求成功
  • └ error_code
  • Boolean
  • 401
  • 错误码
  • data
  • OrderLogisticsCreateResult
  • 返回信息
  • packs
  • PackInfo []
  • 面单信息
  • └ error_code
  • String
  • ""
  • 错误码, 如果不存在,表示当前记录请求成功
  • └ error_msg
  • String
  • ""
  • 错误信息
  • └ pack_code
  • String
  • 1
  • 包裹号
  • └ express_code
  • String
  • SF123412344
  • 快递单号
  • └ extras
  • String
  • {"sortCode":"集包地代码","packageCenterCode":"集包名称","packageCenterName":"大头笔编码","shortAddressCode":"大头笔名称","shortAddressName":"分拣码(三段码)"}
  • 扩展信息,JSON格式, 其中内部一定包含示例字段,不同物流公司,包含不同扩展信息,具体可参考各物流公司文档。

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaMosOrderLogisticsCreateRequest req = new AlibabaMosOrderLogisticsCreateRequest();
AlibabaMosOrderLogisticsCreateRequest.OrderLogisticsCreateRequestDTO obj1 = new AlibabaMosOrderLogisticsCreateRequest.OrderLogisticsCreateRequestDTO();
AlibabaMosOrderLogisticsCreateRequest.Sender obj2 = new AlibabaMosOrderLogisticsCreateRequest.Sender();
obj2.setArea("朝阳区");
obj2.setProvince("北京市");
obj2.setTown("高碑店乡");
obj2.setCity("北京市");
obj2.setPhone("010100232x");
obj2.setMobile("186****1479");
obj2.setName("张三");
obj2.setDetail("惠河南街****号");
obj1.setSender(obj2);
List<AlibabaMosOrderLogisticsCreateRequest.Pack> list4 = new ArrayList<AlibabaMosOrderLogisticsCreateRequest.Pack>();
AlibabaMosOrderLogisticsCreateRequest.Pack obj5 = new AlibabaMosOrderLogisticsCreateRequest.Pack();
list4.add(obj5);
obj5.setPackCode("1");
obj5.setLogisticsCode("SF");
obj5.setRemark("备注");
obj5.setDeliveryOrderCode("D20221013214135");
List<AlibabaMosOrderLogisticsCreateRequest.PackItem> list8 = new ArrayList<AlibabaMosOrderLogisticsCreateRequest.PackItem>();
AlibabaMosOrderLogisticsCreateRequest.PackItem obj9 = new AlibabaMosOrderLogisticsCreateRequest.PackItem();
list8.add(obj9);
obj9.setQuantity(1L);
obj9.setName("女装");
list6.setPackItems(list8);
obj5.setLogisticsType("SE0141");
obj5.setAttrs("{}");
obj1.setPacks(list4);
req.setOrderLogisticsCreateRequestDto(obj1);
AlibabaMosOrderLogisticsCreateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_mos_order_logistics_create_response>
    <result>
        <success>false</success>
        <error_code>401</error_code>
        <data>
            <packs>
                <pack_info>
                    <error_code>&quot;&quot;</error_code>
                    <error_msg>&quot;&quot;</error_msg>
                    <pack_code>1</pack_code>
                    <express_code>SF123412344</express_code>
                    <extras>{&quot;sortCode&quot;:&quot;集包地代码&quot;,&quot;packageCenterCode&quot;:&quot;集包名称&quot;,&quot;packageCenterName&quot;:&quot;大头笔编码&quot;,&quot;shortAddressCode&quot;:&quot;大头笔名称&quot;,&quot;shortAddressName&quot;:&quot;分拣码(三段码)&quot;}</extras>
                </pack_info>
            </packs>
        </data>
    </result>
</alibaba_mos_order_logistics_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

返回
顶部