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

对接系统吉客云·奇门

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

集成系统:金蝶云星空

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

系统对接接口配置

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

吉客云·奇门接口明细

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

请求参数

接口字段字段名称预设值描述 modified_begin起始时间修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 modified_end结束时间修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 startModified最后修改时间（起始） endModified最后修改时间（截止） tradeNo销售单号，多个用半角逗号分隔 pageSize每页记录数，默认50，最大100020 pageIndex页码，0为第1页{{PAGINATION_START_PAGE}} hasTotal默认返回，首次调用时可以传1获取总记录数1 startCreated创建时间（起始） endCreated创建时间（截止） startAuditTime审核时间（起始） endAuditTime审核时间（截止） startConsignTime发货时间（起始）{{LAST_SYNC_TIME datetime}} endConsignTime发货时间（截止）{{CURRENT_TIME datetime}} tradeStatus订单状态 tradeType订单类型11 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.specId,goodsDelivery.batchNo,goodsDelivery.productionDate,goodsDelivery.expirationDate,goodsDetail.shareFavourableAfterFee,goodsDelivery.sendCount,goodsDetail.divideSellTotal,goodsDetail.shareOrderDiscountFee,goodsDetail.shareOrderPlatDiscountFee

响应参数

接口字段字段名称预设值描述 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

请求参数

接口字段字段名称预设值描述 FBillNo出库单号{{tradeNo}}出库单号 FBillTypeID单据类型XSCKD01_SYS单据类型 FDate日期{{consignTime_new}}日期 FSaleOrgId销售组织function case '{{shopCode}}' when '10002480' then '104' else '103' end组织 FCustomerID客户{{shopCode}}基础资料 FStockOrgId发货组织103组织 FNote备注错漏调整-出库多行文本 FAPIAPItrue多行文本 FReceiveAddress收货人地址文本 FEntity明细信息details FEntity.FMaterialID物料编码{{details.goodsDetail_goodsNo}}基础资料 FEntity.FUnitID库存单位_findCollection find FPurchaseUnitId_FNumber from 44da707b-4d02-3e20-ad97-fdd69ff7a37d where FNumber={{details.goodsDetail_goodsNo}}基础资料 FEntity.FRealQty实发数量{{details.goodsDetail_goodsDelivery_sendCount}}数量 FEntity.FPriceUnitId计价单位findCollection find FPurchaseUnitId_FNumber from 44da707b-4d02-3e20-ad97-fdd69ff7a37d where FNumber={{details.goodsDetail_goodsNo}}基础资料 FEntity.FSalUnitID销售单位_findCollection find FPurchaseUnitId_FNumber from 44da707b-4d02-3e20-ad97-fdd69ff7a37d where FNumber={{details.goodsDetail_goodsNo}}基础资料 FEntity.FTaxPrice含税单价function {{details.goodsDetail_goodsDelivery_batchamount}}/{{details.goodsDetail_goodsDelivery_sendCount}}单价 FEntity.FEntryTaxRate税率%13小数 FEntity.FStockID仓库{{warehouseCode}}基础资料 FEntity.FLot批次号{{details.goodsDetail_goodsDelivery_batchNo}} FEntity.FProduceDate生产日期{{details.goodsDetail_goodsDelivery_productionDate}} FEntity.FExpiryDate有效期至{{details.goodsDetail_goodsDelivery_expirationDate}} FEntity.FEntrynote备注文本 FEntity.FSOORDERNO订单单号金蝶自定义 FEntity.FTHIRDENTRYID管易订单单号{{tradeNo}}金蝶自定义 FEntity.FORDERNUM管易订单单号{{tradeNo}}金蝶自定义 FEntity.FPLATFORMNUM管易平台单号{{sourceTradeNos}}金蝶自定义 FEntity.SubHeadEntity财务信息 FEntity.SubHeadEntity.FSettleOrgID结算组织_function case '{{shopCode}}' when '10002480' then '104' else '103' end组织 FEntity.SubHeadEntity.FThirdBillNo第三方单据编号{{tradeNo}}第三方单据编号 FEntity.SubHeadEntity.FThirdBillId第三方单据平台单号{{sourceTradeNos}}第三方单据平台单号 FEntity.SubHeadEntity.FormId业务对象表单IdSAL_OUTSTOCK必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.SubHeadEntity.Operation执行的操作Save FEntity.SubHeadEntity.IsAutoSubmitAndAudit提交并审核true FEntity.SubHeadEntity.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.SubHeadEntity.InterationFlags允许负库存STK_InvCheckResult

系统集成总览

全面支持数据集成操作可视化、拖拽流式开发，无代码完成多套异构系统集成，降低使用门槛，提升交付速度。特别是在面向吉客云·奇门、金蝶云星空间API接口集成时，通过对API的设计、创建、测试、部署、集成、管理、运维、下线等全生命周期管理，帮助企业洞察运营状况，进一步优化流程，提高企业商业价值。基于Web图形界面，通过拖拽、连接、配置完成流程设计，数据整合和集成，高效打通业务系统，通过面向运营的统计报表，直观查看API各项指标，实现对全局和项目层级双维度的监控管理。再通过轻易云数据集成中台通过统一门户注册管理，将业务以API的方式对外开放，实现业务创新、能力输出。

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