金蝶云星空对接打通钉钉采购订单查询接口与发起审批实例(官方)接口
数据源平台:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
写入目标:钉钉
钉钉（DingTalk）是阿里巴巴集团专为中国企业打造的免费沟通和协同的多端平台，提供PC版，Web版和手机版，有考勤打卡、签到、审批、日志、公告、钉盘、钉邮等强大功能。
数据集成方案配置
系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：金蝶云星空的接口参数设置，以及设定好目标平台：钉钉的映射，即可启动方案进行测试通过该系统数据集成平台的能力，可以集成的应用系统包括CRM、ERP、钉钉、企业微信、MES、飞书、用友、金蝶等 177 个不同应用系统之间的无代码接口集成，并且每周都在增加新的应用系统接入。
金蝶云星空接口明细
- API：executeBillQuery
- NAME：采购订单查询
- METHOD：POST
请求参数
| 接口字段 | 名称 | 预设值 |
|---|
| FPOOrderEntry_FEntryId | FPOOrderEntry_FEntryId | FPOOrderEntry_FEntryId |
| FID | FID | FID |
| FBillNo | 单据编号 | FBillNo |
| FSourceBillNo | 源单编号 | FSourceBillNo |
| FBillTypeID_FNumber | 单据类型 | FBillTypeID_FNumber |
| FBusinessType | 业务类型 | FBusinessType |
| FSupplierId_FNumber | 供应商 | FSupplierId.FNumber |
| FSettleModeId_FNumber | 结算方式 | FSettleModeId.FNumber |
| FPayConditionId_FNumber | 付款条件 | FPayConditionId.FNumber |
| FDate | 采购日期 | FDate |
| FDocumentStatus | 单据状态 | FDocumentStatus |
| FPreMatchAmountFor | 预付已核销金额 | FPreMatchAmountFor |
| FPayAdvanceBillId_FNumber | 预付单号 | FPayAdvanceBillId.FNumber |
| FPurchaseOrgId_FNumber | 采购组织 | FPurchaseOrgId.FNumber |
| FPurchaseDeptId_FNumber | 采购部门 | FPurchaseDeptId.FNumber |
| FPurchaserGroupId_FNumber | 采购组 | FPurchaserGroupId.FNumber |
| FPurchaserId_FNumber | 采购员 | FPurchaserId.FNumber |
| FProviderId_FNumber | 供货方 | FProviderId.FNumber |
| FSettleId_FNumber | 结算方 | FSettleId.FNumber |
| FChargeId_FNumber | 收款方 | FChargeId.FNumber |
| FCorrespondOrgId_FNumber | 对应组织 | FCorrespondOrgId.FNumber |
| FAssignSupplierId_FNumber | 指定供应商 | FAssignSupplierId.FNumber |
| FMaterialId_FNumber | 物料编码 | FMaterialId.FNumber |
| FBarcode | 零售条形码 | FBarcode |
| FQty | 采购数量 | FQty |
| FDeliveryDate | 交货日期 | FDeliveryDate |
| FLocation | 交货地点 | FLocation |
| FLocationAddress | 交货地址 | FLocationAddress |
| FPrice | 单价 | FPrice |
| FTaxPrice | 含税单价 | FTaxPrice |
| FEntryDiscountRate | 折扣率% | FEntryDiscountRate |
| FEntryDiscount | 折扣额 | FEntryDiscount |
| FEntryTaxRate | 税率% | FEntryTaxRate |
| FEntryTaxAmount | 税额 | FEntryTaxAmount |
| FAllAmount | 价税合计 | FAllAmount |
| FEntryAmount | 金额 | FEntryAmount |
| FRequireOrgId_FNumber | 需求组织 | FRequireOrgId.FNumber |
| FRequireDeptId_FNumber | 需求部门 | FRequireDeptId.FNumber |
| FRequireStaffId_FNumber | 需求人 | FRequireStaffId.FNumber |
| FReceiveOrgId_FNumber | 收料组织 | FReceiveOrgId.FNumber |
| FBranchId_FNumber | 收货门店 | FBranchId.FNumber |
| FReceiveDeptId_FNumber | 收料部门 | FReceiveDeptId.FNumber |
| FEntrySettleOrgId_FNumber | 结算组织 | FEntrySettleOrgId.FNumber |
| FGiveAway | 是否赠品 | FGiveAway |
| FEntryNote | 备注 | FEntryNote |
| FSupMatId | 供应商物料编码 | FSupMatId |
| FSupMatName | 供应商物料名称 | FSupMatName |
| FLot | 批号 | FLot |
| FSupplierLot | 供应商批号 | FSupplierLot |
| FReceiveQty | 累计收料数量 | FReceiveQty |
| FRemainReceiveQty | 剩余收料数量 | FRemainReceiveQty |
| FStockInQty | 累计入库数量 | FStockInQty |
| FRemainStockINQty | 剩余入库数量 | FRemainStockINQty |
| FMrbQty | 累计退料数量 | FMrbQty |
| FCHECKRETQTY | 收料可退数量 | FCHECKRETQTY |
| FSTOCKRETQTY | 库存可退数量 | FSTOCKRETQTY |
| FConsumeSumQty | 消耗汇总数量 | FConsumeSumQty |
| FSrcBillTypeId | 源单类型 | FSrcBillTypeId |
| FSrcBillNo | 源单编号 | FSrcBillNo |
| FReqTraceNo | 需求跟踪号 | FReqTraceNo |
| FMtoNo | 计划跟踪号 | FMtoNo |
| FDEMANDTYPE | 需求来源 | FDEMANDTYPE |
| FDEMANDBILLNO | FDEMANDBILLNO | FDEMANDBILLNO |
| FDEMANDBILLENTRYSEQ | 需求单据行号 | FDEMANDBILLENTRYSEQ |
| FDEMANDBILLENTRYID | 需求单据分录内码 | FDEMANDBILLENTRYID |
| Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} |
| StartRow | 开始行索引 | {{PAGINATION_START_ROW}} |
| TopRowCount | 返回总行数 | |
| FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME}}' |
| FieldKeys | 需查询的字段key集合 | |
| FormId | 业务对象表单Id | 业务对象表单Id |
响应参数
| 接口字段 | 名称 | 预设值 |
|---|
| FPOOrderEntry_FEntryId | FPOOrderEntry_FEntryId | |
| FID | FID | |
| FBillNo | 单据编号 | |
| FSourceBillNo | 源单编号 | |
| FBillTypeID_FNumber | 单据类型 | |
| FBusinessType | 业务类型 | |
| FSupplierId_FNumber | 供应商 | |
| FSettleModeId_FNumber | 结算方式 | |
| FPayConditionId_FNumber | 付款条件 | |
| FDate | 采购日期 | |
| FDocumentStatus | 单据状态 | |
| FPreMatchAmountFor | 预付已核销金额 | |
| FPayAdvanceBillId_FNumber | 预付单号 | |
| FPurchaseOrgId_FNumber | 采购组织 | |
| FPurchaseDeptId_FNumber | 采购部门 | |
| FPurchaserGroupId_FNumber | 采购组 | |
| FPurchaserId_FNumber | 采购员 | |
| FProviderId_FNumber | 供货方 | |
| FSettleId_FNumber | 结算方 | |
| FChargeId_FNumber | 收款方 | |
| FCorrespondOrgId_FNumber | 对应组织 | |
| FAssignSupplierId_FNumber | 指定供应商 | |
| FMaterialId_FNumber | 物料编码 | |
| FBarcode | 零售条形码 | |
| FQty | 采购数量 | |
| FDeliveryDate | 交货日期 | |
| FLocation | 交货地点 | |
| FLocationAddress | 交货地址 | |
| FPrice | 单价 | |
| FTaxPrice | 含税单价 | |
| FEntryDiscountRate | 折扣率% | |
| FEntryDiscount | 折扣额 | |
| FEntryTaxRate | 税率% | |
| FEntryTaxAmount | 税额 | |
| FAllAmount | 价税合计 | |
| FEntryAmount | 金额 | |
| FRequireOrgId_FNumber | 需求组织 | |
| FRequireDeptId_FNumber | 需求部门 | |
| FRequireStaffId_FNumber | 需求人 | |
| FReceiveOrgId_FNumber | 收料组织 | |
| FBranchId_FNumber | 收货门店 | |
| FReceiveDeptId_FNumber | 收料部门 | |
| FEntrySettleOrgId_FNumber | 结算组织 | |
| FGiveAway | 是否赠品 | |
| FEntryNote | 备注 | |
| FSupMatId | 供应商物料编码 | |
| FSupMatName | 供应商物料名称 | |
| FLot | 批号 | |
| FSupplierLot | 供应商批号 | |
| FReceiveQty | 累计收料数量 | |
| FRemainReceiveQty | 剩余收料数量 | |
| FStockInQty | 累计入库数量 | |
| FRemainStockINQty | 剩余入库数量 | |
| FMrbQty | 累计退料数量 | |
| FCHECKRETQTY | 收料可退数量 | |
| FSTOCKRETQTY | 库存可退数量 | |
| FConsumeSumQty | 消耗汇总数量 | |
| FSrcBillTypeId | 源单类型 | |
| FSrcBillNo | 源单编号 | |
| FReqTraceNo | 需求跟踪号 | |
| FMtoNo | 计划跟踪号 | |
| FDEMANDTYPE | 需求来源 | |
| FDEMANDBILLNO | 需求单据编号 | |
| FDEMANDBILLENTRYSEQ | 需求单据行号 | |
| FDEMANDBILLENTRYID | 需求单据分录内码 | |
钉钉接口明细
- 接口：topapi/processinstance/create
- 接口名称：发起审批实例(官方)
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 |
|---|
| form_component_values | form_component_values | array |
| ext_value | ext_value | string |
| name | name | string |
| dept_id | dept_id | string |
| process_code | process_code | string |
| value | value | string |
| originator_user_id | originator_user_id | string |
系统数据集成价值
从API服务总线层面解决企业烟囱式业务系统集成现状 相互连接企业各业务系统，实现流程端到端打通，复用已有的业务系统能力，让集成架构、服务关系更清晰 使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
