系统数据集成方案

吉客云·奇门与金蝶云星空对接集成销售单查询连通写入空操作(销售单对接（8:售后退货-退货）)

对接系统：吉客云·奇门

对接目标系统:金蝶云星空

配置集成方案

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：吉客云·奇门，然后选择对应的连接器。选择对应的销售单查询作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的写入空操作接口作为数据写入动作，既可以完成第一步的数据对接配置。

吉客云·奇门接口明细

• 接口：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

金蝶云星空接口明细

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

请求参数

字段	名称	类型	描述
FBillTypeID	单据类型	string	单据类型
FBillNo	单据编号	string	单据编号
FSaleOrgId	销售组织	string	组织
FDate	日期	string	日期
FStockOrgId	库存组织	string	组织
FRetcustId	退货客户	string	基础资料
FXSLX	销售类型	string	多行文本
FAPI	API	string	多行文本
F_sht_Note	备注	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.FOwnerTypeId	货主类型	string	多类别基础资料列表
FEntity.FOwnerId	货主	string	多类别基础资料
FEntity.FStockId	仓库	string	基础资料
FEntity.FLot	批次号	string
FEntity.FProduceDate	生产日期	string
FEntity.FExpiryDate	有效期至	string
FEntity.FNote	备注	string	文本
FEntity.FOrderNo	订单单号	string
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgId	结算组织	string	组织
FEntity.SubHeadEntity.FThirdBillNo	第三方单据编号	string
FEntity.SubHeadEntity.FThirdBillId	第三方单据平台单号	string
FEntity.SubHeadEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FEntity.SubHeadEntity.Operation	执行的操作	string
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	bool
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubHeadEntity.SubSystemId	系统模块	string	默认仓库模块

数据对接效果

通过轻易云集成平台系列产品线可以协助企业轻易快捷的构建基于微服务架构的新一代企业服务总线，传统基于SOA架构的ESB产品主要解决的数据集成和协议转换等基础功能，已完全不能满足基于微服务架构、混合云集成架构、跨组织、跨单位的总线解决方案。 而轻易云集成平台的每个产品线都是新一代的按照最新的互联网架构模式进行研发的产品线，能快速协助企业从传统的SOA架构转向微服务架构的服务总线解决方案。

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