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

接入系统：吉客云·奇门

吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求，重新定位、全新设计推出的换代产品，从业务数字化和组织数字化两个方向出发，以构建流程的闭环为依归，致力于为企业的数字化升级提供落地工具。

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

金蝶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，最大1000string 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平台商品idstring 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店铺idstring 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自定义字段1string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn2自定义字段2string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn3自定义字段3string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn4自定义字段4string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn5自定义字段5string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn6自定义字段6string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn7自定义字段7string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn8自定义字段8string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn9自定义字段9string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn10自定义字段10string 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.goodsDetail_goodsDelivery_batchamount对接金额string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.goodsDetail_goodsDelivery_sendCount对接数量string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.shopCode店铺编号string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.consignTime_new发货日期string

金蝶云星空接口明细

API：batchSave
NAME：写入空操作
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillNo出库单号出库单号 FBillTypeID单据类型XSCKD01_SYS单据类型 FDate日期{{consignTime_new}}日期 FSaleOrgId销售组织function case '{{shopCode}}' when '10002480' then '104' else '103' end组织 FCustomerID客户{{shopCode}}基础资料 FStockOrgId发货组织103组织 FNote备注代发货(来自分销商)多行文本 FAPIAPItrue多行文本 FReceiveAddress收货人地址文本 F_ora_Assistant3搭赠类型SO文本 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有效期至 FEntity.FEntrynote备注文本 FEntity.FSOORDERNO订单单号金蝶自定义 FEntity.FTHIRDENTRYID管易订单单号金蝶自定义 FEntity.FORDERNUM管易订单单号金蝶自定义 FEntity.FPLATFORMNUM管易平台单号金蝶自定义 FEntity.SubHeadEntity财务信息 FEntity.SubHeadEntity.FSettleOrgID结算组织_function case '{{shopCode}}' when '10002480' then '104' else '103' end组织 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

系统打通概况

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。

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