金蝶云星空和吉客云单据接口对接

金蝶云星空和吉客云单据接口对接

源系统:吉客云

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

目标系统:金蝶云星空

金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。

数据集成方案配置

使用轻易云系统数据集成平台对应的模块：数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统：吉客云，然后选择对应的连接器。选择对应的销售单查询作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器（关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的销售出库新增接口作为数据写入动作，既可以完成第一步的数据对接配置。

吉客云接口明细

• API：jackyun.tradenotsensitiveinfos.list.get

• NAME：销售单查询

• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
modified_begin	起始时间		修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
modified_end	结束时间		修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
startModified	最后修改时间（起始）
endModified	最后修改时间（截止）
tradeNo	销售单号，多个用半角逗号分隔
pageSize	每页记录数，默认50，最大1000	20
pageIndex	页码，0为第1页	{{PAGINATION_START_PAGE}}
hasTotal	默认返回，首次调用时可以传1获取总记录数	1
startCreated	创建时间（起始）
endCreated	创建时间（截止）
startAuditTime	审核时间（起始）
endAuditTime	审核时间（截止）
startConsignTime	发货时间（起始）	2022-02-22 00:00:00
endConsignTime	发货时间（截止）	2022-02-28 23:59:59
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	付尾款时间

金蝶云星空接口明细

• 调用接口：batchSave

• 接口名称：销售出库新增

• 方法：POST

请求参数

字段	字段名称	类型	配置值
FBillTypeID	单据类型	string	XSCKD07_SYS
FBillNo	单据编号	string	{{TradeNo}}
FDate	日期	string	{{ConsignTime}}
FSaleOrgId	销售组织	string	findCollection find textField_kvqkngs2 from ea596597-d03a-353b-8684-36dd37cf69bb where textField_kvg91fcn={{ShopCode}}
FCustomerID	客户	string	_findCollection find textField_kvg91fco from ea596597-d03a-353b-8684-36dd37cf69bb where textField_kvg91fcn={{ShopCode}}
FNote	备注	string	{{SellerMemo}}
FStockOrgId	发货组织	string	findCollection find textField_kvgbyy6b from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvgbyy68={{WarehouseCode}}
FOwnerIdHead	货主	string	_findCollection find textField_kvgbyy6b from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvgbyy68={{WarehouseCode}}
FEntity	明细信息	array	GoodsDetail
FEntity.FCustMatID	客户物料编码	string
FEntity.FMaterialID	物料编码	string	{{GoodsDetail.GoodsNo}}
FEntity.FRealQty	实发数量	string	{{GoodsDetail.SellCount}}
FEntity.FPrice	单价	string	{{GoodsDetail.SellPrice}}
FEntity.FAmount	金额	string
FEntity.FStockID	仓库	string	{{WarehouseCode}}
FEntity.FEntrynote	备注	string	{{GoodsMemo}}
FEntity.FTaxPrice	含税单价	string	{{GoodsDetail.SellPrice}}
FEntity.FDiscount	折扣额	string	{{GoodsDetail.DiscountFee}}
FEntity.FEntryTaxRate	税率	string
FEntity.F_JKBillNo	吉客云单据编号	string	{{TradeNo}}
FEntity.F_JKSHOPNUMBER	网店订单号	string	{{OnlineTradeNo}}
FEntity.F_PAEZ_Postid	吉客云物流单号	string	{{MainPostid}}
FEntity.F_PAEZ_Weight	包裹重量	string	{{EstimateWeight}}
FEntity.F_PAEZ_LogisticName	物流公司	string	{{LogisticName}}
FEntity.FormId	业务对象表单Id	string	SAL_OUTSTOCK
FEntity.Operation	执行的操作	string	Save
FEntity.IsAutoSubmitAndAudit	提交并审核	bool	true
FEntity.IsVerifyBaseDataField	验证基础资料	bool	false
FEntity.SubSystemId	系统模块	string	21

数据对接价值

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