吉客云对接打通金蝶云星空销售单查询接口与销售出库新增接口
接入系统:吉客云
“吉客云”是一站式企业数字化解决方案系统,可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案,“吉客云”具有业务流程更流畅,数据共享更充分,使用成本更低廉等优势。不仅如此,通过“吉链”,可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道,数据对接就像加微信好友一样方便!
集成系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
接口方案配置
系统对接前期需要通过调研公司的业务,规划出最便捷,效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地,轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台:吉客云的接口参数设置,以及设定好目标平台:金蝶云星空的映射,即可启动方案进行测试
吉客云接口明细
- 调用接口:oms.trade.fullinfoget
- 接口名称:销售单查询
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
---|---|---|---|
modified_begin | 起始时间 | string | |
modified_end | 结束时间 | string | |
startModified | 最后修改时间(起始) | string | 2021-11-16 00:00:00 |
endModified | 最后修改时间(截止) | string | {{CURRENT_TIME datetime}} |
tradeNo | 销售单号,多个用半角逗号分隔 | string | |
pageSize | 每页记录数,默认50,最大1000 | string | {{PAGINATION_PAGE_SIZE}} |
pageIndex | 页码,0为第1页 | string | {{PAGINATION_START_PAGE}} |
hasTotal | 默认返回,首次调用时可以传1获取总记录数 | string | 1 |
startCreated | 创建时间(起始) | string | 2021-11-14 11:17:00 |
endCreated | 创建时间(截止) | string | 2021-11-15 18:17:00 |
startAuditTime | 审核时间(起始) | string | |
endAuditTime | 审核时间(截止) | string | |
startConsignTime | 发货时间(起始) | string | |
endConsignTime | 发货时间(截止) | string | |
tradeStatus | 订单状态 | string | 6000 |
tradeType | 订单类型 | string | |
sourceTradeNos | 网店订单号 | string | |
shopIds | 店铺id | string | |
fields | 需要返回字段列表逗号分隔 | string | 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 | string |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
---|---|---|---|
checkTotal | 对账金额 | string | |
tradeNo | 订单编号 | string | |
postFee | 实际邮资 | string | |
otherFee | 其它费用 | string | |
sellerMemo | 备注 | string | |
buyerMemo | 买家备注 | string | |
goodsDetail | 货品详情 | array | |
goodsDetail.goodsNo | 货品编号 | string | |
goodsDetail.goodsName | 货品名称 | string | |
goodsDetail.specName | 规格名称 | string | |
goodsDetail.barcode | 条码 | string | |
goodsDetail.sellCount | 数量 | string | |
goodsDetail.unit | 单位 | string | |
goodsDetail.sellPrice | 单价 | string | |
goodsDetail.sellTotal | 总金额 | string | |
goodsDetail.cost | 货品成本 | string | |
goodsDetail.discountTotal | 优惠金额 | string | |
goodsDetail.discountPoint | 抵扣积分 | string | |
goodsDetail.shareFavourableFee | 分摊金额 | string | |
goodsDetail.goodsMemo | 货品备注 | string | |
goodsDetail.cateName | 货品类别 | string | |
goodsDetail.brandName | 品牌 | string | |
goodsDetail.goodsTags | 货品标签 | string | |
goodsDetail.isFit | 组合装标记 | string | |
goodsDetail.isGift | 赠品标记 | string | |
goodsDetail.taxRate | 税率 | string | |
goodsDetail.estimateGoodsVolume | 预估体积(单个货品) | string | |
goodsDetail.isPresell | 是否预售货品标记1是0否 | string | |
goodsDetail.customerPrice | 终端销售单价 | string | |
goodsDetail.customerTotal | 终端销售金额 | string | |
goodsDetail.tradeGoodsNo | 交易编号 | string | |
goodsDetail.tradeGoodsName | 交易名称 | string | |
goodsDetail.tradeGoodsSpec | 交易规格 | string | |
goodsDetail.tradeGoodsUnit | 交易单位 | string | |
goodsDetail.sourceTradeNo | 网店订单号 | string | |
goodsDetail.sourceSubtradeNo | 网店子订单好 | string | |
goodsDetail.platCode | 平台代码 | string | |
goodsDetail.platGoodsId | 平台商品id | string | |
goodsDetail.subTradeId | 商品明细id(唯一) | string | |
goodsDetail.taxFee | 税额 | string | |
goodsDetail.estimateWeight | 预估重量 | string | |
goodsDetail.discountFee | 优惠金额 | string | |
goodsDetail.appendMemo | 追加备注 | string | |
goodsDetail.tradeFrom | 订单来源 | string | |
goodsDetail.register | 登记人 | string | |
goodsDetail.seller | 业务员 | string | |
goodsDetail.auditor | 审核人 | string | |
goodsDetail.reviewer | 复核人 | string | |
goodsDetail.packageWeight | 包裹重量 | string | |
goodsDetail.tradeCount | 订单总数量 | string | |
goodsDetail.goodsTypeCount | 商品样数 | string | |
goodsDetail.freezeReason | 冻结原因 | string | |
goodsDetail.abnormalDescription | 问题单具体描述 | string | |
goodsDetail.onlineTradeNo | 网店订单号 | string | |
goodsDetail.goodslist | 货品摘要 | string | |
goodsDetail.gmtCreate | 创建时间 | string | |
goodsDetail.gmtModified | 最后修改时间 | string | |
goodsDetail.stockoutNo | 出库单号 | string | |
goodsDetail.confirmTime | 确认时间 | string | |
goodsDetail.departName | 部门名称 | string | |
goodsDetail.lastShipTime | 承诺发货时间 | string | |
goodsDetail.payStatus | 付款状态:未付款、部分付款、已付款 | string | |
goodsDetail.tradeStatus | 订单状态 | string | |
goodsDetail.grossProfit | 毛利 | string | |
goodsDetail.estimateVolume | 订单预估体积 | string | |
goodsDetail.customerName | 客户名称 | string | |
goodsDetail.customerTypeName | 客户类型 | string | |
goodsDetail.customerGradeName | 客户等级 | string | |
goodsDetail.customerTags | 客户标签 | string | |
goodsDetail.customerCode | 客户编号 | string | |
goodsDetail.customerDiscount | 折扣 | string | |
goodsDetail.specialReminding | 特别提醒 | string | |
goodsDetail.blackList | 黑名单 | string | |
goodsDetail.tradeTime | 下单时间 | string | |
goodsDetail.country | 国家 | string | |
goodsDetail.state | 省 | string | |
goodsDetail.city | 城市 | string | |
goodsDetail.district | 区县 | string | |
goodsDetail.town | 街道 | string | |
goodsDetail.zip | 邮编 | string | |
goodsDetail.payTime | 支付时间 | string | |
goodsDetail.countryCode | 国家编码 | string | |
goodsDetail.cityCode | 城市编码 | string | |
goodsDetail.invoiceType | 发票类型 | string | |
goodsDetail.payerName | 购方名称 | string | |
goodsDetail.payerRegno | 购方税号 | string | |
goodsDetail.payerBankAccount | 购方开户行及帐号 | string | |
goodsDetail.payerPhone | 购方电话 | string | |
goodsDetail.auditTime | 审核时间 | string | |
goodsDetail.payerAddress | 购方地址 | string | |
goodsDetail.invoiceNo | 发票号码 | string | |
goodsDetail.invoiceCode | 发票代码 | string | |
goodsDetail.invoiceStatus | 发票开具状态 | string | |
goodsDetail.payerBankName | 购方开户行 | string | |
goodsDetail.preTypedetail | 预定类别描述 | string | |
goodsDetail.firstPayment | 付首款金额 | string | |
goodsDetail.finalPayment | 付尾款金额 | string | |
goodsDetail.firstPaytime | 付首款时间 | string | |
goodsDetail.finalPaytime | 付尾款时间 | string | |
goodsDetail.reviewTime | 复核时间 | string | |
goodsDetail.activationTime | 激活时间 | string | |
goodsDetail.customerTotalFee | 终端货款合计 | string | |
goodsDetail.customerDiscountFee | 终端优惠 | string | |
goodsDetail.notifyPickTime | 通知仓库发货时间 | string | |
goodsDetail.consignTime | 发货时间 | string | |
goodsDetail.orderNo | 发货单单号 | string | |
goodsDetail.customerPostFee | 终端应收邮资 | string | |
goodsDetail.shopId | 店铺id | string | |
goodsDetail.shopName | 店铺名称 | string | |
goodsDetail.tradeOrderPayList | 订单支付详情 | array | |
goodsDetail.tradeOrderPayList.chargeCurrency | 结算币种 | string | |
goodsDetail.tradeOrderPayList.accountName | 收款账户名称 | string | |
goodsDetail.tradeOrderPayList.payType | 支付方式:1,支付宝 2,财付通 3,微信支付 4,银联支付 5,盛付通 6,其它 7,现金 8,储值卡 9,扫码付 10,挂账 11,诺诺支付 16,易付宝 32,有赞支付 33,汇付支付 35,商盟支付 36,易宝支付 37,汇聚支付 38,合利宝支付 27,通联支付 | string | |
goodsDetail.tradeOrderPayList.payNo | 支付单号 | string | |
goodsDetail.tradeOrderPayList.chargeCurrencyCode | 结算币种编码 | string | |
goodsDetail.tradeOrderPayList.chargeExchangeRate | 结算汇率 | string | |
goodsDetail.tradeOrderPayList.chargeType | 结算方式:1.担保交易2.银行收款3.现金收款4.货到付款5.欠款计应收6.客户预存款7.多种结算8.退换货冲抵9.电子钱包 | string | |
goodsDetail.tradeOrderPayList.chargeAccount | 收款帐户 | string | |
goodsDetail.tradeOrderPayList.payment | 应收金额 | string | |
goodsDetail.tradeOrderPayList.customerPayment | 终端应收合计 | string | |
goodsDetail.tradeOrderPayList.companyName | 公司名称 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt | 销售单自定义字段 | object | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn1 | 自定义字段1 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn2 | 自定义字段2 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn3 | 自定义字段3 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn4 | 自定义字段4 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn5 | 自定义字段5 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn6 | 自定义字段6 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn7 | 自定义字段7 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn8 | 自定义字段8 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn9 | 自定义字段9 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn10 | 自定义字段10 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.tradeId | 系统编码 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.isBillCheck | 对账状态 1对账,其他未对账 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.warehouseCode | 仓库编码 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.warehouseName | 仓库名称 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.logisticName | 物流名称 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.billDate | 对账时间 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.logisticType | 配送方式 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.mainPostid | 运单号 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.tradeType | 订单类型 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.totalFee | 商品金额 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.receivedPostFee | 应收邮资 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.couponFee | 平台优惠 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.receivedTotal | 已收金额 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.isDelete | 删除标记,0 未删除, 1已删除 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.flagIds | 标记id | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.flagNames | 标记名称 | string | |
goodsDetail.tradeOrderPayList.tradeOrderColumnExt.shopCode | 店铺编号 | string |
金蝶云星空接口明细
- API:batchSave
- NAME:销售出库新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
---|---|---|---|
FBillTypeID | 单据类型 | XSCKD07_SYS | 单据类型 |
FBillNo | 单据编号 | 单据编号 | |
FDate | 日期 | {{tradeTime}} | 日期 |
FSaleOrgId | 销售组织 | findCollection find textField_kvqkngs2 from ea596597-d03a-353b-8684-36dd37cf69bb where textField_kvg91fcn={{shopCode}} | 组织 |
FCustomerID | 客户 | _findCollection find textField_kvg91fco from ea596597-d03a-353b-8684-36dd37cf69bb where textField_kvg91fcn={{shopCode}} | 基础资料 |
FNote | 备注 | {{sellerMemo}} | 多行文本 |
FStockOrgId | 发货组织 | findCollection find textField_kvgbyy6b from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvgbyy68={{warehouseCode}} | 多类别基础资料 |
FOwnerIdHead | 货主 | _findCollection find textField_kvgbyy6b from ba7b4c50-b81c-315d-835f-9e07995df2a1 where textField_kvgbyy68={{warehouseCode}} | 多类别基础资料 |
FEntity | 明细信息 | goodsDetail | |
FEntity.FCustMatID | 客户物料编码 | 基础资料 | |
FEntity.FMaterialID | 物料编码 | {{goodsDetail.goodsNo}} | 基础资料 |
FEntity.FRealQty | 实发数量 | {{goodsDetail.sellCount}} | 数量 |
FEntity.FPrice | 单价 | {{goodsDetail.sellPrice}} | 单价 |
FEntity.FAmount | 金额 | 金额 | |
FEntity.FStockID | 仓库 | {{warehouseCode}} | 基础资料 |
FEntity.FEntrynote | 备注 | {{sellerMemo}} | 文本 |
FEntity.FTaxPrice | 含税单价 | {{goodsDetail.sellPrice}} | |
FEntity.FDiscount | 折扣额 | {{goodsDetail.discountTotal}} | |
FEntity.FEntryTaxRate | 税率 | ||
FEntity.F_JKBillNo | 吉客云单据编号 | {{tradeNo}} | |
FEntity.FSHOPNUMBER | 网店订单号 | {{sourceTradeNo}} | |
FEntity.F_PAEZ_Postid | 吉客云物流单号 | {{mainPostid}} | |
FEntity.F_PAEZ_Weight | 包裹重量 | {{estimateWeight}} | |
FEntity.F_PAEZ_LogisticName | 物流公司 | {{logisticName}} | |
FEntity.FormId | 业务对象表单Id | SAL_OUTSTOCK | 必须填写金蝶的表单ID如 |
FEntity.Operation | 执行的操作 | Save | |
FEntity.IsAutoSubmitAndAudit | 提交并审核 | false | |
FEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
FEntity.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
数据对接价值
全新的API数据集成模式,赋能企业业务创新 传统企业集成主要采用点对点或ESB集成方式,基于全新API战略中台的API新型集成方式通过解耦系统资源,降低系统间对接难度,实现快速业务需求响应,提升对接效率,助力企业满足快速业务交付需求,实现业务创新。通过构建API生态,助力能力开放与共享 基于API战略中台梳理并整合内部API资源与IT资产,可实现内部资源共享,满足内部开发人员资源使用需求,例如:金蝶云星空与吉客云之间数据集成;并将API资源对外可控开放,打造面向开发者的生态服务,为您打通自身和上下游合作伙伴,创造共赢价值链。开展API战略中台,重塑IT 帮助您基于内部资源构建不同业务能力中心,打造企业统一API战略中台,赋能企业发展,实现对业务频繁变化的快速响应。同时您在能力中心基础上构建新业务时,无需从“零”组建各业务模块,提升开发效率,重塑IT组织及交付能力。