从金蝶云星空到聚水潭通过接口集成数据

源系统:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
目标系统:聚水潭
聚水潭SaaSERP于2014年4月上线,目前累计超过2.5万商家注册使用,成为淘宝应用服务市场ERP类目商家数和商家月订单增速最快的ERP。2014年及2015年“双十一”当天,聚水潭SaaSERP平稳、安全、顺畅的处理了近千万订单,超过了淘宝对ERP系统吞吐量极限要求的16倍,成为行业里的新标杆。截止目前,聚水潭客户已超2.5万家,其中有南极人、POVOS奔腾,恒源祥,柚子美衣,洁丽雅,FLYCO飞科,波司登,满速,欧丝璐等,并与知名电商圈“老A电商学院”达成深度合作。
多系统对接方案配置
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程,将金蝶云星空、聚水潭之间接口数据联通,支持数据在线预览、数据集成流程全过程调试,Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能,用户通过可视化的拖、拽即可完成数据处理逻辑,将数据加工处理后分发到下游业务系统或其他异构存储中。


金蝶云星空接口明细
- API:executeBillQuery
- NAME:采购退料查询
- METHOD:POST
请求参数
接口字段 | 名称 | 预设值 |
FPURMRBENTRY_FEntryID | 明细信息ID | FPURMRBENTRY_FEntryID |
FID | 实体主键 | FID |
FBillNo | 单据编号 | FBillNo |
FDocumentStatus | 单据状态 | FDocumentStatus |
FStockOrgId_FNumber | 退料组织 | FStockOrgId.FNumber |
FDate | 退料日期 | FDate |
FBillTypeID_FNumber | 单据类型 | FBillTypeID.FNumber |
FTAKEDELIVERYNO | 提货单号 | FTAKEDELIVERYNO |
FSupplierID_FNumber | 供应商 | FSupplierID.FNumber |
FDESCRIPTION | 备注 | FDESCRIPTION |
FCarrierID_FNumber | 承运商 | FCarrierID.FNumber |
FDELIVERYNO | 送货单号 | FDELIVERYNO |
FPurchaseOrgId_FNumber | 采购组织 | FPurchaseOrgId.FNumber |
FMRTYPE | 退料类型 | FMRTYPE |
FMRMODE | 退料方式 | FMRMODE |
FMRREASON | 退料原因 | FMRREASON |
FREPLENISHMODE | 补料方式 | FREPLENISHMODE |
FCreateDate | 创建日期 | FCreateDate |
FModifyDate | 最后修改日期 | FModifyDate |
FApproveDate | 审核日期 | FApproveDate |
FCreatorId | 创建人 | FCreatorId |
FApproverId | 审核人 | FApproverId |
FCancelerId | 作废人 | FCancelerId |
FCancelDate | 作废日期 | FCancelDate |
FCARRYNO | 运输单号 | FCARRYNO |
FCancelStatus | 作废状态 | FCancelStatus |
FACCEPTORID_FNumber | 接收方 | FACCEPTORID.FNumber |
FSettleId_FNumber | 结算方 | FSettleId.FNumber |
FBusinessType | 业务类型 | FBusinessType |
FAcceptAddress | 接收方地址 | FAcceptAddress |
FCHARGEID_FNumber | 收款方 | FCHARGEID.FNumber |
FAPSTATUS | 应付状态 | FAPSTATUS |
FTransferBizType | 跨组织业务类型 | FTransferBizType |
FCorrespondOrgId_FNumber | 对应组织 | FCorrespondOrgId.FNumber |
FSupplyOrderNo | 订单号 | FSupplyOrderNo |
FPayOrgId_FNumber | 付款组织 | FPayOrgId.FNumber |
FSettleOrgId_FNumber | 结算组织 | FSettleOrgId.FNumber |
FSETTLETYPEID_FNumber | 结算方式 | FSETTLETYPEID.FNumber |
FPAYCONDITIONID_FNumber | 付款条件 | FPAYCONDITIONID.FNumber |
FSettleCurrId_FNumber | 结算币别 | FSettleCurrId.FNumber |
FBILLTAXAMOUNT | 税额 | FBILLTAXAMOUNT |
FBILLCOSTAMOUNT | 总成本 | FBILLCOSTAMOUNT |
FBILLALLAMOUNT | 价税合计 | FBILLALLAMOUNT |
FEXCHANGETYPEID_FNumber | 汇率类型 | FEXCHANGETYPEID.FNumber |
FIsIncludedTax | 含税 | FIsIncludedTax |
FBillAmount | 金额 | FBillAmount |
FISGENFORIOS | 跨组织结算生成 | FISGENFORIOS |
FSettleSupplierID_FNumber | 结算组织供应商 | FSettleSupplierID.FNumber |
FISPRICEEXCLUDETAX | 价外税 | FISPRICEEXCLUDETAX |
FISINVOICEARLIER | 先到票后入库 | FISINVOICEARLIER |
FTHIRDSRCTYPE | 第三方来源 | FTHIRDSRCTYPE |
FTHIRDBILLID | 第三方单据ID | FTHIRDBILLID |
FTHIRDBILLNO | 第三方单据编号 | FTHIRDBILLNO |
FMATERIALID_FNumber | 物料编码 | FMATERIALID.FNumber |
FMATERIALID_FBARCODE | 条码 | FMATERIALID.FBARCODE |
FREPLENISHQTY | 补料数量 | FREPLENISHQTY |
FKEAPAMTQTY | 扣款数量 | FKEAPAMTQTY |
FSTOCKID_FNumber | 仓库 | FSTOCKID.FNumber |
FStockStatusId | 库存状态 | FStockStatusId |
FNOTE | 备注 | FNOTE |
FProduceDate | 生产日期 | FProduceDate |
FEXPIRYDATE | 到期日 | FEXPIRYDATE |
FCONTRACTNO | 合同单号 | FCONTRACTNO |
FREQTRACENO | 需求跟踪号 | FREQTRACENO |
FORDERNO | 订单单号 | FORDERNO |
FPRICEUNITQTY | 计价数量 | FPRICEUNITQTY |
FCostPrice | 成本价 | FCostPrice |
FTAXPRICE | 含税单价 | FTAXPRICE |
FDISCOUNTRATE | 折扣率(%) | FDISCOUNTRATE |
FTAXNETPRICE | 净价 | FTAXNETPRICE |
FENTRYCOSTAMOUNT | 总成本 | FENTRYCOSTAMOUNT |
FENTRYTAXRATE | 税率 | FENTRYTAXRATE |
FENTRYTAXAMOUNT | 税额 | FENTRYTAXAMOUNT |
FALLAMOUNT | 价税合计 | FALLAMOUNT |
FOWNERID_FNumber | 货主 | FOWNERID.FNumber |
FJOINQTY | 关联数量 | FJOINQTY |
FRMREALQTY | 实退数量 | FRMREALQTY |
FRMMUSTQTY | 应退数量 | FRMMUSTQTY |
FSTOCKLOCID | 仓位 | FSTOCKLOCID |
FSRCBillTypeId | 源单类型 | FSRCBillTypeId |
FSRCBillNo | 源单编号 | FSRCBillNo |
FLot_FNumber | 批号 | FLot.FNumber |
FPrice | 单价 | FPrice |
FAmount | 金额 | FAmount |
FDiscount | 折扣额 | FDiscount |
FBFLowId | 业务流程 | FBFLowId |
FSRCSeq | 源单行号 | FSRCSeq |
FMtoNo | 计划跟踪号 | FMtoNo |
FIsStock | 是否可库存 | FIsStock |
FGiveAway | 是否赠品 | FGiveAway |
FRowId | 行标识 | FRowId |
FParentRowId | 父行标识 | FParentRowId |
FBarcode | 零售条形码 | FBarcode |
Limit | 最大行数 | {{PAGINATION_PAGE_SIZE}} |
StartRow | 开始行索引 | {{PAGINATION_START_ROW}} |
TopRowCount | 返回总行数 | |
FilterString | 过滤条件 | FApproveDate>='{{LAST_SYNC_TIME dateTime}}' AND FDocumentStatus = 'C' AND FStockId.FNumber IN ('11084916') AND FMATERIALID.FIsSalseByNet=1 |
FieldKeys | 需查询的字段key集合 | |
FormId | 业务对象表单Id | PUR_MRB |
响应参数
接口字段 | 名称 | 预设值 |
FPURMRBENTRY_FEntryID | 明细信息ID | |
FID | 实体主键 | |
FBillNo | 单据编号 | |
FDocumentStatus | 单据状态 | |
FStockOrgId_FNumber | 退料组织 | |
FDate | 退料日期 | |
FBillTypeID_FNumber | 单据类型 | |
FTAKEDELIVERYNO | 提货单号 | |
FSupplierID_FNumber | 供应商 | |
FDESCRIPTION | 备注 | |
FCarrierID_FNumber | 承运商 | |
FDELIVERYNO | 送货单号 | |
FPurchaseOrgId_FNumber | 采购组织 | |
FMRTYPE | 退料类型 | |
FMRMODE | 退料方式 | |
FMRREASON | 退料原因 | |
FREPLENISHMODE | 补料方式 | |
FCreateDate | 创建日期 | |
FModifyDate | 最后修改日期 | |
FApproveDate | 审核日期 | |
FCreatorId | 创建人 | |
FApproverId | 审核人 | |
FCancelerId | 作废人 | |
FCancelDate | 作废日期 | |
FCARRYNO | 运输单号 | |
FCancelStatus | 作废状态 | |
FACCEPTORID_FNumber | 接收方 | |
FSettleId_FNumber | 结算方 | |
FBusinessType | 业务类型 | |
FAcceptAddress | 接收方地址 | |
FCHARGEID_FNumber | 收款方 | |
FAPSTATUS | 应付状态 | |
FTransferBizType | 跨组织业务类型 | |
FCorrespondOrgId_FNumber | 对应组织 | |
FSupplyOrderNo | 订单号 | |
FPayOrgId_FNumber | 付款组织 | |
FSettleOrgId_FNumber | 结算组织 | |
FSETTLETYPEID_FNumber | 结算方式 | |
FPAYCONDITIONID_FNumber | 付款条件 | |
FSettleCurrId_FNumber | 结算币别 | |
FBILLTAXAMOUNT | 税额 | |
FBILLCOSTAMOUNT | 总成本 | |
FBILLALLAMOUNT | 价税合计 | |
FEXCHANGETYPEID_FNumber | 汇率类型 | |
FIsIncludedTax | 含税 | |
FBillAmount | 金额 | |
FISGENFORIOS | 跨组织结算生成 | |
FSettleSupplierID_FNumber | 结算组织供应商 | |
FISPRICEEXCLUDETAX | 价外税 | |
FISINVOICEARLIER | 先到票后入库 | |
FTHIRDSRCTYPE | 第三方来源 | |
FTHIRDBILLID | 第三方单据ID | |
FTHIRDBILLNO | 第三方单据编号 | |
FMATERIALID_FNumber | 物料编码 | |
FMATERIALID_FBARCODE | 条码 | |
FREPLENISHQTY | 补料数量 | |
FKEAPAMTQTY | 扣款数量 | |
FSTOCKID_FNumber | 仓库 | |
FStockStatusId | 库存状态 | |
FNOTE | 备注 | |
FProduceDate | 生产日期 | |
FEXPIRYDATE | 到期日 | |
FCONTRACTNO | 合同单号 | |
FREQTRACENO | 需求跟踪号 | |
FORDERNO | 订单单号 | |
FPRICEUNITQTY | 计价数量 | |
FCostPrice | 成本价 | |
FTAXPRICE | 含税单价 | |
FDISCOUNTRATE | 折扣率(%) | |
FTAXNETPRICE | 净价 | |
FENTRYCOSTAMOUNT | 总成本 | |
FENTRYTAXRATE | 税率 | |
FENTRYTAXAMOUNT | 税额 | |
FALLAMOUNT | 价税合计 | |
FOWNERID_FNumber | 货主 | |
FJOINQTY | 关联数量 | |
FRMREALQTY | 实退数量 | |
FRMMUSTQTY | 应退数量 | |
FSTOCKLOCID | 仓位 | |
FSRCBillTypeId | 源单类型 | |
FSRCBillNo | 源单编号 | |
FLot_FNumber | 批号 | |
FPrice | 单价 | |
FAmount | 金额 | |
FDiscount | 折扣额 | |
FBFLowId | 业务流程 | |
FSRCSeq | 源单行号 | |
FMtoNo | 计划跟踪号 | |
FIsStock | 是否可库存 | |
FGiveAway | 是否赠品 | |
FRowId | 行标识 | |
FParentRowId | 父行标识 | |
FBarcode | 零售条形码 | |
聚水潭接口明细
- 调用接口:jushuitan.otherinout.upload
- 接口名称:新建其它出入库(新)
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
is_confirm | 是否自动确认单据 | string | 1 |
wms_co_id | 分仓编号 | string | 11084916 |
type | 出入库类型: in是入库 out是出库 | string | out |
external_id | 外部单号 | string | {{FBillNo}}cgth{{CURRENT_TIME}} |
warehouse | 主仓=1,销退仓=2, 进货仓=3,次品仓 = 4 | string | 3 |
drp_co_name | 出库类型 | string | 采购退货单 |
receiver_name | 收件人姓名 | string | |
receiver_mobile | 收件人手机号 | string | |
receiver_state | 收件地址省 | string | |
receiver_city | 收件地址市 | string | |
receiver_district | 收件地址区 | 县 | string | |
receiver_address | 收件详细地址 | string | |
items | 商品列表 | array | items |
items.remark | 备注 | string | |
items.sku_id | 商品编码 | string | {{items.FMATERIALID_FNumber}} |
items.qty | 数量 | string | {{items.FRMREALQTY}} |
items.batch_id | 批次单号,系统中需开启相关配置 | string | {{items.FLot_FNumber}} |
items.produced_date | 生产日期,系统中需开启相关配置 | string | {{items.FProduceDate}} |
items.expiration_date | 有效期至,系统中需开启相关配置 | string | {{items.FEXPIRYDATE}} |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
code | 非0失败 | string | |
msg | 错误描述 | string | |
data | 返回内容 | array | |
data.external_id | 外部单号 | string | |
data.io_id | 系统内部单号 | string | |
系统集成总览
采集并引入全业务、多终端、多形态的数据,经过处理以及对应平台接口的数据结构适配,形成以业务核心为对象为中心的连接和标签体系。配合企业根据自身的实际情况以及业务需求完成方案的规划、部署与实施,将沉淀的业务数据进入到平台进行体系化的加工,再以服务化的方式支持业务平台上的应用。达成高效支持业务敏捷创新的高质量和标准化的数据服务组合。

