金蝶云星空和吉客云单据接口对接
接入系统:吉客云
吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求,重新定位、全新设计推出的换代产品,从业务数字化和组织数字化两个方向出发,以构建流程的闭环为依归,致力于为企业的数字化升级提供落地工具。
写入目标:金蝶云星空
金蝶K/3Cloud(金蝶云星空)是移动互联网时代的新型ERP,是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”,旨在帮助企业打造面向新时代的生态互联与协同平台,围绕生态中的每个角色,提供随手可得的云服务,最终实现敏捷协同,智慧运营的企业运营新境界。整个产品采用SOA架构,完全基于BOS平台组建而成,业务架构上贯穿流程驱动与角色驱动思想,结合中国管理模式与中国管理实践积累,精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建,支持跨数据库应用,支持本地部署、私有云部署与公有云部署三种部署方式,同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业,其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
接口方案配置
通过轻易云系统数据集成平台新增创建集成方案,通过轻易云的方案市场可以一键复制,并且可以借鉴其他的方案配置完成方案制作,方案制作只需要两步,第一步先确定好对应的数据来源;源系统:吉客云接口:销售单查询通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统:金蝶云星空接口:销售出库新增,通过写入调度者匹配获取到的数据和写入的映射关系,即可自动生成符合目标系统:金蝶云星空写入的数据自动产生写入队列,通过运行概况,系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况
吉客云接口明细
- API:jackyun.tradenotsensitiveinfos.list.get
- NAME:销售单查询
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
---|---|---|---|
modified_begin | 起始时间 | 修改起始时间,和结束时间必须同时存在,时间间隔不能超过七天,与线上单号不能同时为空 | |
modified_end | 结束时间 | 修改结束时间,和起始时间必须同时存在,时间间隔不能超过七天,与线上单号不能同时为空 | |
startModified | 最后修改时间(起始) | ||
endModified | 最后修改时间(截止) | ||
tradeNo | 销售单号,多个用半角逗号分隔 | ||
pageSize | 每页记录数,默认50,最大1000 | 50 | |
pageIndex | 页码,0为第1页 | {{PAGINATION_START_PAGE}} | |
startCreated | 创建时间(起始) | ||
endCreated | 创建时间(截止) | ||
startAuditTime | 审核时间(起始) | ||
endAuditTime | 审核时间(截止) | ||
startConsignTime | 发货时间(起始) | 2022-06-01 00:00:00 | |
endConsignTime | 发货时间(截止) | 2022-06-02 00:00:00 | |
tradeStatus | 订单状态 | ||
tradeType | 订单类型 | 91,7,5,2,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_l2iazxw0 from a7cb0b9d-2aef-342a-bcb9-7d02e747f1d8 where textField_l2iazxvw={{ShopCode}} |
FCustomerID | 客户 | string | _findCollection find textField_l2iazxvz from a7cb0b9d-2aef-342a-bcb9-7d02e747f1d8 where textField_l2iazxvw={{ShopCode}} |
FNote | 备注 | string | {{SellerMemo}} |
FStockOrgId | 发货组织 | string | findCollection find textField_l2ib4q9s from 0ce3a160-9fb2-36e5-a2ac-57f5ad0f3c72 where textField_l2ib4q9p={{WarehouseCode}} |
FOwnerIdHead | 货主 | string | _findCollection find textField_l2ib4q9s from 0ce3a160-9fb2-36e5-a2ac-57f5ad0f3c72 where textField_l2ib4q9p={{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.FSoorDerno | 订单单号 | string | {{OnlineTradeNo}} |
FEntity.FJKShopNumber | 网店订单号 | string | {{OnlineTradeNo}} |
FEntity.FPostid | 吉客云物流单号 | string | {{MainPostid}} |
FEntity.FWeight | 包裹重量 | string | {{EstimateWeight}} |
FEntity.FLogisticName | 物流公司 | string | {{LogisticName}} |
FEntity.FSaleDeptID | 销售部门 | string | findCollection find textField_l2iazxw1 from a7cb0b9d-2aef-342a-bcb9-7d02e747f1d8 where textField_l2iazxvw={{ShopCode}} |
FEntity.FDeliveryDeptID | 发货部门 | string | _findCollection find textField_l2ic44lv from 0ce3a160-9fb2-36e5-a2ac-57f5ad0f3c72 where textField_l2ib4q9p={{WarehouseCode}} |
FEntity.F_QKZI_Assistant | 往来类型 | string | WL001 |
FEntity.FormId | 业务对象表单Id | string | SAL_OUTSTOCK |
FEntity.Operation | 执行的操作 | string | Save |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | false |
FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | false |
FEntity.InterationFlags | 允许负库存 | bool | STK_InvCheckResult |
FEntity.SubSystemId | 系统模块 | string | 21 |
系统集成总览
全面管控企业的API资产,梳理现有业务系统的API。实现API文档的统一管理,建立API的上线、下线、监控的统一管理体系。API低代码开发平台能够实现低代码或零代码一键发布API服务,很好地解决企业用户上面的问题。轻易云应用集成主要解决已有应用系统的无序蔓延现象,减少各业务系统间的维护成本,减少各应用系统的操作系统、开发语言、访问协议、通信技术多而杂、整合难度大的问题,将企业数据平滑对接,减少信息竖井。