电视机V3.0后端
parent: ee3599cb | 补丁 | 提交 | ignore whitespace
#
Junjie
8 天以前 0dac7157ea8a80579e20d447f1a9e582f6c4df7c 
#
1个文件已删除
1个文件已添加
301 ■■■■■ 已修改文件
src/main/resources/docs/地图操作说明书.pdf 补丁 | 查看 | 原始文档 | blame | 历史
src/main/resources/docs/开发接口文档.md 301 ●●●●● 补丁 | 查看 | 原始文档 | blame | 历史 
 src/main/resources/docs/µØͼ²Ù×÷˵Ã÷Êé.pdf

Binary files differ



 src/main/resources/docs/¿ª·¢½Ó¿ÚÎĵµ.md


New file


@@ -0,0 +1,301 @@


# API æŽ¥å£æ–‡æ¡£




- **文档版本**：v1.0.0


- **最后更新**：2026-2-24




---




## 1. æ¦‚è¿°




### 1.1 ç›®æ ‡


- ç¬¬ä¸‰æ–¹æŽ¥å£æ–‡æ¡£ï¼šæ™ºèƒ½å¤§å±ç³»ç»Ÿä¸Žç¬¬ä¸‰æ–¹ç³»ç»Ÿæ•°æ®äº¤äº’接口文档。




---




## 2. é€šç”¨çº¦å®š




### 2.1 æ•°æ®æ ¼å¼


- **请求/响应格式**：`application/json; charset=utf-8`


- **字符集**：UTF-8




### 2.2 é€šç”¨ Header


| Header | å¿…å¡« | ç¤ºä¾‹ | è¯´æ˜Ž |


|---|---:|---|---|




### 2.4 é€šç”¨å“åº”结构




```json


{


  "code": 200,


  "message": "success",


  "data": {}


}


```




---




## 3. WCS接口




### 3.1 WCS站点信息同步




- **API URL(WCS实际提供为准)**：`/openapi/stationStatus`


- **请求/响应格式**：`application/json; charset=utf-8`


- **字符集**：UTF-8


- **请求方式**: POST




#### 3.1.1 Header


| Header | å¿…å¡« | ç¤ºä¾‹ | è¯´æ˜Ž |


|---|---:|---|---|




#### 3.1.2 Body


| Body | å¿…å¡« | ç±»åž‹    | ç¤ºä¾‹            | è¯´æ˜Ž          |


|------|---:|-------|---------------|-------------|


|stationIds|  æ˜¯ | int[] | [100,101,102] | éœ€è¦æŸ¥è¯¢çš„站点编号列表 |




#### 3.1.3 å“åº”字段


| å­—段         | ç±»åž‹   | ç¤ºä¾‹   | è¯´æ˜Ž     |


|------------|------|------|--------|


| stationIds | int  | 100  | ç«™ç‚¹ç¼–号   |


| autoing    | bool | true | è‡ªåŠ¨     |


| loading    | bool | true | æœ‰ç‰©     |


| error      | int  | 0    | é”™è¯¯ç     |


| errorMsg | str  |   | é”™è¯¯ä¿¡æ¯   |


| systemWarning | str  |   | ç³»ç»ŸæŠ¥è­¦ä¿¡æ¯ |


| superTaskNo | str  |   | WMS任务号 |




### 3.1.4 å“åº”JSON


```json


{


  "msg" : "操作成功",


  "code" : 200,


  "data" : [ {


    "stationId" : 1152,


    "autoing" : true,


    "loading" : false,


    "error" : 0,


    "errorMsg" : null,


    "systemWarning" : null,


    "superTaskNo" : "0"


  }, {


    "stationId" : 1157,


    "autoing" : true,


    "loading" : true,


    "error" : 0,


    "errorMsg" : null,


    "systemWarning" : null,


    "superTaskNo" : "0"


  }]


}


```


### 3.2 WMS任务查询接口




- **API URL(WCS实际提供为准)**：`/open/asrs/queryTask`


- **请求/响应格式**：`application/json; charset=utf-8`


- **字符集**：UTF-8


- **请求方式**: POST




#### 3.2.1 Header


| Header | å¿…å¡« | ç¤ºä¾‹ | è¯´æ˜Ž |


|---|---:|---|---|




#### 3.2.2 Body


| Body | å¿…å¡« | ç±»åž‹  | ç¤ºä¾‹   | è¯´æ˜Ž  |


|------|---:|-----|------|-----|


|barcode|  æ˜¯ | str | 1234 | æ‰˜ç›˜ç  |




#### 3.2.3 å“åº”字段


| å­—段         | ç±»åž‹     | ç¤ºä¾‹   | è¯´æ˜Ž                                                                          |


|------------|--------|------|-----------------------------------------------------------------------------|


| matnr | str    |   | ç‰©æ–™å·                                                                         |


| maktx    | str    |  | ç‰©æ–™åç§°                                                                        |


| batch    | str    |  | æ‰¹æ¬¡å·                                                                         |


| specs      | str    |     | è§„æ ¼                                                                          |


| anfme | double |   | æ•°é‡                                                                          |


| ioType | int    |   | ä»»åŠ¡ç±»åž‹ï¼š<br/>1、入库<br/>53、拣料回库<br/>57、盘点回库<br/>101、出库<br/>103、拣料出库<br/>107、盘点出库 |




### 3.2.4 å“åº”JSON


```json


{


  "msg" : "操作成功",


  "code" : 200,


  "data" : {


    "wrkDetls" : [ {


      "anfme" : 100.0,


      "matnr" : "50001LR-71",


      "maktx" : "气泡袋",


      "batch" : null,


      "specs" : "50001LR-71"


    } ],


    "ioType": 1


  }


}


```




### 3.3 WMS入库任务查询接口




- **API URL(WCS实际提供为准)**：`/open/asrs/queryComb`


- **请求/响应格式**：`application/json; charset=utf-8`


- **字符集**：UTF-8


- **请求方式**: POST




#### 3.3.1 Header


| Header | å¿…å¡« | ç¤ºä¾‹ | è¯´æ˜Ž |


|---|---:|---|---|




#### 3.3.2 Body


| Body | å¿…å¡« | ç±»åž‹  | ç¤ºä¾‹   | è¯´æ˜Ž  |


|------|---:|-----|------|-----|


|barcode|  æ˜¯ | str | 1234 | æ‰˜ç›˜ç  |




#### 3.3.3 å“åº”字段


| å­—段         | ç±»åž‹     | ç¤ºä¾‹   | è¯´æ˜Ž   |


|------------|--------|------|------|


| matnr | str    |   | ç‰©æ–™å·  |


| maktx    | str    |  | ç‰©æ–™åç§° |


| batch    | str    |  | æ‰¹æ¬¡å·  |


| specs      | str    |     | è§„æ ¼   |


| anfme | double |   | æ•°é‡   |




### 3.3.4 å“åº”JSON


```json


{


  "msg" : "操作成功",


  "code" : 200,


  "data" : {


    "combDetls" : [ {


      "anfme" : 100.0,


      "matnr" : "50001LR-71",


      "maktx" : "气泡袋",


      "batch" : null,


      "specs" : "50001LR-71"


    } ]


  }


}


```




### 3.4 WMS库存数据查询




- **API URL(WCS实际提供为准)**：`/open/asrs/queryLoc`


- **请求/响应格式**：`application/json; charset=utf-8`


- **字符集**：UTF-8


- **请求方式**: GET




#### 3.4.1 Header


| Header | å¿…å¡« | ç¤ºä¾‹ | è¯´æ˜Ž |


|---|---:|---|---|




#### 3.4.2 Body


| Body | å¿…å¡« | ç±»åž‹  | ç¤ºä¾‹   | è¯´æ˜Ž  |


|------|---:|-----|------|-----|




#### 3.4.3 å“åº”字段


| å­—段         | ç±»åž‹     | ç¤ºä¾‹   | è¯´æ˜Ž   |


|------------|--------|------|------|


| emptyCount | int    |   | ç©ºåº“位数量  |


| disableCount    | int    |  | ç¦ç”¨åº“位数量 |


| total    | int    |  | æ€»åº“位数量 |


| stockCount    | int    |  | åœ¨åº“位数量 |


| usedPr    | double |  | åº“位使用率 |


| used    | int    |  | åº“位使用数量 |


| pie    | list   |  | é¥¼å›¾æ•°æ® |




### 3.4.4 å“åº”JSON


```json


{


  "msg" : "操作成功",


  "code" : 200,


  "data" : {


    "emptyCount" : 52994,


    "total" : 53130,


    "usedPr" : 0.3,


    "disableCount" : 0,


    "used" : 136,


    "pie" : [ {


      "name" : "在库",


      "value" : 122


    }, {


      "name" : "空",


      "value" : 52994


    }, {


      "name" : "使用",


      "value" : 14


    }, {


      "name" : "禁用",


      "value" : 0


    } ],


    "stockCount" : 122


  }


}


```




### 3.5 WMS入出库折线图




- **API URL(WCS实际提供为准)**：`/open/asrs/line/charts`


- **请求/响应格式**：`application/json; charset=utf-8`


- **字符集**：UTF-8


- **请求方式**: GET




#### 3.5.1 Header


| Header | å¿…å¡« | ç¤ºä¾‹ | è¯´æ˜Ž |


|---|---:|---|---|




#### 3.5.2 Body


| Body | å¿…å¡« | ç±»åž‹  | ç¤ºä¾‹   | è¯´æ˜Ž  |


|------|---:|-----|------|-----|




#### 3.5.3 å“åº”字段


| å­—段         | ç±»åž‹     | ç¤ºä¾‹   | è¯´æ˜Ž   |


|------------|--------|------|------|




### 3.5.4 å“åº”JSON


```json


{


  "msg" : "操作成功",


  "code" : 200,


  "data" : {


    "rows" : [ {


      "name" : "入库数量",


      "data" : [ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 198 ]


    }, {


      "name" : "出库数量",


      "data" : [ 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 ]


    } ]


  }


}


```




### 3.6 WMS库存数据统计




- **API URL(WCS实际提供为准)**：`/open/asrs/locDetl/statistics`


- **请求/响应格式**：`application/json; charset=utf-8`


- **字符集**：UTF-8


- **请求方式**: GET




#### 3.6.1 Header


| Header | å¿…å¡« | ç¤ºä¾‹ | è¯´æ˜Ž |


|---|---:|---|---|




#### 3.6.2 Body


| Body | å¿…å¡« | ç±»åž‹  | ç¤ºä¾‹   | è¯´æ˜Ž  |


|------|---:|-----|------|-----|




#### 3.6.3 å“åº”字段


| å­—段         | ç±»åž‹     | ç¤ºä¾‹   | è¯´æ˜Ž   |


|------------|--------|------|------|




### 3.6.4 å“åº”JSON


```json


{


  "msg" : "操作成功",


  "code" : 200,


  "data" : {


    "records" : [ {


      "anfme" : 19500.0,


      "matnr" : "50001LR-71",


      "maktx" : "气泡袋",


      "batch" : null,


      "specs" : "50001LR-71"


    } ]


  }


}


```