吉客云·奇门和金蝶云星空接口打通对接实战|轻易云数据集成平台

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

接入系统：吉客云·奇门

杭州吉客云网络技术有限公司是经国家认定的高新技术企业，是国内领先的SaaSERP软件服务商，致力于为企业提供安全稳定、高可用性和高扩展性的一站式数字化解决方案。

接入系统：金蝶云星空

金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。

数据接口配置方案

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

吉客云·奇门接口明细

接口：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	单据编号
FDate	日期	string	日期
FSaleOrgID	销售组织	string	组织
FRetcustId	客户	string	基础资料
FStockOrgID	发货组织	string	多类别基础资料
FOwnerIdHead	货主	string	多类别基础资料
F_LSJC_Text	关联单号	string	多行文本
F_LSJC_Text1	来源单号	string	多行文本
F_LSJC_Text2	收货单号	string	多行文本
F_LSJC_Text4	入库类型	string	多行文本
F_LSJC_Text11	备注	string	多行文本
FEntity	明细信息	array
FEntity.FCustMatID	客户物料编码	string	基础资料
FEntity.FMaterialID	物料编码	string	基础资料
FEntity.FRealQty	实发数量	string	数量
FEntity.Flot	批号	string	批号
FEntity.FPrice	单价	string	单价
FEntity.FAmount	金额	string	金额
FEntity.FStockID	仓库	string	基础资料
FEntity.FEntrynote	备注	string	文本
FEntity.FTaxPrice	含税单价	string
FEntity.FDiscount	折扣额	string
FEntity.FEntryTaxRate	税率	string
FEntity.FSoorDerno	订单单号	string
FEntity.FSalCostPrice	销售成本价	string	销售成本价
FEntity.FCostPrice	成本价(本位币)	string	成本价(本位币)
FEntity.FEntryCostAmount	总成本	string	总成
FEntity.F_LSJC_Decimal	总成本（网店）	string	总成本（网店）
FEntity.F_LSJC_Decimal1	销售成本价（网店）	string	销售成本价（网店）
FEntity.FJKShopNumber	网店订单号	string
FEntity.FPostid	吉客云物流单号	string
FEntity.FWeight	包裹重量	string
FEntity.FLogisticName	物流公司	string
FEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FEntity.Operation	执行的操作	string
FEntity.IsAutoSubmitAndAudit	提交并审核	bool
FEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubSystemId	系统模块	string	默认仓库模块
FEntity.InterationFlags	允许负库存	string

系统对接总览

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