金蝶云星空和小满OKKICRM接口打通对接实战
对接源平台:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
对接目标系统:小满OKKICRM
小满科技一直以“人工智能+大数据”为核心驱动力，并融入多年深耕CRM行业的经验，为外贸客户提供多场景的解决方案。凭借卓越的服务水准，小满科技先后斩获“年度最佳外贸SaaS服务商”、“2019杰出品牌形象奖”、“2020最佳企业服务平台”、“2020影响未来的产品GREAT100”、“2020最具商业价值品牌等诸多大奖，并于2020年8月获得阿里巴巴D轮融资，行业领先地位不断夯实。
数据接口配置方案
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：金蝶云星空，源系统 API：客户查询，目标系统：小满OKKICRM，目标系统 API推送产品到小满产品库。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
金蝶云星空接口明细
- 接口：executeBillQuery
- 接口名称：客户查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FCUSTID | FCUSTID | string | |
| FNumber | 编码 | string | |
| FName | 名称 | string | |
| FCreateOrgId_FNumber | 创建组织 | string | |
| FUseOrgId_FNumber | 使用组织 | string | |
| FDescription | 描述 | string | |
| FIsTrade | 是否交易客户 | string | |
| FCustTypeId_FNumber | 客户类别 | string | |
| FGroup_FNumber | 客户分组 | string | |
| FSALDEPTID_FNumber | 销售部门 | string | |
| FSELLER_FNumber | 销售员 | string | |
| FSETTLETYPEID_FNumber | 结算方式 | string | |
| FRECCONDITIONID_FNumber | 收款条件 | string | |
| FDISCOUNTLISTID_FNumber | 折扣表 | string | |
| FPRICELISTID_FNumber | 价目表 | string | |
| FTRANSLEADTIME | 运输提前期 | string | |
| FInvoiceType | 发票类型 | string | |
| FTaxType_FNumber | 税分类 | string | |
| FShortName | 简称 | string | |
| FADDRESS | 地址 | string | |
| FZIP | 邮编 | string | |
| FWEBSITE | 首页 | string | |
| FTEL | 电话 | string | |
| FFAX | 传真 | string | |
| FCompanyClassify_FNumber | 公司类别 | string | |
| FCompanyNature_FNumber | 公司性质 | string | |
| FCompanyScale_FNumber | 公司规模 | string | |
| FINVOICETITLE | 发票抬头 | string | |
| FTAXREGISTERCODE | 纳税登记号 | string | |
| FINVOICEBANKNAME | 开户银行 | string | |
| FINVOICETEL | 开票联系电话 | string | |
| FINVOICEBANKACCOUNT | 银行账号 | string | |
| FINVOICEADDRESS | 开票通讯地址 | string | |
| FSUPPLIERID_FNumber | 对应供应商 | string | |
| FIsGroup | 集团客户 | string | |
| FIsDefPayer | 默认付款方 | string | |
| FGROUPCUSTID_FNumber | 对应集团客户 | string | |
| FCOUNTRY1_FNumber | 开户国家 | string | |
| FBANKCODE | 银行账号 | string | |
| FACCOUNTNAME | 账户名称 | string | |
| FBankTypeRec_FNumber | 收款银行 | string | |
| FTextBankDetail | 网点名称 | string | |
| FBankDetail_FNumber | 银行网点 | string | |
| FOpenAddressRec | 开户行地址 | string | |
| FCNAPS | 联行号 | string | |
| FCURRENCYID_FNumber | 币别 | string | |
| FISDEFAULT1 | 默认 | string | |
| FDefaultConsiLoc_FNumber | 默认收货地点 | string | |
| FDefaultSettleLoc_FNumber | 默认开票地点 | string | |
| FDefaultPayerLoc_FNumber | 默认付款地点 | string | |
| FDefaultContact_FNumber | 默认联系人 | string | |
| FMarginLevel | 保证金比例（%） | string | |
| Limit | 最大行数 | string | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | string | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | int | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | string | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | array | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FCUSTID | FCUSTID | string | |
| FNumber | 编码 | string | |
| FName | 名称 | string | |
| FCreateOrgId_FNumber | 创建组织 | string | |
| FUseOrgId_FNumber | 使用组织 | string | |
| FDescription | 描述 | string | |
| FIsTrade | 是否交易客户 | string | |
| FCustTypeId_FNumber | 客户类别 | string | |
| FGroup_FNumber | 客户分组 | string | |
| FSALDEPTID_FNumber | 销售部门 | string | |
| FSELLER_FNumber | 销售员 | string | |
| FSETTLETYPEID_FNumber | 结算方式 | string | |
| FRECCONDITIONID_FNumber | 收款条件 | string | |
| FDISCOUNTLISTID_FNumber | 折扣表 | string | |
| FPRICELISTID_FNumber | 价目表 | string | |
| FTRANSLEADTIME | 运输提前期 | string | |
| FInvoiceType | 发票类型 | string | |
| FTaxType_FNumber | 税分类 | string | |
| FShortName | 简称 | string | |
| FADDRESS | 地址 | string | |
| FZIP | 邮编 | string | |
| FWEBSITE | 首页 | string | |
| FTEL | 电话 | string | |
| FFAX | 传真 | string | |
| FCompanyClassify_FNumber | 公司类别 | string | |
| FCompanyNature_FNumber | 公司性质 | string | |
| FCompanyScale_FNumber | 公司规模 | string | |
| FINVOICETITLE | 发票抬头 | string | |
| FTAXREGISTERCODE | 纳税登记号 | string | |
| FINVOICEBANKNAME | 开户银行 | string | |
| FINVOICETEL | 开票联系电话 | string | |
| FINVOICEBANKACCOUNT | 银行账号 | string | |
| FINVOICEADDRESS | 开票通讯地址 | string | |
| FSUPPLIERID_FNumber | 对应供应商 | string | |
| FIsGroup | 集团客户 | string | |
| FIsDefPayer | 默认付款方 | string | |
| FGROUPCUSTID_FNumber | 对应集团客户 | string | |
| FCOUNTRY1_FNumber | 开户国家 | string | |
| FBANKCODE | 银行账号 | string | |
| FACCOUNTNAME | 账户名称 | string | |
| FBankTypeRec_FNumber | 收款银行 | string | |
| FTextBankDetail | 网点名称 | string | |
| FBankDetail_FNumber | 银行网点 | string | |
| FOpenAddressRec | 开户行地址 | string | |
| FCNAPS | 联行号 | string | |
| FCURRENCYID_FNumber | 币别 | string | |
| FISDEFAULT1 | 默认 | string | |
| FDefaultConsiLoc_FNumber | 默认收货地点 | string | |
| FDefaultSettleLoc_FNumber | 默认开票地点 | string | |
| FDefaultPayerLoc_FNumber | 默认付款地点 | string | |
| FDefaultContact_FNumber | 默认联系人 | string | |
| FMarginLevel | 保证金比例（%） | string | |
小满OKKICRM接口明细
- 接口：/v1/product/push
- 接口名称：推送产品到小满产品库
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| name | 产品名称 | string | 产品名称 |
| product_no | ATC NO | string | ATC NO |
| model | 产品型号 | string | 产品型号 |
| description | 产品描述 | string | 产品描述 |
| images | 产品主图片(url) | string | 产品主图片(url) |
| from_url | 产品链接 | string | 产品链接 |
| 5863804916 | (自定义字段) 产品链接 | string | (自定义字段) 产品链接 |
| 5863826923 | (自定义字段) PTDID | string | (自定义字段) PTDID |
| 5863825103 | (自定义字段) ATCNO | string | (自定义字段) ATCNO |
系统对接概况
全新的API数据集成模式，赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式，基于全新API战略中台的API新型集成方式通过解耦系统资源，降低系统间对接难度，实现快速业务需求响应，提升对接效率，助力企业满足快速业务交付需求，实现业务创新。通过构建API生态，助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产，可实现内部资源共享，满足内部开发人员资源使用需求，例如：小满OKKICRM与金蝶云星空之间数据集成；并将API资源对外可控开放，打造面向开发者的生态服务，为您打通自身和上下游合作伙伴，创造共赢价值链。开展API战略中台，重塑IT 帮助您基于内部资源构建不同业务能力中心，打造企业统一API战略中台，赋能企业发展，实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时，无需从“零”组建各业务模块，提升开发效率，重塑IT组织及交付能力。
