订单变更接口
1. 获取订单变更单列表
请求地址
text
GET /Purchase/OrderChange参数说明
订单变更单查询接口支持丰富的条件过滤参数，请参见支持的查询参数附录
返回结果
json
{
"offset": 0,
"total": 13,
"results": [
{
"id": "6f7de7bf-c767-4416-a56e-17582030eb87",
"serialNo": "POC202109060001",
"orderSerialNo": "PAO202109030002",
"purchasePlatform": 0,
"companyId": 53291,
"companyCode": "AB",
"companyName": "易点易动",
"orderCompanyId": 53291,
"orderCompanyCode": "AB",
"orderCompanyName": "易点易动",
"changedBy": 53763,
"changedUserName": "霍龙",
"orderBy": 53763,
"orderUserName": "霍龙",
"orderTime": "1630661317",
"changedTime": "1630919274",
"vendorId": "4e0024ac-8c9f-4946-bc77-de6a1e4801e0",
"vendorName": "苏宁易购",
"comment": "变更下",
"orderComment": "下的订单啊",
"status": 1,
"paidAmount": 0.0000,
"details": [
{
"id": "5aa7b850-a7d4-4ccc-b81b-54e80059a5e4",
"orderDetailId": "a8a9fb58-e277-4bbc-833f-2738a6f0d73a",
"changeId": "6f7de7bf-c767-4416-a56e-17582030eb87",
"skuId": 39596,
"skuCode": "11Pro",
"skuName": "小米11",
"specs": "11Pro",
"measureUnit": "台",
"skuType": 1,
"assetTypeCode": "01010102",
"assetTemplateName": "小米11",
"displayIndex": 1,
"quantity": 1.00,
"oldQuantity": 1.00,
"changedQuantity": 2.00,
"amount": 9999.0000,
"oldAmount": 9999.0000,
"changedAmount": 20000.0000,
"changedPrice": 10000.00,
"closedQuantity": 0,
"closedAmount": 0,
"taxRate": 0,
"noTaxAmount": 0,
"price": 9999.00,
"arrivalQuantity": 0.00,
"arrivalAmount": 0.000000000000,
"status": 1
},
{
"id": "eb99612f-9554-4302-b6f2-411f01a75707",
"orderDetailId": "56c58cda-e599-45a0-90ca-edaae7c9dcd1",
"changeId": "6f7de7bf-c767-4416-a56e-17582030eb87",
"skuId": 96533,
"skuCode": "0001",
"skuName": "铝塑板",
"specs": "Y43",
"measureUnit": "张",
"skuType": 2,
"assetTypeCode": "",
"assetTemplateName": "",
"displayIndex": 2,
"quantity": 3.00,
"oldQuantity": 3.00,
"changedQuantity": 2.00,
"amount": 60.0000,
"oldAmount": 60.0000,
"changedAmount": 40.0000,
"changedPrice": 20.00,
"closedQuantity": 0,
"closedAmount": 0,
"taxRate": 0,
"noTaxAmount": 0,
"price": 20.00,
"arrivalQuantity": 0.00,
"arrivalAmount": 0.000000000000,
"status": 1
}
],
"attachments": []
}
],
"meta": {}
}| 参数 | 说明 |
|---|---|
| offset | 当前结果对于首条结果的偏移量，指定分页查询时不为0 |
| total | 所有符合查询条件的查询结果数量，指定需要结果记录数量时不为0 |
| results | 符合查询条件的订单变更单详情集合 |
| meta | 其他信息 |
2. 新增订单变更单
请求地址
text
POST /Purchase/OrderChange请求示例
json
{
"companyCode": "AB",
"orderSerialNo": "PAO202109030002",
"comment": "变更下",
"details": [
{
"orderDetailId": "a8a9fb58-e277-4bbc-833f-2738a6f0d73a",
"skuId": 39596,
"skuType": 1,
"DisplayIndex": 1,
"ChangedQuantity": 2,
"OldQuantity": 1,
"ChangedAmount": 20000,
"OldAmount": 9999,
"Status": 1
},
{
"orderDetailId": "56c58cda-e599-45a0-90ca-edaae7c9dcd1",
"skuId": 96533,
"skuType": 2,
"DisplayIndex": 2,
"ChangedQuantity": 2,
"OldQuantity": 3,
"ChangedAmount": 40,
"OldAmount": 60,
"Status": 1
}
],
"status": 1,
"changedTime": "1630919274"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| companyCode | 是 | 采购公司编码 |
| orderSerialNo | 是 | 采购订单号 |
| comment | 否 | 变更说明 |
| changedTime | 是 | 变更日期（时间戳格式） |
| status | 是 | 该字段传1为保存单据（草稿状态的变更单）、传2为保存并提交单据（已提交的变更单） |
| details | 是 | 要变更的物品详情 |
物品详情
| 参数 | 是否必须 | 说明 |
|---|---|---|
| orderDetailId | 是 | 采购订单子表id |
| skuId | 是 | 物品id（资产或耗材的原id） |
| skuType | 是 | 物品类型（1：资产、2:耗材） |
| displayIndex | 是 | 显示的行号（物品的序列号） |
| ChangedQuantity | 是 | 变更后采购数量 |
| OldQuantity | 是 | 原采购数量 |
| ChangedAmount | 是 | 变更后采购金额 |
| OldAmount | 是 | 原采购金额 |
| Status | 是 | 物品状态（1:草稿、2:已提交、3:已审批、4:已驳回、5:已关闭、6:已完成） |
返回结果
json
{
"id":"6f7de7bf-c767-4416-a56e-17582030eb87",
"serialNo":"POC202109060001"
}结果说明
| 属性名称 | 说明 |
|---|---|
| id | 订单变更单id |
| serialNo | 订单变更单号 |
3. 修改、提交变更单
请求地址
text
POST Purchase/OrderChange/put请求示例
json
{
"companyCode": "AB",
"orderSerialNo": "PAO202109030002",
"comment": "变更下啊1",
"details": [
{
"orderDetailId": "a8a9fb58-e277-4bbc-833f-2738a6f0d73a",
"skuId": 39596,
"skuType": 1,
"DisplayIndex": 1,
"ChangedQuantity": 2,
"OldQuantity": 1,
"ChangedAmount": 20000,
"OldAmount": 9999,
"Status": 1
},
{
"orderDetailId": "56c58cda-e599-45a0-90ca-edaae7c9dcd1",
"skuId": 96533,
"skuType": 2,
"DisplayIndex": 2,
"ChangedQuantity": 2,
"OldQuantity": 3,
"ChangedAmount": 40,
"OldAmount": 60,
"Status": 1
}
],
"status": 1,
"changedTime": "1630919274",
"serialNo": "POC202109060001"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| serialNo | 是 | 变更单号 |
| companyCode | 是 | 采购公司编码 |
| orderSerialNo | 是 | 采购订单号 |
| comment | 否 | 变更说明 |
| changedTime | 是 | 变更日期（时间戳格式） |
| status | 是 | 该字段传1为保存单据（草稿状态的变更单）、传2为保存并提交单据（已提交的变更单） |
| details | 是 | 要变更的物品详情 |
提交订单变更单时status字段传2
物品详情
| 参数 | 是否必须 | 说明 |
|---|---|---|
| orderDetailId | 是 | 采购订单子表id |
| skuId | 是 | 物品id（资产或耗材的原id） |
| skuType | 是 | 物品类型（1：资产、2:耗材） |
| displayIndex | 是 | 显示的行号（物品的序列号） |
| ChangedQuantity | 是 | 变更后采购数量 |
| OldQuantity | 是 | 原采购数量 |
| ChangedAmount | 是 | 变更后采购金额 |
| OldAmount | 是 | 原采购金额 |
| Status | 是 | 物品状态（1:草稿、2:已提交、3:已审批、4:已驳回、5:已关闭、6:已完成） |
返回结果
json
{
"id":"6f7de7bf-c767-4416-a56e-17582030eb87",
"serialNo":"POC202109060001"
}结果说明
| 属性名称 | 说明 |
|---|---|
| id | 订单变更单id |
| serialNo | 订单变更单号 |
4. 删除订单变更单
请求地址
text
POST /Purchase/OrderChange/delete请求示例
json
{
"serialNo": "POC202109090001"
}参数说明
| 参数 | 是否必须 | 说明 |
|---|---|---|
| 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
{属性名称}In={值，值，值} 属性的值需包含在指定的集合中，如：IdIn=1,2,3
Between
{属性名称}Between={值，值} 属性的值需处于指定的区间之间，仅支持数字，如： IdBetween=1,3
字符串包含指定字符
{属性名称}Contains={值} 如：nameContains=abc
字符串以指定字符开头
{属性名称}StartsWith={值} 如：nameStartsWith=abc
字符串以指定字符结尾
{属性名称}EndsWith={值} 如：nameEndsWith=abc
2. 数据实体格式
1. 订单变更单数据对象格式
| 属性名称 | 说明 |
|---|---|
| id | 订单变更单id |
| serialNo | 订单变更单号 |
| orderSerialNo | 采购订单号 |
| purchasePlatform | 采购平台（暂时无用） |
| companyId | 采购公司id |
| companyCode | 采购公司编码 |
| companyName | 采购公司名称 |
| orderCompanyId | 采购订单中采购公司id |
| orderCompanyCode | 采购订单中采购公司编码 |
| orderCompanyName | 采购订单中采购公司名称 |
| changedBy | 变更后的采购员Id |
| changedUserName | 变更后的采购员名称 |
| orderBy | 采购订单中的采购员Id |
| orderUserName | 采购订单中的采购员名称 |
| orderTime | 采购订单中的采购时间（时间戳格式） |
| changedTime | 变更后的采购时间（时间戳格式） |
| vendorId | 供应商id |
| vendorName | 供应商名称 |
| comment | 变更单的变更说明 |
| orderComment | 采购订单说明 |
| status | 订单状态（1：草稿、2:已提交、3:已审批、4:已驳回、5:已完成） |
| paidAmount | 已支付金额 |
| details | 订单变更单包含的物品详情集合 |
| attachments | 附件信息（请从pc端操作附件） |
订单变更单包含的物品详情
| 属性名称 | 说明 |
|---|---|
| id | 子表id |
| orderDetailId | 关联的采购订单的子表Id |
| changeId | 订单变更单id |
| skuId | 物品id（资产或耗材的原id） |
| skuName | 物品名称 |
| skuCode | 物品编码 |
| measureUnit | 物品计量单位 |
| specs | 物品规格型号 |
| skuType | 物品类型（1:资产、2:耗材） |
| assetTypeCode | 资产分类编码 |
| assetTemplateName | 资产标准名称 |
| displayIndex | 显示的行号（物品的序列号） |
| quantity | 原采购数量 |
| oldQuantity | 原采购数量 |
| changedQuantity | 变更后采购数量 |
| amount | 原采购金额 |
| oldAmount | 原采购金额 |
| changedAmount | 变更后的采购金额 |
| changedPrice | 变更后的采购单价 |
| closedQuantity | 已关闭数量 |
| closedAmount | 已关闭金额 |
| taxRate | 税率 |
| noTaxAmount | 不含税金额 |
| price | 原采购单价 |
| arrivalQuantity | 到货数量 |
| arrivalAmount | 到货金额 |
| status | 物品状态（1:草稿、2:已提交、3:已审批、4:已驳回、5:已关闭、6:已完成） |