库存明细
- Kook Siong Then
- 1 获取库存明细
- 2 更新 / 输入库存明细
- 3 删除库存明细
基准URL: /smartfin/api/v1/stockmgmt
以下API的响应将以压缩形式返回。要对其进行解压缩，请安装npm: pako 插件并使用特定功能（inflate）来解压缩返回响应主体。
在实现HTTP服务时，每个请求的 HttpHeaders 需要设置为以下格式：
headers: new HttpHeaders({
'Content-Type': 'application/json'
}),
responseType: 'arraybuffer' as 'json'
获取库存明细
POST /smartfin/api/v1/stockmgmt/select
获取当前用户可见的所有库存。
验证 / 授权
请求标头
架构
请求标头:
Content-Type: application/json
Authorization （验证）：
string - JWT <<您的API密钥（令牌）>> (必填项)
请求载荷
例子:
JSON主体： {
"s_date":"2023-01-01",
"e_date":"2023-12-15",
"phy_trade_ids":[],
"stock_lvls": ["EX"], // 所有库存级别(stock_lvl)在库存明细中均为EX
"is_ap": false //由于库存级别为EX, 这个参数就等于false
} |
请求架构
s_date, e_date - string根据给定的日期范围过滤库存（
s_date=开始日期，e_date=结束日期）。
根据在请求主体中提供的合同ID过滤库存 ( 每个库存明细都分配给一个合同ID，响应将仅返回具有给定合同ID的库存，而不考虑解析的
s_date和e_date。 )
响应
例子:
返回
|
架构
有关数据的最后更新时间以及更新数据的用户的信息。
有关数据的创建时间以及创建数据的用户的信息。
user_id- 用户ID（数据所属的用户）stock_id- 分配给数据独立ID。该ID可用于检索库存明细。phy_trade_id- 与库存关联的合同ID。
maf_group_id- 库存所属的独立群组ID。
wh_id- 与库存关联的仓储ID。wh_add, wh_entity, wh_name- 仓储的相关细节。
更新 / 输入库存明细
更新URL:
POST /smartfin/api/v1/stockmgmt/execution_update
输入URL:
POST /smartfin/api/v1/stockmgmt/execution_insert
将新的库存明细输入或更新到数据库中。
验证 / 授权
请求标头
架构
请求标头:
Content-Type: application/json
Authorization （验证）：
string - JWT <<您的API密钥（令牌）>> (必填项)
请求载荷 （ 更新 ）
例子:
JSON 主体: |
请求载荷 ( 输入 )
例子:
JSON 主体: |
请求架构
根据给定的日期范围过滤库存（
s_date=开始日期，e_date=结束日期）。
将被更新的合同ID（当传递有效合同ID时，将更新合同的库存明细，如出入库数量、未出入库数量等）。
包含与
stmg于 库存明细 | 响应 相同的参数 ( 请参考上述 库存明细 | 请求载荷 ( 输入 ) 请求主体中需要包含的必需参数 )stock_id不需要传递，并且在此数组中不是必需的。包含要输入到数据库中的新库存明细。
包含与
stmg于 库存明细 | 响应 相同的参数 (请参考上述 库存明细 | 请求载荷 （ 更新 ） 请求主体中需要包含的必需参数 )包含要更新到数据库中的现有库存明细。
响应:
与 库存明细 | 响应 ( 请参考每个参数的定义 ) 的响应主体相同。
删除库存明细
DELETE /smartfin/api/v1/stockmgmt/delete
根据其 stock_id 删除单个/多个库存明细。
验证 / 授权
请求标头
架构
请求标头:
Content-Type: application/json
Authorization （验证）：
string - JWT <<您的API密钥（令牌）>> (必填项)
请求载荷
例子:
JSON 主体: |
包含用户删除的独立stock_id的数组。
将被更新的合同ID（当传递有效合同ID时，将更新合同的库存明细，如出入库数量、未出入库数量等）。
响应:
与 库存明细 | 响应 ( 请参考每个参数的定义 ) 的响应主体相同。