金蝶云星空与钉钉对接集成逐个单据查询打通发起审批实例(官方)

来源系统:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

集成系统:钉钉

钉钉是阿里巴巴集团打造的企业级智能移动办公平台，是数字经济时代的企业组织协同办公和应用开发平台。钉钉将IM即时沟通、钉钉文档、钉闪会、钉盘、Teambition、OA审批、智能人事、钉工牌、工作台深度整合，打造简单、高效、安全、智能的数字化未来工作方式，助力企业的组织数字化和业务数字化。

数据接口配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：金蝶云星空接口：逐个单据查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：钉钉接口：发起审批实例(官方)，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：钉钉写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

金蝶云星空接口明细

• API：ExecuteBillQuery

• NAME：逐个单据查询

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
Limit	最大行数	{{PAGINATION_PAGE_SIZE}}	金蝶的查询分页参数
StartRow	开始行索引	{{PAGINATION_START_ROW}}	金蝶的查询分页参数
TopRowCount	返回总行数		金蝶的查询分页参数
FilterString	过滤条件	FApproveDate>='{{LAST_SYNC_TIME datetime}}'	示例写法 FSupplierId.FNumber = 'VEN00010' and FApproveDate>=
FieldKeys	需查询的字段key集合		金蝶分录主键ID格式：FPOOrderEntry_FEntryId,其它格式 FPurchaseOrgId.FNumber
FormId	业务对象表单Id	PUR_PurchaseOrder	必须填写金蝶的表单ID如 UR_PurchaseOrder

响应参数

接口字段	字段名称	预设值	描述
BillNo	单据编号
DocumentStatus	单据状态
Date	采购日期
PurchaseOrgId_Id	采购组织Id
PurchaseOrgId_Name	采购组织_名称
PurchaseOrgId_Number	采购组织编码
SupplierId_Id	供应商_Id
SupplierId_Name	供应商名称
SupplierId_Number	供应商_编码
PurchaserGroupId_Id	采购组Id
PurchaserGroupId_Name	采购组_名称
PurchaserGroupId_Number	采购组编码
PurchaseDeptId_Id	采购部门_Id
PurchaseDeptId_Name	采购部门名称
PurchaseDeptId_Number	采购部门_编码
CreatorId_Id	创建人Id
CreatorId_Name	创建人_名称
CreatorId_Number	创建人编码
CreateDate	创建日期
ModifierId_Id	最后修改人_Id
ModifierId_Name	最后修改人名称
ModifierId_Number	最后修改人_编码
ModifyDate	最后修改日期
ApproverId_Id	审核人Id
ApproverId_Name	审核人_名称
ApproverId_Number	审核人编码
ApproveDate	审核日期
CancellerId_Id	作废人_Id
CancellerId_Name	作废人名称
CancellerId_Number	作废人_编码
CancelDate	作废日期
CancelStatus	作废状态
CloseStatus	关闭状态
PurchaserId_Id	采购员Id
PurchaserId_Name	采购员_名称
PurchaserId_Number	采购员编码
CloserId_Id	关闭人_Id
CloserId_Name	关闭人名称
CloserId_Number	关闭人_编码
CloseDate	关闭日期
BillTypeId	单据类型
SettleId_Id	结算方Id
SettleId_Name	结算方_名称
SettleId_Number	结算方编码
ChargeId_Id	收款方_Id
ChargeId_Name	收款方名称
ChargeId_Number	收款方_编码
ProviderId_Id	供货方Id
ProviderId_Name	供货方_名称
ProviderId_Number	供货方编码
ChangerId_Id	变更人_Id
ChangerId_Name	变更人名称
ChangerId_Number	变更人_编码
VersionNo	版本号
ChangeDate	变更日期
ChangeReason	变更原因
BusinessType	业务类型
ProviderAddress	供货方地址
AssignSupplierId_Id	指定供应商Id
AssignSupplierId_Name	指定供应商_名称
AssignSupplierId_Number	指定供应商编码
CorrespondOrgId_Id	对应组织_Id
CorrespondOrgId_Name	对应组织名称
CorrespondOrgId_Number	对应组织_编码
ProviderContact	供货方联系人(旧)
NETORDERBILLNO	供应商协同平台订单编号(6.1废弃)
NetOrderBillId	供应商协同平台订单ID(6.1废弃)
ConfirmStatus	确认状态
ConfirmerId_Id	确认人Id
ConfirmerId_Name	确认人_名称
ConfirmerId_Number	确认人编码
ConfirmDate	确认日期
ProviderContactId_Id	供货方联系人_Id
ProviderContactId_Name	供货方联系人名称
ProviderContactId_Number	供货方联系人_编码
FSourceBillNo	源单编号
ChangeStatus	变更状态
FACCTYPE	验收方式
FRelReqStatus	释放采购申请
MANUALCLOSE	手工关闭
ProviderEMail	邮箱
CloseReason	关闭原因
IsMobBill	移动单据
IsUseDrpSalePOPush	分销销售订单生成
IsCreateStraightOutIN	生成直运出入库
F_yckd_CheckBox	新品订单
POOrderFinance	财务信息

钉钉接口明细

• 接口：topapi/processinstance/create

• 接口名称：发起审批实例(官方)

• 接口方法：POST

请求参数

字段	名称	类型	描述
process_code	审批流的唯一码	string	process_code在审批流程编辑页面的URL网址中获取。
originator_user_id	发起人	string	审批实例发起人的userid。
dept_id	发起人所在部门	string	发起人所在的部门，如果发起人属于根部门，传-1。
form_component_values	审批流表单参数	object
form_component_values.name
form_component_values.value		string
form_component_values.单据编码
form_component_values.供应商		string
form_component_values.采购日期
form_component_values.表格		array
form_component_values.表格.物料编码
form_component_values.表格.物料名称		string
form_component_values.表格.数量
form_component_values.表格.支付方式		string

系统对接概况

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。