金蝶知识库文档K/3WISEAPI接口应用本文档适用于K/3PLM14.3以上版本，文章指导K/3WISEAPI接口使用环境配置。本文以K/3WISE14.3为例，讲解API接口的配置并运用客户的提单来讲解使用的过程。2018年6月30日V1.0编写人：杨创亮2018年6月30日V2.0修改人：本文件使用须知著作权人保留本文件的内容的解释权，并且仅将本文件内容提供给阁下个人使用。对于内容中所含的版权和其他所有权声明，您应予以尊重并在其副本中予以保留。您不得以任何方式修改、复制、公开展示、公布或分发这些内容或者以其他方式把它们用于任何公开或商业目的。任何未经授权的使用都可能构成对版权、商标和其他法律权利的侵犯。如果您不接受或违反上述约定，您使用本文件的授权将自动终止，同时您应立即销毁任何已下载或打印好的本文件内容。著作权人对本文件内容可用性不附加任何形式的保证，也不保证本文件内容的绝对准确性和绝对完整性。本文件中介绍的产品、技术、方案和配置等仅供您参考，且它们可能会随时变更，恕不另行通知。本文件中的内容也可能已经过期，著作权人不承诺更新它们。如需得到最新的技术信息和服务，您可向当地的金蝶业务联系人和合作伙伴进行咨询。著作权声明著作权所有2018金蝶软件（中国）有限公司。所有权利均予保留。金蝶软件（中国）有限公司K/3服务支持部第1页共16页本期概述版本信息版权信息金蝶知识库文档目录1.概述......................................................................32.配置过程讲解....................................32.1安装IIS并生成站点API..............................................................................32.2API授权设置............................................................82.3安装POSTMAN软件和谷歌浏览器56以上版本...............................102.4获取Token.............................................................112.5获取生产领料单模板示例................................................123.案例讲解.................................................................13金蝶软件（中国）有限公司K/3服务支持部第2页共16页金蝶知识库文档1.概述通过配置能够实现API的使用，通过配置过程介绍和提单处理分析让使用者对API有了使用的基础。本文档旨在让技术支持人员对API问题分析有一个好的参考。2.配置过程讲解2.1安装IIS并生成站点K3API步骤第一步，完整安装web服务器所需要的服务器角色。如图-1所示。图-1IIS安装第二步，使用站点及远程组件配置工具生成K3API站点，全部勾上，完成后站点如图-2所示。金蝶软件（中国）有限公司K/3服务支持部第3页共16页金蝶知识库文档图-2API在web服务器中生成第三步，查看相关服务是否启动，服务为KingdeeK/3BackgroundTaskServicefor.net和KingdeeK/3servicemanagerfor.NET如图-3所示。图-3服务启动金蝶软件（中国）有限公司K/3服务支持部第4页共16页金蝶知识库文档第四步，站点名称配置，在WebAPI服务器站点位置输入http://服务器IP:端口/k3api,如图-4所示。图-4站点配置点击测试提示连接成功，如图-5所示。图-5连接成功第五步，测试打开API页面是否正常，直接在IE浏览器输入http://服务器IP:端金蝶软件（中国）有限公司K/3服务支持部第5页共16页金蝶知识库文档口/k3api站点名称打开经常会报错，进入K3ERP\K3API打开WEB文件，修改错误模式让错误显示如图-6所示。图-6测试站点是否正常正确的打开方式是双击主控台-->EBDI-->API-->API说明打开。注意需默认浏览器为IE。如图-7所示。金蝶软件（中国）有限公司K/3服务支持部第6页共16页金蝶知识库文档图-7选择存放路径打开之后正常的页面如图-8所示：金蝶软件（中国）有限公司K/3服务支持部第7页共16页金蝶知识库文档图-8API页面注意：使用API之前必须安装功能补丁，客户需在服务期内才可以安装。补丁会更新但补丁号不会变，若需要更新，需卸载补丁再安装。14.3版本补丁号为PT122582、PT121676，15.0版本补丁号为PT122953、PT122970，若出现如图-9所示异常多是没有安装补丁所导致。图-9异常页面2.2API授权设置步骤第一步，打开API授权。金蝶软件（中国）有限公司K/3服务支持部第8页共16页金蝶知识库文档图-10API授权位置第二步，进行API授权企业管理设置，点击企业管理->新增，输入企业代码、企业名称和企业邮箱，这三项为必填项，其他可以不填。传输加密是给传输的数据加密可以自己设置密钥。如图-11所示。图-11企业管理页面金蝶软件（中国）有限公司K/3服务支持部第9页共16页金蝶知识库文档第二步，进行授权管理，如果打勾弹出授权框直接关闭即可，如图-12所示。图-12弹出授权框选择自己想要授权的类别并点击保存，如图-13所示。金蝶软件（中国）有限公司K/3服务支持部第10页共16页金蝶知识库文档图-13保存授权2.3安装POSTMAN软件和谷歌浏览器56以上版本安装完成之后，打开的界面，如图-14所示。图-14postman界面2.4获取token步骤第一步，在API授权—企业管理中双击企业代码位置弹出企业管理修改，复制授权码。如图-15所示。金蝶软件（中国）有限公司K/3服务支持部第11页共16页金蝶知识库文档图-15授权码位置第二步，在打开的API站点中找到请求示例，该示例将用于获取Token。图-16Token请求示例位置金蝶软件（中国）有限公司K/3服务支持部第12页共16页金蝶知识库文档第三步，获取Token，输入示例修改企业授权码之后点击Send获取，有限期为1小时。如图-17所示。图-17获取Token2.5获取生产领料单模板示例第一步，点击供应链->生产领料单，复制请求示例。如图-18所示。金蝶软件（中国）有限公司K/3服务支持部第13页共16页金蝶知识库文档图-18生产领料单获取模板示例第二步，在postman中输入获取的示例，将token换成新获取的token，选择post传输，点击Send之后便可看到提示获取成功。如图-19所示。图-19获取生产领料单模板3.案例讲解提单描述：客户描述调用销售订单GetList接口报FPlanMode字段不存在。k3wise自带的api平台接口，调取金蝶接口的销售订单，以前正常，现在不正常了提示："StatusCode":201,"Message":"字段[FPlanMode]不存在该KEY值","Data":null}仔细看提单描述能够发现字段[FPlanMode]有多一个空格。我们测试一下，果然还原了客户的问题，报错和描述一样，如图-20所示。将字段FPlanMode后面空格删除后再发送即正常，如图-21所示。金蝶软件（中国）有限公司K/3服务支持部第14页共16页金蝶知识库文档图-20还原客户问题金蝶软件（中国）有限公司K/3服务支持部第15页共16页金蝶知识库文档图-21正常的情况金蝶软件（中国）有限公司K/3服务支持部第16页共16页
