吉客云·奇门对接打通金蝶云星空销售单查询接口与销售出库新增接口
对接系统：吉客云·奇门
“吉客云”是一站式企业数字化解决方案系统，可实现业务、财务、办公、人事等一体化管理。相对于传统多套软件系统的集成方案，“吉客云”具有业务流程更流畅，数据共享更充分，使用成本更低廉等优势。不仅如此，通过“吉链”，可以快捷的与您的合作伙伴进行系统对接。同时“吉客云”还打造了供销关系、仓储委托关系、生产委外加工关系、物流代发关系等多种企业间数字化协作通道，数据对接就像加微信好友一样方便！
写入目标:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
系统对接接口配置
集成方案是整个轻易云集成平台的核心，每一个集成方案代表一种业务的对接策略（对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息），用户可以根据业务的不同新建多个不同规则的集成方案。比如：采购订单同步，线上销售出库同步，线下销售出库同步。一个集成方案必须要配置源系统：吉客云·奇门，源系统 API：销售单查询，目标系统：金蝶云星空，目标系统 API销售出库新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。
吉客云·奇门接口明细
- 接口：oms.trade.fullinfoget
- 接口名称：销售单查询
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| modified_begin | 起始时间 | string | 修改起始时间，和结束时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 |
| modified_end | 结束时间 | string | 修改结束时间，和起始时间必须同时存在，时间间隔不能超过七天，与线上单号不能同时为空 |
| startModified | 最后修改时间（起始） | string | |
| endModified | 最后修改时间（截止） | string | |
| tradeNo | 销售单号，多个用半角逗号分隔 | string | |
| pageSize | 每页记录数，默认50，最大1000 | string | |
| 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 | 店铺id | string | |
| fields | 需要返回字段列表逗号分隔 | string | |
| 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 | 应收金额 | float | |
| 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 | 单据类型 | XSCKD01_SYS | 单据类型 |
| FBillNo | 单据编号 | 单据编号 | |
| FDate | 日期 | 日期 | |
| FSaleOrgId | 销售组织 | 组织 | |
| FCustomerID | 客户 | 基础资料 | |
| FCarriageNO | 运输单号 | 文本 | |
| FStockOrgId | 发货组织 | 组织 | |
| FLinkPhone | 联系电话 | 文本 | |
| FLinkMan | 收货人姓名 | 文本 | |
| FReceiveAddress | 收货方地址 | 文本 | |
| SubHeadEntity | 财务信息 | ||
| SubHeadEntity.FSettleTypeID | 结算方式 | JSFS04_SYS | 基础资料 |
| SubHeadEntity.FReceiverAddress | 收货人地址 | 文本 | |
| SubHeadEntity.FReceiverName | 收货人 | 文本 | |
| SubHeadEntity.FReceiverMobile | 收货人手机 | 文本 | |
| SubHeadEntity.FEntity | 明细信息 | ||
| SubHeadEntity.FEntity.FMaterialID | 物料编码 | 基础资料 | |
| SubHeadEntity.FEntity.FRealQty | 实发数量 | 数量 | |
| SubHeadEntity.FEntity.FTaxPrice | 含税单价 | 单价 | |
| SubHeadEntity.FEntity.FStockID | 仓库 | 基础资料 | |
| SubHeadEntity.FEntity.FormId | 业务对象表单Id | SAL_OUTSTOCK | 必须填写金蝶的表单ID如
|
| SubHeadEntity.FEntity.Operation | 执行的操作 | Save | |
| SubHeadEntity.FEntity.IsAutoSubmitAndAudit | 提交并审核 | true | |
| SubHeadEntity.FEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| SubHeadEntity.FEntity.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
系统打通概况
大部分的企业都可能只用一套系统组织架构复杂，业务流程繁琐，内部同时有OA系统、BI系统、ERP系统......且各个系统都需要独立登陆，造成IT部门数据监管困难！如何在同一套中台系统上关联多管理系统呢？系统集成平台，就可以无缝集成各个业务系统，主数不统一、交易数据来回导出导入、业务融合等问题。通过轻易云系统集成平台完美结合：打破企业内部数据孤岛，无需繁琐的处理工序，与数据集成服务完美结合，让数据真正通起来。 资源互补：汇集各种行业解决方案，资源互补，企业管理融合提升。让对接开箱即用的、可视化拖、拉、拽实现接口服务编排与聚合。
