通过金蝶云之星销售订单查询界面和销售出库新界面对接 JikCloud
吉客云对接打通金蝶云星空销售单查询接口与销售出库新增接口
源系统:吉客云
“吉客云”是一站式企业数字化解决方案系统,可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案,“吉客云”具有业务流程更流畅,数据共享更充分,使用成本更低廉等优势。不仅如此,通过“吉链”,可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道,数据对接就像加微信好友一样方便!
目标系统:金蝶云星空
金蝶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部门数据监管困难!如何在同一套中台系统上关联多管理系统呢?系统集成平台,就可以无缝集成各个业务系统,主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合:打破企业内部数据孤岛,无需繁琐的处理工序,与数据集成服务完美结合,让数据真正通起来。 资源互补:汇集各种行业解决方案,资源互补,企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。
上一篇: 个人记账软件 - 开源免费