do-add-purchase (新增采购单)

公共参数

接口地址 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-add-purchase

公共响应参数:

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

请求参数

名称
类型
必须
示例值
描述
warehouseName
String
true
仓库名称
providerName
String
true
供应商名称
employeeName
String
true
员工名称
orderBillNO
String
false
自定义单据号,最长字符20
expressMoney
String
false
采购运费
estimatedTime
String
false
到货天数
expressType
String
false
快递方式
expressId
String
false
快递单号
content
String
false
采购备注
notCalculate
String
false
是否计算采购在途,1计算 2不计算
isAutoSubmitCheck
String
false
生成的采购单将自动提交采购,1自动 2不自动
stockList
JSON
true
多维
商品信息

响应参数

名称
类型
示例值
描述
code
String
0000
999失败;000成功
message
String
新增成功
描述信息
groupId
String
12423434554769
采购批次号

异常示例

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

错误码解释

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