吉客云对接打通金蝶云星空销售单查询接口与销售出库新增接口

吉客云对接打通金蝶云星空销售单查询接口与销售出库新增接口

源系统:吉客云

“吉客云”是一站式企业数字化解决方案系统，可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案，“吉客云”具有业务流程更流畅，数据共享更充分，使用成本更低廉等优势。不仅如此，通过“吉链”，可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道，数据对接就像加微信好友一样方便！

目标系统:金蝶云星空

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

数据对接方案

轻易云集成平台的对接是通过一个个对应的对接方案去形成两个系统对接的连线，所以对接方案的配置极其重要，方案可以选择一键复制，轻易云有海量的对接方案可支持一键复制，复制后直接启动使用（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息。或者可以通过手工配置，配置只要确认源平台：吉客云的取数逻辑，例如什么时间取什么样的数据。即可完成配置，目标平台：金蝶云星空，把获取的数据组装成目标系统需要的格式进行写入。

吉客云接口明细

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

请求参数

接口字段	字段名称	预设值	描述
modified_begin	起始时间		修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
modified_end	结束时间		修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空
startModified	最后修改时间（起始）
endModified	最后修改时间（截止）
tradeNo	销售单号，多个用半角逗号分隔
pageSize	每页记录数，默认50，最大1000	{{PAGINATION_PAGE_SIZE}}
pageIndex	页码，0为第1页	{{PAGINATION_START_PAGE}}
hasTotal	默认返回，首次调用时可以传1获取总记录数	1
startCreated	创建时间（起始）
endCreated	创建时间（截止）
startAuditTime	审核时间（起始）
endAuditTime	审核时间（截止）
startConsignTime	发货时间（起始）	2021-11-29 00:00:00
endConsignTime	发货时间（截止）	2021-11-30 23:59:59
tradeStatus	订单状态
tradeType	订单类型	2
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	单据类型	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
FEntity.FTaxPrice	含税单价	string	{{goodsDetail.sellPrice}}
FEntity.FDiscount	折扣额	string	{{goodsDetail.discountTotal}}
FEntity.FEntryTaxRate	税率	string
FEntity.FIsFree	赠品	string	{{goodsDetail.isGift}}
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

系统对接概况

大部分的企业都可能只用一套系统组织架构复杂，业务流程繁琐，内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆，造成IT部门数据监管困难！如何在同一套中台系统上关联多管理系统呢？系统集成平台，就可以无缝集成各个业务系统，主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。