文档中心 > API类目 > 天猫校园零售

qimen.tmall.campus.order.create (天猫校园零售订单创建)

天猫校园零售对接ISV的订单创建，包含正向订单和逆向订单

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
memberCode	String	可选	会员uid		会员uid
owner	String	可选	ztxx		owner
deptName	String	可选	天猫校园居亦测试旗舰店03		门店名称
orderType	String	可选	1/商品订单		订单类型[格式：数字枚举/中文名称]
distMode	String	可选	配送模式暂不传		配送模式
orderSource	String	可选	102/云POS		订单来源[格式：数字枚举/中文名称]
buildManName	String	可选	收银员姓名		收银员姓名
orderItem	OrderItem []	可选		最大列表长度：999999	商品行列表
└ weigh Number 可选 0 重量(单位克) └ amount Number 可选 5 商品数量 └ saleMoney Number 可选 20000 实际销售金额（不包含运费金额+包装费） └ wholeDiscount Number 可选 0 整单折扣金额(单位分) └ salePrice Number 可选 5000 销售单价(单位分) └ originalInsideId Number 可选 12314455555 原子订单ID └ insideId String 可选 2480593681582852857 子订单ID └ saleAgio Number 可选 2000 促销折扣金额(单位分) └ goodsType Number 可选 1 商品类型 └ goodsBarCode String 可选商品条码商品条码 └ goodsOrderType Number 可选 90 商品行订单类型 └ weightGoods String 可选 0 是否散称 └ transMoney Number 可选 0 运费金额(单位分) └ sellOperatorCode String 可选收银员工号收银员工号 └ sellOperatorName String 可选收银员姓名收银员姓名 └ goodsName String 可选商品名称商品名称 └ virtualGoods Number 可选 0 是否虚拟商品[0否1是] └ singleDiscount Number 可选 0 单品折扣金额(单位分)
rePlacementFlag	Number	可选	0		销退货标志[0销售\|1退货退款\|2仅退款] 3出库前退款
discountItem	DiscountItem []	可选		最大列表长度：999999	优惠列表
└ promotionType Number 可选 111 活动类型 └ promotionName String 可选天猫营销活动名称活动名称 └ orderItemID String 可选子订单号子订单号 └ promotionCode String 可选天猫营销活动编码天猫营销活动编码 └ discountPrice Number 可选 5000 优惠金额(单位分) └ insideId String 可选促销ID 促销ID └ voucherCode String 可选优惠券实例优惠券实例 assumeList AssumeInfo [] 可选优惠承担列表 └ assumeRate Number 可选 1300 优惠券承担比例(13%传 1300) └ assumeMoney Number 可选 100 优惠券承担金额（(单位分) └ assumeCode String 可选 111 优惠券承担方编码 └ assumeName String 可选天猫校园优惠券承担方名称 └ discType Number 可选 1 优惠券折扣标识，1代表优惠券
memberName	String	可选	会员名称		会员名称
accTime	String	可选	HHmmss		制单时间
payList	PayList []	可选		最大列表长度：999999	支付方式列表
└ payAmount Number 可选 50000 支付金额 └ payMethod String 可选支付方式编码支付方式编码 └ payMethodName String 可选支付方式名称支付方式名称
recMoney	Number	可选	230000		实际支付金额
accDate	String	可选	yyyyMMdd		制单日期
_platform_num	String	可选	880001		租户号
submitTime	String	可选	yyyyMMddHHmmss		确认时刻
originalOrderBillNO	String	可选	原单号		原单号
transMoney	Number	可选	0		运费金额(单位分)
buildManCode	String	可选	收银员工号		收银员工号
payInformationSource	Number	可选	2		支付信息来源[枚举：]
orderProcessMode	Number	可选	3		订单处理方式[枚举：]
billNumber	String	可选	2480593681582852857		订单号
deptCode	String	可选	748190043		门店编码
deviceId	String	可选	8e3aa269b231d635290761cabee7b756		终端号
otherSourceBillNO	String	可选	1171653650546833		校园单号

响应参数

名称	类型	示例值	描述
success	Boolean	true	调用是否成功
errCode	String	错误编码	错误编码
errMsg	String	错误消息	错误消息

请求示例

{"deptName":"天猫校园居亦测试旗舰店03","orderType":"1/商品订单","distMode":"配送模式暂不传","buildManName":"收银员姓名","orderBizType":1,"discountItem":[{"promotionType":111,"promotionName":"天猫营销活动名称","discType":1,"orderItemID":"子订单号","promotionCode":"天猫营销活动编码","discountPrice":5000,"insideId":"促销ID","voucherCode":"优惠券实例","assumeList":[{"assumeName":"天猫校园","assumeRate":1300,"assumeCode":"111","assumeMoney":100}]}],"memberName":"会员名称","deviceId":"8e3aa269b231d635290761cabee7b756","transMoney":0,"payInformationSource":2,"orderProcessMode":3,"packageFee":100,"memberCode":"会员uid","owner":"ztxx","orderSource":"102/云POS","orderItem":[{"weigh":0,"amount":5,"saleMoney":20000,"wholeDiscount":0,"salePrice":5000,"originalInsideId":0,"insideId":"2480593681582852857","saleAgio":2000,"goodsType":1,"goodsBarCode":"商品条码","goodsOrderType":90,"weightGoods":"0","transMoney":0,"sellOperatorCode":"收银员工号","sellOperatorName":"收银员姓名","goodsName":"商品名称","virtualGoods":0,"singleDiscount":0}],"rePlacementFlag":0,"accTime":"HHmmss","payList":[{"payAmount":50000,"payMethod":"支付方式编码","payMethodName":"支付方式名称","payMethodCode":32}],"recMoney":230000,"accDate":"yyyyMMdd","_platform_num":"880001","submitTime":"yyyyMMddHHmmss","deliveryFee":100,"originalOrderBillNO":"原单号","buildManCode":"收银员工号","billNumber":"2480593681582852857","deptCode":"748190043","otherSourceBillNO":"1171653650546833"}

响应示例

{
    "success":true,
    "errCode":"错误编码",
    "errMsg":"错误消息"
}

验签示例

{"success":"false","errCode":"sign-check-failure","errMsg":"Illegal request"}

错误码解释

错误码	错误描述	解决方案
isp.http-connection-timeout
response-body-parse-error

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

淘宝开放平台

天猫校园零售

qimen.tmall.campus.order.create (天猫校园零售订单创建)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ