新增采购单

websocket测试

POST

请求地址/router

系统相关界面

“界面路径：【采购】----【采购单管理】----【新增采购单】”

请求地址

环境	服务地址(HTTP/HTTPS)
V2正式环境	https://gw.superboss.cc/router

2022年4月1日以后申请的APP Key，统一使用V2正式环境的请求地址：https://gw.superboss.cc/router

公共参数

调用任何一个API都必须传入的参数，目前支持的公共参数有：

参数名称	参数类型	是否必须	参数描述
method	string	是	API接口名称
appKey	string	是	分配给应用的AppKey
timestamp	string	是	时间戳，时区为GMT+8，例如：2020-09-21 16:58:00。API服务端允许客户端请求最大时间误差为10分钟
format	string	否	响应格式。默认为json格式，可选值：json
version	string	是	API协议版本可选值：1.0
sign_method	string	否	签名的摘要算法(默认 hmac)，可选值为：hmac，md5，hmac-sha256。
sign	string	是	签名
session	string	是	授权会话信息（即access_token，由系统分配）

请求头

参数名

类型

描述

必填

Content-Type

string

multipart/form-data

必填

API接口地址

参数名

类型

描述

必填

method

string

purchase.add

必填

请求参数

参数名

类型

描述

必填

outerCode

string

外部采购订单号(不允许重复)

可选

remark

string

备注

可选

supplierCode

string

供应商(编码) - 必填

必填

deliveryDate

string

交货日期

可选

items

string

采购的商品列表 json [{"outerId":"springday","quantity":1,"price":1,"remark":"备注信息"}]

必填

outerId

string

springday

必填

quantity

number

采购数量

必填

price

number

采购单价（单位：分）

必填

remark

string

备注信息

必填

warehouseCode

string

仓库外部编码

必填

status

string

状态 WAIT_VERIFY （草稿）、VERIFYING(提交审核)、VERIFY（审核）

可选

请求示例


{
"outerCode": "string",
"remark": "string",
"supplierCode": "string",
"deliveryDate": "string",
"items": " [{"outerId":"springday","quantity":1,"price":1,"remark":"备注信息"}]",
"warehouseCode": "string",
"status": "string"
}

响应参数

参数名

类型

描述

必填

string

示例：采购单id

必填

响应示例


{
  "id": 12345
}

异常示例


{
    "code": "25",
    "msg": "服务方法(purchase.add:1.0)的签名无效",
    "success": false,
    "trace_id": "3553483395423660"
}

错误码解释

错误码	错误信息	解决方案
25	服务方法(purchase.add:1.0)的签名无效	签名参数错误