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

数据源平台:吉客云

杭州吉客云网络技术有限公司是经国家认定的高新技术企业，是国内领先的SaaSERP软件服务商，致力于为企业提供安全稳定、高可用性和高扩展性的一站式数字化解决方案。

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

金蝶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，最大100050 pageIndex页码，0为第1页{{PAGINATION_START_PAGE}} startCreated创建时间（起始） endCreated创建时间（截止） startAuditTime审核时间（起始） endAuditTime审核时间（截止） startConsignTime发货时间（起始）2022-06-21 00:00:00 endConsignTime发货时间（截止）2022-06-23 00:00:00 tradeStatus订单状态6000 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店铺编号

金蝶云星空接口明细

API：batchSave
NAME：销售出库新增
METHOD：POST

请求参数

接口字段字段名称预设值描述 FBillTypeID单据类型XSCKD07_SYS单据类型 FBillNo单据编号{{TradeNo}}单据编号 FDate日期{{ConsignTime}}日期 FSaleOrgId销售组织findCollection find textField_l2iazxw0 from a7cb0b9d-2aef-342a-bcb9-7d02e747f1d8 where textField_l2iazxvw={{ShopCode}}组织 FCustomerID客户_findCollection find textField_l2iazxvz from a7cb0b9d-2aef-342a-bcb9-7d02e747f1d8 where textField_l2iazxvw={{ShopCode}}基础资料 FNote备注{{SellerMemo}}多行文本 FStockOrgId发货组织findCollection find textField_l2ib4q9s from 0ce3a160-9fb2-36e5-a2ac-57f5ad0f3c72 where textField_l2ib4q9p={{WarehouseCode}}多类别基础资料 FOwnerIdHead货主_findCollection find textField_l2ib4q9s from 0ce3a160-9fb2-36e5-a2ac-57f5ad0f3c72 where textField_l2ib4q9p={{WarehouseCode}}多类别基础资料 FEntity明细信息GoodsDetail FEntity.FCustMatID客户物料编码基础资料 FEntity.FMaterialID物料编码{{GoodsDetail.GoodsNo}}基础资料 FEntity.FRealQty实发数量{{GoodsDetail.SellCount}}数量 FEntity.FPrice单价{{GoodsDetail.SellPrice}}单价 FEntity.FAmount金额金额 FEntity.FStockID仓库{{WarehouseCode}}基础资料 FEntity.FEntrynote备注{{GoodsMemo}}文本 FEntity.FTaxPrice含税单价{{GoodsDetail.SellPrice}} FEntity.FDiscount折扣额{{GoodsDetail.DiscountFee}} FEntity.FEntryTaxRate税率 FEntity.FSoorDerno订单单号{{OnlineTradeNo}} FEntity.FJKShopNumber网店订单号{{OnlineTradeNo}} FEntity.FPostid吉客云物流单号{{MainPostid}} FEntity.FWeight包裹重量{{EstimateWeight}} FEntity.FLogisticName物流公司{{LogisticName}} FEntity.FSaleDeptID销售部门findCollection find textField_l2iazxw1 from a7cb0b9d-2aef-342a-bcb9-7d02e747f1d8 where textField_l2iazxvw={{ShopCode}} FEntity.FDeliveryDeptID发货部门_findCollection find textField_l2ic44lv from 0ce3a160-9fb2-36e5-a2ac-57f5ad0f3c72 where textField_l2ib4q9p={{WarehouseCode}} FEntity.F_QKZI_Assistant往来类型WL001 FEntity.FormId业务对象表单IdSAL_OUTSTOCK必须填写金蝶的表单ID如😛UR_PurchaseOrder FEntity.Operation执行的操作Save FEntity.IsAutoSubmitAndAudit提交并审核false FEntity.IsVerifyBaseDataField验证基础资料false是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.InterationFlags允许负库存STK_InvCheckResult是否验证所有的基础资料有效性，布尔类，默认false（非必录） FEntity.SubSystemId系统模块21默认仓库模块

系统打通概况

从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通吉客云到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。

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