do-create-order (新增订单)

公共参数

接口地址 http://openapi.mabangerp.com
提交方式 POST
HTTP Header Content-Type: application/json
Authorization: 签名
签名:HTTP Body所有入参的字符串JSON格式和开发者密钥传递给HMAC-SHA256哈希算法来计算签名
HMAC签名函数的输出是二进制字符串。这需要进行十六进制编码以生成签名字符串。
例如:
HTTP Body所有入参的字符串JSON:{"developerId":10000,"timestamp":1592478495,"action":"get-order-list"}
开发者密钥:c5540d632392451a0ad89721d0705ce24cb2
生成的签名: ae6dbd7743e05cafb8b3b17b7f11d4379a2392a8da119acf66082a3262651f96
HTTP Body HTTP正文应仅包含序列化的JSON字符串(所有入参的数据)
请求频率 每分钟300个请求, 在响应头中可查看(限制X-RateLimit-Limit, 剩余X-RateLimit-Remaining)

公共请求参数:

名称 类型 必须 描述
developerId String 开发者账号(需联系客服开通)
timestamp String Unix 时间戳;接口有效时间半小时
action String 方法:do-create-order

公共响应参数:

名称 类型 必须 描述
code String 请求失败返回的错误码
message String 请求失败返回的错误信息

请求参数

名称
类型
必须
示例值
描述
platformOrderId
String
true
订单编号
salesRecordNumber
String
false
平台编号,不传按订单存储
platformTrackNumber
String
false
平台跟踪单号
shopName
String
true
rrr
店铺名称
shippingType
String
false
发货类型
warehouseName
String
false
rrr11
发货仓库名称
myLogisticsChannelId
String
false
51871
Erp物流渠道编号
trackNumber1
String
false
内部单号
trackNumber2
String
false
虚拟单号
buyerUserId
String
true
100001
买家编号
buyerName
String
false
mb
买家名称
phone1
String
true
买家电话一
phone2
String
false
买家电话二
country
String
true
中国
买家国家,和countryCode俩者至少一个必填
countryCode
String
false
CN
买家国家二字码,填写时country可不写
district
String
false
买家所属区域
province
String
false
买家省份
city
String
false
买家城市
street1
String
true
买家地址一
street2
String
false
买家地址二
abnnumber
String
false
VAT税号
email
String
false
买家邮箱
doorcode
String
false
买家门牌号
postCode
String
false
买家邮编
buyerMessage
String
false
买家留言
currencyId
String
true
USD
订单币种
voucherPrice
String
false
0
优惠金额
shippingCost
String
false
0
运费支出
shippingFee
String
false
0
邮费
platformFee
String
false
0
平台费
itemTotal
String
false
0
商品总售价,如果填写值,将不按照商品售价计算
otherIncome
String
false
0
其他收入
otherExpend
String
false
0
其他支出
insuranceFee
String
false
0
原始保险费
paypalFee
String
false
0
原始资金转账费
paidTime
Datetime
true
2019-11-26 16:30:22
付款时间
paymentName
String
false
支付方式
codflag
String
false
10.cod订单 11.wish WE订单
shippingService
String
false
买家自选物流
dlypName
String
false
是否自提信息
paypalId
String
false
paypal编号
transNumber
String
false
转账流水号
deliveryRemark
String
false
发货备注
remark
String
false
订单备注
orderItemList
JSON
true
多维
所有商品信息
extendAttr
JSON
false
多维
组装扩展属性

响应参数

名称
类型
示例值
描述
code
String
000
999失败;000成功
message
String
订单创建成功
描述信息

异常示例

 {
    "code":999,
    "message":失败原因
}
 

错误码解释

错误码 错误消息
000 成功
999 失败描述