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

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

来源系统:吉客云

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

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

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

配置集成方案

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：吉客云接口：销售单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：金蝶云星空接口：销售出库新增，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：金蝶云星空写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

吉客云接口明细

• API：jackyun.tradenotsensitiveinfos.list.get
• 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-12-01 00:00:00
endConsignTime	发货时间（截止）	2021-12-02 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	付尾款时间
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	{{GoodsMemo}}
FEntity.FTaxPrice	含税单价	string	{{GoodsDetail.SellPrice}}
FEntity.FDiscount	折扣额	string	{{GoodsDetail.DiscountTotal}}
FEntity.FEntryTaxRate	税率	string
FEntity.F_JKBillNo	吉客云单据编号	string	{{TradeNo}}
FEntity.FSHOPNUMBER	网店订单号	string	{{SourceTradeNo}}
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	false
FEntity.IsVerifyBaseDataField	验证基础资料	bool	false
FEntity.SubSystemId	系统模块	string	21

数据对接价值

通过无代码的数据集成与数据建模的智能数据管道技术，帮助企业将所有应用程序、数据库、事件和文件等数据信息提取到数据仓库中，并快速将分散的数据转化为数据集、API、自动化流程等开箱即用的数据服务。配置接口的模式对接吉客云和金蝶云星空，使得单据无缝互通。打造企业内部数据一体化，让企业日常运营管理实现敏捷数据化运营。实现供应链业务信息流的互通，同时支持供应链数据分析流程自动化，结果推送，推进相关供应链问题优化。及时打通供应链孤岛，实现数据驱动供应链协同，进一步提升企业竞争力。