采购申请接口

1. 获取采购申请单列表

请求地址

text

GET /Purchase/Application

参数说明

采购申请单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录

返回结果

json

{
    "offset": 0,
    "total": 13,
    "results": [
        {
            "id": "1ac1ade2-3fe9-4452-85c5-ba555755288e",
            "serialNo": "PAA202109030001",
            "companyId": 53291,
            "companyCode": "AB",
            "companyName": "易点易动",
            "appliedBy": 53763,
            "appliedUserName": "霍龙",
            "appliedTime": "1630654805",
            "appliedDepartment": 332972,
            "appliedDepartmentCode": "10",
            "appliedDepartmentName": "行政部",
            "appliedEmployId": "1cb0d53e-fb7d-4e1a-8414-2362fdf82ff3",
            "appliedEmployName": "蔡子华",
            "appliedType": 1,
            "purchaseCompanyId": 53291,
            "purchaseCompanyCode": "AB",
            "purchaseCompanyName": "易点易动",
            "receiveAddress": "5楼仓库",
            "vendorId": "4e0024ac-8c9f-4946-bc77-de6a1e4801e0",
            "vendorName": "苏宁易购",
            "expectedTimeArrival": "1630654805",
            "comment": "缺货，申请",
            "status": 1,
            "updateTime": "1630655056",
            "updateBy": "53763",
            "details": [
                {
                    "id": "aae99fda-6539-4782-a0f0-a5587fe0a6d2",
                    "skuId": 39596,
                    "skuName": "小米11",
                    "skuCode": "11Pro",
                    "skuUnit": "台",
                    "skuSpecs": "11Pro",
                    "skuType": 1,
                    "assetTypeCode": "01010102",
                    "assetTemplateName": "小米11",
                    "displayIndex": 1,
                    "quantity": 2.00,
                    "price": 9999.0000,
                    "amount": 19998.000000,
                    "purchasedQuantity": 0.00,
                    "assignedQuantity": 0.00,
                    "receivedQuantity": 0.00,
                    "closedQuantity": 0.00,
                    "status": 1,
                    "applicationId": "1ac1ade2-3fe9-4452-85c5-ba555755288e",
                    "comment": "资产",
                },
                {
                    "id": "13bb2d6a-e804-4d2f-a0ca-add61148e2ad",
                    "skuId": 96533,
                    "skuName": "铝塑板",
                    "skuCode": "0001",
                    "skuUnit": "张",
                    "skuSpecs": "Y43",
                    "skuType": 2,
                    "assetTypeCode": "",
                    "assetTemplateName": "",
                    "displayIndex": 2,
                    "quantity": 10.00,
                    "price": 20.0000,
                    "amount": 200.000000,
                    "purchasedQuantity": 0.00,
                    "assignedQuantity": 0.00,
                    "receivedQuantity": 0.00,
                    "closedQuantity": 0.00,
                    "status": 1,
                    "applicationId": "1ac1ade2-3fe9-4452-85c5-ba555755288e",
                    "comment": "耗材",
                }
            ],
            "attachments": []
        }
    ],
    "meta": {}
}

参数	说明
offset	当前结果对于首条结果的偏移量，指定分页查询时不为0
total	所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0
results	符合查询条件的采购申请单详情集合
meta	其他信息

2. 新增采购申请单

请求地址

text

POST /Purchase/Application

请求示例

json

{
  "companyCode": "AB",
  "appliedDepartmentCode": "10",
  "purchaseCompanyCode": "AB",
  "appliedTime": "1630654805",
  "vendorId": "4e0024ac-8c9f-4946-bc77-de6a1e4801e0",
  "receiveAddress": "5楼仓库",
  "expectedTimeArrival": "1630654805",
  "comment": "缺货，申请",
  "details": [
    {
      "skuCode": "11Pro",
      "skuType": 1,
      "assetTemplateName": "小米11",
      "assetTypeCode": "01010102",
      "displayIndex": 1,
      "quantity": 2,
      "amount": 19998,
      "price": 9999,
      "comment": "资产"
    },
    {
      "skuCode": "0001",
      "skuType": 2,
      "assetTemplateName": "铝塑板",
      "displayIndex": 2,
      "quantity": 10,
      "amount": 200,
      "price": 20,
      "comment": "耗材"
    }
  ],
  "status": 2
}

参数说明

参数	是否必须	说明
companyCode	是	申请公司编码
appliedDepartmentCode	否	申请部门编码
purchaseCompanyCode	是	采购公司编码
appliedTime	是	申请时间（时间戳格式）
vendorId	否	供应商id
receiveAddress	否	收货信息
expectedTimeArrival	否	期望到货日期（时间戳格式）
comment	是	申请说明
status	否	该字段不传值为保存单据（草稿状态的申请单）、传2为保存并提交单据（已提交的申请单）
details	是	要申请的物品详情（可以在设置-通用设置中调整为“允许申请不指定具体物品”，设置完成后可以不上传物品的信息）

物品详情

参数	是否必须	说明
skuCode	是	物品编码
skuType	是	物品类型（1：资产、2:耗材）
assetTemplateName	是	物品名称
assetTypeCode	否	资产分类编码（如果物品类型为资产，则该项必填）
displayIndex	是	显示的行号（物品的序列号）
quantity	是	物品数量
amount	否	物品单价
price	否	物品金额
comment	否	物品备注

返回结果

json

{
    "id":"1ac1ade2-3fe9-4452-85c5-ba555755288e",
    "serialNo":"PAA202109030001"
}

结果说明

属性名称	说明
id	申请单id
serialNo	申请单号

3. 修改、提交采购申请单

请求地址

text

POST /Purchase/Application/put

请求示例

json

{
  "serialNo": "PAA202109030001",
  "companyCode": "AB",
  "appliedDepartmentCode": "10",
  "purchaseCompanyCode": "AB",
  "appliedTime": "1630654805",
  "vendorId": "4e0024ac-8c9f-4946-bc77-de6a1e4801e0",
  "receiveAddress": "5楼仓库",
  "expectedTimeArrival": "1630654805",
  "comment": "缺货，申请",
  "details": [
    {
      "skuCode": "11Pro",
      "skuType": 1,
      "assetTemplateName": "小米11",
      "assetTypeCode": "01010102",
      "displayIndex": 1,
      "quantity": 2,
      "amount": 19998,
      "price": 9999,
      "comment": "资产"
    },
    {
      "skuCode": "0001",
      "skuType": 2,
      "assetTemplateName": "铝塑板",
      "displayIndex": 2,
      "quantity": 10,
      "amount": 200,
      "price": 20,
      "comment": "耗材"
    }
  ],
  "status": 2
}

参数说明

参数	是否必须	说明
serialNo	是	申请单号
companyCode	是	申请公司编码
appliedDepartmentCode	否	申请部门编码
purchaseCompanyCode	是	采购公司编码
appliedTime	是	申请时间（时间戳格式）
vendorId	否	供应商id
receiveAddress	否	收货信息
expectedTimeArrival	否	期望到货日期（时间戳格式）
comment	是	申请说明
status	是	该字段传1为保存单据（草稿状态的申请单）、传2为保存并提交单据（已提交的申请单）
details	是	要申请的物品详情（可以在设置-通用设置中调整为“允许申请不指定具体物品”，设置完成后可以不上传物品的信息）

提交申请单时status字段传2

物品详情

参数	是否必须	说明
skuCode	是	物品编码
skuType	是	物品类型（1：资产、2:耗材）
assetTemplateName	是	物品名称
assetTypeCode	否	资产分类编码（如果物品类型为资产，则该项必填）
displayIndex	是	显示的行号（物品的序列号）
quantity	是	物品数量
amount	否	物品单价
price	否	物品金额
comment	否	物品备注

返回结果

json

{
    "id":"1ac1ade2-3fe9-4452-85c5-ba555755288e",
    "serialNo":"PAA202109030001"
}

结果说明

属性名称	说明
id	申请单id
serialNo	申请单号

4. 删除申请单

请求地址

text

POST /Purchase/Application/delete

请求示例

json

{
    "serialNo": "PAA202109030004"
}

参数说明

参数	是否必须	说明
serialNo	是	申请单号

返回结果

json

{}

对于成功删除的请求，该接口仅返回HTTP 200 OK

5. 关闭申请单

请求地址

text

POST /Purchase/Application/status/put

请求示例

json

{
    "serialNo": "PAA202109030004"
}

参数说明

参数	是否必须	说明
serialNo	是	申请单号

返回结果

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={值，值，值} 属性的值需包含在指定的集合中，如：IdIn=1,2,3

Between

{属性名称}Between={值，值} 属性的值需处于指定的区间之间，仅支持数字，如： IdBetween=1,3

字符串包含指定字符

{属性名称}Contains={值} 如：nameContains=abc

字符串以指定字符开头

{属性名称}StartsWith={值} 如：nameStartsWith=abc

字符串以指定字符结尾

{属性名称}EndsWith={值} 如：nameEndsWith=abc

2. 数据实体格式

1. 采购申请单数据对象格式

属性名称	说明
id	采购申请单id
serialNo	采购申请单号
companyId	申请公司id
companyCode	申请公司编码
companyName	申请公司名称
appliedBy	申请人Id
appliedUserName	申请人名称
appliedTime	申请时间（时间戳格式）
appliedDepartment	申请部门Id
appliedDepartmentCode	申请部门编码
appliedDepartmentName	申请部门名称
appliedEmployId	申请人关联的员工的id
appliedEmployName	申请人关联的员工的名称
appliedType	申请单类型（1：管理员端发起的申请、2:员工端发起的申请）
purchaseCompanyId	采购公司Id
purchaseCompanyCode	采购公司编码
purchaseCompanyName	采购公司名称
receiveAddress	收货信息
vendorId	供应商id
vendorName	供应商名称
expectedTimeArrival	期望到货日期（时间戳格式）
comment	申请说明
status	申请单状态（1：草稿、2:已提交、3:已审批、4:已驳回、5:已完成）
updateTime	更新时间（时间戳格式）
updateBy	更新人
details	采购申请单包含的物品详情集合
attachments	附件信息（请从pc端操作附件）

采购申请单包含的物品详情

属性名称	说明
id	子表id
skuId	物品id（资产或耗材的原id）
skuName	物品名称
skuCode	物品编码
skuUnit	物品计量单位
skuSpecs	物品规格型号
skuType	物品类型（1:资产、2:耗材）
assetTypeCode	资产分类编码
assetTemplateName	资产标准名称
displayIndex	显示的行号（物品的序列号）
quantity	申请数量
price	单价
amount	申请金额
purchasedQuantity	已购买数量
assignedQuantity	已分配数量
receivedQuantity	已收货数量
closedQuantity	关闭数量
status	物品状态（1:草稿、2:已提交、3:已审批、4:已驳回、5:已关闭、6:已完成）
applicationId	关联的申请单Id
comment	物品备注

表单和数据接口

数据接口

通讯录接口

流程接口

资产管理接口

库存管理接口

采购管理接口

成员端接口

百度大脑（AI）插件

e签宝电子签章插件

契约锁电子签章插件

腾讯云电子签章插件

开具电子发票插件

天聚数行插件

钉钉考勤同步插件

企业微信打卡同步插件

自定义邮件通知插件

采购申请接口 ​

1. 获取采购申请单列表 ​

请求地址 ​

参数说明 ​

采购申请单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录 ​

返回结果 ​

2. 新增采购申请单 ​

请求地址 ​

请求示例 ​

参数说明 ​

物品详情 ​

返回结果 ​

结果说明 ​

3. 修改、提交采购申请单 ​

请求地址 ​

请求示例 ​

参数说明 ​

物品详情 ​

返回结果 ​

结果说明 ​

4. 删除申请单 ​

请求地址 ​

请求示例 ​

参数说明 ​

返回结果 ​

5. 关闭申请单 ​

请求地址 ​

请求示例 ​

参数说明 ​

返回结果 ​

附录 ​

1. 支持的查询参数 ​

2. 数据实体格式 ​

1. 采购申请单数据对象格式 ​

采购申请单包含的物品详情 ​

采购申请接口

1. 获取采购申请单列表

请求地址

参数说明

采购申请单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录

返回结果

2. 新增采购申请单

请求地址

请求示例

参数说明

物品详情

返回结果

结果说明

3. 修改、提交采购申请单

请求地址

请求示例

参数说明

物品详情

返回结果

结果说明

4. 删除申请单

请求地址

请求示例

参数说明

返回结果

5. 关闭申请单

请求地址

请求示例

参数说明

返回结果

附录

1. 支持的查询参数

2. 数据实体格式

1. 采购申请单数据对象格式

采购申请单包含的物品详情