吉客云·奇门对接打通金蝶云星空销售单查询接口与写入空操作接口|轻易云数据集成平台

吉客云·奇门对接打通金蝶云星空销售单查询接口与写入空操作接口

对接系统吉客云·奇门

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

对接系统：金蝶云星空

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

数据接口配置方案

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：吉客云·奇门，然后选择对应的连接器。选择对应的jackyun.tradenotsensitiveinfos.list.get作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的写入空操作接口作为数据写入动作完成第一步的接口配置。

吉客云·奇门接口明细

接口：jackyun.tradenotsensitiveinfos.list.get
接口名称：销售单查询
接口方法：POST

请求参数

字段	名称	类型	描述
modified_begin	起始时间	string	修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
modified_end	结束时间	string	修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
startModified	最后修改时间（起始）	string
endModified	最后修改时间（截止）	string
tradeNo	销售单号，多个用半角逗号分隔	string
pageSize	每页记录数，默认50，最大1000	string
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	平台商品id	string
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	店铺id	string
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	自定义字段1	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn2	自定义字段2	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn3	自定义字段3	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn4	自定义字段4	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn5	自定义字段5	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn6	自定义字段6	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn7	自定义字段7	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn8	自定义字段8	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn9	自定义字段9	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn10	自定义字段10	string
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.flagIds	标记id	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.flagNames	标记名称	string
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.shopCode	店铺编号	string

金蝶云星空接口明细

接口：batchSave
接口名称：写入空操作
接口方法：POST

请求参数

字段	名称	类型	描述
FBillNo	出库单号	string	出库单号
FBillTypeID	单据类型	string	单据类型
FDate	日期	string	日期
FSaleOrgId	销售组织	string	组织
FCustomerID	客户	string	基础资料
FStockOrgId	发货组织	string	组织
FNote	备注	string	多行文本
FAPI	API	string	多行文本
FReceiveAddress	收货人地址	string	文本
F_ora_Assistant3	搭赠类型	string	文本
FEntity	明细信息	array
FEntity.FMaterialID	物料编码	string	基础资料
FEntity.FUnitID	库存单位	string	基础资料
FEntity.FRealQty	实发数量	string	数量
FEntity.FPriceUnitId	计价单位	string	基础资料
FEntity.FSalUnitID	销售单位	string	基础资料
FEntity.FTaxPrice	含税单价	string	单价
FEntity.FEntryTaxRate	税率%	string	小数
FEntity.FStockID	仓库	string	基础资料
FEntity.FLot	批次号	string
FEntity.FProduceDate	生产日期	string
FEntity.FExpiryDate	有效期至	string
FEntity.FEntrynote	备注	string	文本
FEntity.FSOORDERNO	订单单号	string	金蝶自定义
FEntity.FTHIRDENTRYID	管易订单单号	string	金蝶自定义
FEntity.FORDERNUM	管易订单单号	string	金蝶自定义
FEntity.FPLATFORMNUM	管易平台单号	string	金蝶自定义
FEntity.SubHeadEntity	财务信息	object
FEntity.SubHeadEntity.FSettleOrgID	结算组织	string	组织
FEntity.SubHeadEntity.FThirdBillNo	第三方单据编号	string	第三方单据编号
FEntity.SubHeadEntity.FThirdBillId	第三方单据平台单号	string	第三方单据平台单号
FEntity.SubHeadEntity.FormId	业务对象表单Id	string	必须填写金蝶的表单ID如:PUR_PurchaseOrder
FEntity.SubHeadEntity.Operation	执行的操作	string
FEntity.SubHeadEntity.IsAutoSubmitAndAudit	提交并审核	bool
FEntity.SubHeadEntity.IsVerifyBaseDataField	验证基础资料	bool	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FEntity.SubHeadEntity.InterationFlags	允许负库存	string

数据对接效果

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