吉客云·奇门和金蝶云星空集成接口设计

接通系统：吉客云·奇门

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

对接目标平台:金蝶云星空

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

接口方案配置

数据集成平台对应的配置吉客云·奇门与金蝶云星空的对接只要三步就能完成两个系统之间的数据对接。第一步根据吉客云·奇门的接口参数要求记录在轻易云集成平台。第二步配置吉客云·奇门与金蝶云星空之间的字段对应关系（更多方案可借鉴轻易云数据集成社区论坛中找到相关方案信息）第三步完成方案的检查参数设置：传递时间、重试次数、是否启动、前置条件等上线运行。轻易云数据集成中台提供快速与各种业务系统进行连接的能力，可以将软件接口上线到平台轻松实现数百款应用软件的数据互通。也可以将轻易云的集成能力嵌入到您的软件系统中，将数百款软件的集成能力变成您产品的功能与卖点，扩展额外收入，提升客户成交率，成交金额与满意度。

吉客云·奇门接口明细

API：oms.trade.fullinfoget
NAME：销售单查询
METHOD：POST

请求参数

接口字段名称预设值 modified_begin起始时间 modified_end结束时间 startModified最后修改时间（起始）{{LAST_SYNC_TIME datetime}} endModified最后修改时间（截止）{{CURRENT_TIME datetime}} tradeNo销售单号，多个用半角逗号分隔 pageSize每页记录数，默认50，最大100020 pageIndex页码，0为第1页{{PAGINATION_START_PAGE}} hasTotal默认返回，首次调用时可以传1获取总记录数1 startCreated创建时间（起始） endCreated创建时间（截止） startAuditTime审核时间（起始） endAuditTime审核时间（截止） startConsignTime发货时间（起始） endConsignTime发货时间（截止） tradeStatus订单状态 tradeType订单类型1 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店铺编号

金蝶云星空接口明细

调用接口：batchSave
接口名称：销售出库新增
方法：POST

请求参数

字段字段名称类型配置值 FBillTypeID单据类型stringXSCKD01_SYS FBillNo单据编号string FDate日期string FSaleOrgId销售组织string FCustomerID客户string FCarriageNO运输单号string FStockOrgId发货组织string FLinkPhone联系电话string FLinkMan收货人姓名string FReceiveAddress收货方地址string SubHeadEntity财务信息object SubHeadEntity.FSettleTypeID结算方式stringJSFS04_SYS SubHeadEntity.FReceiverAddress收货人地址string SubHeadEntity.FReceiverName收货人string SubHeadEntity.FReceiverMobile收货人手机string SubHeadEntity.FEntity明细信息array SubHeadEntity.FEntity.FMaterialID物料编码string SubHeadEntity.FEntity.FRealQty实发数量string SubHeadEntity.FEntity.FTaxPrice含税单价string SubHeadEntity.FEntity.FStockID仓库string SubHeadEntity.FEntity.FormId业务对象表单IdstringSAL_OUTSTOCK SubHeadEntity.FEntity.Operation执行的操作stringSave SubHeadEntity.FEntity.IsAutoSubmitAndAudit提交并审核booltrue SubHeadEntity.FEntity.IsVerifyBaseDataField验证基础资料boolfalse SubHeadEntity.FEntity.SubSystemId系统模块string21

系统数据集成价值

可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。