入库单接口
1. 获取耗材入库单、冲销单列表
请求地址
text
GET /consumable/inStorage参数说明
耗材入库单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录
返回结果
json
{
"offset": 0,
"total": 13,
"results": [
{
"warehouseCode": "1001",
"details": [
{
"serialNo": "RK202004180001",
"enterpriseId": 4506,
"batchNo": "20041802",
"consumableId": 92509,
"code": "00001",
"name": "钢笔",
"picturePath": "/UploadImage/fecccae7-57d6-4c3a-adb6-1985cef042d1.jpg",
"thumbnailPath": "/UploadImage/eeed2784-2610-4bf1-a2d7-557131df9d60.jpg",
"specification": "文具",
"measureUnit": "根",
"quantity": 20.00,
"unitPrice": 5.0000,
"amount": 100.0000,
"remark": "",
"barcode": "00001"
}
],
"inType": 0,
"serialNo": "RK202004180001",
"enterpriseId": 4506,
"vendor": "供应",
"signatureStatus": 1,
"signaturePicturePath": "/SignatureImage/a70d2b46-cb24-459d-a260-cf22d43d5ccd.jpg",
"warehouseId": 10180,
"warehouseName": "北京仓",
"handleTime": "1587139200",
"createdTime": "1587180561",
"createdBy": 6261,
"createdByName": "尚德",
"remark": "入库",
"lastTime": "1587180590",
"lastUserID": 6261,
"lastUser": "尚德",
"updatedTime": "1587180590",
"forceComplete": false
}
],
"meta": {}
}| 参数 | 说明 |
|---|---|
| offset | 当前结果对于首条结果的偏移量，指定分页查询时不为0 |
| total | 所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0 |
| results | 符合查询条件的耗材入库单详情集合 |
| meta | 其他信息 |
2. 新增耗材入库单
请求地址
text
POST /consumable/inStorage请求示例
json
{
"HandleTime":"1601308800",
"InType":"0",
"Remark":"备注",
"WarehouseCode":"1001",
"Products":[
{
"Quantity":"20",
"Amount":"60.0",
"Code":"26886859",
"BatchNo":"20092901",
"Remark":"物品"
}
],
"Vendor":"供应"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| HandleTime | 是 | 业务日期（时间戳格式） |
| InType | 是 | 单据类型（0:耗材入库单） |
| Remark | 否 | 入库备注 |
| WarehouseCode | 是 | 入库仓库 |
| Vendor | 否 | 供应商 |
| Products | 是 | 物品详情集合 |
物品详情
| 属性名称 | 说明 |
|---|---|
| Code | 物品编码 |
| BatchNo | 批次 |
| Quantity | 数量 |
| Amount | 金额 |
| Remark | 备注 |
返回结果
json
{
"serialNo": "CIS202009290001",
"signatureId": 341300,
"safetyStockReminder": ""
}结果说明
| 属性名称 | 说明 |
|---|---|
| serialNo | 单据号 |
| signatureId | 签字id |
| safetyStockReminder | 安全库存报警 |
3. 修改耗材入库单
请求地址
text
PUT /consumable/inStorage/{serialNo}
POST /consumable/inStorage/{serialNo}/put对于不支持PUT请求的网络环境，请尝试使用备份的POST请求地址
请求示例
json
{
"HandleTime":"1601308800",
"Remark":"备注",
"WarehouseCode":"1001",
"Products":[
{
"Quantity":"20",
"Amount":"60.0",
"Code":"26886859",
"BatchNo":"20092901",
"Remark":"物品"
}
],
"Vendor":"供应"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| HandleTime | 是 | 业务日期（时间戳格式） |
| Remark | 否 | 入库备注 |
| WarehouseCode | 是 | 入库仓库 |
| Vendor | 否 | 供应商 |
| Products | 是 | 物品详情集合 |
返回结果
json
{
"serialNo": "CIS202009290001",
"signatureId": 341300,
"safetyStockReminder": ""
}结果说明
| 属性名称 | 说明 |
|---|---|
| serialNo | 单据号 |
| signatureId | 签字id |
| safetyStockReminder | 安全库存报警 |
4. 删除耗材入库单
请求地址
text
DELETE /consumable/inStorage/{serialNo}
POST /consumable/inStorage/{serialNo}/delete对于不支持DELETE请求的网络环境，请尝试使用备份的POST请求地址
返回结果
json
{}对于成功删除的请求，该接口仅返回HTTP 200 OK
5. 新增耗材冲销单
请求地址
text
POST /consumable/antiInStorage请求示例
json
{
"HandleTime":"1601308800",
"InType":"1",
"Remark":"备注",
"WarehouseCode":"1001",
"Products":[
{
"Quantity":"20",
"Amount":"60.0",
"Code":"26886859",
"BatchNo":"20092901",
"Remark":"物品"
}
],
"Vendor":"供应"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| HandleTime | 是 | 业务日期（时间戳格式） |
| InType | 是 | 单据类型（1:耗材冲销单） |
| Remark | 否 | 冲销备注 |
| WarehouseCode | 是 | 冲销仓库 |
| Vendor | 否 | 供应商 |
| Products | 是 | 物品详情集合 |
返回结果
json
{
"serialNo": "CAI202009290001",
"signatureId": 341300,
"safetyStockReminder": ""
}结果说明
| 属性名称 | 说明 |
|---|---|
| serialNo | 单据号 |
| signatureId | 签字id |
| safetyStockReminder | 安全库存报警 |
6. 修改耗材冲销单
请求地址
text
PUT /consumable/antiInStorage/{serialNo}
POST /consumable/antiInStorage/{serialNo}/put对于不支持PUT请求的网络环境，请尝试使用备份的POST请求地址
请求示例
json
{
"HandleTime":"1601308800",
"Remark":"备注",
"WarehouseCode":"1001",
"Products":[
{
"Quantity":"20",
"Amount":"60.0",
"Code":"26886859",
"BatchNo":"20092901",
"Remark":"物品"
}
],
"Vendor":"供应"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| HandleTime | 是 | 业务日期（时间戳格式） |
| Remark | 否 | 冲销备注 |
| WarehouseCode | 是 | 冲销仓库 |
| Vendor | 否 | 供应商 |
| Products | 是 | 物品详情集合 |
返回结果
json
{
"serialNo": "CAI202009290001",
"signatureId": 341300,
"safetyStockReminder": ""
}结果说明
| 属性名称 | 说明 |
|---|---|
| serialNo | 单据号 |
| signatureId | 签字id |
| safetyStockReminder | 安全库存报警 |
7. 删除耗材冲销单
请求地址
text
DELETE /consumable/antiInStorage/{serialNo}
POST /consumable/antiInStorage/{serialNo}/delete对于不支持DELETE请求的网络环境，请尝试使用备份的POST请求地址
返回结果
json
{}对于成功删除的请求，该接口仅返回HTTP 200 OK
附录
1. 支持的查询参数
如无特别说明，下列操作对于查询实体对象中的任意属性均适用。使用时只需将其追加至请求的querystring中即可。对实体对象中不存在的属性进行操作将会得到不可预期的结果。
分页
skip={数字} 跳过指定条数的记录数
take={数字} 取出指定条数的记录数（注：最大值为1500，即单页最多返回1500条数据）
include=total 需要返回记录总数
排序
orderBy=[-]{属性名称},[-]{属性名称} 返回结果按指定属性排序，在名称前加”-“表示按倒序排序。多个属性的排序可使用逗号分隔。如：orderBy=-Id,Name,-Age
条件过滤
不等于
{属性名称}!={值} 如：Id!=1
大于等于
>{属性名称}={值} 如：>Id=1
大于
{属性名称}>={值} 如：Id>=1
小于
<{属性名称}={值} 如：<Id=1
小于等于
{属性名称}<={值} 如：Id<=1
In
{属性名称}In={值，值，值} 属性的值需包含在指定的集合中，如：IdIn=1,2,3
Between
{属性名称}Between={值，值} 属性的值需处于指定的区间之间，仅支持数字，如： IdBetween=1,3
字符串包含指定字符
{属性名称}Contains={值} 如：nameContains=abc
字符串以指定字符开头
{属性名称}StartsWith={值} 如：nameStartsWith=abc
字符串以指定字符结尾
{属性名称}EndsWith={值} 如：nameEndsWith=abc
2. 数据实体格式
1. 耗材入库单数据对象格式
| 属性名称 | 说明 |
|---|---|
| warehouseCode | 入库仓库编码 |
| inType | 单据类型（0:入库单、1:冲销单） |
| serialNo | 单据号 |
| enterpriseId | 企业id |
| vendor | 供应商 |
| warehouseId | 入库仓库id |
| warehouseName | 入库仓库名称 |
| handleTime | 经办日期（时间戳格式） |
| createdTime | 创建日期（时间戳格式） |
| createdBy | 创建人id |
| createdByName | 创建人 |
| remark | 备注 |
| lastTime | 最后一次修改时间（时间戳格式） |
| lastUserID | 最后一次修改人id |
| lastUser最后一次修改人 | |
| updatedTime | 更新时间（时间戳格式） |
| forceComplete | 是否强制完成 |
| signatureStatus | 办理状态（0:待签字、1:已签字、2:已驳回、4:审批中、5:已审批、6:已驳回、10:已审批待签字、11:已审批已签字、12:已审批已驳回、3:空状态） |
| signaturePicturePath | 签字图片 |
| dataJson | 单据扩展字段字符串合集 |
| details | 耗材入库、冲销单包含的物品详情集合 |
耗材入库、冲销单包含的物品详情
| 属性名称 | 说明 |
|---|---|
| serialNo | 单据号 |
| enterpriseId | 企业id |
| batchNo | 批次号 |
| consumableId | 物品id |
| code | 物品编码 |
| name | 物品名称 |
| picturePath | 物品图片路径 |
| thumbnailPath | 物品缩略图路径 |
| specification | 规格型号 |
| measureUnit | 计量单位 |
| quantity | 数量 |
| unitPrice | 单价 |
| amount | 金额 |
| remark | 备注 |
| barcode | 商品码 |