金蝶云星空对接打通钉钉供应商查询接口与更新表单数据（宜搭）接口
数据源平台:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
对接目标平台:钉钉
钉钉（DingTalk）是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化，实现企业管理“人、财、物、事、产、供、销、存”的全链路数字化。
接口方案配置
在轻易云平台进行集成方案的配置时，为了实现快速搭建，轻易云平台还提供了现有的市场方案进行复制参考。用户可以在创建集成方案的时候在第四步选择引用市场方案，参考市场主流所进行的字段配置完成集成方案的自定义化快速配置，即便是第一次使用轻易云平台的用户也能轻松搭建属于自己的数据同步方案。向导式配置，让配置更加清晰，首先确定该方方案的对接内容，第二歩获取筛选数据源平台的数据，第三步数据源与写入目标形成映射关系配置。完成配置后一键启用
金蝶云星空接口明细
- API：executeBillQuery
- NAME：供应商查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FSupplierId | FSupplierId | FSupplierId | |
| FNumber | 编码 | FNumber | |
| FName | 名称 | FName | |
| FCreateOrgId_FNumber | 创建组织 | FCreateOrgId.FNumber | |
| FUseOrgId_FNumber | 使用组织 | FUseOrgId.FNumber | |
| FDescription | 描述 | FDescription | |
| FShortName | 简称 | FShortName | |
| FMinPOValue | 最小订单量 | FMinPOValue | 小数 |
| FCountry_FNumber | 国家 | FCountry.FNumber | 单选辅助资料列表 |
| FBusinessStatus | 业务状态 | FBusinessStatus | 单据状态 |
| FProvincial_FNumber | 地区 | FProvincial.FNumber | 单选辅助资料列表 |
| FFreezeLimit | 冻结范围 | FFreezeLimit | 多选下拉列表 |
| FAddress | 通讯地址 | FAddress | 多行文本 |
| FZip | 邮政编码 | FZip | 文本 |
| FFreezeDate | 冻结日期 | FFreezeDate | 日期 |
| FPurchaserGroupId_FNumber | 采购组 | FPurchaserGroupId.FNumber | 基础资料 |
| FParentSupplierId_FNumber | 汇总公司 | FParentSupplierId.FNumber | 基础资料 |
| FLanguage_FNumber | 语言 | FLanguage.FNumber | 单选辅助资料列表 |
| FWebSite | 公司网址 | FWebSite | 多行文本 |
| FCustomerId_FNumber | 对应客户 | FCustomerId.FNumber | 基础资料 |
| FPayCurrencyId_FNumber | 结算币别 | FPayCurrencyId.FNumber | 基础资料 |
| FSettleTypeId_FNumber | 结算方式 | FSettleTypeId.FNumber | 基础资料 |
| FPayCondition_FNumber | 付款条件 | FPayCondition.FNumber | 基础资料 |
| FSettleId_FNumber | 结算方 | FSettleId.FNumber | 基础资料 |
| FPayAdvanceAmount | 单次预付额度 | FPayAdvanceAmount | 小数 |
| FTaxType_FNumber | 税分类 | FTaxType.FNumber | 单选辅助资料列表 |
| FTaxRegisterCode | 税务登记号 | FTaxRegisterCode | 文本 |
| FTendType_FNumber | 经营类型 | FTendType.FNumber | 单选辅助资料列表 |
| FChargeId_FNumber | 收款方 | FChargeId.FNumber | 基础资料 |
| FInvoiceType | 发票类型 | FInvoiceType | 下拉列表 |
| FTaxRateId_FNumber | 默认税率 | FTaxRateId.FNumber | 基础资料 |
| FFinanceDesc | 描述 | FFinanceDesc | 多行文本 |
| FTrade_FNumber | 行业 | FTrade.FNumber | 单选辅助资料列表 |
| FPRICELISTID_FNumber | 默认价目表 | FPRICELISTID.FNumber | 基础资料 |
| FDiscountListId_FNumber | 默认折扣表 | FDiscountListId.FNumber | 基础资料 |
| FFoundDate | 创立日期 | FFoundDate | 日期 |
| FNeedConfirm | 需要确认 | FNeedConfirm | 复选框 |
| FProviderId_FNumber | 供货方 | FProviderId.FNumber | 基础资料 |
| FLegalPerson | 法人代表 | FLegalPerson | 文本 |
| FWipStockId_FNumber | 默认WIP仓库 | FWipStockId.FNumber | 基础资料 |
| FRegisterFund | 注册资金(万元) | FRegisterFund | 小数 |
| FRegisterCode | 工商登记号 | FRegisterCode | 文本 |
| FVmiBusiness | VMI业务 | FVmiBusiness | 复选框 |
| FSOCIALCRECODE | 统一社会信用代码 | FSOCIALCRECODE | 文本 |
| FTendPermit | 生产经营许可证 | FTendPermit | 文本 |
| FVmiStockId_FNumber | VMI仓库 | FVmiStockId.FNumber | 基础资料 |
| FRegisterAddress | 注册地址 | FRegisterAddress | 多行文本 |
| FDeptId_FNumber | 负责部门 | FDeptId.FNumber | 基础资料 |
| FStaffId_FNumber | 负责人 | FStaffId.FNumber | 基础资料 |
| FSupplierClassify_FNumber | 供应商分类 | FSupplierClassify.FNumber | 单选辅助资料列表 |
| FSupplyClassify | 供应类别 | FSupplyClassify | 下拉列表 |
| FSupplierGrade_FNumber | 供应商等级 | FSupplierGrade.FNumber | 单选辅助资料列表 |
| FGroup | 供应商分组 | FGroup | 分组 |
| FCompanyClassify_FNumber | 公司类别 | FCompanyClassify.FNumber | 单选辅助资料列表 |
| FCompanyNature_FNumber | 公司性质 | FCompanyNature.FNumber | 单选辅助资料列表 |
| FCompanyScale_FNumber | 公司规模 | FCompanyScale.FNumber | 单选辅助资料列表 |
| FCorrespondOrgId_FNumber | 对应组织 | FCorrespondOrgId.FNumber | 组织 |
| FStartDate | 生效日期 | FStartDate | 日期 |
| FEndDate | 失效日期 | FEndDate | 日期 |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} | 金蝶的查询分页参数 |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} | 金蝶的查询分页参数 |
| TopRowCount | 返回总行数 | | 金蝶的查询分页参数 |
| FilterString | 过滤条件 | FAuditDate>='{{LAST_SYNC_TIME datetime}}' | 示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>= |
| FieldKeys | 需查询的字段key集合 | | 金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber |
| FormId | 业务对象表单Id | BD_Supplier | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FSupplierId | FSupplierId | | |
| FNumber | 编码 | | |
| FName | 名称 | | |
| FCreateOrgId_FNumber | 创建组织 | | |
| FUseOrgId_FNumber | 使用组织 | | |
| FDescription | 描述 | | |
| FShortName | 简称 | | |
| FMinPOValue | 最小订单量 | | 小数 |
| FCountry_FNumber | 国家 | | 单选辅助资料列表 |
| FBusinessStatus | 业务状态 | | 单据状态 |
| FProvincial_FNumber | 地区 | | 单选辅助资料列表 |
| FFreezeLimit | 冻结范围 | | 多选下拉列表 |
| FAddress | 通讯地址 | | 多行文本 |
| FZip | 邮政编码 | | 文本 |
| FFreezeDate | 冻结日期 | | 日期 |
| FPurchaserGroupId_FNumber | 采购组 | | 基础资料 |
| FParentSupplierId_FNumber | 汇总公司 | | 基础资料 |
| FLanguage_FNumber | 语言 | | 单选辅助资料列表 |
| FWebSite | 公司网址 | | 多行文本 |
| FCustomerId_FNumber | 对应客户 | | 基础资料 |
| FPayCurrencyId_FNumber | 结算币别 | | 基础资料 |
| FSettleTypeId_FNumber | 结算方式 | | 基础资料 |
| FPayCondition_FNumber | 付款条件 | | 基础资料 |
| FSettleId_FNumber | 结算方 | | 基础资料 |
| FPayAdvanceAmount | 单次预付额度 | | 小数 |
| FTaxType_FNumber | 税分类 | | 单选辅助资料列表 |
| FTaxRegisterCode | 税务登记号 | | 文本 |
| FTendType_FNumber | 经营类型 | | 单选辅助资料列表 |
| FChargeId_FNumber | 收款方 | | 基础资料 |
| FInvoiceType | 发票类型 | | 下拉列表 |
| FTaxRateId_FNumber | 默认税率 | | 基础资料 |
| FFinanceDesc | 描述 | | 多行文本 |
| FTrade_FNumber | 行业 | | 单选辅助资料列表 |
| FPRICELISTID_FNumber | 默认价目表 | | 基础资料 |
| FDiscountListId_FNumber | 默认折扣表 | | 基础资料 |
| FFoundDate | 创立日期 | | 日期 |
| FNeedConfirm | 需要确认 | | 复选框 |
| FProviderId_FNumber | 供货方 | | 基础资料 |
| FLegalPerson | 法人代表 | | 文本 |
| FWipStockId_FNumber | 默认WIP仓库 | | 基础资料 |
| FRegisterFund | 注册资金(万元) | | 小数 |
| FRegisterCode | 工商登记号 | | 文本 |
| FVmiBusiness | VMI业务 | | 复选框 |
| FSOCIALCRECODE | 统一社会信用代码 | | 文本 |
| FTendPermit | 生产经营许可证 | | 文本 |
| FVmiStockId_FNumber | VMI仓库 | | 基础资料 |
| FRegisterAddress | 注册地址 | | 多行文本 |
| FDeptId_FNumber | 负责部门 | | 基础资料 |
| FStaffId_FNumber | 负责人 | | 基础资料 |
| FSupplierClassify_FNumber | 供应商分类 | | 单选辅助资料列表 |
| FSupplyClassify | 供应类别 | | 下拉列表 |
| FSupplierGrade_FNumber | 供应商等级 | | 单选辅助资料列表 |
| FGroup | 供应商分组 | | 分组 |
| FCompanyClassify_FNumber | 公司类别 | | 单选辅助资料列表 |
| FCompanyNature_FNumber | 公司性质 | | 单选辅助资料列表 |
| FCompanyScale_FNumber | 公司规模 | | 单选辅助资料列表 |
| FCorrespondOrgId_FNumber | 对应组织 | | 组织 |
| FStartDate | 生效日期 | | 日期 |
| FEndDate | 失效日期 | | 日期 |
钉钉接口明细
- 调用接口：/v1.0/yida/forms/instances
- 接口名称：更新表单数据（宜搭）
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| textField_ku6aw61h | 编码 | string | {{FNumber}} |
| textField_ku6aw61g | 供应商名称 | string | {{FName}} |
| appType | 应用ID | string | APP_KFJOIBQ7VRMTDLQSLKQG |
| systemToken | 应用秘钥 | string | JR766WA1S5PON0QZXMNBZZKZKPGT1VMYM5OMKO |
| language | 语言 | string | zh_CN |
| formInstId | 要更新的表单数据ID | string | _findCollection find resultId from 9883778a-d6d3-3396-8297-bd204abebda8 where FSupplierId={{FSupplierId}} |
| userId | 钉钉的userId | string | 16000443318138909 |
系统数据集成价值
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到钉钉之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。
