系统数据集成方案

金蝶云星空与巨益OMS对接集成客户查询连通非组合商品单个同步(ERP客户对接OMS分销商测试)

数据源系统:金蝶云星空

集成系统:巨益OMS

接口方案配置

通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：金蝶云星空，并且选择对应的连接器（关于金蝶云星空的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的客户查询接口作为数据对接来源。然后再通过写入目标平台配置目标系统为巨益OMS，并且选择对应连接器。选择对应的非组合商品单个同步接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。

金蝶云星空接口明细

• 接口：ExecuteBillQuery
• 接口名称：客户查询
• 接口方法：POST

请求参数

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

响应参数

字段	名称	类型	描述
DocumentStatus	单据状态	string
ForbidStatus	禁用状态	string
Name	客户名称	string
Number	客户编码	string
Description	备注	string
CreateOrgId_Id	创建组织_Id	string
CreateOrgId_Name	创建组织_名称	string
CreateOrgId_Number	创建组织_编码	string
UseOrgId_Id	使用组织_Id	string
UseOrgId_Name	使用组织_名称	string
UseOrgId_Number	使用组织_编码	string
CreatorId_Id	创建人_Id	string
CreatorId_Name	创建人_名称	string
CreatorId_Number	创建人_编码	string
ModifierId_Id	修改人_Id	string
ModifierId_Name	修改人_名称	string
ModifierId_Number	修改人_编码	string
CreateDate	创建日期	string
FModifyDate	修改日期	string
ShortName	简称	string
COUNTRY	国家	string
PROVINCIAL	地区	string
FZIP	邮政编码	string
TEL	联系电话	string
FTAXREGISTERCODE	纳税登记号	string
FAX	传真	string
FGROUPCUSTID_Id	对应集团客户_Id	string
FGROUPCUSTID_Name	对应集团客户_名称	string
FGROUPCUSTID_Number	对应集团客户_编码	string
FSUPPLIERID_Id	对应供应商_Id	string
FSUPPLIERID_Name	对应供应商_名称	string
FSUPPLIERID_Number	对应供应商_编码	string
TRADINGCURRID_Id	结算币别_Id	string
TRADINGCURRID_Name	结算币别_名称	string
TRADINGCURRID_Number	结算币别_编码	string
SALDEPTID_Id	销售部门_Id	string
SALDEPTID_Name	销售部门_名称	string
SALDEPTID_Number	销售部门_编码	string
SALGROUPID_Id	销售组_Id	string
SALGROUPID_Name	销售组_名称	string
SALGROUPID_Number	销售组_编码	string
SELLER_Id	销售员_Id	string
SELLER_Name	销售员_名称	string
SELLER_Number	销售员_编码	string
TRANSLEADTIME	运输提前期	string
PRICELISTID_Id	价目表_Id	string
PRICELISTID_Name	价目表_名称	string
PRICELISTID_Number	价目表_编码	string
DISCOUNTLISTID_Id	折扣表_Id	string
DISCOUNTLISTID_Name	折扣表_名称	string
DISCOUNTLISTID_Number	折扣表_编码	string
SETTLETYPEID_Id	结算方式_Id	string
SETTLETYPEID_Name	结算方式_名称	string
SETTLETYPEID_Number	结算方式_编码	string
RECEIVECURRID_Id	收款币别_Id	string
RECEIVECURRID_Name	收款币别_名称	string
RECEIVECURRID_Number	收款币别_编码	string
RECCONDITIONID_Id	收款条件_Id	string
RECCONDITIONID_Name	收款条件_名称	string
RECCONDITIONID_Number	收款条件_编码	string
FISCREDITCHECK	启用信用管理	string
APPROVERID_Id	审核人_Id	string
APPROVERID_Name	审核人_名称	string
APPROVERID_Number	审核人_编码	string
APPROVEDATE	审核日期	string
FORBIDDERID_Id	禁用人_Id	string
FORBIDDERID_Name	禁用人_名称	string
FORBIDDERID_Number	禁用人_编码	string
FORBIDDATE	禁用日期	string
TaxType	税分类	string
CustTypeId	客户类别	string
ADDRESS	通讯地址	string
WEBSITE	公司网址	string
FGroup_Id	客户分组_Id	string
FGroup_Name	客户分组_名称	string
FGroup_Number	客户分组_编码	string
CompanyScale	公司规模	string
CompanyType	公司类别	string
CompanyNature	公司性质	string
CorrespondOrgId_Id	对应组织_Id	string
CorrespondOrgId_Name	对应组织_名称	string
CorrespondOrgId_Number	对应组织_编码	string
Priority	客户优先级	string
InvoiceType	发票类型	string
TaxRate_Id	默认税率_Id	string
TaxRate_Name	默认税率_名称	string
TaxRate_Number	默认税率_编码	string
IsDefPayer	默认付款方	string
CPAdminCode	订货平台管理员	string
IsGroup	集团客户	string
INVOICETITLE	发票抬头	string
INVOICEBANKNAME	开户银行	string
INVOICEBANKACCOUNT	银行账号	string
INVOICETEL	开票联系电话	string
INVOICEADDRESS	开票通讯地址	string
IsTrade	是否交易客户	string
UncheckExpectQty	不校验可发量	string
F_out_id	外部id	string
F_KHLX	客户类型	string
BD_CUSTBANK	银行信息	array
BD_CUSTBANK.BANKCODE	银行账号	string
BD_CUSTBANK.CURRENCYID_Id	币别_Id	string
BD_CUSTBANK.CURRENCYID_Name	币别_名称	string
BD_CUSTBANK.CURRENCYID_Number	币别_编码	string
BD_CUSTBANK.ACCOUNTNAME	账户名称	string
BD_CUSTBANK.ISDEFAULT	默认	string
BD_CUSTBANK.COUNTRY	开户国家	string
BD_CUSTBANK.OPENBANKNAME	开户银行	string
BD_CUSTBANK.BankTypeRec_Id	收款银行_Id	string
BD_CUSTBANK.BankTypeRec_Name	收款银行_名称	string
BD_CUSTBANK.BankTypeRec_Number	收款银行_编码	string
BD_CUSTBANK.OpenAddressRec	开户行地址	string
BD_CUSTBANK.CNAPS	联行号	string
BD_CUSTBANK.FTextBankDetail	网点名称	string
BD_CUSTBANK.BankDetail_Id	银行网点_Id	string
BD_CUSTBANK.BankDetail_Name	银行网点_名称	string
BD_CUSTBANK.BankDetail_Number	银行网点_编码	string
BD_CUSTBANK.BD_CUSTCONTACT	地址信息	array
BD_CUSTBANK.BD_CUSTCONTACT.NUMBER	地点编码	string
BD_CUSTBANK.BD_CUSTCONTACT.NAME	地点名称	string
BD_CUSTBANK.BD_CUSTCONTACT.ADDRESS	详细地址	string
BD_CUSTBANK.BD_CUSTCONTACT.TRANSLEADTIME	运输提前期	string
BD_CUSTBANK.BD_CUSTCONTACT.TAXRATE	税率	string
BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultConsignee	默认收货地址	string
BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultSettle	默认开票地址	string
BD_CUSTBANK.BD_CUSTCONTACT.IsDefaultPayer	默认付款地址	string
BD_CUSTBANK.BD_CUSTCONTACT.TTel	固定电话	string
BD_CUSTBANK.BD_CUSTCONTACT.EMail	电子邮箱	string
BD_CUSTBANK.BD_CUSTCONTACT.IsUsed	启用	string
BD_CUSTBANK.BD_CUSTCONTACT.TContact_Id	联系人_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.TContact_Name	联系人_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.TContact_Number	联系人_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.MOBILE	移动电话	string
BD_CUSTBANK.BD_CUSTCONTACT.FLocationStatus	地址禁用状态	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG	订货组织	array
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Id	订货组织_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Name	订货组织_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.OrderOrgId_Number	订货组织_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.ISDEFAULT	默认	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT	商务信息	object
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.EnableSL	启用商联在线	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeStatus	冻结状态	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeLimit	冻结范围	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Id	冻结人_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Name	冻结人_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeOperator_Number	冻结人_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FreezeDate	冻结日期	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.PROVINCE	省份	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.CITY	城市	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Id	默认收货地点_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Name	默认收货地点_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultConsiLoc_Number	默认收货地点_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Id	默认开票地点_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Name	默认开票地点_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultSettleLoc_Number	默认开票地点_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Id	默认付款地点_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Name	默认付款地点_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultPayerLoc_Number	默认付款地点_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Id	默认联系人_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Name	默认联系人_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.DefaultContact_Number	默认联系人_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.MarginLevel	保证金比例（%）	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FDebitCard	结算卡	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Id	结算方_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Name	结算方_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.SettleId_Number	结算方_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Id	付款方_Id	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Name	付款方_名称	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.ChargeId_Number	付款方_编码	string
BD_CUSTBANK.BD_CUSTCONTACT.BD_CUSTORDERORG.BD_CUSTOMEREXT.FALLOWJOINZHJ	允许对接智慧订货	string

巨益OMS接口明细

• 接口：singleitem.synchronize
• 接口名称：非组合商品单个同步
• 接口方法：POST

请求参数

字段	名称	类型	描述
actionType	操作类型	string	操作类型(两种类型：add update),示例值(add)
address	地址	object	扩展属性
balanceDeductType	扣款类型	string	货主编码,示例值(HZ123)
distributorCode	分销商编码	string	供应商编码,示例值(GY123)
distributorCompanyName	分销商等级名称	string	供应商名称,示例值(淘宝)
distributorName	分销商名称	string	仓库编码(统仓统配等无需ERP指定仓储编码的情况填OTHER),示例值(CK1234)

数据对接价值

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通金蝶云星空到巨益OMS之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。

系统数据对接方案元数据代码