资产入库单接口 ​

1. 获取列表 ​

请求地址 ​

text
GET /AssetInStorage

参数说明 ​

资产入库单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录 ​

返回结果 ​

json
 {
    "offset": 0,
    "total": 1,
    "results": [
    {
        "assets": [
            {
                "id": "374908b4-5e5f-4c6f-b6cb-f724278db1df",
                "inStorageId": "43ead74b-ed2e-4d64-8f6d-5ee0cae24827",
                "barcode": "ssa",
                "name": "sss",
                "assetTypeName": "12",
                "specs": "sss",
                "measureUnit": "s",
                "useCompanyName": "测试公司-王佳豪",
                "userEmployeeNo": "TT-015",
                "user": "T钱多多",
                "districtName": "hahahhahahha",
                "ownCompanyCode": "000079",
                "ownCompanyName": "湖南云箭集团",
                "address": "s",
                "supervisor": "doris 3",
                "source": "购入",
                "purchaseDate": "2022-01-27",
                "amount": "100",
                "sn": "sss",
                "serviceLife": "12",
                "vendorContacts": "a",
                "vendorPhoneNumber": "18931160920",
                "maintainerName": "杨祖行",
                "maintenanceExpiredDate": "2022-01-27",
                "dataJson": "{\"input_63479\":\"1\",\"input_63481\":\"2\",\"input_64808\":\"s\",\"input_1637052869819\":\"s\",\"input_63480\":\"21\",\"input_58364\":\"12\",\"input_63134\":\"1\"}",
                "purchaseReceiveSerialNo": "",
                "purchaseReceiveDetailId": "00000000-0000-0000-0000-000000000000"
            }
        ],
        "assetTotal": 39,
        "id": "3cf31677-2d91-451e-9dcb-002b192e1aec",
        "enterpriseId": 1469,
        "serialNo": "AIS202201260022",
        "createdBy": "1941",
        "createdTime": "1643177900",
        "stauts": 0,
        "dataJson": "{\"serialNo\":\"AIS202201260022\",\"receiveSerialNo\":null,\"creator\":{\"value\":1941,\"label\":\"XGY\"},\"date\":\"2022-01-26\",\"vendor\":null,\"createDate\":\"2022-01-26\",\"ownCompany\":{\"value\":49678,\"code\":\"000079\",\"label\":\"湖南云箭集团\",\"type\":\"departmentName\"},\"source\":{\"value\":\"1\",\"label\":\"购入\",\"color\":{\"backgroundColor\":\"#577eff\",\"foreColor\":\"#ffffff\"}},\"remark\":null,\"version\":\"\"}"
    }]
}
参数说明
offset当前结果对于首条结果的偏移量，指定分页查询时不为0
total所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results符合查询条件的资产入库单详情集合

2. 新建修改入库单 ​

请求地址 ​

text
PUT /AssetInStorage
POST /AssetInStorage/put
x-www-from-urlencoded方式传值

对于不支持PUT请求的网络环境，请尝试使用备份的POST请求姿势

请求示例 ​

json
{
   "FormJson": {
       "serialNo": "AIS202201270002",
       "receiveSerialNo": {
           "id": "b6391496-8098-4cb9-b0a6-8d0add41d1b2",
           "serialNo": "PAR202201120001",
           "purchasePlatform": 1,
           "sourceType": 2,
           "companyId": 49678,
           "companyCode": "000079",
           "companyName": "湖南云箭集团",
           "receivedBy": 1941,
           "receivedUserName": "XGY",
           "receivedTime": "2022-01-12",
           "vendorId": "e451ef34-3d7f-4ec5-9057-d97d46ed92f6",
           "vendorName": "供应商名称",
           "comment": "订单说明: ",
           "status": 3,
           "attachments": []
       },
       "creator": {
           "value": 1941,
           "label": "XGY"
       },
       "date": "2022-01-27",
       "vendor": {
           "value": "e451ef34-3d7f-4ec5-9057-d97d46ed92f6",
           "label": "供应商名称"
       },
       "createDate": "2022-01-27",
       "ownCompany": {
           "value": 50677,
           "code": "000170",
           "label": "测试",
           "type": "departmentName"
       },
       "source": {
           "value": "4",
           "label": "捐赠",
           "color": {
               "backgroundColor": "#4fbbe0",
               "foreColor": "#ffffff"
           }
       },
       "remark": null,
       "version": ""
   },
   "DataJson": [{
       "barcode": "ssa",
       "name": "sss",
       "assetTypeName": "12",
       "specs": "sss",
       "measureUnit": "s",
       "useCompanyName": "测试公司-王佳豪",
       "userEmployeeNo": "TT-015",
       "user": "T钱多多",
       "districtName": "hahahhahahha",
       "ownCompanyCode": "000079",
       "ownCompanyName": "湖南云箭集团",
       "address": "s",
       "supervisor": "doris 3",
       "source": "购入",
       "purchaseDate": "2022-01-27",
       "amount": "100",
       "sn": "sss",
       "serviceLife": "12",
       "vendorContacts": "a",
       "vendorPhoneNumber": "18931160920",
       "maintainerName": "杨祖行",
       "maintenanceExpiredDate": "2022-01-27",
       "dataJson": "{\"input_63479\":\"1\",\"input_63481\":\"2\",\"input_64808\":\"s\",\"input_1637052869819\":\"s\",\"input_63480\":\"21\",\"input_58364\":\"12\",\"input_63134\":\"1\"}",
   }],
   "Status": 0
 }

参数说明 ​

参数是否必填说明
FormJson是入库单详情
DataJson是入库单包含的资产集合
Status是类型(0:草稿;1:提交)

创建资产入库单单据属性详情 ​

属性名称说明
SerialNo入库单号
ReceiveSerialNo关联收货单详情
Creator创建人详情
Date入库日期
Vendor供应商详情
CreateDate创建日期
OwnCompany所属公司详情
Source来源详情
Remark入库说明

资产入库单关联收货单详情 - 收货管理单数据对象格式 ​

属性名称说明
id收货单id
serialNo收货管理单号
purchasePlatform采购平台
sourceType收货单的来源类型（1：无关联采购订单、2：关联了采购订单）
companyId收货公司Id
companyCode收货公司编码
companyName收货公司名称
receivedBy收货人Id
receivedUserName收货人名称
receivedTime收货时间（时间戳格式）
vendorId供应商Id
vendorName供应商名称
comment变更单的变更说明
status订单状态（1：草稿、2：已提交、3：已审批、4：已驳回、5：已完成）
attachments附加信息（请从管理员端操作附件）

创建人详情 ​

属性名称说明
value创建人用户Id
label创建人名称

供应商详情 ​

属性名称说明
value供应商Id
label供应商名称

所属公司详情 ​

属性名称说明
value所属公司或部门Id
code所属公司或部门编码
label所属公司或部门名称
type所属组织为公司时应使用"companyName"，为部门时应使用"departmentName"

来源详情 ​

属性名称说明
value来源方式（1:购入、2:自建、3:租赁、4:捐赠、5:其他、6:内部购入、7:盘盈）
label来源名称

返回结果 ​

json
{}

对于成功创建的请求，该进口仅返回HTTP 200 OK

3. 删除入库单 ​

请求地址 ​

text
ELETE /AssetInStorage/{SerialNo}
POST /AssetInStorage/{SerialNo}/Delete

对于不支持DELETE请求的网络环境，请尝试使用备份的POST请求地址

请求示例 ​

json
{}

说明 ​

只能删除草稿状态的单据，对于成功删除的请求，该接口仅返回HTTP 200 OK

附录 ​

1. 支持的查询参数 ​

如无特别说明，下列操作对于查询实体对象中的任意属性均适用。使用时只需将其追加至请求的querystring中即可。对实体对象中不存在的属性进行操作将会得到不可预期的结果。

分页

skip={数字} 跳过指定条数的记录数

take={数字} 取出指定条数的记录数

include=total 需要返回记录总数

排序

orderBy=[-]{属性名称},[-]{属性名称} 返回结果按指定属性排序，在名称前加”-“表示按倒序排序。多个属性的排序可使用逗号分隔。如：orderBy=-Id,Name,-Age

高级搜索

使用 {ExtensionFilters} 属性来过滤资产入库单数据 详情。

高级搜索过滤字段详情 ​

属性名称说明
label字段名称
operator过滤条件详情
value除了供应商,收货单号,所属公司,来源字段其他均是简单类型(string),复杂类型过滤查询详见 详情
过滤条件 ​
属性名称说明
EqualTo等于
NotEqualTo不等于
Contains包含
NotContains不包含
StartsWith开头为
GreaterThan大于
GreaterThanOrEqualTo大于等于
LessThan小于
LessThanOrEqualTo小于等于
自定义字段详情 ​
属性名称说明
value字段值
label字段名称
请求示例 ​
text
                url?take=50&skip=0&include=total&orderby=-createdTime&extensionFilters=[{label:"name",operator:"Contains",value:"电脑"}]

2. 数据实体格式 ​

1. 查询资产入库单返回单据详情格式 ​

属性名称说明
assets资产明细详情
assetTotal资产明细总数
id单据标识
serialNo入库单号
createdBy创建人标识
createdTime创建日期
stauts状态枚举

2. 创建资产入库单资产数据详情 ​

属性名称说明
barcode资产编码
name资产名称
assetTypeName资产分类名称
specs规格型号
measureUnit计量单位
useCompanyName使用公司名称
userEmployeeNo使用人工号
user使用人名称
districtName区域名称
ownCompanyCode所属公司编码
ownCompanyCode所属公司名称
address存放地点
supervisor管理员
source来源
purchaseDate购入日期
amount金额
sn设备序列号
serviceLife使用期限（月）
vendorContacts供应商联系人
vendorPhoneNumber供应商联系方式
maintainerName维保负责人
maintenanceExpiredDate维保到期日
dataJson资产扩展字段

3. 入库单状态枚举 ​

属性名称说明
0草稿
1,5已完成
2审批中
3已驳回