文档中心 > API类目 > 天猫精灵供应链网关API

alibaba.gsc.openapi.eel.delivery.create (创建发货单)

发货单创建接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
delivery_order_create_request DeliveryorderCreateRequestExt 必须 发货单创建参数
  • delivery_order
  • DeliveryOrderEx
  • 必须
  • COMPLEX
  • 发货单信息
  • └ delivery_order_code
  • String
  • 必须
  • TB1234
  • 出库单号
  • └ pre_delivery_order_code
  • String
  • 必须
  • 98657452
  • 原出库单号(ERP分配)补发单模式该参数必填
  • └ pre_delivery_order_id
  • String
  • 可选
  • 5241263
  • 原出库单号(WMS分配)换发单场景该参数必填
  • └ order_type
  • String
  • 必须
  • JYCK
  • 出库单类型(JYCK=一般交易出库单;HHCK=换货出库单;BFCK=补发出库单;QTCK=其他出 库 单)
  • └ warehouse_code
  • String
  • 必须
  • OTHER
  • 仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER)
  • └ order_flag
  • String
  • 可选
  • COD
  • 订单标记 ,用字符串格式来表示订单标记列表: 比如COD, 中间用“^”来隔开, COD =货到付款 , LIMIT=限时配送 , PRESELL=预售 , COMPLAIN=已投诉 ,SPLIT=拆单, EXCHANGE=换货, VISIT=上门 , MODIFYTRANSPORT=是否可改配送方式, 是否可改配送方式 默认可更改 , CONSIGN =物流宝代理发货, 自动更改发货状态SELLER_AFFORD =是否卖家承担运费 默认是, 即没 , FENXIAO=分销订单
  • └ source_platform_code
  • String
  • 必须
  • TB
  • 订单来源平台编码, TB= 淘宝 、TM=天猫 、JD=京东、DD=当当、PP=拍拍、YX=易讯、EBAY=ebay、QQ=QQ网购、AMAZON=亚马逊、SN=苏宁、GM=国美、WPH=唯品会、JM=聚美、LF=乐蜂、MGJ=蘑菇街、JS=聚尚、PX=拍鞋、YT=银泰、YHD=1号店、VANCL=凡客、YL=邮乐、YG=优购、1688=阿里巴巴、POS=POS门店、PDD=拼多多、RRSLJ=日日顺乐家、MSJ=美食杰、UGO=优品购、OTHER=其他
  • └ source_platform_name
  • String
  • 可选
  • 1
  • 订单来源平台名称
  • └ create_time
  • String
  • 必须
  • 2016-07-06 12:00:00
  • 发货单创建时间(YYYY-MM-DD HH:MM:SS)
  • └ place_order_time
  • String
  • 必须
  • 2016-07-06 12:00:00
  • 前台订单/店铺订单的创建时间/下单时间
  • └ pay_time
  • String
  • 可选
  • 2016-07-06 12:00:00
  • 订单支付时间
  • └ pay_no
  • String
  • 可选
  • 1
  • 支付平台交易号
  • └ operator_code
  • String
  • 可选
  • 1
  • 操作员 (审核员) 编码
  • └ operator_name
  • String
  • 可选
  • 1
  • 操作员 (审核员) 名称
  • └ operate_time
  • String
  • 必须
  • 2016-07-06 12:00:00
  • 操作(审核)时间(YYYY-MM-DD HH:MM:SS)
  • └ shop_nick
  • String
  • 必须
  • 淘宝店
  • 店铺名称
  • └ seller_nick
  • String
  • 可选
  • 1
  • 卖家名称
  • └ buyer_nick
  • String
  • 可选
  • 1
  • 买家昵称
  • └ total_amount
  • String
  • 可选
  • 1
  • 订单总金额 (元)
  • └ item_amount
  • String
  • 可选
  • 1
  • 商品总金额 (元)
  • └ discount_amount
  • String
  • 可选
  • 1
  • 订单折扣金额 (元)
  • └ freight
  • String
  • 可选
  • 1
  • 快递费用
  • └ ar_amount
  • String
  • 可选
  • 1
  • 应收金额 (元)
  • └ got_amount
  • String
  • 可选
  • 1
  • 已收金额 (元)
  • └ service_fee
  • String
  • 可选
  • 1
  • COD服务费
  • └ logistics_code
  • String
  • 必须
  • SF
  • 物流公司编码(SF=顺丰、EMS=标准快递、EYB=经济快件、ZJS=宅急送、YTO=圆通 ZTO=中 通(ZTO)、HTKY=百世汇通、UC=优速、STO=申通、TTKDEX=天天快递、QFKD=全峰、FAST=快捷、POSTB=邮政小包、 GTO=国通、YUNDA=韵达、JD=京东配送、DD=当当宅配、AMAZON=亚马逊物流、 OTHER=其他)
  • └ logistics_name
  • String
  • 可选
  • 1
  • 物流公司名称
  • └ express_code
  • String
  • 可选
  • 1
  • 运单号
  • └ logistics_area_code
  • String
  • 可选
  • 1
  • 快递区域编码
  • delivery_requirements
  • DeliveryRequirements
  • 可选
  • 投递信息
  • └ schedule_type
  • String
  • 可选
  • 1
  • 投递时延要求, int, 1=工作日,2=节假日,101=当日达,102=次晨达,103=次日达, 104=预约达
  • └ schedule_day
  • String
  • 可选
  • 1
  • 要求送达日期
  • └ schedule_start_time
  • String
  • 可选
  • 1
  • 投递时间范围要求 (开始时间)
  • └ schedule_end_time
  • String
  • 可选
  • 1
  • 投递时间范围要求 (结束时间)
  • └ delivery_type
  • String
  • 可选
  • 1
  • 发货服务类型,PTPS(普通配送),LLPS(冷链配送)
  • sender_info
  • SenderInfo
  • 必须
  • 1
  • 发货人信息
  • └ company
  • String
  • 可选
  • 1
  • 公司名称**菜鸟无此字段,请空值传入**
  • └ name
  • String
  • 必须
  • 老王
  • 姓名
  • └ zip_code
  • String
  • 可选
  • 1
  • 邮编
  • └ tel
  • String
  • 可选
  • 1
  • 固定电话
  • └ mobile
  • String
  • 必须
  • 13214567869
  • 移动电话
  • └ email
  • String
  • 可选
  • 1
  • 电子邮箱**菜鸟无此字段,请空值传入**
  • └ country_code
  • String
  • 可选
  • 1
  • 国家二字码**菜鸟无此字段,请空值传入**
  • └ province
  • String
  • 必须
  • 浙江省
  • 省份
  • └ city
  • String
  • 必须
  • 杭州
  • 城市
  • └ area
  • String
  • 可选
  • 余杭区
  • 区域
  • └ town
  • String
  • 可选
  • xxx村
  • 村镇
  • └ detail_address
  • String
  • 必须
  • 杭州市余杭区989号
  • 详细地址
  • receiver_info
  • ReceiverInfo
  • 可选
  • 收件人
  • └ company
  • String
  • 可选
  • 1
  • 公司名称**菜鸟无此字段,请空值传入**
  • └ name
  • String
  • 必须
  • 老王
  • 姓名
  • └ zip_code
  • String
  • 可选
  • 1
  • 邮编
  • └ tel
  • String
  • 可选
  • 1
  • 固定电话
  • └ mobile
  • String
  • 必须
  • 13214567869
  • 移动电话
  • └ email
  • String
  • 可选
  • 1
  • 电子邮箱**菜鸟无此字段,请空值传入**
  • └ country_code
  • String
  • 可选
  • 1
  • 国家二字码**菜鸟无此字段,请空值传入**
  • └ province
  • String
  • 必须
  • 浙江省
  • 省份
  • └ city
  • String
  • 必须
  • 杭州
  • 城市
  • └ area
  • String
  • 可选
  • 余杭区
  • 区域
  • └ town
  • String
  • 可选
  • xxx村
  • 村镇
  • └ detail_address
  • String
  • 必须
  • 杭州市余杭区989号
  • 详细地址
  • └ is_urgency
  • String
  • 可选
  • N
  • 是否紧急
  • └ invoice_flag
  • String
  • 可选
  • N
  • 是否需要发票
  • invoices
  • Invoice []
  • 可选
  • 发票
  • └ type
  • String
  • 可选
  • INVOICE
  • 发票类型,INVOICE=普通发票,VINVOICE=增值税普通发票, EVINVOICE=电子增票
  • └ header
  • String
  • 可选
  • 1
  • 发票抬头
  • └ amount
  • String
  • 可选
  • 1
  • 发票总金额
  • └ content
  • String
  • 可选
  • 1
  • 发票内容
  • detail
  • Detail
  • 可选
  • 详细
  • items
  • Item []
  • 可选
  • 商品
  • └ item_name
  • String
  • 可选
  • 1
  • 商品名称
  • └ unit
  • String
  • 可选
  • 1
  • 商品单位
  • └ price
  • String
  • 可选
  • 1
  • 商品单价
  • └ quantity
  • String
  • 可选
  • 1
  • 数量
  • └ amount
  • String
  • 可选
  • 1
  • 金额
  • └ insurance_flag
  • String
  • 可选
  • 1
  • 是否需要保险
  • insurance
  • Insurance
  • 可选
  • 保险内容
  • └ type
  • String
  • 可选
  • 1
  • 保险类型
  • └ amount
  • String
  • 可选
  • 1
  • 保险金额
  • └ buyer_message
  • String
  • 可选
  • 1
  • 买家留言
  • └ seller_message
  • String
  • 可选
  • 1
  • 卖家留言
  • └ remark
  • String
  • 可选
  • 1
  • 备注
  • └ shop_code
  • String
  • 可选
  • B002
  • 店铺编码
  • └ partner_code
  • String
  • 可选
  • 1
  • 客户编码
  • order_lines
  • OrderLine []
  • 必须
  • COMPLEX
  • 订单列表
  • └ order_line_no
  • String
  • 必须
  • 11
  • 单据行号
  • └ source_order_code
  • String
  • 可选
  • 11
  • 交易平台订单
  • └ sub_source_order_code
  • String
  • 可选
  • 11
  • 交易平台子订单编码
  • └ owner_code
  • String
  • 必须
  • H1234
  • 货主编码
  • └ item_code
  • String
  • 必须
  • I1234
  • 商品编码
  • └ item_id
  • String
  • 必须
  • 2001236541582
  • 仓储系统商品编码
  • └ inventory_type
  • String
  • 可选
  • ZP
  • 库存类型, ZP=正品, CC=残次,JS=机损, XS= 箱损, ZT=在途库存,默认为查所有类型的库存
  • └ item_name
  • String
  • 可选
  • 1
  • 商品名称
  • └ ext_code
  • String
  • 可选
  • 1
  • 交易平台商品编码
  • └ plan_qty
  • String
  • 必须
  • 11
  • 应发商品数量
  • └ retail_price
  • String
  • 可选
  • 1
  • 零售价
  • └ actual_price
  • String
  • 可选
  • 12.0
  • 实际成交价格
  • └ discount_amount
  • String
  • 可选
  • 1
  • 单件商品折扣金额
  • └ batch_code
  • String
  • 可选
  • 1
  • 批次编码
  • └ product_date
  • String
  • 可选
  • 1
  • 生产日期YYYY-MM-DD
  • └ expire_date
  • String
  • 可选
  • 1
  • 过期日期YYYY-MM-DD
  • └ key
  • String
  • 可选
  • abc
  • 业务流水号
  • └ client
  • String
  • 可选
  • 1
  • 业务区分

响应参数

名称 类型 示例值 描述
delivery_order_create_response DeliveryOrderCreateResponse COMPLEX 默认描述
  • └ delivery_order_id
  • String
  • W1234
  • 出库单仓储系统编码
  • └ warehouse_code
  • String
  • W1345
  • 仓库编码(统仓统配使用)
  • └ logistics_code
  • String
  • P2345
  • 物流公司编码(统仓统配使用)
  • delivery_orders
  • DeliveryOrder []
  • 发货单信息
  • └ delivery_order_id
  • String
  • C1234
  • 出库单仓储系统编码
  • └ warehouse_code
  • String
  • W789
  • 仓库编码(统仓统配使用)
  • └ logistics_code
  • String
  • SF
  • 物流公司编码(统仓统配使用)
  • order_lines
  • OrderLine []
  • COMPLEX
  • 订单行信息
  • └ order_line_no
  • String
  • 11
  • 行号
  • └ item_code
  • String
  • I234
  • ERP商品编码
  • └ item_id
  • String
  • W234
  • WMS商品编码
  • └ quantity
  • String
  • 1
  • 数量
  • └ flag
  • String
  • success
  • 响应结果:success|failure
  • └ code
  • String
  • 0
  • 响应码
  • └ message
  • String
  • invalid appkey
  • 响应信息

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaGscOpenapiEelDeliveryCreateRequest req = new AlibabaGscOpenapiEelDeliveryCreateRequest();
AlibabaGscOpenapiEelDeliveryCreateRequest.DeliveryorderCreateRequestExt obj1 = new AlibabaGscOpenapiEelDeliveryCreateRequest.DeliveryorderCreateRequestExt();
AlibabaGscOpenapiEelDeliveryCreateRequest.DeliveryOrderEx obj2 = new AlibabaGscOpenapiEelDeliveryCreateRequest.DeliveryOrderEx();
obj2.setDeliveryOrderCode("TB1234");
obj2.setPreDeliveryOrderCode("98657452");
obj2.setPreDeliveryOrderId("5241263");
obj2.setOrderType("JYCK");
obj2.setWarehouseCode("OTHER");
obj2.setOrderFlag("COD");
obj2.setSourcePlatformCode("TB");
obj2.setSourcePlatformName("1");
obj2.setCreateTime("2016-07-06 12:00:00");
obj2.setPlaceOrderTime("2016-07-06 12:00:00");
obj2.setPayTime("2016-07-06 12:00:00");
obj2.setPayNo("1");
obj2.setOperatorCode("1");
obj2.setOperatorName("1");
obj2.setOperateTime("2016-07-06 12:00:00");
obj2.setShopNick("淘宝店");
obj2.setSellerNick("1");
obj2.setBuyerNick("1");
obj2.setTotalAmount("1");
obj2.setItemAmount("1");
obj2.setDiscountAmount("1");
obj2.setFreight("1");
obj2.setArAmount("1");
obj2.setGotAmount("1");
obj2.setServiceFee("1");
obj2.setLogisticsCode("SF");
obj2.setLogisticsName("1");
obj2.setExpressCode("1");
obj2.setLogisticsAreaCode("1");
AlibabaGscOpenapiEelDeliveryCreateRequest.DeliveryRequirements obj3 = new AlibabaGscOpenapiEelDeliveryCreateRequest.DeliveryRequirements();
obj3.setScheduleType("1");
obj3.setScheduleDay("1");
obj3.setScheduleStartTime("1");
obj3.setScheduleEndTime("1");
obj3.setDeliveryType("1");
obj2.setDeliveryRequirements(obj3);
AlibabaGscOpenapiEelDeliveryCreateRequest.SenderInfo obj4 = new AlibabaGscOpenapiEelDeliveryCreateRequest.SenderInfo();
obj4.setCompany("1");
obj4.setName("老王");
obj4.setZipCode("1");
obj4.setTel("1");
obj4.setMobile("13214567869");
obj4.setEmail("1");
obj4.setCountryCode("1");
obj4.setProvince("浙江省");
obj4.setCity("杭州");
obj4.setArea("余杭区");
obj4.setTown("xxx村");
obj4.setDetailAddress("杭州市余杭区989号");
obj2.setSenderInfo(obj4);
AlibabaGscOpenapiEelDeliveryCreateRequest.ReceiverInfo obj5 = new AlibabaGscOpenapiEelDeliveryCreateRequest.ReceiverInfo();
obj5.setCompany("1");
obj5.setName("老王");
obj5.setZipCode("1");
obj5.setTel("1");
obj5.setMobile("13214567869");
obj5.setEmail("1");
obj5.setCountryCode("1");
obj5.setProvince("浙江省");
obj5.setCity("杭州");
obj5.setArea("余杭区");
obj5.setTown("xxx村");
obj5.setDetailAddress("杭州市余杭区989号");
obj2.setReceiverInfo(obj5);
obj2.setIsUrgency("N");
obj2.setInvoiceFlag("N");
List<AlibabaGscOpenapiEelDeliveryCreateRequest.Invoice> list7 = new ArrayList<AlibabaGscOpenapiEelDeliveryCreateRequest.Invoice>();
AlibabaGscOpenapiEelDeliveryCreateRequest.Invoice obj8 = new AlibabaGscOpenapiEelDeliveryCreateRequest.Invoice();
list7.add(obj8);
obj8.setType("INVOICE");
obj8.setHeader("1");
obj8.setAmount("1");
obj8.setContent("1");
AlibabaGscOpenapiEelDeliveryCreateRequest.Detail obj10 = new AlibabaGscOpenapiEelDeliveryCreateRequest.Detail();
List<AlibabaGscOpenapiEelDeliveryCreateRequest.Item> list12 = new ArrayList<AlibabaGscOpenapiEelDeliveryCreateRequest.Item>();
AlibabaGscOpenapiEelDeliveryCreateRequest.Item obj13 = new AlibabaGscOpenapiEelDeliveryCreateRequest.Item();
list12.add(obj13);
obj13.setItemName("1");
obj13.setUnit("1");
obj13.setPrice("1");
obj13.setQuantity("1");
obj13.setAmount("1");
obj10.setItems(list12);
list9.setDetail(obj10);
obj2.setInvoices(list7);
obj2.setInsuranceFlag("1");
AlibabaGscOpenapiEelDeliveryCreateRequest.Insurance obj14 = new AlibabaGscOpenapiEelDeliveryCreateRequest.Insurance();
obj14.setType("1");
obj14.setAmount("1");
obj2.setInsurance(obj14);
obj2.setBuyerMessage("1");
obj2.setSellerMessage("1");
obj2.setRemark("1");
obj2.setShopCode("B002");
obj2.setPartnerCode("1");
obj1.setDeliveryOrder(obj2);
List<AlibabaGscOpenapiEelDeliveryCreateRequest.OrderLine> list16 = new ArrayList<AlibabaGscOpenapiEelDeliveryCreateRequest.OrderLine>();
AlibabaGscOpenapiEelDeliveryCreateRequest.OrderLine obj17 = new AlibabaGscOpenapiEelDeliveryCreateRequest.OrderLine();
list16.add(obj17);
obj17.setOrderLineNo("11");
obj17.setSourceOrderCode("11");
obj17.setSubSourceOrderCode("11");
obj17.setOwnerCode("H1234");
obj17.setItemCode("I1234");
obj17.setItemId("2001236541582");
obj17.setInventoryType("ZP");
obj17.setItemName("1");
obj17.setExtCode("1");
obj17.setPlanQty("11");
obj17.setRetailPrice("1");
obj17.setActualPrice("12.0");
obj17.setDiscountAmount("1");
obj17.setBatchCode("1");
obj17.setProductDate("1");
obj17.setExpireDate("1");
obj1.setOrderLines(list16);
obj1.setKey("abc");
obj1.setClient("1");
req.setDeliveryOrderCreateRequest(obj1);
AlibabaGscOpenapiEelDeliveryCreateResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_gsc_openapi_eel_delivery_create_response>
    <delivery_order_create_response>
        <delivery_order_id>W1234</delivery_order_id>
        <warehouse_code>W1345</warehouse_code>
        <logistics_code>P2345</logistics_code>
        <delivery_orders>
            <delivery_order>
                <delivery_order_id>C1234</delivery_order_id>
                <warehouse_code>W789</warehouse_code>
                <logistics_code>SF</logistics_code>
                <order_lines>
                    <order_line>
                        <order_line_no>11</order_line_no>
                        <item_code>I234</item_code>
                        <item_id>W234</item_id>
                        <quantity>1</quantity>
                    </order_line>
                </order_lines>
            </delivery_order>
        </delivery_orders>
        <flag>success</flag>
        <code>0</code>
        <message>invalid appkey</message>
    </delivery_order_create_response>
</alibaba_gsc_openapi_eel_delivery_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

返回
顶部