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

来源系统:吉客云

“吉客云”是一站式企业数字化解决方案系统，可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案，“吉客云”具有业务流程更流畅，数据共享更充分，使用成本更低廉等优势。不仅如此，通过“吉链”，可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道，数据对接就像加微信好友一样方便！

目标系统:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

数据接口配置

系统对接前期需要通过调研公司的业务，规划出最便捷，效率最高的整体流程。通过流程我们需要建立对应的方案来吧这些流程一一的落地，轻易云集成平台开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。只需要根据指引设定好对应的参数即可启动使用。设定好源平台：吉客云的接口参数设置，以及设定好目标平台：金蝶云星空的映射，即可启动方案进行测试

吉客云接口明细

接口：oms.trade.fullinfoget
接口名称：销售单查询
接口方法：POST

请求参数

字段名称类型描述 modified_begin起始时间string修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 modified_end结束时间string修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 startModified最后修改时间（起始）string endModified最后修改时间（截止）string tradeNo销售单号，多个用半角逗号分隔string pageSize每页记录数，默认50，最大1000string pageIndex页码，0为第1页string hasTotal默认返回，首次调用时可以传1获取总记录数string startCreated创建时间（起始）string endCreated创建时间（截止）string startAuditTime审核时间（起始）string endAuditTime审核时间（截止）string startConsignTime发货时间（起始）string endConsignTime发货时间（截止）string tradeStatus订单状态string tradeType订单类型string sourceTradeNos网店订单号string shopIds店铺idstring fields需要返回字段列表逗号分隔string warehouseIds仓库idstring

响应参数

字段名称类型描述 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平台商品idstring 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店铺idstring 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自定义字段1string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn2自定义字段2string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn3自定义字段3string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn4自定义字段4string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn5自定义字段5string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn6自定义字段6string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn7自定义字段7string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn8自定义字段8string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn9自定义字段9string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.customizeTradeColumn10自定义字段10string 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标记idstring goodsDetail.tradeOrderPayList.tradeOrderColumnExt.flagNames标记名称string goodsDetail.tradeOrderPayList.tradeOrderColumnExt.shopCode店铺编号string

金蝶云星空接口明细

调用接口：batchSave
接口名称：销售出库新增
方法：POST

请求参数

字段字段名称类型配置值 FBillTypeID单据类型stringXSCKD07_SYS FBillNo单据编号string{{tradeNo}} FDate日期string{{consignTime}} FSaleOrgId销售组织stringfindCollection 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发货组织stringfindCollection 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明细信息arraygoodsDetail 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业务对象表单IdstringSAL_OUTSTOCK FEntity.Operation执行的操作stringSave FEntity.IsAutoSubmitAndAudit提交并审核booltrue FEntity.IsVerifyBaseDataField验证基础资料boolfalse FEntity.SubSystemId系统模块string21

数据对接价值

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

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