diff --git a/mes/工单/更新工单状态.md b/mes/工单/更新工单状态.md new file mode 100644 index 0000000..1f8c867 --- /dev/null +++ b/mes/工单/更新工单状态.md @@ -0,0 +1,96 @@ +### 修改工单 + +此接口可修改工单的状态("O"(字母O):开启;"C":关闭)。 + +--- + +### 基本信息 + +方法:POST + +URL:http://localhost:8033/open/UpdateWorkStatus + +认证:需要 + +--- + +### 请求 + +请求参数 + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | string | 是 | 厂区。 | +| code | string | 是 | 工单号。 | +| wo_status | string | 否 | 工单状态("O"(字母O):开启;"C":关闭) | + +请求示例 + +``` +{ + "data": { + "profile": "测试", + "code": "NewWorkorder001", + "wo_status": "C" + } +} +``` + +--- + +### 响应 + +响应字段 + +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| workorder | object | 工单。 | +| - code | string | 工单号。 | +| - areaCode | string | 车间编号。 | +| - areaDesc | string | 车间描述。 | +| - typeCode | string | 工单类型。 | +| - typeDesc | string | 工单类型。 | +| - orderCode | string | 订单号。 | +| - orderTypeCode | string | 订单类型。 | +| - orderTypeDesc | string | 订单类型。 | +| - customer | string | 客户。 | +| - oemCustomer | string | OEM 客户。 | +| - productCode | string | 产品编码。 | +| - productGrade | string | 产品等级。 | +| - planNum | int | 计划数量。 | +| - warnNum | int | 预警数量。 | +| - targetNum | int | 工单交付数量。 | +| - beginTime | string | 工单开始时间。 | +| - endTime | string | 工单结束时间 | +| - createTime | string | 工单创建时间。 | + +成功时的响应示例: + +``` +{ + "clock": "2023-01-01 20:00:00.000", + "status": "ok", + "data": { + "workorder": { + "code": "NewWorkorder001", + "areaCode": "1", + "areaDesc": null, + "typeCode": "301", + "typeDesc": "正常工单", + "orderCode": "NewOrder001", + "orderTypeCode": "General", + "orderTypeDesc": "常规订单", + "customer": "客户", + "oemCustomer": "OEM 客户", + "productCode": "1000", + "productGrade": "600", + "planNum": 5200, + "warnNum": 4800, + "targetNum": 5000, + "beginTime": "2008-08-08 20:00:00", + "endTime": "2008-08-24 20:00:00", + "createTime": "2023-01-01 20:00:00" + } + } +} +``` diff --git a/mes/物料/添加物料.md b/mes/物料/添加物料.md index 352e621..e1fc916 100644 --- a/mes/物料/添加物料.md +++ b/mes/物料/添加物料.md @@ -21,7 +21,8 @@ URL: http://localhost:8033/open/AddMaterial | profile | string | 是 | 厂区代码 | | materialCode | string | 是 | 物料编码 | | materialTypeCode | string | 是 | 物料类别代码 | -| descriptions | string | 否 | 物料描述 | +| materialName | string | 否 | 物料名称 | +| descriptions | string | 是 | 物料描述 | | spec | string | 否 | 规格 | | model | string | 否 | 型号 | | erpTypeCode | string | 否 | ERP物料类型 | @@ -58,6 +59,7 @@ attrs字段 "profile": "测试", "materialCode": "CELL002", "materialTypeCode": "CELL", + "materialName": "电池片", "descriptions": "电池片描述", "spec","4*100", "model","s700", @@ -111,7 +113,7 @@ attrs字段 "materialCode": "CELL002", "materialTypeCode": "CELL", "materialTypeDesc": "电池片", - "descriptions": "电池片描述", + "descriptions": "电池片-电池片描述", "createTime": "2023-07-05 14:29:40.008", "attrs": [ { diff --git a/mes/质量/列出车间生产不良明细.md b/mes/质量/列出车间生产不良明细.md new file mode 100644 index 0000000..f5e1cbf --- /dev/null +++ b/mes/质量/列出车间生产不良明细.md @@ -0,0 +1,133 @@ +### 列出车间生产不良明细(ListSerialDefects) + +此接口用于获取车间组件不良明细,搜索不良明细 + +--- + +### 基本信息 + +方法:POST + +URL: http://localhost:8033/open/ListSerialDefects + +--- + +### 请求 + +请求参数 + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | string | 是 | 厂区代码 | +| StartTime | string | 是 | 开始时间 | +| EndTime | string | 是 | 结束时间 | +| StationType | array[string] | 否 | 站点类型(QEL(前EL)\CYHJY(层压后检验)\HEL(后EL)\QJ(全检)\QC(品质管控)) | + +示例 1: + +``` +{ + "data": { + "profile": "测试", + "StartTime": "2024-09-30 00:00:00", + "EndTime": "2024-09-31 00:00:00" + } +} +``` + +--- + +### 响应 + +响应字段 + +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| StationType | string | 站点类型 | +| DefectList | Array | 物料属性 | + +DefectList字段 + +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| SerialNbr | string | 组件序列号 | +| WksId | string | 机台号 | +| CreateTime | string | 不良创建时间 | +| DefectGroupDesc | string | 不良大类名称 | +| DefectTypeDesc | string | 不良小类名称 | +| DefectPosition | string | 不良位置 | +| Operator | string | 不良提交人 | +| Workorder | string | 工单号 | +| ProductCode | string | 产品编码 | + +查询成功时,响应如下: + +``` +{ + "clock": "2024-09-30 14:12:33.463", + "status": "ok", + "data": { + "list": [ + { + "StationType": "QEL", + "DefectList": [ + { + "SerialNbr": "20230704001", + "WksId": "QEL001", + "CreateTime": "2024-09-30 05:00:00", + "DefectGroupDesc": "EL不良", + "DefectTypeDesc": "破片", + "DefectPosition": "A-8", + "Operator": "admin", + "Workorder": "20241018001", + "ProductCode": "1001" + } + ] + }, + { + "StationType": "HEL", + "DefectList": [ + { + "SerialNbr": "20230704001", + "WksId": "HEL001", + "CreateTime": "2024-09-30 05:00:00", + "DefectGroupDesc": "EL不良", + "DefectTypeDesc": "隐裂", + "DefectPosition": "C-6", + "Operator": "admin", + "Workorder": "20241018001", + "ProductCode": "1001" + } + ] + }, + { + "StationType": "QJ", + "DefectList": [ + { + "SerialNbr": "20230704001", + "WksId": "QJ001", + "CreateTime": "2024-09-30 05:00:00", + "DefectGroupDesc": "外观不良", + "DefectTypeDesc": "玻璃脏污", + "DefectPosition": "", + "Operator": "admin", + "Workorder": "20241018001", + "ProductCode": "1001" + } + ] + }, + ] + } +} +``` + +查询报错: + +``` +{ + "clock": "2024-09-30 20:00:00.000", + "status": "exception", + "message": "错误信息", + "data": {} +} +``` \ No newline at end of file diff --git a/wms/分布式调入、调出-电池片/分布式调入-电池片.md b/wms/分布式调入、调出-电池片/分布式调入-电池片.md new file mode 100644 index 0000000..534d68b --- /dev/null +++ b/wms/分布式调入、调出-电池片/分布式调入-电池片.md @@ -0,0 +1,268 @@ +### 新增分布式调入-电池片 +此接口用于新增WMS中电池片的分布式调入(接口提供给电池仓库系统) +此接口需要认证,详情请查看《认证方式》。 + +--- + +### 基本信息 +方法:POST +URL: http://localhost:8033/open/SolarNPlusAddDistributedAllocationCellWms + +--- + +### 请求 + +__请求参数__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | String | 是 | 厂区| +| BillInCode | String | 是 | 单据内码| +| AllotType | String | 是 | 调拨类型| +| BillNo | String | 是 | 单据编号| +| ApplyDate | String | 否 | 申请日期| +| ApplyOrg | String | 是 | 申请组织| +| CalloutOwnerType | String | 是 | 调出货主类型| +| CallinOwnerType | String | 是 | 调入货主类型| +| Status | String | 是 | 状态(0 禁用,1 启用)| +| Type | String | 是 | 类型(0 分布式调出,1 分布式调入)| +| Remark | String | 否 | 备注| +| TypeOfGoods | String | 是 | 货品类型(0 原材料,1 产成品)| +| WmsDistributeAllocationDetail | Array | 是 | 分布式调入、调出明细| + +__WmsDistributeAllocationDetail字段__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| LineId | String | 是 | 行内码| +| MaterialCode | String | 是 | 物料编码| +| FinalGrade | String | 否 | 等级| +| Color | String | 否 | 颜色| +| Efficient | String | 否 | 效率| +| PowerGrade | String | 否 | 功率| +| CurrentGrade | String | 否 | 电流| +| UnitId | String | 是 | 主单位| +| AstUnitId | String | 是 | 辅单位| +| ChangeRate | String | 是 | 换算率| +| ApplyNumber | String | 是 | 申请数量| +| BatchNo | String | 是 | 批号| +| SupplierId | String | 是 | 原厂供应商| +| AgentSupplierId | String | 是 | 入库供应商| +| ProductionTime | String | 是 | 生产日期| +| ValidDays | String | 是 | 保质期(单位默认:天)| +| CalloutOrg | String | 是 | 调出组织| +| CalloutStock | String | 是 | 调出仓库| +| CalloutOwnerType | String | 是 | 调出货主类型| +| CalloutOwnerCode | String | 是 | 调出货主| +| CalloutInventoryStatus | String | 是 | 调出库存状态| +| CallinOrg | String | 是 | 调入组织| +| CallinStock | String | 是 | 调入仓库| +| CallinOwnerType | String | 是 | 调入货主类型| +| CallinOwnerCode | String | 是 | 调入货主| +| CallinInventoryStatus | String | 是 | 调入库存状态| +| Remark | String | 是 | 备注| +| RDistributeAllocationPackageNo | Array | 是 | 电池片分布式调入箱号明细| + +__RDistributeAllocationPackageNo字段__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| package_no | String | 是 | 条码箱号| +| material_spec | String | 是 | 规格型号| +| material_code | String | 否 | 物料编码| +| material_name | String | 否 | 物料名称| +| batch_no | String | 否 | 物料批次| +| grade | String | 否 | 等级| +| eff | String | 否 | 效率| +| color | String | 是 | 颜色| +| power | String | 是 | 功率| +| number | double | 是 | 数量| +| ocv | String | 是 | 开压| + + +__请求示例:__ +``` +{ + "data":{ + "profile":"旭合测试100", + "BillInCode":"1", + "AllotType":"1", + "BillNo":"1", + "ApplyDate":"2025-06-26 14:36:00", + "ApplyOrg":"100", + "CalloutOwnerType":"1", + "CallinOwnerType":"1", + "Status":"1", + "Type":"1", + "Remark":"测试", + "TypeOfGoods":"0", + "WmsDistributeAllocationDetail":[ + { + "LineId":"1", + "MaterialCode":"10204001", + "FinalGrade":"A", + "Color":"", + "Efficient":"25.2", + "PowerGrade":"", + "CurrentGrade":"", + "UnitId":"PCS", + "AstUnitId":"PCS", + "ChangeRate":"1/1", + "ApplyNumber":"10000", + "BatchNo":"250626", + "SupplierId":"VEN00200", + "AgentSupplierId":"VEN00200", + "ProductionTime":"2025-09-01", + "ValidDays":"", + "CalloutOrg":"1", + "CalloutStock":"1", + "CalloutOwnerType":"1", + "CalloutOwnerCode":"100", + "CalloutInventoryStatus":"1", + "CallinOrg":"1", + "CallinStock":"1", + "CallinOwnerType":"1", + "CallinOwnerCode":"1", + "CallinInventoryStatus":"1", + "Remark":"", + "RDistributeAllocationPackageNo": [ + { + "package_no": "250626001", + "material_spec": "非SE/PE/LECO/主栅16BB12焊点/正面细栅180/背面细栅210/带鱼叉_130um", + "material_code": "10B04016", + "material_name": "182.2*183.75/256单晶N型TOPCon双面电池片V05", + "batch_no": "250708D-10B04016-Z2507003", + "grade": "A.", + "eff": "24.7%", + "color": "蓝色", + "power": "8.27", + "number": 1000, + "ocv": "H" + }, + { + "package_no": "250626002", + "material_spec": "非SE/PE/LECO/主栅16BB12焊点/正面细栅180/背面细栅210/带鱼叉_130um", + "material_code": "10B04016", + "material_name": "182.2*183.75/256单晶N型TOPCon双面电池片V05", + "batch_no": "250708D-10B04016-Z2507003", + "grade": "A.", + "eff": "24.7%", + "color": "蓝色", + "power": "8.27", + "number": 1000, + "ocv": "H" + } + ] + } + ] + } +} +```` + +--- + +### 响应 +__响应字段__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| clock | string | 当前服务器时钟。 | +| status | string | 状态,ok:成功,error:错误,exception:异常 | +| data | object | 成功后返回具体内容 | + +__data:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | + +``` +{ + "clock": "2025-06-26 15:48:22.176", + "duration": "6.14s", + "status": "ok", + "data": { + "bill_in_code": "1", + "allot_type": "1", + "bill_no": "1", + "apply_date": "2025-06-26 14:36:00", + "apply_org": "100", + "callout_owner_type": "1", + "callin_owner_type": "1", + "status": 1, + "type": "1", + "remark": "测试", + "create_username": "WMS-CELL", + "type_of_goods": "0", + "distributeAllocationDetail": [ + { + "parent_key": "5335395b1b7c49bb9c06f8e1dc42f845", + "line_id": "1", + "material_code": "10204001", + "final_grade": "A", + "color": "", + "efficient": "25.2", + "power_grade": "", + "current_grade": "", + "unit_id": "PCS", + "astunit_id": "PCS", + "change_rate": "1/1", + "apply_number": 10000, + "batch_no": "250626", + "ProductionTime":"2025-09-01", + "valid_days": "", + "callout_org": "1", + "callout_stock": "1", + "callout_owner_type": "1", + "callout_owner_code": "100", + "callout_inventory_status": "1", + "callin_org": "1", + "callin_stock": "1", + "callin_owner_type": "1", + "callin_owner_code": "1", + "callin_inventory_status": "1", + "remark": "", + "supplierId": "VEN00200", + "agentSupplierId": "VEN00200", + "RDistributeAllocationPackageNo": [ + { + "package_no": "250626001", + "material_spec": "非SE/PE/LECO/主栅16BB12焊点/正面细栅180/背面细栅210/带鱼叉_130um", + "material_code": "10B04016", + "material_name": "182.2*183.75/256单晶N型TOPCon双面电池片V05", + "batch_no": "250708D-10B04016-Z2507003", + "grade": "A.", + "eff": "24.7%", + "color": "蓝色", + "power": "8.27", + "number": 1000, + "ocv": "H" + }, + { + "package_no": "250626002", + "material_spec": "非SE/PE/LECO/主栅16BB12焊点/正面细栅180/背面细栅210/带鱼叉_130um", + "material_code": "10B04016", + "material_name": "182.2*183.75/256单晶N型TOPCon双面电池片V05", + "batch_no": "250708D-10B04016-Z2507003", + "grade": "A.", + "eff": "24.7%", + "color": "蓝色", + "power": "8.27", + "number": 1000, + "ocv": "H" + } + ], + "created": 1750952900428, + "updated": 1750952900428, + "profile": "旭合测试100", + "key": "02e30e3730ad41efae4b1f466b306939", + "flag": 1 + } + ], + "created": 1750952900405, + "updated": 1750952900405, + "profile": "旭合测试100", + "key": "5335395b1b7c49bb9c06f8e1dc42f845", + "flag": 1 + } +} +``` + + diff --git a/wms/分布式调入、调出/分布式调入、调出-产成品.md b/wms/分布式调入、调出/分布式调入、调出-产成品.md index c6892e4..43b4d90 100644 --- a/wms/分布式调入、调出/分布式调入、调出-产成品.md +++ b/wms/分布式调入、调出/分布式调入、调出-产成品.md @@ -27,6 +27,7 @@ __请求参数__ | Status | String | 是 | 状态(0 禁用,1 启用)| | Type | String | 是 | 类型(0 分布式调出,1 分布式调入)| | Remark | String | 否 | 备注| +| TypeOfGoods | String | 是 | 货品类型(0 原材料,1 产成品)| | WmsDistributeAllocationDetail | Array | 是 | 分布式调入、调出明细| __WmsDistributeAllocationDetail字段__ @@ -76,6 +77,7 @@ __请求示例:__ "Status":"", "Type":"", "Remark":"", + "TypeOfGoods":"1", "WmsDistributeAllocationDetail":[ { "LineId":"", diff --git a/wms/分布式调入、调出/分布式调入、调出-原材料.md b/wms/分布式调入、调出/分布式调入、调出-原材料.md index fe7af8c..64f3af9 100644 --- a/wms/分布式调入、调出/分布式调入、调出-原材料.md +++ b/wms/分布式调入、调出/分布式调入、调出-原材料.md @@ -27,6 +27,7 @@ __请求参数__ | Status | String | 是 | 状态(0 禁用,1 启用)| | Type | String | 是 | 类型(0 分布式调出,1 分布式调入)| | Remark | String | 否 | 备注| +| TypeOfGoods | String | 是 | 货品类型(0 原材料,1 产成品)| | WmsDistributeAllocationDetail | Array | 是 | 分布式调入、调出明细| __WmsDistributeAllocationDetail字段__ @@ -76,6 +77,7 @@ __请求示例:__ "Status":"", "Type":"", "Remark":"", + "TypeOfGoods":"0", "WmsDistributeAllocationDetail":[ { "LineId":"", diff --git a/wms/原材料销售发货通知/AddMaterialDeliveryPlan.md b/wms/原材料销售发货通知/AddMaterialDeliveryPlan.md new file mode 100644 index 0000000..0a85f6c --- /dev/null +++ b/wms/原材料销售发货通知/AddMaterialDeliveryPlan.md @@ -0,0 +1,118 @@ +### AddMaterialDeliveryPlan + +此接口用于添加发货计划(材料销售发货通知单)。 + +--- + +### 基本信息 + +方法:POST + +URL: http://localhost:8033/open/AddMaterialDeliveryPlan + +--- + +### 请求 + +__请求参数__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | string | 是 | 厂区代码 | +| SaleNo | string | 是 | 发货通知单 | +| BusinessType | long | 是 | 业务类型 1发货 2退货 | +| MaterialSaleTime | string | 是 | 计划发货日期 | +| MaterialDeliveryDetail | Array | 是 | 发货批次 | + +__batches__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| LineId | string | 是 | 唯一行号(通知单明细批次号) | +| MaterialCode | string | 是 | 物料代码 | +| discripTionOfGoods | string | 否 | 物料名称 | +| Number | double | 是 | 申请发货数量 | +| CustomerCode | string | 是 | 客户代码 | +| isGift | int | 否 | 是否正品 1是 2否 | +| CellGrade | string | 否 | 等级(辅助属性) | +| CellColor | string | 否 | 颜色(辅助属性) | +| CellEff | string | 否 | 效率(辅助属性) | +| CellUop | string | 否 | 功率(辅助属性) | +| CurrentGrade | string | 否 | 电流(辅助属性) | +| ERPSaleOrder | string | 否 | erp材料销售出库单号(用于销售退库是传递) | + +__请求示例__ + +``` +{ + "data": { + "profile": "测试", + "SaleNo": "FHTZD001428", + "BusinessType": "1", + "MaterialSaleTime": "2024-09-30 10:00:00", + "batches": [ + { + "LineId": "103347", + "MaterialCode": "10404004", + "BillNo": "XSDD000873", + "discripTionOfGoods": "182.2*183.75单晶N型TOPCon双面电池片", + "CustomerCode": "CUST0354", + "Number": 8300.0, + "CellGrade": "A", + "CellColor":"", + "CellEff": "24.7%", + "CellUop": "", + "CurrentGrade": "", + "ERPSaleOrder": "" + }, + { + "LineId": "103348", + "MaterialCode": "10404004", + "BillNo": "XSDD000873", + "discripTionOfGoods": "182.2*183.75单晶N型TOPCon双面电池片", + "CustomerCode": "CUST0354", + "number": 168644.0, + "CellGrade": "A", + "CellColor":"", + "CellEff": "24.8%", + "CellUop": "", + "CurrentGrade":"", + "ERPSaleOrder": "" + } + ] + } +} + +``` + +--- + +### 响应 +__响应字段__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| clock | string | 当前服务器时钟。 | +| status | string | 状态,ok:成功,error:错误,exception:异常 | +| data | object | 成功后返回具体内容 | + +__data:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | + +``` +{ + "clock": "2024-09-26 13:53:17.804", + "duration": "7.75s", + "status": "ok", + "data": {} +} + +{ + "clock": "2024-09-26 13:50:28.317", + "duration": "15.4s", + "status": "error", + "message": "该原材料销售发货通知单号已经存在", + "data": {} +} + + diff --git a/wms/原材料销售发货通知/UpdateMaterialDeliveryPlan.md b/wms/原材料销售发货通知/UpdateMaterialDeliveryPlan.md new file mode 100644 index 0000000..bf97895 --- /dev/null +++ b/wms/原材料销售发货通知/UpdateMaterialDeliveryPlan.md @@ -0,0 +1,118 @@ +### AddMaterialDeliveryPlan + +此接口用于更新发货计划(材料销售发货通知单)。 + +--- + +### 基本信息 + +方法:POST + +URL: http://localhost:8033/open/UpdateMaterialDeliveryPlan + +--- + +### 请求 + +__请求参数__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | string | 是 | 厂区代码 | +| SaleNo | string | 是 | 发货通知单 | +| BusinessType | long | 是 | 业务类型 1发货 2退货 | +| MaterialSaleTime | string | 是 | 计划发货日期 | +| MaterialDeliveryDetail | Array | 是 | 发货批次 | + +__batches__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| LineId | string | 是 | 唯一行号(通知单明细批次号) | +| MaterialCode | string | 是 | 物料代码 | +| discripTionOfGoods | string | 否 | 物料名称 | +| Number | double | 是 | 申请发货数量 | +| CustomerCode | string | 是 | 客户代码 | +| isGift | int | 否 | 是否正品 1是 2否 | +| CellGrade | string | 否 | 等级(辅助属性) | +| CellColor | string | 否 | 颜色(辅助属性) | +| CellEff | string | 否 | 效率(辅助属性) | +| CellUop | string | 否 | 功率(辅助属性) | +| CurrentGrade | string | 否 | 电流(辅助属性) | +| ERPSaleOrder | string | 否 | erp材料销售出库单号(用于销售退库是传递) | + +__请求示例__ + +``` +{ + "data": { + "profile": "测试", + "SaleNo": "FHTZD001428", + "BusinessType": "1", + "MaterialSaleTime": "2024-09-30 10:00:00", + "batches": [ + { + "LineId": "103347", + "MaterialCode": "10404004", + "BillNo": "XSDD000873", + "discripTionOfGoods": "182.2*183.75单晶N型TOPCon双面电池片", + "CustomerCode": "CUST0354", + "Number": 8300.0, + "CellGrade": "A", + "CellColor":"", + "CellEff": "24.7%", + "CellUop": "", + "CurrentGrade": "", + "ERPSaleOrder": "" + }, + { + "LineId": "103348", + "MaterialCode": "10404004", + "BillNo": "XSDD000873", + "discripTionOfGoods": "182.2*183.75单晶N型TOPCon双面电池片", + "CustomerCode": "CUST0354", + "number": 168644.0, + "CellGrade": "A", + "CellColor":"", + "CellEff": "24.8%", + "CellUop": "", + "CurrentGrade": "", + "ERPSaleOrder": "" + } + ] + } +} + +``` + +--- + +### 响应 +__响应字段__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| clock | string | 当前服务器时钟。 | +| status | string | 状态,ok:成功,error:错误,exception:异常 | +| data | object | 成功后返回具体内容 | + +__data:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | + +``` +{ + "clock": "2024-09-26 13:53:17.804", + "duration": "7.75s", + "status": "ok", + "data": {} +} + +{ + "clock": "2024-09-26 13:50:28.317", + "duration": "15.4s", + "status": "error", + "message": "该原材料销售发货通知单号不存在", + "data": {} +} + + diff --git a/wms/发货通知/AddDeliveryPlan.md b/wms/发货通知/AddDeliveryPlan.md index c7ef3eb..ba66c61 100644 --- a/wms/发货通知/AddDeliveryPlan.md +++ b/wms/发货通知/AddDeliveryPlan.md @@ -36,6 +36,7 @@ __请求参数__ | contractNo | string | 否 | 销售合同号 | | batches | Array | 否 | 发货批次 | | ERP_Status | int | 否 | 发货状态(0:创建;1:可发货) | +| ERP_ShipTo | string | 否 | 发货客户地址 | __batches__ @@ -59,6 +60,7 @@ __batches__ | deliveryTime | string | 否 | 预计发货时间/退货时间 | | saleMan | string | 否 | 业务员 | | pallets | Array | 否 | 托盘号数组 ["123","1234","123456"] | +| ERP_ShipTo | string | 否 | 发货客户地址 | __请求示例__ @@ -81,6 +83,7 @@ __请求示例__ "goodsCode":"", "goodsDesc":"", "contractNo":"", + "ERP_ShipTo":"", "batches":[ { "batchNo":"B0123123123ds", @@ -104,7 +107,8 @@ __请求示例__ "123", "12345", "123456" - ] + ], + "ERP_ShipTo":"" } ] } diff --git a/wms/发货通知/UpdateDeliveryPlan.md b/wms/发货通知/UpdateDeliveryPlan.md new file mode 100644 index 0000000..3927eac --- /dev/null +++ b/wms/发货通知/UpdateDeliveryPlan.md @@ -0,0 +1,142 @@ +### AddDeliveryPlan + +此接口用于更新发货计划(发货通知单)。 + +--- + +### 基本信息 + +方法:POST + +URL: http://localhost:8033/open/UpdateDeliveryPlan + +--- + +### 请求 + +__请求参数__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | string | 是 | 厂区代码 | +| ordNo | string | 是 | 计划单号(通知单号) | +| businessType | long | 是 | 业务类型 1发货 2退货 | +| power | decimal | 否 | 功率(默认批次第一行功率挡) | +| currentGrade | string | 否 | 电流挡 (默认批次第一行功率挡)| +| finalGrade | string | 否 | 最终等级 (默认批次第一行最终等级)| +| color | string | 否 | 颜色(默认批次第一行颜色) | +| customerCode | string | 否 | 客户代码 | +| customer | string | 否 | 客户 | +| number | long | 否 | 发货数量(批次发货数量总和) | +| deliveryType | int | 否 | 发货类型 1国内 2国外 | +| deliveryTime | string | 否 | 发货时间 yyyy-MM-dd HH:mm:ss | +| onlyNumber | string | 否 | 唯一码 | +| goodsCode | string | 否 | 货物编码 (默认批次第一行物料代码)| +| goodsDesc | string | 否 | 货物描述(默认批次第一行物料对应描述) | +| contractNo | string | 否 | 销售合同号 | +| batches | Array | 否 | 发货批次 | +| ERP_Status | int | 否 | 发货状态(0:创建;1:可发货) | +| ERP_ShipTo | string | 否 | 发货客户地址 | + +__batches__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| batchNo | string | 是 | 批次号(唯一序号) | +| materialCode | string | 是 | 物料代码 | +| deliveryNeed | string | 否 | 发货需求 | +| customerCode | string | 否 | 客户代码(未填使用表单中客户代码) | +| customer | string | 否 | 客户(未填使用表单中客户) | +| contractNo | string | 否 | 销售合同号(未填使用表单中销售合同号) | +| billNo | string | 否 | 销售订单号 | +| goodDesc | string | 否 | 货物名称 | +| power | decimal | 否 | 功率 | +| currentGrade | string | 否 | 电流挡 | +| finalGrade | string | 否 | 最终等级 | +| color | string | 否 | 颜色 | +| number | long | 否 | 申请发货组件数量 | +| isGift | int | 否 | 是否正品 1是 2否 | +| htlx | string | 否 | 合同类型 | +| deliveryTime | string | 否 | 预计发货时间/退货时间 | +| saleMan | string | 否 | 业务员 | +| pallets | Array | 否 | 托盘号数组 ["123","1234","123456"] | +| ERP_ShipTo | string | 否 | 发货客户地址 | + +__请求示例__ + +``` +{ + "data":{ + "profile":"测试", + "ordNo":"", + "businessType":1, + "power":550, + "currentGrade":"", + "finalGrade":"A", + "color":"B", + "customerCode":"C001", + "customer":"政府", + "number":10000000, + "deliveryType":1, + "deliveryTime":"2023-01-01 09:00:00", + "onlyNumber":"FHZF00000211213", + "goodsCode":"", + "goodsDesc":"", + "contractNo":"", + "ERP_ShipTo":"", + "batches":[ + { + "batchNo":"B0123123123ds", + "materialCode":"Module0001", + "deliveryNeed":"", + "customerCode":"", + "customer":"", + "contractNo":"", + "billNo":"", + "goodDesc":"", + "power":550, + "currentGrade":"", + "finalGrade":"A", + "color":"B", + "number":10000, + "isGift":0, + "htlx":"", + "deliveryTime":"2023-01-01 09:00:00", + "saleMan":"", + "pallets":[ + "123", + "12345", + "123456" + ], + "ERP_ShipTo":"" + } + ] + } +} + +``` + +--- + +### 响应 +__响应字段__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| clock | string | 当前服务器时钟。 | +| status | string | 状态,ok:成功,error:错误,exception:异常 | +| data | object | 成功后返回具体内容 | + +__data:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | + +``` +{ + "clock": "2023-06-25 20:00:00.000", + "status": "ok", + "data": { + + } +} + + diff --git a/wms/委外用料清单/新增采购订单.md b/wms/委外用料清单/新增采购订单.md new file mode 100644 index 0000000..9f4cb09 --- /dev/null +++ b/wms/委外用料清单/新增采购订单.md @@ -0,0 +1,166 @@ +### WMS增加委外用料清单 +此接口用于新增WMS中的委外用料清单(委托代工) +此接口需要认证,详情请查看《认证方式》。 + +--- + +### 基本信息 +方法:POST +URL: http://localhost:8033/open/AddListOfOutsourcedMaterials + +--- + +### 请求 + +__请求参数__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | string | 是 | 厂区 | +| BillNo | string | 是 | 单据编号 | +| OutsourceOrd | string | 是 | 委外订单编号 | +| OutsourceOrdId | string | 是 | 委外订单行号 | +| OutsourceInCode | string | 是 | 委外订单内码 | +| OutsourceLineInCode | string | 是 | 委外订单行内码 | +| OutsourceOrdType | string | 是 | 委外订单类型 | +| OutsourceMaterialInCode | string | 是 | 委外用料清单内码 | +| ProductCode | string | 是 | 产品编码 | +| Status | string | 是 | 状态(0 禁用,1 启用) | +| Number | string | 是 | 数量 | +| UnitId | string | 是 | 主单位 | +| AstUnitId | string | 是 | 辅单位 | +| ChangeRate | string | 是 | 换算率 | +| Remark | string | 否 | 备注 | +| OutsourcePoOrd | string | 否 | 委外采购订单单号 | +| OutsourcePoOrdId | string | 否 | 委外采购订单行号 | +| OutsourcedMaterialsDetail | Array | 是 | 委外订单明细 | + +_OutsourcedMaterialsDetail:__ +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| LineId | string | 是 | 委外用料清单行内码 | +| MaterialCode | string | 是 | 物料编码 | +| ShoudIssued | string | 是 | 应发数量 | +| UnitId | string | 是 | 主单位 | +| AstUnitId | string | 是 | 辅单位 | +| ChangeRate | string | 是 | 换算率 | +| OwnerType | string | 否 | 货主类型 | +| OwnerCode | string | 否 | 货主 | +| cellGrade | string | 否 | 辅助属性:等级 | +| cellColor | string | 否 | 辅助属性:颜色 | +| cellEff | string | 否 | 辅助属性:效率 | +| cellUop | string | 否 | 辅助属性:功率 | +| currentGrade | string | 否 | 辅助属性:电流 | + +__请求示例:__ +``` +{ + "data": { + "Profile": "test", + "BillNo": "123456", + "OutsourceOrd": "OutsourceOrd", + "OutsourceOrdId": "OutsourceOrdId", + "OutsourceInCode": "OutsourceInCode", + "OutsourceLineInCode": "OutsourceLineInCode", + "OutsourceOrdType": "OutsourceOrdType", + "OutsourceMaterialInCode": "OutsourceMaterialInCode", + "ProductCode": "ProductCode", + "Status": "1", + "Number": "500", + "UnitId": "UnitId", + "AstUnitId": "AstUnitId", + "ChangeRate": "ChangeRate", + "remark": "remark", + "OutsourcePoOrd": "OutsourcePoOrd", + "OutsourcePoOrdId": "1", + "OutsourcedMaterialsDetail": [ + { + "LineId": "LineId", + "MaterialCode": "MaterialCode", + "ShoudIssued": "123.5625", + "UnitId": "UnitId", + "AstUnitId": "AstUnitId", + "ChangeRate": "ChangeRate", + "OwnerType": "组织", + "OwnerCode": "100", + } + ] + } +} +```` + +--- + +### 响应 +__响应字段__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| clock | string | 当前服务器时钟。 | +| status | string | 状态,ok:成功,error:错误,exception:异常 | +| data | object | 成功后返回具体内容 | + +__data:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | + +``` +{ + "clock": "2024-12-12 13:26:22.860", + "duration": "570ms", + "status": "ok", + "data": { + "bill_no": "123456", + "outsource_ord": "OutsourceOrd", + "outsource_ord_id": "OutsourceOrdId", + "outsourc_in_code": "OutsourceInCode", + "outsource_line_in_code": "OutsourceLineInCode", + "outsource_ord_type": "OutsourceOrdType", + "outsource_material_in_code": "OutsourceMaterialInCode", + "product_code": "ProductCode", + "product_name": null, + "specification": null, + "status": 1, + "number": "500", + "unit_id": "UnitId", + "astunit_id": "AstUnitId", + "change_rate": "ChangeRate", + "remark": "remark", + "create_username": "ERP", + "OutsourcePoOrd": "OutsourcePoOrd", + "OutsourcePoOrdId": "1", + "outsourcedMaterialsDetail": [ + { + "parent_key": "23a9d58dd3e144ccb554270f8141d845", + "line_id": "LineId", + "material_code": "MaterialCode", + "material_name": null, + "specification": null, + "shoud_issued": 123.5625, + "issued_quantity": 0, + "unit_id": "UnitId", + "astunit_id": "AstUnitId", + "change_rate": "ChangeRate", + "owner_type": "组织", + "owner_code": "100", + "materialTypeName": null, + "materialDesc": null, + "unitName": null, + "astUnitName": null, + "created": 1734009982777, + "updated": 1734009982777, + "profile": "test", + "key": "b56520572ad2493a9335247783902cf3", + "flag": 1 + } + ], + "created": 1734009982769, + "updated": 1734009982769, + "profile": "segtest", + "key": "23a9d58dd3e144ccb554270f8141d845", + "flag": 1 + } +} + +``` + + diff --git a/wms/采购订单/更新采购订单.md b/wms/采购订单/更新采购订单.md new file mode 100644 index 0000000..770dcbe --- /dev/null +++ b/wms/采购订单/更新采购订单.md @@ -0,0 +1,115 @@ +### 原料仓、成品仓更新采购订单(到货通知单) +此接口用于更新WMS中的采购订单 +此接口需要认证,详情请查看《认证方式》。 + +--- + +### 基本信息 +方法:POST +URL: http://localhost:8033/open/UpdatePurChaseOrder + +--- + +### 请求 + +__请求参数__ + +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| profile | string | 是 | 厂区 | +| documentNo | string | 是 | 到货单号 | +| documentId | string | 否 | 单据ID | +| type | string | 是 | 单据类型 0:发/退货单 1:发货单 2:退货单 | +| documentDetail | Array | 是 | 单据明细 | + +_documentDetail:__ +| 参数名 | 类型 | 必填 | 说明 | +| :-- | :-- | :-- | :-- | +| lineId | string | 是 | 唯一行号 | +| contractNo | string | 是 | 合同号 | +| purchaseOrderNo | string | 是 | 采购订单号 | +| materialCode | string | 是 | 物料编码 | +| supplierCode | string | 是 | 原始供应商 | +| agencySupplierCode | string | 否 | 入库供应商 | +| planArrivalNumber | string | 是 | 计划到货数量 | +| planArrivalTime | string | 是 | 计划到货时间 | +| unitId | string | 是 | 主单位 | +| astUnitId | string | 是 | 辅单位 | +| changeRate | string | 是 | 换算率 | +| profile | string | 是 | 组织 | +| orderBillType | string | 否 | 采购订单单据类型 | +| orderBusinessType | string | 否 | 采购订单交易类型 | +| contractBillType | string | 否 | 采购合同单据类型 | +| contractBusinessType | string | 否 | 采购合同交易类型 | +| buyerCode | string | 是 | 采购员 | +| buyerDepartmentCode | string | 否 | 采购部门 | +| cellGrade | string | 否 | 辅助属性:等级 | +| cellColor | string | 否 | 辅助属性:颜色 | +| cellEff | string | 否 | 辅助属性:效率 | +| cellUop | string | 否 | 辅助属性:功率 | +| currentGrade | string | 否 | 辅助属性:电流 | +| isGiveAway | int | 否 | 是否赠品 1:是 0 :否 | + +__请求示例:__ +``` +{ + "data":{ + "documentNo":"", + "documentId":"", + "documentDetail": [ + { + "lineId":"", + "contractNo":"", + "purchaseOrderNo":"", + "materialCode":"", + "supplierCode":"", + "agencySupplierCode":"", + "planArrivalNumber":"", + "planArrivalTime":"", + "unitId":"", + "astUnitId":"", + "changeRate":"", + "profile":"", + "orderBillType":"", + "orderBusinessType":"", + "contractBillType":"", + "contractBusinessType":"", + "buyerCode":"", + "buyerDepartmentCode":"", + "cellGrade":"", + "cellColor":"", + "cellEff":"", + "cellUop":"", + "currentGrade":"", + "isGiveAway":0, + }, + ], + } +} +```` + +--- + +### 响应 +__响应字段__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | +| clock | string | 当前服务器时钟。 | +| status | string | 状态,ok:成功,error:错误,exception:异常 | +| data | object | 成功后返回具体内容 | + +__data:__ +| 字段 | 类型 | 说明 | +| :-- | :-- | :-- | + +``` +{ + "clock": "2023-06-25 20:00:00.000", + "status": "ok", + "data": { + } +} + +``` + +