金蝶云星空和吉客云单据接口对接
![](https://i-blog.csdnimg.cn/blog_migrate/1dde12d1cdab796058c43018382839bb.jpeg)
源系统:吉客云
吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求,重新定位、全新设计推出的换代产品,从业务数字化和组织数字化两个方向出发,以构建流程的闭环为依归,致力于为企业的数字化升级提供落地工具。
目标系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据集成方案配置
使用轻易云系统数据集成平台对应的模块:数据集成方案。然后选择开始创建数据集成方案。在方案配置表单中选择对应的源业务系统:吉客云,然后选择对应的连接器。选择对应的销售单查询作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空,并且选择对应连接器(关于金蝶云星空的接口如何配置可以在轻易云数据集成社区论坛中找到相关信息,选择好对应的销售出库新增接口作为数据写入动作,既可以完成第一步的数据对接配置。
![](https://i-blog.csdnimg.cn/blog_migrate/f49efd64af2909b4666786670f385d81.png)
吉客云接口明细
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的方式对外开放,实现业务创新、能力输出。
![](https://i-blog.csdnimg.cn/blog_migrate/ab7798b2d0cefd5e26ca6105775b7ba4.png)
![](https://i-blog.csdnimg.cn/blog_migrate/372d90f2c7b253fd0c8be4e5b406e971.png)
![](https://i-blog.csdnimg.cn/blog_migrate/802d4ebb39d979122f934afb66b87b31.png)