diff --git a/mes/原材料分批/修改原材料分批.md b/mes/原材料分批/修改原材料分批.md new file mode 100644 index 0000000..261bd47 --- /dev/null +++ b/mes/原材料分批/修改原材料分批.md @@ -0,0 +1,102 @@ +### 修改原材料分批 +此接口用于仓库发料，ERP发料，支持母批发料修改，此操作为调整母批的原始发料数量以及剩余数量。 +子批修改仅支持批次属性修改 +此接口需要认证，详情请查看《认证方式》。 + +--- + +### 基本信息 +方法：POST +URL: http://localhost:8033/open/updteMaterialBatch + +--- + +### 请求 + +__请求参数__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | String | 是 | 厂区配置profile | +| WorkOrder | String | 是 | 工单号 | +| BatchNumber | String | 是 | 母批号 | +| SubBatchNumber | String | 否 | 子批号,子批发料时必传子批号，否则默认为母批发料 | +| MaterialCode | String | 是 | 物料编码 | +| Uom | String | 是 | 单位 | +| Count | Double | 是 | 发料数量 | +| SupplierBatchNo | String | 否 | 供应商来料批次号 | +| Supplier | String | 否 | 供应商 | +| SecondSupplier | String | 否 | 第二供应商 | +| Remark | String | 否 | 备注 | +| MaterialAttrs | Array | 否 | 批次物料属性 | + + +__MaterialAttrs:__ +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| MaterialTypeCode | String | 否 | 物料类别代码 | +| MaterialTypeDesc | String | 否 | 物料类别名称 | +| AttrCode | String | 否 | 属性代码 | +| AttrName | String | 否 | 属性名称 | +| ValueCode | String | 否 | 属性值代码 | +| Value | String | 否 | 属性值名称 | + +__请求示例：__ +``` + +{ + { + "data":{ + "profile": "测试", + "WorkOrder": "12346", + "BatchNumber": "CELL1000", + "SubBatchNumber": "CELL1000-01", + "MaterialCode": "CELL12", + "Uom": "块", + "Count": 100, + "SupplierBatchNo": "ZL0203001", + "Supplier": "中来", + "SecondSupplier": "中来", + "Remark": "这里是备注", + "MaterialAttrs":[ + { + "MaterialTypeCode": "CELL", + "MaterialTypeDesc": "电池片", + "AttrCode": "GG", + "AttrName": "规格", + "ValueCode": "middle", + "Value": "中号" + } + ] + } + } +} + +```` + +--- + +### 响应 +__响应字段__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| clock | string | 当前服务器时钟。 | +| status | string | 状态，ok：成功，error：错误，exception：异常 | +| data | object | 成功后返回具体内容 | + +__data:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | + +``` +{ + "clock": "2023-06-25 20:00:00.000", + "status": "ok", + "data": { + + } +} + +``` + + diff --git a/mes/原材料分批/删除原材料批次.md b/mes/原材料分批/删除原材料批次.md new file mode 100644 index 0000000..1fc4889 --- /dev/null +++ b/mes/原材料分批/删除原材料批次.md @@ -0,0 +1,66 @@ +### 删除原材料批次 +此接口用于仓库发料，ERP发料，支持母批发料修改，支持母批、子批删除。 +母批删除为扣减指定物料数量，子批删除为删除未使用的子批数据。 +此接口需要认证，详情请查看《认证方式》。 + +--- + +### 基本信息 +方法：POST +URL: http://localhost:8033/open/deleteMaterialBatch + +--- + +### 请求 + +__请求参数__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | String | 是 | 厂区配置profile | +| WorkOrder | String | 是 | 工单号 | +| BatchNumber | String | 是 | 母批号 | +| SubBatchNumber | String | 否 | 子批号,子批发料时必传子批号，否则默认为母批发料 | + +__请求示例：__ +``` + +{ + { + "data":{ + "profile": "测试", + "WorkOrder": "12346", + "BatchNumber": "CELL1000", + "SubBatchNumber": "CELL1000-01" + } + } +} + +```` + +--- + +### 响应 +__响应字段__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| clock | string | 当前服务器时钟。 | +| status | string | 状态，ok：成功，error：错误，exception：异常 | +| data | object | 成功后返回具体内容 | + +__data:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | + +``` +{ + "clock": "2023-06-25 20:00:00.000", + "status": "ok", + "data": { + + } +} + +``` + + diff --git a/mes/原材料分批/原材料批次列表.md b/mes/原材料分批/原材料批次列表.md new file mode 100644 index 0000000..2ba14a9 --- /dev/null +++ b/mes/原材料分批/原材料批次列表.md @@ -0,0 +1,89 @@ +### 原材料批次列表 +此接口用于查询mes中对应的原材料批次信息。 +此接口需要认证，详情请查看《认证方式》。 + +--- + +### 基本信息 +方法：POST +URL: http://localhost:8033/open/materialBatchList + +--- + +### 请求 + +__请求参数__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | String | 是 | 厂区配置profile | +| WorkOrder | String | 否 | 工单号 | +| BatchNumber | String | 否 | 母批号 | +| SubBatchNumber | String | 否 | 子批号 | + +__请求示例：__ +``` + +{ + { + "data":{ + "profile": "测试", + "WorkOrder": "12346", + "BatchNumber": "CELL1000", + "SubBatchNumber": "CELL1000-01" + } + } +} + +```` + +--- + +### 响应 +__响应字段__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| clock | String | 当前服务器时钟。 | +| status | String | 状态，ok：成功，error：错误，exception：异常 | +| data | Array | 成功后返回具体内容 | + +__data:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| key | String | 批次记录主键 | +| workOrder | String | 工单号 | +| batchNumber | String | 母批号 | +| subBatchNumber | String | 子批号 | +| materialCode | String | 物料代码 | +| uom | String | 物料单位 | +| count | Double | 批次物料数量 | + +``` +{ + "clock": "2023-06-25 20:00:00.000", + "status": "ok", + "data": [ + { + "key":"123", + "workOrder":"123456", + "batchNumber":"CELL1000", + "subBatchNumber":"", + "materialCode":"CELL12", + "uom":"块", + "count":1000 + }, + { + "key":"1234", + "workOrder":"123456", + "batchNumber":"CELL1000", + "subBatchNumber":"CELL1000-01", + "materialCode":"CELL12", + "uom":"块", + "count":80 + } + ] +} + +``` + + diff --git a/mes/原材料分批/原材料批次详细信息.md b/mes/原材料分批/原材料批次详细信息.md new file mode 100644 index 0000000..792c3e1 --- /dev/null +++ b/mes/原材料分批/原材料批次详细信息.md @@ -0,0 +1,129 @@ +### 原材料批次详细信息 +此接口用于查询mes中对应的原材料批次的详细信息。 +此接口需要认证，详情请查看《认证方式》。 + +--- + +### 基本信息 +方法：POST +URL: http://localhost:8033/open/materialBatchDetail + +--- + +### 请求 + +__请求参数__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | String | 是 | 厂区配置profile | +| WorkOrder | String | 是 | 工单号 | +| BatchNumber | String | 是 | 母批号 | +| SubBatchNumber | String | 否 | 子批号 | + +__请求示例：__ +``` + +{ + { + "data":{ + "profile": "测试", + "WorkOrder": "12346", + "BatchNumber": "CELL1000", + "SubBatchNumber": "CELL1000-01" + } + } +} + +```` + +--- + +### 响应 +__响应字段__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| clock | String | 当前服务器时钟。 | +| status | String | 状态，ok：成功，error：错误，exception：异常 | +| data | Object | 成功后返回具体内容 | + +__data:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| key | String | 批次记录主键 | +| workOrder | String | 工单号 | +| batchNumber | String | 母批号 | +| subBatchNumber | String | 子批号 | +| materialCode | String | 物料代码 | +| materialName | String | 物料名称 | +| materialTypeCode | String | 物料类别代码 | +| materialTypeDesc | String | 物料类别名称 | +| uom | String | 物料单位 | +| count | Double | 批次物料数量 | +| surplusQty | Double | 剩余数量 | +| supplierBatchNo | String | 供应商来料批次号 | +| supplierCode | String | 供应商代码 | +| supplier | String | 供应商名称 | +| secondSupplierCode | String | 第二供应商代码 | +| secondSupplier | String | 第二供应商名称 | +| createTime | String | 分批时间 | +| remark | String | 备注 | +| materialAttrs | Array | 批次物料属性 | + +__MaterialAttrs:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| materialTypeCode | String | 物料类别代码 | +| materialTypeDesc | String | 物料类别 | +| attrCode | String | 属性代码 | +| attrName | String | 属性名称 | +| valueCode | String | 属性值代码 | +| value | String | 属性值名称 | + +``` +{ + "clock": "2023-06-25 20:00:00.000", + "status": "ok", + "data": { + "key":"", + "workOrder":"123456", + "batchNumber":"CELL1000", + "subBatchNumber":"", + "materialCode":"CELL12", + "materialName": "12号电池片", + "materialTypeCode":"CELL", + "materialTypeDesc":"电池片", + "uom":"块", + "count":1000, + "surplusQty": 534, + "supplierBatchNo": "ZL0902001", + "supplierCode":"ZL", + "supplier": "中来", + "secondSupplierCode": "ZL", + "secondSupplier": "中来", + "createTime": "2021-01-01 09:00:00", + "remark": "这里是备注", + "materialAttrs": [ + { + "materialTypeCode":"CELL", + "materialTypeDesc":"电池片", + "attrCode":"Color", + "attrName":"颜色", + "valueCode":"Blue", + "value":"蓝色" + }, + { + "materialTypeCode":"CELL", + "materialTypeDesc":"电池片", + "attrCode":"Size", + "attrName":"规格", + "valueCode":"144T", + "value":"144T" + } + ] + } +} + +``` + + diff --git a/mes/原材料分批/新增原材料分批.md b/mes/原材料分批/新增原材料分批.md new file mode 100644 index 0000000..6736e2e --- /dev/null +++ b/mes/原材料分批/新增原材料分批.md @@ -0,0 +1,101 @@ +### 新增原材料分批 +此接口用于仓库发料，ERP发料，支持母批发料和子批发料。 +此接口需要认证，详情请查看《认证方式》。 + +--- + +### 基本信息 +方法：POST +URL: http://localhost:8033/open/addMaterialBatch + +--- + +### 请求 + +__请求参数__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | String | 是 | 厂区配置profile | +| WorkOrder | String | 是 | 工单号 | +| BatchNumber | String | 是 | 母批号 | +| SubBatchNumber | String | 否 | 子批号,子批发料时必传子批号，否则默认为母批发料 | +| MaterialCode | String | 是 | 物料编码 | +| Uom | String | 是 | 单位 | +| Count | Double | 是 | 发料数量 | +| SupplierBatchNo | String | 否 | 供应商来料批次号 | +| Supplier | String | 否 | 供应商 | +| SecondSupplier | String | 否 | 第二供应商 | +| Remark | String | 否 | 备注 | +| MaterialAttrs | Array | 否 | 批次物料属性 | + + +__MaterialAttrs:__ +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| MaterialTypeCode | String | 否 | 物料类别代码 | +| MaterialTypeDesc | String | 否 | 物料类别名称 | +| AttrCode | String | 否 | 属性代码 | +| AttrName | String | 否 | 属性名称 | +| ValueCode | String | 否 | 属性值代码 | +| Value | String | 否 | 属性值名称 | + +__请求示例：__ +``` + +{ + { + "data":{ + "profile": "测试", + "WorkOrder": "12346", + "BatchNumber": "CELL1000", + "SubBatchNumber": "CELL1000-01", + "MaterialCode": "CELL12", + "Uom": "块", + "Count": 100, + "SupplierBatchNo": "ZL0203001", + "Supplier": "中来", + "SecondSupplier": "中来", + "Remark": "这里是备注", + "MaterialAttrs":[ + { + "MaterialTypeCode": "CELL", + "MaterialTypeDesc": "电池片", + "AttrCode": "GG", + "AttrName": "规格", + "ValueCode": "middle", + "Value": "中号" + } + ] + } + } +} + +```` + +--- + +### 响应 +__响应字段__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| clock | string | 当前服务器时钟。 | +| status | string | 状态，ok：成功，error：错误，exception：异常 | +| data | object | 成功后返回具体内容 | + +__data:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | + +``` +{ + "clock": "2023-06-25 20:00:00.000", + "status": "ok", + "data": { + + } +} + +``` + +