金蝶知识库文档API功能应用本文档适用于K/3WISE15.1版本2018年11月24日V1.0编写人：龚文浩1.本文件使用须知著作权人保留本文件的内容的解释权，并且仅将本文件内容提供给阁下个人使用。对于内容中所含的版权和其他所有权声明，您应予以尊重并在其副本中予以保留。您不得以任何方式修改、复制、公开展示、公布或分发这些内容或者以其他方式把它们用于任何公开或商业目的。任何未经授权的使用都可能构成对版权、商标和其他法律权利的侵犯。如果您不接受或违反上述约定，您使用本文件的授权将自动终止，同时您应立即销毁任何已下载或打印好的本文件内容。著作权人对本文件内容可用性不附加任何形式的保证，也不保证本文件内容的绝对准确性和绝对完整性。本文件中介绍的产品、技术、方案和配置等仅供您参考，且它们可能会随时变更，恕不另行通知。本文件中的内容也可能已经过期，著作权人不承诺更新它们。如需得到最新的技术信息和服务，您可向当地的金蝶业务联系人和合作伙伴进行咨询。著作权声明著作权所有2018金蝶软件（中国）有限公司。所有权利均予保留。金蝶软件（中国）有限公司K/3服务支持部第1页共12页本期概述版本信息版权信息金蝶知识库文档目录一、功能介绍..............................................................3二、前期环境配置..........................................................3三、案例..................................................................41、API授权.................................................................................................................................42、获取Token..............................................................................................................................73、通过API新增单据................................................................................................................84、请求参数..............................................................................................................................11金蝶软件（中国）有限公司K/3服务支持部第2页共12页金蝶知识库文档一、功能介绍K3WISE支持提供开放业务单据及基础资料的API接口，为开发者提供最全面的API服务。客户需要查看API接口说明，可打开【EBDI】-【API平台】-【API】-【API说明】，查阅接口参数调用说明及调用方法。二、前期环境配置使用API说明需先配置APIWEB站点，双击打开【API说明】，弹出站点配置界面,或者在个人工作台下的【系统设置】-【系统设置】-【系统参数配置】-【站点名称配置】进行配置WEBAPI服务器站点:图1目前Wise14.3之后的版本才有API功能，14.3之前的版本只能使用Webservice功能。14.3版本需要先打补丁：PT122582、PT121676；15.0版本需要先打补丁：PT122953、PT122970（建议直接安装当前版本的最新整合补丁）；15.1版本不需要安装补丁。测试API问题推荐使用Postman工具，可到网上下载，建议下载最新版本。金蝶软件（中国）有限公司K/3服务支持部第3页共12页金蝶知识库文档API总体流程:图2Token说明：调用K3API必须首先要获取K3APIToken，然后才能通过Token访问K3API。Token有效时间默认为1个小时，用户可后台配置Token有效时间，请尽量保证声明周期内小频次调用，提升API调用质量。Token有效期设置，K3管理员可通过表t_SystemProfile修改Token有效期，找到记录FCategory等于API，并且FKey等于TokenValidity的记录，修改该记录FValue值即可，以秒为单位。三、案例下面将通过API新增“销售增值税发票”为案例，讲解API应用方法。1、API授权打开【EBDI】-【API平台】-【API】-【API授权】，如图3，在【企业管理】点击“新增”，新增一个企业，“企业代码”、“企业名称”、“企业邮箱”是必录项，邮箱不需要录入真实存在的邮箱，系统不会对这个进行校验，也不影响后续的操作，录完后点击保存即可，如图4。金蝶软件（中国）有限公司K/3服务支持部第4页共12页金蝶知识库文档图3图4新增企业后，点击【授权管理】，对需要使用的接口进行授权，如下图5，对“销售增值税发票”进行授权。点击【设置】，可以对数据开放进行限制，录入条件后系统将按照条件进行权限控制，如下图6。金蝶软件（中国）有限公司K/3服务支持部第5页共12页金蝶知识库文档图5图6在【EBDI】-【API平台】按上述操作完成设置后，代表K3端的参数已经设置完毕，下面可以打开【API说明】，查询需要调用的请求示例，并通过Postman工具进行下一步操作。金蝶软件（中国）有限公司K/3服务支持部第6页共12页金蝶知识库文档2、获取Token设置完授权后，接着我们需要查看API说明，找到我们需要调用的请求示例和请求参数等信息。打开【EBDI】-【API平台】-【API】-【API说明】，在弹出的网页左侧找到“平台类”-“Token”，如下图7，并将“请求示例”中的参数复制粘贴到Postman中，如下图8。图7图8完成图8所示的操作后，打开【EBDI】-【API平台】-【API】-【API授权】-【企业管理】，双击企业test01，将授权码（图4）复制并粘贴到Postman中，如下图9，点击“Send”，系统提示获取Token成功。金蝶软件（中国）有限公司K/3服务支持部第7页共12页金蝶知识库文档图93、通过API新增单据获取Token后，我们再回到【API说明】，左侧找到“财务”-“销售增值税发票”，在“接口列表”选择我们需要用的接口，如下图10，此处我们需要用到“新增”，得到后续要用到的“请求示例”和“请求参数”，如下图11。金蝶软件（中国）有限公司K/3服务支持部第8页共12页金蝶知识库文档图10图11参见图11，将请求示例（示例A）复制粘贴到Postman中，将“GET”修改为“POST”，第二行选择“Body”，第三行选择“raw”，然后继续将请求参数（参数B）复制粘贴到Postman中，如下图12，然后点击“Send”执行传输数据工作。金蝶软件（中国）有限公司K/3服务支持部第9页共12页金蝶知识库文档图12如果构建的请求参数（参数B）编写没问题的话，系统会返回“Successful”的提示，如下图13，此时登录k3，在销售增值税发票序时簿中，能看到传输成功的发票，如下图14。图13金蝶软件（中国）有限公司K/3服务支持部第10页共12页金蝶知识库文档图14通过API修改单据的操作跟新增单据的逻辑一样，先查询到修改的请求示例以及请求参数，然后通过第三方软件传输到K3即可。4、请求参数下面附上一些测试用的请求参数，方便同事们测试API功能：金蝶软件（中国）有限公司K/3服务支持部第11页共12页金蝶知识库文档金蝶软件（中国）有限公司K/3服务支持部第12页共12页
