金蝶云星空对接打通金蝶云星空应付单查询接口与应付单新增接口
对接源平台:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上,提供了标准的管理模式;通过标准的业务架构:多会计准则、多币别、多地点、多组织、多税制应用框架等,有效支持企业的运营管理;K/3Cloud提供了标准的业务建模:35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合,288个业务服务构件,让企业及伙伴可快速构建出行业化及个性化的应用。
对接系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据接口配置方案
通过轻易云系统数据集成平台:数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统:金蝶云星空,然后选择对应的连接器。选择对应的executeBillQuery作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器(关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息)。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。
金蝶云星空接口明细
- 调用接口:executeBillQuery
- 接口名称:应付单查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
---|---|---|---|
Limit | 最大行数 | string | {{PAGINATION_PAGE_SIZE}} |
FormId | 业务对象表单Id | string | AP_Payable |
FieldKeys | 需查询的字段key集合 | array | |
TopRowCount | 返回总行数 | int | |
FilterString | 过滤条件 | string | |
StartRow | 开始行索引 | string | {{PAGINATION_START_ROW}} |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
---|---|---|---|
FID | 实体主键 | String | |
FBillNo | 单据编号 | String | |
FDOCUMENTSTATUS | 单据状态 | String | |
FRelateHadPayAmount | 表头基本 | String | |
FDATE | 业务日期 | String | |
FSETTLEORGID | 结算组织 | String | |
FNOTWRITTENOFFAMOUNTFOR | 表头基本 | String | |
FCURRENCYID | 币别 | String | |
FBillTypeID | 单据类型 | String | |
FModifierId | 修改人 | int | |
FAPPROVEDATE | 审核日期 | String | |
FCreateDate | 创建日期 | String | |
FModifyDate | 修改日期 | String | |
FAPPROVERID | 审核人 | String | |
FWRITTENOFFSTATUS | 付款核销状态 | String | |
FOPENSTATUS | 开票核销状态 | String | |
FCreatorId | 创建人 | String | |
FALLAMOUNTFOR | 价税合计 | String | |
FENDDATE_H | 到期日 | String | |
FOWNERTYPE | 货主类型 | String | |
FOWNERID | 货主 | String | |
FACCOUNTSYSTEM | 会计核算体系 | String | |
FISTAX | 按含税单价录入 | String | |
FCancellerId | 作废人 | String | |
FCancelDate | 作废日期 | String | |
FCancelStatus | 作废状态 | String | |
FPayConditon | 付款条件 | String | |
FSUPPLIERID | 供应商 | String | |
FPURCHASEORGID | 采购组织 | String | |
FBUSINESSTYPE | 业务类型 | String | |
FPURCHASEDEPTID | 采购部门 | String | |
FPURCHASERGROUPID | 采购组 | String | |
FPURCHASERID | 采购员 | String | |
FSourceBillType | 源单类型 | String | |
FISINIT | 是否期初单据 | String | |
FINSTOCKBUSTYPE | 入库单业务类型 | String | |
FMRBBUSTYPE | 退料单业务类型 | String | |
FPAYORGID | 付款组织 | String | |
FISBYIV | 是发票审核自动生成 | String | |
FISGENHSADJ | 是否需要成本调整 | String | |
FISTAXINCOST | 税额计入成本 | String | |
FMatchMethodID | 核销方式 | String | |
FISPRICEEXCLUDETAX | 价外税 | String | |
FAP_Remark | 备注 | String | |
FSetAccountType | 立账类型 | String | |
FISHookMatch | 参与暂估应付核销 | String | |
FIsWriteOff | 转销 | String | |
FISINVOICEARLIER | 先到票后入库 | String | |
FRedBlue | 红蓝字 | String | |
FByVerify | 生成方式 | String | |
FScanPoint | 扫描点 | String | |
FISCASHPURCHASE | 现购 | String | |
FOUTSUPPLIERID | 转出供应商 | String | |
FISINSIDEBILL | 外部单据 | String | |
FBILLMATCHLOGID | 开票核销记录序号 | String | |
FWBOPENQTY | 反写开票数量 | String | |
FPRESETBASE1 | 预设基础资料字段1 | String | |
FPRESETBASE2 | 预设基础资料字段2 | String | |
FPRESETTEXT1 | 预设文本字段1 | String | |
FPRESETTEXT2 | 预设文本字段2 | String | |
FPRESETASSISTANT2 | 预设辅助资料字段2 | String | |
FPRESETASSISTANT1 | 预设辅助资料字段1 | String | |
FIsGeneratePlanByCostItem | 按费用项目生成计划 | String | |
FEntityDetail | 明细 | array | |
FEntityDetail.FEntryID | 实体主键 | String | |
FEntityDetail.FMATERIALID | 物料编码 | String | |
FEntityDetail.FMaterialName | 物料名称 | String | |
FEntityDetail.FModel | 规格型号 | String | |
FEntityDetail.FMaterialType | 物料类别 | String | |
FEntityDetail.FPrice | 单价 | String | |
FEntityDetail.FTaxPrice | 含税单价 | String | |
FEntityDetail.FPriceCoefficient | 价格系数 | String | |
FEntityDetail.FPriceQty | 计价数量 | String | |
FEntityDetail.FDISCOUNTAMOUNTFOR | 折扣额 | String | |
FEntityDetail.FEntryDiscountRate | 折扣率(%) | String | |
FEntityDetail.FNoTaxAmountFor_D | 不含税金额 | String | |
FEntityDetail.FEntryTaxRate | 税率(%) | String | |
FEntityDetail.FTAXAMOUNTFOR_D | 税额 | String | |
FEntityDetail.FALLAMOUNTFOR_D | 价税合计 | String | |
FEntityDetail.FComment | 备注 | String | |
FEntityDetail.FIVALLAMOUNTFOR | 采购发票价税合计 | String | |
FEntityDetail.FDISCOUNTAMOUNT | 折扣额本位币 | String | |
FEntityDetail.FTAXAMOUNT_D | 税额本位币 | String | |
FEntityDetail.FALLAMOUNT_D | 价税合计本位币 | String | |
FEntityDetail.FNOTAXAMOUNT_D | 不含税金额本位币 | String | |
FEntityDetail.FOPENSTATUS_D | 开票核销状态 | String | |
FEntityDetail.FOPENAMOUNTFOR_D | 已开票核销金额 | String | |
FEntityDetail.FORDERNUMBER | 采购订单号 | String | |
FEntityDetail.FPRICEUNITID | 计价单位 | String | |
FEntityDetail.FBASICUNITID | 基本单位 | String | |
FEntityDetail.FBASICUNITQTY | 计价基本数量 | String | |
FEntityDetail.FPriceWithTax | 含税净价 | String | |
FEntityDetail.FBaseJoinQty | 基本单位关联数量 | String | |
FEntityDetail.FSOURCETYPE | 源单类型 | String | |
FEntityDetail.FSourceBillNo | 源单编号 | String | |
FEntityDetail.FTaxCombination | 税组合 | String | |
FEntityDetail.FBUYIVBASICQTY | 采购发票基本单位数量 | String | |
FEntityDetail.FBUYIVQTY | 采购发票数量 | String | |
FEntityDetail.FOPENQTY_D | 已开票核销数量 | String | |
FEntityDetail.FTEMPTAXRATE | 卖家代扣增值税税率 | String | |
FEntityDetail.FMatchNotTaxAmtFor | 已核销不含税金额 | String | |
FEntityDetail.FHadMatchAmountFor | 已开票金额 | String | |
FEntityDetail.FSettleTran | 结算清单调拨类型 | String | |
FEntityDetail.FSpecialQTY | 特殊核销数量 | String | |
FEntityDetail.FSpecialAmountFor | 特殊核销金额 | String | |
FEntityDetail.FBizEntryId | 业务单据分录内码 | String | |
FEntityDetail.FBizID | 业务单据内码 | String | |
FEntityDetail.FBizBillTypeId | 业务单据类型 | String | |
FEntityDetail.FBizBillNo | 业务单据编号 | String | |
FEntityDetail.FBizFormId | 业务单据名称 | String | |
FEntityDetail.FMaterialDesc | 物料说明 | String | |
FEntityDetail.FALLOCATESTATUS | 分配状态 | String | |
FEntityDetail.FHOOKSTATUS | 勾稽状态 | String | |
FEntityDetail.FCOSTID | 费用项目编码 | String | |
FEntityDetail.FCostName | 费用项目名称 | String | |
FEntityDetail.FINCLUDECOST | 计入成本 | String | |
FEntityDetail.FINSTOCKID | 入库单号 | String | |
FEntityDetail.FOUTSTOCKID | 出库单号 | String | |
FEntityDetail.FISOUTSTOCK | 是否有出库单号 | String | |
FEntityDetail.FCOSTDEPARTMENTID | 费用承担部门 | String | |
FEntityDetail.FAUXPROPID | 辅助属性 | String | |
FEntityDetail.FF100001 | 规格尺寸 | String | |
FEntityDetail.FF100002 | 颜色 | String | |
FEntityDetail.FLot | 批号 | String | |
FEntityDetail.FASSETID | 卡片编码 | String | |
FEntityDetail.FASSETNAME | 资产名称 | String | |
FEntityDetail.FMONUMBER | 生产订单编号 | String | |
FEntityDetail.FMOENTRYSEQ | 生产订单行号 | String | |
FEntityDetail.FOPNO | 工序计划号 | String | |
FEntityDetail.FSEQNUMBER | 序列号 | String | |
FEntityDetail.FOPERNUMBER | 工序号 | String | |
FEntityDetail.FPROCESSID | 作业 | String | |
FEntityDetail.FFPRODEPARTMENTID | 生产车间 | String | |
FEntityDetail.FWWINTYPE | 入库类型 | String | |
FEntityDetail.FIsFree | 是否赠品 | String | |
FEntityDetail.FStockUnitId | 库存单位 | String | |
FEntityDetail.FStockBaseQty | 库存基本数量 | String | |
FEntityDetail.FStockQty | 库存数量 | String | |
FEntityDetail.FPriceBaseDen | 计价基本分母 | String | |
FEntityDetail.FStockBaseNum | 库存基本分子 | String | |
FEntityDetail.FOrderEntryID | 采购订单明细内码 | String | |
FEntityDetail.FORDERENTRYSEQ | 采购订单行号 | String | |
FEntityDetail.FPAYMENTAMOUNT | 已结算金额 | String | |
FEntityDetail.FBUYIVINIQTY | 采购发票数量期初 | String | |
FEntityDetail.FBUYIVINIBASICQTY | 采购发票基本单位数量期初 | String | |
FEntityDetail.FIVINIALLAMOUNTFOR | 采购发票价税合计期初 | String | |
FEntityDetail.FPushRedQty | 已下推负数财务应付数量 | String | |
FEntityDetail.FSRCROWID | 源单行内码 | String | |
FEntityDetail.FISINVOICEALLARRIVED | 已完全到票 | String | |
FEntityDetail.FBarcode | 零售条形码 | String | |
FEntityDetail.FDIFFAMOUNT | 成本差异金额 | String | |
FEntityDetail.FDIFFALLAMOUNT | 价税合计差异金额 | String | |
FEntityDetail.FDIFFAMOUNTEXRATE | 成本汇率差异金额 | String | |
FEntityDetail.FDIFFALLAMOUNTEXRATE | 价税合计汇率差异金额 | String | |
FEntityDetail.FNORECEIVEAMOUNT | 未结算金额 | String | |
FEntityDetail.FNOINVOICEAMOUNT | 未开票核销金额 | String | |
FEntityDetail.FNOINVOICEQTY | 未开票核销数量 | String | |
FEntityDetail.FROOTSETACCOUNTTYPE | 源立账类型 | String | |
FEntityDetail.FROOTSOURCETYPE | 源应付单源单类型 | String | |
FEntityDetail.FOPENAMOUNT | 已核销金额本位币 | String | |
FEntityDetail.Fmatchnottaxamt | 已核销不含税金额本位币 | String | |
FEntityDetail.FEntityDetail_FEntryID | FEntityDetail_FEntryID | string |
金蝶云星空接口明细
- 调用接口:batchSave
- 接口名称:应付单新增
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
---|---|---|---|
FBillTypeID | 单据类型 | string | QTYFD01_SYS |
FBillNo | 单据编号 | string | {{id}} |
FDATE | 业务日期 | string | function FROM_UNIXTIME( ( {{expenseDate}} / 1000 ) ,'%Y-%m-%d %H:%i:%S' ) |
FCONTACTUNITTYPE | 往来单位类型 | string | BD_Supplier |
FCONTACTUNIT | 往来单位 | string | 2201 |
FCURRENCYID | 币别 | string | PRE001 |
FSETTLEORGID | 结算组织 | string | 100 |
FPAYORGID | 付款组织 | string | 100 |
FRemarks | 备注 | string | {{remark}} |
FSettleTypeID | 结算方式 | string | |
FMAINBOOKSTDCURRID | 本位币 | string | PRE001 |
FEXCHANGETYPE | 汇率类型 | string | HLTX01_SYS |
FExchangeRate | 汇率 | string | 1.0 |
FNOTAXAMOUNT | 不含税金额本位币 | string | |
FTAXAMOUNT | 税额本位币 | string | |
FACCNTTIMEJUDGETIME | 到期日计算日期 | string | _function FROM_UNIXTIME( ( {{expenseDate}} / 1000 ) ,'%Y-%m-%d %H:%i:%S' ) |
FCancelStatus | 作废状态 | string | A |
FBUSINESSTYPE | 业务类型 | string | T |
FEntity | 单据明细 | array | details |
FEntity.FCOSTID | 费用项目编码 | string | FYXM02_SYS |
FEntity.FCOSTDEPARTMENTID | 费用承担部门 | string | BM000002 |
FEntity.FINVOICETYPE | 发票类型 | string | |
FEntity.FEntryTaxRate | 税率(%) | string | A |
FEntity.FNOTAXAMOUNTFOR | 不含税金额 | string | {{details.amount}} |
FEntity.FTAXAMOUNTFOR | 税额 | string | |
FEntity.FCOMMENT | 备注 | string | |
FEntity.FSourceBillNo | 源单编号 | string | |
FEntity.FormId | 业务对象表单Id | string | AP_OtherPayable |
FEntity.Operation | 执行的操作 | string | BatchSave |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | true |
FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | false |
系统对接概况
随着企业数字化业务的深入发展,对于企业的 IT 或者 CIO 来讲,正在面临一个愈发重要的问题——系统的结构太复杂了,尤其是头部企业,至少有十多套系统,这些系统之间的蛛网状的接口如果经常出问题。企业内部以及企业内部与外部建立起越来越多的业务应用系统,如何整合企业的现有IT资源,使企业中计算机孤岛式的应用向集体协作的方向发展,发挥资源效益的最大化,降低企业成本,正在逐渐成为企业关注的重要问题。用户希望企业内所有系统集成在一个平台上,操作统一,以节省培训时间。使用在轻易云应用集成平台 + MDM基础数据平台的解决方案中,轻易云应用集成平台负责实现异构、分布式系统之间互联互通,实现服务API治理以及数据传输交换。通过轻易云预置的各种适配器组件,连接现有各孤立应用系统,以图形化、拖拽方式构建集成流程和服务,提高应用系统集成工作效率,降低异构系统集成风险。针对未来可能出现的业务需求变更,在应用集成平台上进行动态调整,实现各应用系统之间的集成策略平滑升级。