系统数据集成方案

吉客云·奇门和金蝶云星空接口打通对接实战

源系统:吉客云·奇门

对接目标平台:金蝶云星空

系统对接接口配置

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

吉客云·奇门接口明细

• 接口：jackyun.tradenotsensitiveinfos.list.get
• 接口名称：销售单查询
• 接口方法：POST

请求参数

字段	名称	类型	描述
modified_begin	起始时间	string	修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
modified_end	结束时间	string	修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
startModified	最后修改时间（起始）	string
endModified	最后修改时间（截止）	string
tradeNo	销售单号，多个用半角逗号分隔	string
pageSize	每页记录数，默认50，最大1000	string
pageIndex	页码，0为第1页	string
hasTotal	默认返回，首次调用时可以传1获取总记录数	string
startCreated	创建时间（起始）	string
endCreated	创建时间（截止）	string
startAuditTime	审核时间（起始）	string
endAuditTime	审核时间（截止）	string
startConsignTime	发货时间（起始）	string
endConsignTime	发货时间（截止）	string
tradeStatus	订单状态	string
tradeType	订单类型	string
sourceTradeNos	网店订单号	string
fields	需要返回字段列表逗号分隔	string

响应参数

字段	名称	类型	描述
checkTotal	对账金额	string
tradeNo	订单编号	string
postFee	实际邮资	string
otherFee	其它费用	string
sellerMemo	备注	string
buyerMemo	买家备注	string
goodsDetail	货品详情	array
goodsDetail.goodsNo	货品编号	string
goodsDetail.goodsName	货品名称	string
goodsDetail.specName	规格名称	string
goodsDetail.barcode	条码	string
goodsDetail.sellCount	数量	string
goodsDetail.unit	单位	string
goodsDetail.sellPrice	单价	string
goodsDetail.sellTotal	总金额	string
goodsDetail.cost	货品成本	string
goodsDetail.discountTotal	优惠金额	string
goodsDetail.discountPoint	抵扣积分	string
goodsDetail.shareFavourableFee	分摊金额	string
goodsDetail.goodsMemo	货品备注	string
goodsDetail.cateName	货品类别	string
goodsDetail.brandName	品牌	string
goodsDetail.goodsTags	货品标签	string
goodsDetail.isFit	组合装标记	string
goodsDetail.isGift	赠品标记	string
goodsDetail.taxRate	税率	string
goodsDetail.estimateGoodsVolume	预估体积（单个货品）	string
goodsDetail.isPresell	是否预售货品标记1是0否	string
goodsDetail.customerPrice	终端销售单价	string
goodsDetail.customerTotal	终端销售金额	string
goodsDetail.tradeGoodsNo	交易编号	string
goodsDetail.tradeGoodsName	交易名称	string
goodsDetail.tradeGoodsSpec	交易规格	string
goodsDetail.tradeGoodsUnit	交易单位	string
goodsDetail.sourceTradeNo	网店订单号	string
goodsDetail.sourceSubtradeNo	网店子订单好	string
goodsDetail.platCode	平台代码	string
goodsDetail.platGoodsId	平台商品id	string
goodsDetail.subTradeId	商品明细id（唯一）	string
goodsDetail.taxFee	税额	string
goodsDetail.estimateWeight	预估重量	string
goodsDetail.discountFee	优惠金额	string
goodsDetail.appendMemo	追加备注	string
goodsDetail.tradeFrom	订单来源	string
goodsDetail.register	登记人	string
goodsDetail.seller	业务员	string
goodsDetail.auditor	审核人	string
goodsDetail.reviewer	复核人	string
goodsDetail.packageWeight	包裹重量	string
goodsDetail.tradeCount	订单总数量	string
goodsDetail.goodsTypeCount	商品样数	string
goodsDetail.freezeReason	冻结原因	string
goodsDetail.abnormalDescription	问题单具体描述	string
goodsDetail.onlineTradeNo	网店订单号	string
goodsDetail.goodslist	货品摘要	string
goodsDetail.gmtCreate	创建时间	string
goodsDetail.gmtModified	最后修改时间	string
goodsDetail.stockoutNo	出库单号	string
goodsDetail.confirmTime	确认时间	string
goodsDetail.departName	部门名称	string
goodsDetail.lastShipTime	承诺发货时间	string
goodsDetail.payStatus	付款状态：未付款、部分付款、已付款	string
goodsDetail.tradeStatus	订单状态	string
goodsDetail.grossProfit	毛利	string
goodsDetail.estimateVolume	订单预估体积	string
goodsDetail.customerName	客户名称	string
goodsDetail.customerTypeName	客户类型	string
goodsDetail.customerGradeName	客户等级	string
goodsDetail.customerTags	客户标签	string
goodsDetail.customerCode	客户编号	string
goodsDetail.customerDiscount	折扣	string
goodsDetail.specialReminding	特别提醒	string
goodsDetail.blackList	黑名单	string
goodsDetail.tradeTime	下单时间	string
goodsDetail.country	国家	string
goodsDetail.state	省	string
goodsDetail.city	城市	string
goodsDetail.district	区县	string
goodsDetail.town	街道	string
goodsDetail.zip	邮编	string
goodsDetail.payTime	支付时间	string
goodsDetail.countryCode	国家编码	string
goodsDetail.cityCode	城市编码	string
goodsDetail.invoiceType	发票类型	string
goodsDetail.payerName	购方名称	string
goodsDetail.payerRegno	购方税号	string
goodsDetail.payerBankAccount	购方开户行及帐号	string
goodsDetail.payerPhone	购方电话	string
goodsDetail.auditTime	审核时间	string
goodsDetail.payerAddress	购方地址	string
goodsDetail.invoiceNo	发票号码	string
goodsDetail.invoiceCode	发票代码	string
goodsDetail.invoiceStatus	发票开具状态	string
goodsDetail.payerBankName	购方开户行	string
goodsDetail.preTypedetail	预定类别描述	string
goodsDetail.firstPayment	付首款金额	string
goodsDetail.finalPayment	付尾款金额	string
goodsDetail.firstPaytime	付首款时间	string
goodsDetail.finalPaytime	付尾款时间	string
goodsDetail.reviewTime	复核时间	string
goodsDetail.activationTime	激活时间	string
goodsDetail.customerTotalFee	终端货款合计	string
goodsDetail.customerDiscountFee	终端优惠	string
goodsDetail.notifyPickTime	通知仓库发货时间	string
goodsDetail.consignTime	发货时间	string
goodsDetail.orderNo	发货单单号	string
goodsDetail.customerPostFee	终端应收邮资	string
goodsDetail.shopId	店铺id	string
goodsDetail.shopName	店铺名称	string
goodsDetail.tradeOrderPayList	订单支付详情	array
goodsDetail.tradeOrderPayList.chargeCurrency	结算币种	string
goodsDetail.tradeOrderPayList.accountName	收款账户名称	string
goodsDetail.tradeOrderPayList.payType	支付方式：1,支付宝 2,财付通 3,微信支付 4,银联支付 5,盛付通 6,其它 7,现金 8,储值卡 9,扫码付 10,挂账 11,诺诺支付 16,易付宝 32,有赞支付 33,汇付支付 35,商盟支付 36,易宝支付 37,汇聚支付 38,合利宝支付 27,通联支付	string
goodsDetail.tradeOrderPayList.payNo	支付单号	string
goodsDetail.tradeOrderPayList.chargeCurrencyCode	结算币种编码	string
goodsDetail.tradeOrderPayList.chargeExchangeRate	结算汇率	string
goodsDetail.tradeOrderPayList.chargeType	结算方式：1.担保交易2.银行收款3.现金收款4.货到付款5.欠款计应收6.客户预存款7.多种结算8.退换货冲抵9.电子钱包	string
goodsDetail.tradeOrderPayList.chargeAccount	收款帐户	string
goodsDetail.tradeOrderPayList.payment	应收金额	float
goodsDetail.tradeOrderPayList.customerPayment	终端应收合计	string
goodsDetail.tradeOrderPayList.companyName	公司名称	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt	销售单自定义字段	object
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn1	自定义字段1	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn2	自定义字段2	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn3	自定义字段3	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn4	自定义字段4	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn5	自定义字段5	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn6	自定义字段6	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn7	自定义字段7	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn8	自定义字段8	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn9	自定义字段9	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn10	自定义字段10	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.tradeId	系统编码	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.isBillCheck	对账状态 1对账，其他未对账	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.warehouseCode	仓库编码	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.warehouseName	仓库名称	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.logisticName	物流名称	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.billDate	对账时间	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.logisticType	配送方式	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.mainPostid	运单号	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.tradeType	订单类型	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.totalFee	商品金额	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.receivedPostFee	应收邮资	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.couponFee	平台优惠	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.receivedTotal	已收金额	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.isDelete	删除标记，0 未删除， 1已删除	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.flagIds	标记id	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.flagNames	标记名称	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.shopCode	店铺编号	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.goodsDetail_goodsDelivery_sendCount	数量	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.consignTime_new	发货日期	string

金蝶云星空接口明细

• 接口：batchSave
• 接口名称：写入空操作
• 接口方法：POST

请求参数

字段	名称	类型	描述
FBillNo	出库单号	string	出库单号
FBillTypeID	单据类型	string	单据类型
FDate	日期	string	日期
FSaleOrgId	销售组织	string	组织
FCustomerID	客户	string	基础资料
FStockOrgId	发货组织	string	组织
FNote	备注	string	多行文本
FAPI	API	string	多行文本
FReceiveAddress	收货人地址	string	文本
F_ora_Assistant3	搭赠类型	string	文本
FEntity	明细信息	array
FEntity.FMaterialID	物料编码	string	基础资料
FEntity.FUnitID	库存单位	string	基础资料
FEntity.FRealQty	实发数量	string	数量
FEntity.FPriceUnitId	计价单位	string	基础资料
FEntity.FSalUnitID	销售单位	string	基础资料
FEntity.FTaxPrice	含税单价	string	单价
FEntity.FEntryTaxRate	税率%	string	小数
FEntity.FStockID	仓库	string	基础资料
FEntity.FLot	批次号	string
FEntity.FProduceDate	生产日期	string
FEntity.FExpiryDate	有效期至	string
FEntity.FEntrynote	备注	string	文本
FEntity.FSOORDERNO	订单单号	string	金蝶自定义
FEntity.FTHIRDENTRYID	管易订单单号	string	金蝶自定义
FEntity.FORDERNUM	管易订单单号	string	金蝶自定义
FEntity.FPLATFORMNUM	管易平台单号	string	金蝶自定义
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgID	结算组织	string	组织
FEntity.SubHeadEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FEntity.SubHeadEntity.Operation	执行的操作	string
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	bool
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubHeadEntity.InterationFlags	允许负库存	string

数据对接价值

通过数据集成平台可视化的快速配置调用接口打通吉客云·奇门与金蝶云星空之间的数据接口，使得两个系统之间的对接更加快捷、稳定。轻易云数据集成平台打破信息孤岛、适配多种场景、降低运营成本、缩短开发周期、灵活调度配置是这种多系统数据打通时的特性优势。采用元数据模型驱动的低代码集成工具，基于系统预置的数据模型、映射、编排、日志、脚本等集成核心引擎，通过可视化配置，快速实现客户灵活多变的动态集成需求，让集成开发简单、执行过程可靠、问题风险可控。

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