Przeglądaj źródła

【科翔ERPAPI接口】【接口代码说明】

wuyx 3 miesięcy temu
rodzic
commit
32d95bd611

+ 233 - 0
src/main/resources/README/业务代码说明/型号列表查询.md

@@ -0,0 +1,233 @@
+##### 简要描述
+
+- 物料资料查询
+  1.根据传过来的数据查询物型号资料信息
+
+##### 请求URL
+
+内网调用地址: `http地址/ERPAPI/api/queryList`
+
+##### 请求方式
+- POST
+##### Header
+
+|参数|参数值|
+|:-|:----- |
+| AccessKey|N_KX_JXKX|
+| Timestamp|1702953290104|
+| RequestId|741fef41-ffc5-445f-b427-d79278954b7c|
+
+##### 请求包体
+
+```json
+{
+    "code": "QUERYGOODSLIST",
+    "data": {
+		"startRow": "1",
+		"limit": "20",
+		"filterString": "pr_code = 'LJCC0Z0828447C0' ",
+		"orderString": "order by pr_code desc"
+	}
+}
+```
+
+##### 参数说明
+
+|参数名|必选|  说明 |  类型 |
+|:-|:----- |---|---|
+| code | 是      | 业务标识,SCRAP 表示新增报废记录  | String  |
+| data|是 | 业务数据 | String|
+| startRow|是 | 起始行数(分页显示用) 0 默认从第一行记录  | Int|
+| limit|是 | 最多行数 默认2000 可以不用设置  | Int|
+| filterString|否 | 过滤条件,如“pr_code='abc'” | String|
+| orderString|否 | 排序条件  | String|
+
+##### 返回示例
+``` 
+code 
+	值为1 表示单据写入成功,
+	值不为1 ,message 里面会有写入异常原因
+data 
+	code为1时返回具体下载信息,size表示写入报废记录的条数
+成功示例:
+{
+    "code": "1",
+    "message": "查询成功",
+    "requestId": "741fef41-ffc5-445f-b427-d79278954b7c",
+    "data": [
+        {
+            "pr_custcode": "LJ320",
+            "cu_name": null,
+            "cu_shortname": null,
+            "pr_xbzbn_user": "L",
+            "pr_xbzb": "内销",
+            "pr_style": "量产",
+            "pr_factorycode": "J",
+            "pr_usetype": "C",
+            "pr_usetypen": "工业控制",
+            "pr_usekind": "0",
+            "pr_usekindn": "普通通孔",
+            "pr_serial": "Z",
+            "pr_serialn": "普通板",
+            "pr_nospec": "C",
+            "pr_nospecn": "化金",
+            "pr_tsn_user": null,
+            "pr_ts_user": null,
+            "pr_layer": 8.0,
+            "pr_code": "LJCC0Z0828447C0",
+            "pr_custprodspec": "RV-R3008-VER 1.3",
+            "pr_custprodcode": "/",
+            "pr_xhsx_user": "全制程",
+            "pr_outerboxlength": 172.0,
+            "pr_outerboxwidth": 165.0,
+            "pr_length": 172.0,
+            "pr_width": 145.0,
+            "pr_combinetype_1": 1.0,
+            "pr_combinetype_2": 1.0,
+            "pr_unit": "Unit",
+            "pr_cxkind": "锣板",
+            "pr_zlly": "E-mail",
+            "pr_envreq": "Rohs",
+            "pr_bctp": "FR-4     ",
+            "pr_tg": null,
+            "pr_cpthick": 1.2,
+            "pr_bottomcu": "1/1",
+            "pr_wcdth_user": "H/H  ",
+            "pr_tbthick": "1/1",
+            "pr_mktmbno": null,
+            "pr_halogen": null,
+            "pr_id": 1.09985147E8,
+            "pr_updatedate": "2026-06-13 08:24:12",
+            "pr_pacode": null,
+            "pr_ssttounit": 1.0,
+            "pr_premakelevel": "A",
+            "pr_ifcraft": 0.0,
+            "pr_craftsize": 0.0,
+            "pr_recordman": "彭丹丹",
+            "pr_pkid": null,
+            "pr_statuscode": "AUDITED",
+            "pr_outver": "C",
+            "pr_inver": "0",
+            "pr_groupcode": "成品",
+            "pr_status": "已审核",
+            "pr_isvalid": -1.0,
+            "pr_sqr": "彭丹丹",
+            "pr_engremark": null,
+            "pr_docdate": "2026-06-13 08:24:12",
+            "pr_attach": null,
+            "pr_spec": null,
+            "pr_salearea": 0.305482,
+            "pr_unitarea": 0.38429274,
+            "pr_ifab": 0.0,
+            "pr_remark": null,
+            "pr_nodieceng": 0.0,
+            "pr_nokailiao": "0",
+            "pr_zkcolor": "绿色(C/S,S/S)",
+            "pr_holedeal": "塞孔",
+            "pr_zfcolor": "白字",
+            "pr_kthd": null,
+            "pr_goldthick": "最小1u“",
+            "pr_nh_user": null,
+            "pr_sfht_user": 0.0,
+            "pr_fjbj": "按文件-eq确认下",
+            "pr_description": null,
+            "pr_x_type": "其他",
+            "pr_x_qty": 0.0,
+            "pr_xbbl": "0",
+            "pr_testmode": "新开测试架",
+            "pr_bzfs": "真空包装,25SET/包+不要放湿度卡,干燥剂",
+            "pr_extend3": "出口纸箱+用无字纸箱,除标签外,不要体现任何东西在上面",
+            "pr_delreq": "不接受叉板+出货附切片+试锡板,出货报告",
+            "pr_vendcode": null,
+            "pr_llno": "28447",
+            "pr_tsyq": null,
+            "pr_samepdctno": null,
+            "pr_ifx": 0.0,
+            "pr_testtype": null,
+            "pr_mmkb": null,
+            "pr_board_l": 82.0,
+            "pr_board_w": 49.0,
+            "pr_jhfs": "Set",
+            "pr_prodremark": "国外客户货交:孔铜20以上,不要放干燥剂 ,用无字纸箱",
+            "pr_jhzc": null,
+            "pr_sy_user": null,
+            "pr_pzjb": "A",
+            "pr_ifxbbdy": 0.0,
+            "pr_aaa": "ECN升级",
+            "pr_topnl": 6.0,
+            "pr_pnltosst": 12.0,
+            "pr_topcs": 12.0,
+            "pr_utilization": 78.8,
+            "pr_assignboard": null,
+            "pr_boardinfo": null,
+            "pr_miimg": "NOIMG",
+            "pr_pnlalength": 691.0,
+            "pr_pnlawidth": 620.0,
+            "pr_flagsend_user": "0",
+            "pr_flagplan_user": "0",
+            "pr_manutype": "MAKE",
+            "pr_dhzc": "MPS",
+            "pr_supplytype": "PUSH",
+            "pr_precision": null,
+            "pr_wccode": null,
+            "pr_wcname": null,
+            "pr_gdtqq": null,
+            "pr_plzl": null,
+            "pr_safetystock": null,
+            "pr_minstock": null,
+            "pr_planercode": null,
+            "pr_planner": null,
+            "pr_istracbefore": null,
+            "pr_whcode": "24",
+            "pr_whname": "成品仓",
+            "pr_precheckdate": null,
+            "pr_recentchangedate": "2026-03-03 22:53:39",
+            "pr_recentpurcdate": null,
+            "pr_recentindate": "2026-03-03 21:56:03",
+            "pr_recentoutdate": "2026-03-03 22:53:39",
+            "pr_bzdays": null,
+            "pr_jkgsl": null,
+            "pr_finishoverrate": null,
+            "pr_purcoverrate": null,
+            "pr_mazeroqty": null,
+            "pr_maxstock": null,
+            "pr_qtyperplace": null,
+            "pr_acceptmethod": "1",
+            "pr_qualmethod": null,
+            "pr_aql": null,
+            "pr_validdays": 365.0,
+            "pr_ismsd": null,
+            "pr_msdlevel": null,
+            "pr_inspector": null,
+            "pr_ltqc": null,
+            "pr_stockcatecode": "1405.01",
+            "pr_stockcatename": null,
+            "pr_costcatecode": null,
+            "pr_costcatename": null,
+            "pr_incomecatecode": null,
+            "pr_incomecatename": null,
+            "pr_costlevel": null,
+            "pr_standtime": 0.0,
+            "pr_materialcost": null,
+            "pr_humancost": null,
+            "pr_makecost": null,
+            "pr_salecost": null,
+            "pr_cost": 0.0,
+            "pr_sourcecode_user": "PDM",
+            "pr_pdmid_user": null
+        }
+    ]
+}
+失败示例:
+{
+    "code": "1",
+    "message": "查询成功",
+    "requestId": "741fef41-ffc5-445f-b427-d79278954b7c",
+    "data":null
+}
+```
+
+##### 备注
+
+```
+

+ 0 - 3
src/main/resources/README.md → src/main/resources/README/代码结构及数据结构说明.md

@@ -1,8 +1,5 @@
 # 项目说明
 
-### 线上接口文档
-https://doc.ubtob.net/web/#/569?page_id=7683
-
 #### 代码结构
 - 对接拦截器:
 

+ 57 - 0
src/main/resources/README/公共参数.md

@@ -0,0 +1,57 @@
+
+
+
+##### 简要描述
+
+- 公共参数说明
+
+##### RequestHeader
+
+|参数名|必选| 说明                                                                                       |
+|:----    |:---|:-----------------------------------------------------------------------------------------|
+|AccessKey |是  | 对接账套代码,具体查询《现有账套清单》或系统MASTER表 ,只取默认账套(科翔集团DATACENTER_KX)账套下的数据,此表数据仅用于查询校验账套是否存在,不允许修改删除 |
+|Timestamp |是  | 时间戳,与系统时间比较,超过5分钟认定为非法的请求。                                                               |
+|RequestId |是  | 随机数,用于防止网络重放攻击。用户在不同请求间要使用不同的随机数值,用户自行生成,原则上需要保证唯一                                       |
+
+##### RequestHeader示例
+
+``` 
+ "Header" {
+    "AccessKey": "GZKX_TEST",
+	"Timestamp": "1702953290104",
+	"RequestId": "741fef41-ffc5-445f-b427-d79278954b7c"
+    
+  }
+```
+
+##### 请求包体
+
+|参数名|必选|说明|
+|:----    |:---|:----- |
+|code |是  |接口类型 |
+|data |是  |请求业务数据,具体内容以实际业务为准。  |
+
+
+
+##### 请求包体示例
+
+``` 
+ {
+    "code": "ReciveIn",
+	"data":{
+		...
+	}
+  }
+```
+
+##### 返回参数说明
+
+|参数|说明|
+|:-----  |:-----|
+|code |出错返回码,为0表示成功,非0表示调用失败|
+|message|返回码提示语|
+|requestId|请求ID|
+|data|返回结果|
+
+
+##### 备注

+ 20 - 0
src/main/resources/README/现有账套清单.md

@@ -0,0 +1,20 @@
+
+|工厂代码|对应系统账套|
+|:----    |:---|
+|科翔集团	| DATACENTER_KX
+|广科(正式)	| N_KX_GK
+|江西科翔	| N_KX_JXKX
+|智恩电子	| ZN_P
+|大亚湾科翔	| ZN_DYW
+|上饶科翔	| N_KX_GSD
+|广州(钠能)	| GZKX_NN
+|赣州科翔	| GZKX
+|赣州科翔(一厂)	| GZKX_ONE
+|赣州科翔(二厂)	| GZKX_TWO
+|华宇华源	| HYHY
+|上饶科翔光电	| N_KX_SRGD
+|智恩(测试)	| ZN_P_T
+|陶积电	| N_KX_TJD
+|香港科翔	| N_KX_HK
+|科算智能	| N_KSZN
+|江西科翔(测试)	| N_KX_JXKX_T2