金蝶账务平台应用到越来越多的行业，为了方便行业ERP在集成时，少走一些弯路，分享一些在集成业务实现方面的一些经验。
欢迎大家补充，共同进步。
一、基础装备
资源 ：http://open.kisdee.com ，新集成厂家，需要先用实际企业信息注册、认证，完成后，可登录，以获得对应的开发密钥。温馨提示：产品需要厂家自己登记，logo请按要求上传，简称一般不超过4个汉字，logo和简称将出现在集成应用的产品中，如上图所示，请不要随意填。
资料：开发文档和资源中心
产品：账务平台V14.0，参考：金蝶KIS账务平台V14.0发版及功能更新清单
工具：调试工具、行业模板工具
下载的时候，注意说明，下载适用于V14.0的产品和工具。
温馨提示：由于集成是通过API服务实现，因此对于行业ERP管理软件 是B/S还是C/S，是用什么数据库，用什么语言开发的，用于什么操作系统上的，没有要求。只要能通过API服务交换数据即可。
二、集成准备
1、梳理出哪些资料要对接：
比如客户、部门、供应商、菜品基础资料分类等，每个对接分类资料里，基本要素：代码、名称。
基本的资料分类，系统已经准备好了。
超出上述001-008之外的基础资料分类，需要行业厂家自行建立。
如果新增资料需要与会计科目对应，可以在项目类别属性上增加，名称可自定义。
在这里定义的核算项目类别，在下载模板到账务平台中后，会在基础资料--核算项目中，自动新增，无需再手动添加项目类别。如果该类别中设置了会计科目属性，在下载模板时也会自动下载。当通过行业软件接口同步资料后，用户可以通过这里维护对应的会计科目，以便于可以在凭证模板上设置科目来源于些会计科目字段，实现根据业务记录自动提取对应的会计科目，形成会计分录。
2、梳理出哪些业务数据要对接：
比如直拨单、收款单等，按类型分类，每个类型里包括哪些字段。
其中：不同的软件中对单据类型有不同的定义，建议在设计对接时，单据类型的定义标准、名称，单据的定义标准、名称与行业软件保持一致，这样极大的减少人为的学习成本，避免不必要的再次理解的成本 。
特别说明：日期、单据类型、单据编号、行号，这四项必须的，这是识别是一组数据的标志之一。每组数据里，必须至少要有一个金额字段。
行业工具中的定义示例：
这此梳理好后，结构定义的工作---包括基础资料和业务数据的，都通过行业模板工具，登录上去定义。温馨提示：如果某项定义中涉及到科目，并且在生成凭证时，希望根据业务单据上的基础资料内容自动对应相应的科目，比如上图，就需要在【在科目来源中可选】上打勾，否则在凭证模板中将选择不到。
定义后好，开发按定义的结构和open.kisdee.com上对就的开发规则，进行填充实现就好。
比如数据：
可通过行业工具设计成这样的
用户下载模板后，效果如下：
其中
开发在实现时，业务数据与行业工具中的定义对应关系，如下，详情参考单据同步API
3、基础资料方面：
如果你们软件有上下级关系的，在同步时，要先同步上级的，再同步下级的。
4、在业务数据方面：
把每种业务抽取为成为一个二维的表格，把需要的字段整理出来。涉及到商品或收银明细的，个人建议按明细传，这样用户是要按明细生成账务的处理，还是按汇总，都可以选择。
在集成阶段和试用阶段，建议先要把精力放在怎么生成凭证上，优先把目标聚焦到怎么生成业务数据上，即确定哪些业务数据需要同步，每种业务数据需要哪些数据字段。
在同步时，每个业务数据，比如一张单据，一般都有多行，建议把每行的明细数据都同步。这样做的好处就是以后在生成凭证时，用户可以根据自己的情况或爱好，按明细或汇总数据生成凭证。
温馨提示：由于不同开发工具的特点、各种环境的影响，在集成开发时，要对所发请求中的参数进行转码（urlencode），否则可能提交后的数据显示为乱码，如：
算出来跟这个网站一样就可以了
http://tool.chinaz.com/Tools/urlencode.aspx
是对请求的各个参数转码，不是对custdata值里的各json字段转码
5、集成参数
在集成参数方面，要包括：企业号、账套信息、访问密码（也可以自行命名）等几个参数。
广域网模式下，不存在互联网访问安全问题，可以只需要账套信息即可。
6、最后再去考虑会计制度、凭证模板的问题。
比较建议在第一家客户beta上线确认后，再去定义凭证模板，这样更好理解。
7、业务系统改造
集成与未集成，在应用管制方面，应该有不同，建议你们同时对自己的业务进行管控：
1）已经同步的数据，包括基础资料和业务数据，不允许取消审核、修改、删除；不然到时两边不一致，都找不到原因了。
2）在同步时，建议增加同步的选择条件设置，以便于用户可选择、判断哪些数据可以同步 了
3）如果要修改，修改后，要重新同步；
4）已经同步后已经生成凭证的单据，不允许修改、删除。要修改删除、必须 先删除凭证。在接口上有单据生成凭证状态的接口调用
8、凭证模板
待调试确认后，初次应用，可以与客户的财务人员一起确定每个业务凭证的内容和分录构成，共同完成凭证模板的定义。
毕业绝大部分的行业ERP人员并不熟悉财务，而客户的财务人员熟悉财务但不了解系统如何实现，一起协同，效率更高。
形成后，以后其他客户使用就非常简单了。
温馨提示：
如果某项定义中涉及到科目，并且在生成凭证时，希望根据业务单据上的基础资料内容自动对应相应的科目，比如下图，
就需要在行业工具中进行单据定义时，在【在科目来源中可选】上打勾，否则在凭证模板中将选择不到。
比如希望能够自动根据调出账户、调入账户来自动确定对应的分录，则需要在定义模板时，【在科目来源中可选】上打勾。
如果如上图所示，将在凭证模板中无法选择科目来源：
正确的单据模板设置应该是：
对应的凭证模板是：
三、业务集成：
1、业务数据行标识
在我们的集成业务里，对于单据，同一个单据，有行号的标识，对于同一张单据，行号不可重复。不知道你们的有没有。这个是用于一个单据上有多行数据时的管理。如果没有，你们要确保行号的唯一。
曾经的案例：之前有过一个惨痛教训：通过集成生成的行号，是动态变化的 ，结果导致他们同步数据时，发现有误或不注意了重复同步，就生成不同的行号，结果就是同步 一次，数据翻倍一次。
一般来说，在业务管理里，都会有行号的管理的，就怕遇到万一。
2、集成参数
在集成参数设置里，每个客户的企业号、账套信息、访问密码等信息都是不同的，建议企业号、访问密码是手工录入的，支持复制、粘贴。账套信息利用接口直接获取，不要手工录入。
曾经的案例：账套信息是手工录入的，结果在实施时，客户的账套实例名命名为Xhome，他在集成参数 里输入的是Xhmoe，然后死活连接不了，以为是接口、集成程序有问题，白白折腾了2天。
3、网络应用模式
局域网应用如果是在局域网上应用，建议保留一个输入局域网IP地址的地方，用于输入金蝶账务平台局域网服务器的IP地址。
同时，由于V14.0里对集成安全机制、性能进行了更多的调整，V14.0与V12.3、V13.0在集成API上有一些差异，对于之前已经完成了V13.0集成的伙伴来说，需要修改接口，支持V14.0。在这种情况下，如果已经实现 的集成在老客户在使用，建议在集成版本上增加一个选择，如上图。不同的版本，使用不同的集成API
4、代码实现
就是根据上面的梳理，结合行业ERP的特性，把基础资料和业务数据同步到金蝶中。金蝶软件API接口服务程序根据接口标准定义进行数据的解析和数据的储存服务。其中：
1）涉及到特殊字符的，需要开发者通过程序先转义处理（参考：http://tool.chinaz.com/Tools/urlencode.aspx )，然后再同步。
2）业务数据中的金额小数位、数量小数位等，需要开发者通过程序先进行格式化处理，然后再同步；金蝶软件API接口服务程序只负责接收合理数据，但不对接收的数据进行任何格式化处理，以确保同步数据的唯一性。
3）金蝶软件API接口服务程序为确保同步数据的来源和标准统一，对同步后形成的数据，在金蝶软件中不提供删除、修改的功能，如果需要变更，请通过删除接口在行业ERP软件中发起。
简单来说，主要包括以下：
1）就是需要把行业ERP中的业务数据，抽象和整理成一类一类的基础资料和数据，通过接口同步到金蝶。
2）行业工具来定义你的数据模板
3）开发者参照接口定义，通过集成接口程序来实现数据同步。更多的接口相关内容，请访问：http://open.kisdee.com/wiki/index.php?n=Site.MethodApi
4）数据同步后，元数据就有了。
5）由于每个业务数据、在每个客户那里都有不一样的定义，所以通过凭证模板，可以定义每种数据的会计分录的凭证模板和生成规则。
6）根据凭证模板和业务数据，就可以生成会计凭证了
四、同步数据查询开发同步实现后，通过集成接口，同步后，可以如下的功能进行数据查询，或执行后续的账务处理：
五、关于科目管理
科目管理主要是要根据实际业务来进行，同时要为报表数据服务。
一个原则：就是你的报表上的数据，如果要想能自动取数，就要有从科目上有对应的来源。报表无法获取分析型的数据。比如你报表上要按部门获得对应的收入、成本 ，那你的乎就需要按部门进行辅助核算或明细核算；从集成应用来看，如果你们的业务单据上都可以包括部门的信息，那么建议使用科目 部门辅助核算这种模式。
一般有设置明细科目和设置辅助核算项目、设置为数量金额辅助核算等的区别。
设置明细科目：一般的零星账户或明细不具有共性的明细，设置为明细科目，比如1002银行存款科目下按开户行设置明细，这些明细银行除了银行存款用到，其他科目基本上不会用到。
设置辅助核算项目：把单据上可以体现的、在多个科目中都会用到的明细信息，可以将这些信息归集为某一类进行集中管理。比如预收账款、应收款账，都会涉及到往来单位--客户，而且某些客户既会在应收账款里核算，又会在预收账款里核算，那么设置这些科目按客户进行辅助核算，则可以只维护一个基础资料，而不必在预收账款、应收款账科目中分别去建立明细科目。
同时，在使用集成账务的时候，如果希望能根据业务数据上的客户信息，自动携带到生成的凭证分录上，这些科目也需要按客户进行辅助核算。
其他科目同理。
数量金额辅助核算：如果科目核算的数量变化、单位变化是在业务系统里有完整的业务过程记录，在账务上设置科目是，科目无需也无必要再设置为数量金额辅助核算模式，因为详细的过程和数据都在业务系统里了，查询具体的数据也是在业务系统里有的。只有个别业务系统不管理但账务上又确实需要管理数量、单价的，还需要核算为数量金额辅助核算模式。
其他涉及到往来管理的设计，参考：金蝶KIS产品中往来业务核算应用模式分享
其他内容，参阅如下内容
相关资源