# 金蝶KIS专业版财务凭证同步WebAPI接口

------

- [接口简介](#接口简介)
- [接口说明](#接口说明)
- [登录](#登录)
- [退出登录](#退出登录)
- [会计科目](#会计科目)
- [凭证字](#凭证字)
- [凭证号](#凭证号)
- [同步凭证](#同步凭证)
- [删除凭证](#删除凭证)
- [查看核算项目类型](#查看核算项目类型)
- [查看核算项目](#查看核算项目)
- [查询指定编码的核算项目](#查询指定编码的核算项目)
- [新增客户](#新增客户)
- [按编码修改客户名称](#按编码修改客户名称)
- [查询指定编码的客户](#查询指定编码的客户)
- [新增部门](#新增部门)
- [新增面签组](#新增面签组)
- [C#调用示例](#C#调用示例)
- [VB.net调用示例](#VB.net调用示例)

## 接口简介

本文档为金蝶KIS专业版财务凭证同步WebAPI接口技术文档，本接口可以供任何第三方业务系统调用生成金蝶KIS专业版财务记账凭证。本接口支持金蝶KIS专业版11.0至15.1，以及私有部署的16.0。在可预期的未来，也将继续支持未来新发布的私有部署版本或自购云主机安装部署方式。
1. 调用登录接口，通过AcctKey区分不同帐套；
2. 获得用户token（每次登录会**重新生成**，原token失效）；
3. 调用凭证同步接口（按格式构造参数）；
4. 同步完毕后，调用退出接口以使token失效。若不调用退出接口，则token在重新登录前一直有效。<br/>

- **AcctKey**：金蝶KIS专业版帐套ID，用此ID来连接不同的帐套，数据来自select FAcctID from acctctl..t_ad_kdAccount_gl。
- **Token**:登录成功后返回给调用端的用户身份认证字符串，访问其他所有接口均需提供。

- **接口地址**：http://服务器IP:端口号/api ，实际调用时请将服务器IP替换为实际IP或域名，端口号替换为实际端口号。例如http://192.168.1.106:90/api 。

- **基础资料分页**：现在的计算机硬件能力及网络带宽，足以支撑一次性传输金蝶KIS专业版全部基础资料数据，这样请求与处理都方便，因此未采用分页形式。
- **部署**：本接口需部署在金蝶KIS专业版服务器上。

## 接口说明

所有接口以RESTful的方式访问，参数及返回值均为采用UTF-8编码的标准JSON格式字符串。

接口对凭证的新增、删除操作，客户、部门、面签组的新增操作均需相应的用户权限。请登录金蝶KIS专业版，在`基础设置-用户管理`里进行权限设置。

## 登录

**简要描述：** 登录到金蝶KIS专业版

**请求 URL：** `/login`

**请求方式：** POST

**请求参数：**

```java
{
    "user":                  //用户登录信息段
    {
        "ID":0,              //用户内码，固定为0
        "Name":"Manager",    //用户名称，与专业版登录用户名一致
        "Password":""        //用户登录密码，数据来自select FSID from t_user where FUserID=用户内码，参数必须为FSID字段的值，不能为密码明文
    },
    "AcctKey":24             //帐套ID，数据来自select FAcctID from acctctl..t_ad_kdAccount_gl
}
```

**返回串及字段说明**

```java
{
    "Login":                                             //登录结果信息段
    {
        "Result": 1,                                     //登录结果：1成功，其他值失败
        "Message": "登录验证成功"                         //登录结果的具体描述
    },
    "User":                                              //当前登录用户信息段
    {
        "ID": 16394,                                     //用户内码
        "Name": "Manager",                               //用户名
        "Password": ""                                   //登录密码，固定为空白
    },
    "Secure":                                            //安全认证信息段
    {
        "AcctKey": 24,                                   //帐套ID，此ID区分不同帐套
        "Token": "09400343c35d3b39d8970831e3b1f502"      //用户Token，访问其他接口时用来验证用户登录身份
    }
}

```

## 退出登录

**简要描述：** 功能接口调用完毕后，请调用此接口退出，以使用户Token失效。

**请求 URL：** `/logout`

**请求方式：** POST

**请求参数：**

```java
{
    "AcctKey": 24,                                //帐套ID
    "Token": "09400343c35d3b39d8970831e3b1f502"   //用户Token
}
```

**返回串及字段说明**

```java
{
    "Result": 1,                                  //接口执行结果：1成功，其他值失败
    "Message": "当前用户token清除成功"             //执行结果的具体文字描述
}

```

## 会计科目

**简要描述：** 获取金蝶KIS专业版指定帐套的会计科目列表

**请求 URL：** `/accounts`

**请求方式：** POST

**请求参数：**

```java
{
    "AcctKey": 24,                                //帐套ID
    "Token": "09400343c35d3b39d8970831e3b1f502"   //用户Token
}
```

**返回串及字段说明**

```java
{
    "Result": 1,                                  //接口执行结果：1成功，其他值失败
    "Count": 175,                                 //总科目数
    "Account": [                                  //科目数据，此数据为列表Array形式
        {
            "Name": "库存现金",                    //科目名称
            "FullName": "库存现金",                //科目完整名称，如：银行存款-基本户
            "Group": {                            //科目类别，如流动资产、长期资产、流动负债等
                "ID": 1,                          //科目类别内码
                "Number": "101",                  //科目类别编码
                "Name": "流动资产"                 //科目类别名称
            },
            "Level": 1,                           //科目级别，即第几级科目
            "Detail": true,                       //是否明细科目，True为是，False为否
            "ParentID": 0,                        //上级科目内码，若自身为明细科目，则该值为0
            "DC": 1,                              //余额借贷方向，1为借方，0为贷方
            "CurrencyID": 0,                      //币别内码
            "Quantity": false,                    //科目是否进行数量金额核算
            "Unit": {                             //若进行数量金额核算，数量的计量单位信息
                "ID": 0,                          //计量单位内码，未数量金额核算的科目 值为0
                "Number": "*",                    //计量单位编码，未数量金额核算的科目 值为*
                "Name": "*"                       //计量单位名称，未数量金额核算的科目 值为*
            },
            "IsCash": true,                       //是否现金科目
            "IsBank": false,                      //是否银行科目
            "ItemsID": 0,                         //科目下挂核算项目情况，0代表无核算项目
            "ItemsCount": 0,                      //科目下挂几个核算项目
            "Items":[                             //科目下挂核算项目详情，此数据为列表Array形式。如无核算项目，则此处为空值
                {
                    "ID":0,                       //核算项目类别内码
                    "Number":"*",                 //核算项目类别编码
                    "Name":"*"                    //核算项目类别名称
                }
            ],
            "Forbidden": 0,                       //科目是否被禁用，0：正常使用；1：禁用
            "Message": "",                        //附加信息
            "ID": 1000,                           //科目内码
            "Number": "1001",                     //科目编码
            "UserID": 16394,                      //访问此接口的用户内码
            "UserName": "Manager"                 //访问此接口的用户名
        }, {
            "Name": "被套期项目",
            "FullName": "被套期项目",
            "Group": {
                "ID": 6,
                "Number": "601",
                "Name": "共同类"
            },
            "Level": 1,
            "Detail": true,
            "ParentID": 0,
            "DC": 1,
            "CurrencyID": 1,
            "Quantity": false,
            "Unit": {
                "ID": 0,
                "Number": "*",
                "Name": "*"
            },
            "IsCash": false,
            "IsBank": false,
            "ItemsID": 0,
            "ItemsCount": 0,
            "Items": [],
            "Forbidden": 0,
            "Message": "",
            "ID": 1064,
            "Number": "3202",
            "UserID": 16394,
            "UserName": "Manager"
        }
    ],
    "Message": "获取会计科目列表成功",                 //执行结果的具体文字描述
    "UserID": 16394,
    "UserName": "Manager"
}

```

## 凭证字

**简要描述：** 返回指定帐套的所有凭证字

**请求 URL：** `/words`

**请求方式：** POST

**请求参数：**

```java
{
    "AcctKey": 24,                                //帐套ID
    "Token": "09400343c35d3b39d8970831e3b1f502"   //用户Token
}
```

**返回串及字段说明**

```java
{
    "Result": 1,                            //接口执行结果：1成功，其他值失败
    "Word": [                               //凭证字信息，此数据为列表Array形式
        {
            "ID": 2,                        //凭证字内码
            "Name": "记"                    //凭证字
        },
        {
            "ID": 3,
            "Name": "转"
        },
        {
            "ID": 4,
            "Name": "现收"
        },
        {
            "ID": 5,
            "Name": "现付"
        },
        {
            "ID": 6,
            "Name": "银收"
        },
        {
            "ID": 7,
            "Name": "银付"
        }
    ],
    "Message": "成功读取所有凭证字",         //执行结果的具体文字描述
    "UserID": 16394,                       //访问此接口的用户内码
    "UserName": "Manager"                  //访问此接口的用户名
}

```
## 凭证号

**简要描述：** 返回指定帐套的凭证字对应的最大凭证号

**请求 URL：** `/number`

**请求方式：** POST

**请求参数：**

```java
{
    "AcctKey": 24,                                //帐套ID
    "Token": "09400343c35d3b39d8970831e3b1f502"   //用户Token
}
```

**返回串及字段说明**

```java
{
    "Result": 1,                                   //接口执行结果：1成功，其他值失败   
    "Message": "成功获取凭证字对应最大凭证号",
    "Year": 2017,                                  //财务会计当前年度
    "Period": 6,                                   //财务会计当前期间
    "Numbers": [                                   //最大凭证号信息，账套里可能使用多个凭证字，因此此处为List数组
        {
            "Word": "记",                          //凭证字
            "Number": 14                           //该凭证字对应最大凭证号，即：系统最大凭证号+1。如系统记字对应的最大凭证号为13，则此处返回14。
        }
    ]
}

```

## 同步凭证

**简要描述：** 在金蝶KIS专业版指定帐套里创建一张记账凭证，用户需具备新增凭证权限。

**请求 URL：** `/add`

**请求方式：** POST

**请求参数：**

```java
{
  "Head":{                                 //凭证头信息
    "Word":"记",                           //凭证字，注意此处为汉字，而不是内码
    "Number":0,                            //凭证号，如果为0则按金蝶KIS专业版已有凭证号顺序递增
    "Attachment":2,                        //附件数
    "Date":"2017-06-30",                   //凭证日期
    "TranDate":"2017/06/30",               //业务日期
    "Reference":"凭证接口提供数据"           //参考信息
  },
  "Entries":[                              //凭证分录，至少要有两条且借贷平衡
      {
        "Explanation":"购买音箱一台",       //摘要
        "AcctNumber":"1411.02",            //科目编码
        "TransNumber":"",                  //往来业务编码，可以为空
        "Debit":198.0,                     //借方金额
        "Credit":0.0,                      //贷方金额
        "Qty":1.0,                         //采用数量金额核算的科目的分录数量，未数量金额核算此处为0
        "Price":198.0,                     //采用数量金额核算的科目的分录单价，未数量金额核算此处为0
        "Currency":"RMB",                  //币别编码
        "Items":"269,201,274"              //核算项目内码，科目下挂多个核算项目，内码之间以,（英文逗号）分隔
        },
      {
        "Explanation":"现金支付",
        "AcctNumber":"1001",
        "TransNumber":"",
        "Debit":0.0,
        "Credit":198.0,
        "Qty":0.0,
        "Price":0.0,
        "Currency":"RMB",
        "Items":""
      }
  ],
  "Secure":{                                      //认证信息
    "AcctKey":24,                                 //帐套ID
    "Token":"09400343c35d3b39d8970831e3b1f502"    //用户Token
  }
}

```

**返回串及字段说明**

```java
{
    "Result": 1,               //接口执行结果，1为成功，其他值为失败
    "Message": "成功",         //执行结果的具体文字描述
    "Year": 2017,              //凭证所属会计年度
    "Period": 6,               //凭证所属会计期间
    "Numbers": [
        {
            "Word": "记",      //当前保存的凭证的凭证字 
            "Number": 25       //当前保存的凭证的凭证号
        }
    ]
}
```

## 删除凭证

**简要描述：** 在金蝶KIS专业版指定帐套删除指定会计年度、会计期间的一批凭证，用户需具备凭证删除权限和（或）删除他人凭证的权限。

**请求 URL：** `/delete`

**请求方式：** POST

**请求参数：**

```java
{
    "Year":2021,                      //会计年度
    "Period":5,                       //会计期间
    "Numbers":[                       //要删除的凭证字号列表
        {"Word":"记","Number":1},
        {"Word":"记","Number":2},
        {"Word":"记","Number":3},
        {"Word":"记","Number":15},
        {"Word":"记","Number":29}
    ],
    "Secure":{                        //账套认证信息
        "AcctKey":24,
        "Token":"09400343c35d3b39d8970831e3b1f502"
    }
}

```

**返回串及字段说明**

```java
{
    "Result":1,                                 //此处的返回值为负值，必须检查Message字段记录的未执行删除动作的原因；为1，仍需检查Numbers字段的值，以获得每张凭证的删除状态。
    "Message":"请检查Numbers字段以查看删除结果",      
    "Year":2021,                               //会计年度   
    "Period":5,                                //会计期间
    "Numbers":[                                //提交的要删除凭证列表
        {
            "Result":1,                        //删除状态，1为成功；其余值为删除不成功
            "Word":"记",                       //凭证字
            "Number":1,                        //凭证号
            "Message":"凭证[记字第1号]删除成功"  //删除是否成功的情况描述
        },
        {"Result":-2,"Word":"记","Number":2,"Message":"凭证[记字第2号]无删除他人凭证的权限"},
        {"Result":0,"Word":"记","Number":3,"Message":"凭证[记字第3号]凭证已审核，无法删除"},
        {"Result":-1,"Word":"记","Number":15,"Message":"凭证[记字第15号]凭证已过账，无法删除"},
        {"Result":1,"Word":"记","Number":29,"Message":"凭证[记字第29号]删除成功"}
    ]
}
```

## 查看核算项目类型

**简要描述：** 有些会计科目下挂一个或多个核算项目，凭证接口在提交数据时，需要提供核算项目的内码，本接口是查看核算项目内码接口的前置接口。需先通过本接口获取核算项目类型的内码，然后提交核算项目类型内码至查看核算项目接口。

**请求 URL：** `/itemtype`

**请求方式：** POST

**请求参数：**

```java
{
    "AcctKey": 24,                                //帐套ID
    "Token": "09400343c35d3b39d8970831e3b1f502"   //用户Token
}
```

**返回串及字段说明**

```java
{
    "Result": 1,                           //接口执行结果：1成功，其他值失败
    "Message": "成功获取所有核算项目类别",   //执行结果的具体文字描述
    "Type": [                              //核算项目类型信息，金蝶里可以自定义核算项目，因此每个帐套返回值可能都不一样
        {
            "ID": 1,                       //核算项目类型内码，如1为客户，2为部门等
            "Name": "客户"                 //核算项目类别名称，如客户、部门等
        },
        {
            "ID": 2,
            "Name": "部门"
        },
        {
            "ID": 3,
            "Name": "职员"
        },
        {
            "ID": 4,
            "Name": "物料"
        },
        {
            "ID": 5,
            "Name": "仓库"
        },
        {
            "ID": 6,
            "Name": "备注"
        },
        {
            "ID": 7,
            "Name": "计量单位"
        },
        {
            "ID": 8,
            "Name": "供应商"
        },
        {
            "ID": 9,
            "Name": "现金流量项目"
        }
    ]
}

```

## 查看核算项目

**简要描述：** 根据itemtype接口获得核算项目类别内码后，提交具体内码可以查看该类别的核算项目，按编码排序，不显示已禁用项目。例如，要查看客户信息，就在参数里提交1。依次类推。

**请求 URL：** `/item`

**请求方式：** POST

**请求参数：**

```java
{
    "TypeID":1,                                        //核算项目类别内码，根据itemtype接口获得。1 客户；2 部门；3 职员；4 物料；5 仓库；7 计量单位；8 供应商
    "Secure":{                                         //认证信息
        "AcctKey": 24,                                 //帐套ID
        "Token": "dd98bb330b927b6a881efbdaef6035df"    //用户Token
    }
}
```

**返回串及字段说明**

```java
{
    "Result": 1,                                  //接口执行结果：1成功，其他值失败
    "Message": "成功获取指定类别的核算项目",        //执行结果的具体文字描述
    "Data": [                                     //核算项目具体内容，列表
        {
            "ID": 227,                            //核算项目内码
            "Number": "007",                      //核算项目编码
            "Name": "爱华电脑公司"                 //核算项目名称
        },
        {
            "ID": 229,
            "Number": "009",
            "Name": "爱特儿信息有限公司"
        },
        {
            "ID": 226,
            "Number": "006",
            "Name": "奥德赛电子有限公司"
        }

]
}

```

## 查询指定编码的核算项目

**简要描述：** 本接口为 查看核算项目 接口的扩展接口。参数c为要查询的关键字，可以为核算项目编码，也可以是核算项目名称；q=1表示精确匹配查找编码，q=0表示模糊查找编码。

**请求 URL：** `/item?c=核算项目编码&q=查询方式`

**请求 URL示例：** `/item?c=01.0013&q=1`

**请求方式：** POST

**Body请求参数：**

```java
{
    "TypeID":1,                                        //核算项目类别内码，根据itemtype接口获得。1 客户；2 部门；3 职员；4 物料；5 仓库；7 计量单位；8 供应商
    "Secure":{                                         //认证信息
        "AcctKey": 24,                                 //帐套ID
        "Token": "dd98bb330b927b6a881efbdaef6035df"    //用户Token
    }
}
```

**返回串及字段说明**

```java
{
    "Result": 1,                                  //接口执行结果：1成功，0无满足条件的结果，其他值失败
    "Message": "成功获取指定类别和编码的核算项目",   //执行结果的具体文字描述
    "Data": [                                     //核算项目具体内容，列表
        {
            "ID": 9527,                           //核算项目内码
            "Number": "01.0013",                  //核算项目编码
            "Name": "爱德华自主研发有限公司"        //核算项目名称
        }
    ]
}

```

```java
{
    "Result": 0,                                             //接口执行结果：1成功，0无满足条件的结果，其他值失败
    "Message": "在指定类别的核算项目里未查询到[01.0013]编码",   //执行结果的具体文字描述
    "Data": []
}

```

## 新增客户

**简要描述：** 新增客户到金蝶KIS专业版。

**请求 URL：** `/customer`

**请求方式：** POST

**请求参数：**

```java
{
    "Data":[                                        //客户信息列表
        {
            "Id":0,                                 //客户内码，必选参数，提交参数时必须为0，由接口创建时生成实际的内码
            "Number":"",                            //客户编码，必选参数，提交时可提供具体编码，也可以为空。为空时由接口创建时按"yyyyMMddHHmmssXXXX"格式生成编码
            "Name":"河南宇宙真理有限公司",            //客户名称，必选参数       
            "Address":"郑州市红专路1888号大院",       //客户地址，非必选参数，可为空，或不提交此参数
            "Contactor":"许真理",                    //联系人，非必选参数，可为空，或不提交此参数
            "Tel":"0371-98989898",                  //固定电话，非必选参数，可为空，或不提交此参数
            "Mobile":"13999991999",                 //手机号码，非必选参数，可为空，或不提交此参数
            "Fax":"0371-98989899",                  //传真，非必选参数，可为空，或不提交此参数
            "Bank":"中国农业银行郑州市人民路支行",     //开户银行名称，非必选参数，可为空，或不提交此参数
            "BankAccount":"1110001100",             //开户银行账号，非必选参数，可为空，或不提交此参数 
            "OrganizationCode":"123456789",         //单位客户的统一社会信用代码或个人客户的身份证号，非必选参数，可为空，或不提交此参数
            "F_102":""                              //自定义合同号字段，非必选参数，可为空，或不提交此参数
        },
        {
            "Id":0,
            "Number":"",
            "Name":"河南宇宙文化有限公司",
            "Address":"郑州市文化路251号特有文化大厦",
            "Contactor":"邵文化",
            "Tel":"0371-88888888",
            "Mobile":"13983711911",
            "Fax":"0371-88888889",
            "Bank":"中国农业银行郑州市文化路支行",
            "BankAccount":"2220002200",
            "OrganizationCode":"996251",
            "F_102":""
        }
    ],
    "Secure": {                                     //账套认证信息
        "AcctKey": 1027,
        "Token": "2d058432443ee5a46469be0d2eacecf8"
    }
}
```

**返回串及字段说明**

- 调用成功返回
```java
{
    "Result": 1,                                 //此处返回值大于0，说明创建客户动作成功执行，仍需检查Data字段以掌握同步结果
    "Message": "请检查Data字段数据查看客户同步结果",
    "Data": [
        {
            "ID": 261,                           //客户内码，返回值大于0，说明创建客户成功；<=0说明创建客户失败，失败原因记录在Name字段
            "Number": "20210526164328993",       //客户编码，返回值不为空，说明创建客户成功；为空说明创建客户失败，失败原因记录在Name字段
            "Name": "河南宇宙真理有限公司"         //客户名称，如果创建客户失败，则此字段记录失败原因
        },
        {
            "ID": 262,
            "Number": "20210526164329117",
            "Name": "河南宇宙文化有限公司"
        }
    ]
}

```

```java
{
    "Result": 1,
    "Message": "请检查Data字段数据查看客户同步结果",
    "Data": [
        {
            "ID": 0,
            "Number": "",
            "Name": "客户名称[河南宇宙真理有限公司]已存在，不能创建。"
        },
        {
            "ID": 0,
            "Number": "",
            "Name": "客户名称[河南宇宙文化有限公司]已存在，不能创建。"
        }
    ]
}

```

- 调用失败返回
```java
{
    "Result": -7,                               //<=0时，Message字段记录失败原因。
    "Message": "当前用户[张三]无新增客户的权限",
    "Data": []
}
```

## 按编码修改客户名称

**简要描述：** 按编码修改金蝶KIS专业版的客户名称。action参数值固定为update2。

**请求 URL：** `/customer?action=update2`

**请求方式：** POST

**请求参数：**

```java
{
    "Data":[                                        //客户信息列表
        {                               
            "Number":"03.055",                      //客户编码，必选参数，不能为空
            "Name":"河南宇宙真理有限公司",            //客户名称，必选参数，不能为空      
        },
        {                               
            "Number":"09.107",
            "Name":"河南东来顺驴肉火烧有限公司",    
        },
        {
            "Id":0,                                //客户内码，在本接口中不起作用，可以不提供，也可以为任意值
            "Number":"",
            "Name":"河南宇宙文化有限公司",
            "Address":"郑州市文化路251号特有文化大厦",//客户地址，在本接口中不起作用，可以不提供
            "Contactor":"邵文化",                   //联系人，在本接口中不起作用，可以不提供
            "Tel":"0371-88888888",                  //固定电话，在本接口中不起作用，可以不提供 
            "Mobile":"13983711911",                 //手机，在本接口中不起作用，可以不提供
            "Fax":"0371-88888889",                  //传真，在本接口中不起作用，可以不提供
            "Bank":"中国农业银行郑州市文化路支行",    //开户行，在本接口中不起作用，可以不提供 
            "BankAccount":"2220002200",             //开户行账号，在本接口中不起作用，可以不提供 
            "OrganizationCode":"996251",            //统一社会信用代码或身份证号，在本接口中不起作用，可以不提供 
            "F_102":""                              //自定义字段合同号，在本接口中不起作用，可以不提供 
        }
    ],
    "Secure": {                                     //账套认证信息
        "AcctKey": 1027,
        "Token": "2d058432443ee5a46469be0d2eacecf8"
    }
}
```

**返回串及字段说明**

- 调用成功返回
```java
{
    "Result": 1,                                    //此处返回值大于0，说明更新客户名称动作成功执行，仍需检查Data字段以掌握更新结果
    "Message": "请检查Data字段数据查看客户同步结果",
    "Data": [
        {
            "Result": 1,                            //返回值大于0，说明更新客户名称成功；<=0说明失败，失败原因记录在Message字段
            "Message": "编码[03.055]的名称更新成功",  //如果Result<=0，此字段记录失败原因
        },
        {
            "Result": -19,                     
            "Message": "编码[09.107]不存在",  
        },
        {
            "Result": -16,                     
            "Message": "编码不能为空",  
        }
    ]
}

```

- 调用失败返回
```java
{
    "Result": -7,                               //<=0时，Message字段记录失败原因。
    "Message": "当前用户[张三]无修改客户的权限",
    "Data": []
}
```

## 查询指定编码的客户

**简要描述：** 按指定编码精确查询或模糊查询客户，c参数为查询关键字，可以为客户编码，也可以为客户名称。为空则返回全部客户数据。

**请求 URL：** `/customer?c=客户编码&q=查询方式（1：精确查询；0：模糊查询）`

**请求 URL示例：** `/customer?c=1.001&q=1`

**请求方式：** POST

**请求参数：**

```java
{
    "TypeID":1,                                        //固定为1
    "Secure":{                                         //认证信息
        "AcctKey": 24,                                 //帐套ID
        "Token": "dd98bb330b927b6a881efbdaef6035df"    //用户Token
    }
}
```

**返回串及字段说明**

- 调用成功返回
```java
{
    "Result":1,
    "Message":"",
    "Data":[                                        //客户信息列表
        {
            "Id":9527,                              //客户内码
            "Number":"1.001",                       //客户编码
            "Name":"河南宇宙真理有限公司",            //客户名称     
            "Address":"郑州市红专路1888号大院",       //客户地址
            "Contactor":"许真理",                    //联系人
            "Tel":"0371-98989898",                  //固定电话
            "Mobile":"13999991999",                 //手机号码
            "Fax":"0371-98989899",                  //传真
            "Bank":"中国农业银行郑州市人民路支行",     //开户银行名称
            "BankAccount":"1110001100",             //开户银行账号
            "OrganizationCode":"123456789",         //单位客户的统一社会信用代码或个人客户的身份证号
            "F_102":""                              //自定义合同号字段
        }
    ]
}

```

```java
{
    "Result": 0,
    "Message": "未查询到编码为[1.001]的客户。",
    "Data": []
}

```

- 调用失败返回
```java
{
    "Result": -16,                               //<0时，Message字段记录失败原因。
    "Message": "参数q无效，必须为0（按编码模糊搜索）或1（按编码精确查询）。",
    "Data": []
}
```

## 新增部门

**简要描述：** 新增部门到金蝶KIS专业版。

**请求 URL：** `/department`

**请求方式：** POST

**请求参数：**

```java
{
    "Data":[                                        //部门信息列表
        {
            "Id":0,                                 //部门内码，必选参数，提交参数时必须为0，由接口创建时生成实际的内码
            "Number":"",                            //部门编码，必选参数，提交时可提供具体编码，也可以为空。为空时由接口创建时按"yyyyMMddHHmmssXXXX"格式生成编码
            "Name":"财务部",                        //部门名称，必选参数       
            "Note":"部门的备注信息"                  //部门备注，非必选参数，可为空，或不提交此参数
        },
        {
            "Id":0,
            "Number":"",
            "Name":"物资管理部"
        }
    ],
    "Secure": {                                     //账套认证信息
        "AcctKey": 1027,
        "Token": "2d058432443ee5a46469be0d2eacecf8"
    }
}
```

**返回串及字段说明**

- 调用成功返回
```java
{
    "Result": 1,                                 //此处返回值大于0，说明创建部门动作成功执行，仍需检查Data字段以掌握同步结果
    "Message": "请检查Data字段数据查看部门同步结果",
    "Data": [
        {
            "ID": 265,                           //部门内码，返回值大于0，说明创建部门成功；<=0说明创建部门失败，失败原因记录在Name字段
            "Number": "20210526172924680",       //部门编码，返回值不为空，说明创建部门成功；为空说明创建部门失败，失败原因记录在Name字段
            "Name": "财务部"                      //部门名称，如果创建部门失败，则此字段记录失败原因
        },
        {
            "ID": 266,
            "Number": "20210526172924897",
            "Name": "物资管理部"
        }
    ]
}

```

```java
{
    "Result": 1,
    "Message": "请检查Data字段数据查看客户同步结果",
    "Data": [
        {
            "ID": 0,
            "Number": "",
            "Name": "部门名称[财务部]已存在，不能创建。"
        },
        {
            "ID": 0,
            "Number": "",
            "Name": "部门名称[物资管理部]已存在，不能创建。"
        }
    ]
}

```

- 调用失败返回
```java
{
    "Result": -7,                               //<=0时，Message字段记录失败原因。
    "Message": "当前用户[李四]无新增部门的权限",
    "Data": []
}
```

## 新增面签组

**简要描述：** 新增自定义核算项目面签组到金蝶KIS专业版。

**请求 URL：** `/sd?cid=3513`

**请求方式：** POST

**URL 参数：** cid=面签组的核算项目类别内码，通过查询```sql select FItemClassID from t_ItemClass where FName='面签组'``` 获得，调用时将实际查询到的值替换3513。

**请求参数：**

```java
{
    "Data":[                           //面签组信息列表
        {
            "Id":0,                    //面签组内码，必选参数，提交参数时必须为0，由接口创建时生成实际的内码
            "Number":"1.001",          //面签组编码，必选参数，提交时可提供具体编码，也可以为空，为空时由接口创建时按"yyyyMMddHHmmssXXXX"格式生成编码 
            "Name":"诺基亚组"           //面签组名称，必选参数，必须提交，不可为空 
        },
        {
            "Id":0,
            "Number":"1.002",
            "Name":"摩托罗拉组"
        },
        {
            "Id":0,
            "Number":"1.003",
            "Name":""
        },
        {
            "Id":0,
            "Number":"5.001",
            "Name":"天上星星参北斗组"
        }
    ],
    "Secure": {
        "AcctKey": 1027,
        "Token": "41cbc3fa15a228a540c37d8e765e738f"
    }
}
```

**返回串及字段说明**

- 调用成功返回
```java
{
    "Result": 1,                                               //此处返回值大于0，说明创建面签组动作成功执行，仍需检查Data字段以掌握同步结果
    "Message": "请检查Data字段数据查看同步结果",
    "Data": [
        {
            "ID": -8,                                          //面签组内码，返回值大于0，说明创建成功；<=0说明创建失败，失败原因记录在Name字段
            "Number": "1.001",                                 //面签组编码
            "Name": "面签组编码[1.001]已存在，[诺基亚]不能新增"   //面签组名称，如果创建失败，则此字段记录失败原因
        },
        {
            "ID": 272,                                         //面签组内码，返回值大于0，说明创建成功；<=0说明创建失败，失败原因记录在Name字段
            "Number": "1.002",
            "Name": "摩托罗拉"
        },
        {
            "ID": -1,
            "Number": "1.003",
            "Name": "面签组名称不能为空"
        },
        {
            "ID": -9,
            "Number": "",
            "Name": "面签组编码[5.001]级次为2级，但不存在上级组编码[5]"
        }
    ]
}

```

- 调用失败返回
```java
{
    "Result": -7,                               //<=0时，Message字段记录失败原因。
    "Message": "当前用户[李四]无新增的权限",
    "Data": []
}
```

## C#调用示例

```C#
using System;
using System.Net;

namespace VisitWebAPI_C
{
    class Program
    {
        static void Main(string[] args)
        {
            //以访问登录接口为例
            string result_data;
            string url = "http://192.168.1.102/UXI/api/login";
            //含义：用户Manager登录，该用户密码为空，要登录的帐套内码为24
            //具体提交参数格式请阅读接口技术手册
            string param = "{\"user\":{\"ID\":0,\"Name\":\"Manager\",\"Password\":\"\"},\"AcctKey\":24}";
            WebClient client = new WebClient();
            client.Headers.Add("Content-Type", "application/json;charset=utf-8");
            //给访问webapi的客户端一个标识
            //从而方便从日志中甄别出非法访问客户端
            //也可以不要此句
            client.Headers.Add("User-Agent", "QenghooRuntime/1.0");
            result_data = client.UploadString(url, "POST", param);
            Console.WriteLine(result_data);
            Console.ReadLine();
        }
    }
}

```

## VB.net调用示例
```vb
Imports System.Net
Module Module1

Sub Main()
        '以访问登录接口为例
        Dim result_data As String
        '此处将192.168.1.102替换为服务器实际地址
        Dim url As String = "http://192.168.1.102/UXI/api/login"
        '含义：用户Manager登录，该用户密码为空，要登录的帐套内码为24
        '具体提交参数格式请阅读本技术手册
        Dim param As String = "{""user"":{""ID"":0,""Name"":""Manager"",""Password"":""""},""AcctKey"":24}"
        Dim client As New WebClient
        client.Headers.Add("Content-Type", "application/json;charset=utf-8")
        '给访问webapi的客户端一个标识
        '从而方便从日志中甄别出非法访问客户端
        '也可以不要此句
        client.Headers.Add("User-Agent", "QenghooRuntime/1.0")
        result_data = client.UploadString(url, "POST", param)
        Console.WriteLine(result_data)
        Console.ReadLine()
    End Sub

End Module
```

天蝎大王/vchExt

简介

发行版

贡献者

近期动态

天蝎大王/vchExt .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

天蝎大王/vchExt