跳到主要内容

Excel解析

上传Excel文件，导出文本数据、图片数据​

基本信息​

信息值备注
接口名称Excel解析上传Excel文件，导出文本数据、图片数据
请求状态POSTRESTful方式
接口路径http://localhost:23798/api/File/ExcelParser向服务器地址发送POST请求
远程模式http://www.linkerplus.com/api/ext_erp/File/ExcelParser远程模式向服务器地址发送POST请求，需要ERP注册号注册远程模式，并在Headers添加sn参数
支持日期2025-10-24自该日期起支持
支持版本V11.2 V12.0自该版本起支持

请求参数​

Headers​

参数名称是否必须参数值备注
Content-Type是multipart/form-data用于指定数据的传输类型
LoginId是e835943e-55c2-4bf0-832d-6f4166592941用户登录的LoginId，取用户登录或账套验证接口返回的LoginId
WorksheetIndex是1Excel文件工作表索引
UsrNo否ADMIN账套验证的LoginId需添加UsrNo，用户登录的LoginId则无需添加UsrNo
sn否MGR_REST_1001远程模式需添加sn参数，MGR_REST_ERP注册号

Body​

form-data

参数名称类型是否必须参数值备注其它信息
fileFile是Excel文件

返回数据​

参数名称类型参数值备注
Codenumber0：表示查询成功。详见下方【code 返回说明】
Messagestring执行信息
Resultobject查询到的信息，JSON格式，具体信息参考下面调用范例

code 返回说明​

数值含义备注
0成功执行成功
1失败执行失败
2异常发生异常，一个或多个异常会导致失败
3查不到数据如单号不存在或查找条件不合适等
4数据内容为空查得到数据，但数据内容为空
5数据异常异常数据记录、数据错误
10001登录状态异常请重新登陆
10002尚未支持的类型如查找的单据类别尚未支持

调用范例​

Headers:
  Content-Type: multipart/form-data
  LoginId: e835943e-55c2-4bf0-832d-6f4166592941
  WorksheetIndex: 1
  UsrNo: ADMIN （LoginId为账套验证登录生成时）

Body:
  form-data: file = @测试数据.xlsx

调用返回​

{
    "Code": 0, // 成功
    "Message": "[File]: 成功解析 1 张图片和 2 行文本数据。",
    "Result": {
        "fileName": "测试数据.xlsx",
        "imageCount": 1, // 图片数
        "textRowCount": 2, // 有数据的文本行数
        "mergedImageCount": 1, // 合并单元格内的图片数量
        "parseTime": "2025-10-20 14:17:59",
        "images": [ // 图片数据
            {
                "imageName": "ID_351645831CE24FB7A9CECB999F7032C3", // 图片名称
                "imageFormat": "png", // 图片格式
                "imagePath": "Temp/ExcelImages/ID_351645831CE24FB7A9CECB999F7032C3.png", // 图片本地位置
                "worksheetName": "7.25", // Excel工作表名称
                "startCell": "C12", // 起始单元格
                "endCell": "C13", // 截止单元格
                "coveredCells": [ // 图片所在的单元格
                    "C12",
                    "C13"
                ],
                "isInMergedCell": true, // 是否是合并单元格
                "mergeStartRow": 12, // 合并起始行号
                "mergeStartColumn": 3, // 合并起始列号
                "mergeEndRow": 15, // 合并截止行号
                "mergeEndColumn": 3, // 合并截止列号
                "mergeRange": "C12:C15", // 合并范围
                "mergeStartCell": "C12", // 合并起始单元格
                "mergeEndCell": "C15", // 合并截止单元格
                "mergedCoveredCells": [ // 图片所在的单元格（合并），这里表示12-15行，C列，是合并单元格，表示12-15行都有这张图片
                    "C12",
                    "C13",
                    "C14",
                    "C15"
                ]
            }
        ],
        "textData": [ // 文本数据
            {
                "rowIndex": 1, // 行号
                "cells": [ // 单元格数据
                    {
                        "address": "A2",
                        "value": "客户名称：",
                        "dataType": "String",
                        "format": "General",
                        "isMerged": false,
                        "mergeRange": ""
                    },
                    {
                        "address": "C2",
                        "value": "天思",
                        "dataType": "String",
                        "format": "General",
                        "isMerged": false,
                        "mergeRange": ""
                    },
                    {
                        "address": "D2",
                        "value": "供方名称：",
                        "dataType": "String",
                        "format": "General",
                        "isMerged": true,
                        "mergeRange": "D2:E2"
                    },
                    {
                        "address": "F2",
                        "value": "天心天思",
                        "dataType": "String",
                        "format": "General",
                        "isMerged": true,
                        "mergeRange": "F2:J2"
                    }
                ]
            },
            {
                "rowIndex": 2,
                "cells": [
                    {
                        "address": "A3",
                        "value": "联系人：",
                        "dataType": "String",
                        "format": "General",
                        "isMerged": false,
                        "mergeRange": ""
                    },
                    {
                        "address": "C3",
                        "value": "蔡总",
                        "dataType": "String",
                        "format": "General",
                        "isMerged": false,
                        "mergeRange": ""
                    },
                    {
                        "address": "D3",
                        "value": "联系人：",
                        "dataType": "String",
                        "format": "General",
                        "isMerged": true,
                        "mergeRange": "D3:E3"
                    },
                    {
                        "address": "F3",
                        "value": "王杰",
                        "dataType": "String",
                        "format": "General",
                        "isMerged": true,
                        "mergeRange": "F3:J3"
                    }
                ]
            }
        ]
    }
}

备注​

注意

必须在Headers里面传入用户登录或账套验证的LoginId

提示

当采用的是账套验证获取的LoginId，那么请求头中的UsrNo不能为空。采用用户登录的LoginId则无需在请求头中添加UsrNo