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

对接系统吉客云

“吉客云”是一站式企业数字化解决方案系统，可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案，“吉客云”具有业务流程更流畅，数据共享更充分，使用成本更低廉等优势。不仅如此，通过“吉链”，可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道，数据对接就像加微信好友一样方便！

对接系统：金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

数据接口配置

数据集成平台对应的配置吉客云与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据吉客云的接口参数要求记录在轻易云集成平台。第二步配置吉客云与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。

吉客云接口明细

API：jackyun.tradenotsensitiveinfos.list.get
NAME：销售单查询
METHOD：POST

请求参数

接口字段字段名称预设值描述 modified_begin起始时间修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 modified_end结束时间修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 startModified最后修改时间（起始） endModified最后修改时间（截止） tradeNo销售单号，多个用半角逗号分隔 pageSize每页记录数，默认50，最大100050 pageIndex页码，0为第1页{{PAGINATION_START_PAGE}} hasTotal默认返回，首次调用时可以传1获取总记录数1 startCreated创建时间（起始） endCreated创建时间（截止） startAuditTime审核时间（起始） endAuditTime审核时间（截止） startConsignTime发货时间（起始）_function DATE_FORMAT(DATE_ADD(NOW(),INTERVAL - 3 DAY),'%Y-%m-%d 00:00:00') endConsignTime发货时间（截止）{{CURRENT_TIME datetime}} tradeStatus订单状态9090 tradeType订单类型8 sourceTradeNos网店订单号 shopIds店铺id fields需要返回字段列表逗号分隔checkTotal,tradeNo,postFee,otherFee,chargeCurrency,accountName,payType,payNo,sellerMemo,buyerMemo,goodsDetail,goodsDetail.goodsNo,goodsDetail.goodsName,goodsDetail.specName,goodsDetail.barcode,goodsDetail.sellCount,goodsDetail.unit,goodsDetail.sellPrice,goodsDetail.sellTotal,goodsDetail.cost,goodsDetail.discountTotal,goodsDetail.discountPoint,goodsDetail.taxFee,goodsDetail.shareFavourableFee,goodsDetail.estimateWeight,goodsDetail.goodsMemo,goodsDetail.cateName,goodsDetail.brandName,goodsDetail.goodsTags,goodsDetail.isFit,goodsDetail.isGift,goodsDetail.discountFee,goodsDetail.taxRate,goodsDetail.estimateGoodsVolume,goodsDetail.isPresell,goodsDetail.customerPrice,goodsDetail.customerTotal,goodsDetail.tradeGoodsNo,goodsDetail.tradeGoodsName,goodsDetail.tradeGoodsSpec,goodsDetail.tradeGoodsUnit,goodsDetail.sourceTradeNo,goodsDetail.sourceSubtradeNo,goodsDetail.platCode,goodsDetail.platGoodsId,goodsDetail.subTradeId,appendMemo,tradeFrom,register,seller,auditor,reviewer,estimateWeight,packageWeight,tradeCount,goodsTypeCount,freezeReason,abnormalDescription,onlineTradeNo,goodslist,gmtCreate,gmtModified,stockoutNo,confirmTime,departName,lastShipTime,payStatus,chargeCurrencyCode,chargeExchangeRate,tradeStatus,grossProfit,estimateVolume,customerName,customerTypeName,customerGradeName,customerTags,customerCode,customerDiscount,specialReminding,blackList,tradeTime,country,state,city,district,town,zip,payTime,countryCode,cityCode,invoiceType,payerName,payerRegno,payerBankAccount,payerPhone,auditTime,payerAddress,invoiceNo,invoiceCode,invoiceStatus,payerBankName,preTypedetail,firstPayment,finalPayment,firstPaytime,finalPaytime,reviewTime,activationTime,customerTotalFee,customerDiscountFee,notifyPickTime,consignTime,orderNo,customerPostFee,shopId,shopName,tradeOrderPayList,tradeOrderPayList.chargeType,tradeOrderPayList.chargeCurrency,tradeOrderPayList.chargeAccount,tradeOrderPayList.accountName,tradeOrderPayList.payType,tradeOrderPayList.payNo,tradeOrderPayList.payment,tradeOrderPayList.chargeCurrencyCode,tradeOrderPayList.chargeExchangeRate,customerPayment,companyName,tradeOrderColumnExt,tradeOrderColumnExt.tradeId,tradeOrderColumnExt.customizeTradeColumn1,tradeOrderColumnExt.customizeTradeColumn2,tradeOrderColumnExt.customizeTradeColumn3,tradeOrderColumnExt.customizeTradeColumn4,tradeOrderColumnExt.customizeTradeColumn5,tradeOrderColumnExt.customizeTradeColumn6,tradeOrderColumnExt.customizeTradeColumn7,tradeOrderColumnExt.customizeTradeColumn8,tradeOrderColumnExt.customizeTradeColumn9,tradeOrderColumnExt.customizeTradeColumn10,isBillCheck,warehouseCode,warehouseName,logisticName,tradeId,billDate,logisticType,mainPostid,tradeType,totalFee,taxFee,receivedPostFee,discountFee,payment,couponFee,receivedTotal,isDelete,flagIds,flagNames,shopCode warehouseIds仓库id

响应参数

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

金蝶云星空接口明细

API：batchSave
NAME：销售退货新增
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillTypeID单据类型XSTHD01_SYS单据类型 FBillNo单据编号{{TradeNo}}单据编号 FSaleOrgId销售组织findCollection find textField_l2iazxw0 from a7cb0b9d-2aef-342a-bcb9-7d02e747f1d8 where textField_l2iazxvw={{ShopCode}}组织 FDate日期{{ConsignTime}}日期 FStockOrgId库存组织_findCollection find textField_l2ib4q9s from 0ce3a160-9fb2-36e5-a2ac-57f5ad0f3c72 where textField_l2ib4q9p={{WarehouseCode}}组织 FRetcustId退货客户findCollection find textField_l2iazxvz from a7cb0b9d-2aef-342a-bcb9-7d02e747f1d8 where textField_l2iazxvw={{ShopCode}}基础资料 FSaledeptid销售部门基础资料 FSettleCurrId结算币别基础资料 FBranchId销售门店基础资料 FReturnReason退货原因单选辅助资料列表 FCorrespondOrgId对应组织组织 FStockDeptId库存部门基础资料 FHeadNote备注多行文本 FPayCustId付款方基础资料 FEntity明细信息GoodsDetail FEntity.FMaterialId物料编码{{GoodsDetail.GoodsNo}}基础资料 FEntity.FBarcode零售条形码文本 FEntity.FRealQty实退数量{{GoodsDetail.SellCount}}数量 FEntity.FPrice单价_function ABS( {{GoodsDetail.SellPrice}})单价 FEntity.FTaxPrice含税单价_function ABS({{GoodsDetail.new_price}})单价 FEntity.FIsFree是否赠品复选框 FEntity.FEntryTaxRate税率%小数 FEntity.FReturnType退货类型{{goodsDetail.cateName}}单选辅助资料列表 FEntity.FOwnerTypeId货主类型多类别基础资料列表 FEntity.FOwnerId货主多类别基础资料 FEntity.FStockId仓库{{WarehouseCode}}基础资料 FEntity.FStocklocId仓位维度关联字段 FEntity.FLot批号批次 FEntity.FDeliveryDate退货日期长日期 FEntity.FNote备注文本 FEntity.FEntity_Link关联关系表 FEntity.FEntity_Link.FEntity_Link_FRuleId转换规则OutStock-SalReturnStock FEntity.FEntity_Link.FEntity_Link_FSTableName源单表T_SAL_OUTSTOCKENTRY FEntity.FEntity_Link.FEntity_Link_FSBillId源单内码 FEntity.FEntity_Link.FEntity_Link_FSId源单分录内码 FEntity.SubHeadEntity财务信息 FEntity.SubHeadEntity.FSettleOrgId结算组织组织 FEntity.SubHeadEntity.FSettleTypeId结算方式基础资料 FEntity.SubHeadEntity.FormId业务对象表单IdSAL_RETURNSTOCK必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.SubHeadEntity.Operation执行的操作Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit提交并审核true FEntity.SubHeadEntity.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.SubHeadEntity.SubSystemId系统模块21默认仓库模块

系统对接概况

通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接吉客云和金蝶云星空，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。

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