金蝶云星空和吉客云·奇门单据接口对接
数据源平台:吉客云·奇门
杭州吉客云网络技术有限公司是经国家认定的高新技术企业，是国内领先的SaaSERP软件服务商，致力于为企业提供安全稳定、高可用性和高扩展性的一站式数字化解决方案。
对接目标系统:金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
数据接口配置
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：吉客云·奇门，源系统 API：销售单查询，目标系统：金蝶云星空，目标系统 API销售出库新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
吉客云·奇门接口明细
- 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 from_unixtime(({{LAST_SYNC_TIME}}-86400),'%Y-%m-%d %H:%i:%s')
endConsignTime发货时间（截止）_function from_unixtime(({{LAST_SYNC_TIME}}-86400),'%Y-%m-%d %H:%i:%s')
tradeStatus订单状态
tradeType订单类型1,91,92,93
sourceTradeNos网店订单号
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,,goodsDetail.shareFavourableAfterFee,companyCode
响应参数
接口字段字段名称预设值描述
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单据类型XSCKD07_SYS单据类型
FBillNo单据编号{{tradeNo}}单据编号
FDate日期{{consignTime}}日期
FSaleOrgId销售组织
mongoQuery e66a3e9d-0a3f-370a-886a-701da55d3740 findField=content.companyCode where={"content.companyName" : {"$eq":"{{companyName}}"}}组织
FStockOrgId库存组织_mongoQuery e66a3e9d-0a3f-370a-886a-701da55d3740 findField=content.companyCode where={"content.companyName" : {"$eq":"{{companyName}}"}}多类别基础资料
FOwnerIdHead货主
mongoQuery e66a3e9d-0a3f-370a-886a-701da55d3740 findField=content.companyCode where={"content.companyName" : {"$eq":"{{companyName}}"}}多类别基础资料
FCustomerID客户{{shopCode}}基础资料
FNote备注{{sellerMemo}}多行文本
F_LSJC_Text关联单号{{tradeNo}}多行文本
F_LSJC_Text1来源单号多行文本
F_LSJC_Text2收货单号多行文本
F_LSJC_Text4入库类型{{tradeType}}多行文本
F_LSJC_Text11备注多行文本
FEntity明细信息goodsDetail
FEntity.FCustMatID客户物料编码基础资料
FEntity.FMaterialId物料编码{{goodsDetail.goodsNo}}基础资料
FEntity.FRealQty实退数量{{goodsDetail.sellCount}}数量
FEntity.Flot批号01批号
FEntity.FPrice单价_function {{goodsDetail.shareFavourableAfterFee}}/{{goodsDetail.sellCount}}单价
FEntity.FAmount金额金额
FEntity.FStockId仓库
mongoQuery e66a3e9d-0a3f-370a-886a-701da55d3740 findField=content.companyCode where={"content.companyName" : {"$eq":"{{companyName}}"}}基础资料
FEntity.FEntrynote备注{{goodsMemo}}文本
FEntity.FTaxPrice含税单价_function {{goodsDetail.shareFavourableAfterFee}}/{{goodsDetail.sellCount}}
FEntity.FDiscount折扣额
FEntity.FEntryTaxRate税率
FEntity.FSalCostPrice销售成本价
function {{goodsDetail.cost}}/{{goodsDetail.sellCount}}销售成本价
FEntity.FCostPrice成本价(本位币)_function {{goodsDetail.cost}}/{{goodsDetail.sellCount}}成本价(本位币)
FEntity.FEntryCostAmount总成本{{goodsDetail.cost}}总成
FEntity.F_LSJC_Decimal总成本（网店）{{goodsDetail.cost}}总成本（网店）
FEntity.F_LSJC_Decimal1销售成本价（网店）_function {{goodsDetail.cost}}/{{goodsDetail.sellCount}}销售成本价（网店）
FEntity.FormId业务对象表单IdSAL_OUTSTOCK必须填写金蝶的表单ID如😛UR_PurchaseOrder
FEntity.Operation执行的操作Save
FEntity.IsAutoSubmitAndAudit提交并审核true
FEntity.IsVerifyBaseDataField验证基础资料true是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubSystemId系统模块21默认仓库模块
FEntity.InterationFlags允许负库存STK_InvCheckResult
FEntity.BatchCount服务端开启的线程数5
系统打通概况
数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。
