吉客云·奇门对接打通金蝶云星空销售单查询接口与写入空操作接口
吉客云·奇门对接打通金蝶云星空销售单查询接口与写入空操作接口
对接系统吉客云·奇门
吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求，重新定位、全新设计推出的换代产品，从业务数字化和组织数字化两个方向出发，以构建流程的闭环为依归，致力于为企业的数字化升级提供落地工具。
对接系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据接口配置方案
通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：吉客云·奇门，然后选择对应的连接器。选择对应的jackyun.tradenotsensitiveinfos.list.get作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的写入空操作接口作为数据写入动作完成第一步的接口配置。
吉客云·奇门接口明细
- 接口：jackyun.tradenotsensitiveinfos.list.get
- 接口名称：销售单查询
- 接口方法：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 | |
| fields | 需要返回字段列表逗号分隔 | 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 |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：写入空操作
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
| FBillNo | 出库单号 | string | 出库单号 |
| FBillTypeID | 单据类型 | string | 单据类型 |
| FDate | 日期 | string | 日期 |
| FSaleOrgId | 销售组织 | string | 组织 |
| FCustomerID | 客户 | string | 基础资料 |
| FStockOrgId | 发货组织 | string | 组织 |
| FNote | 备注 | string | 多行文本 |
| FAPI | API | string | 多行文本 |
| FReceiveAddress | 收货人地址 | string | 文本 |
| F_ora_Assistant3 | 搭赠类型 | string | 文本 |
| FEntity | 明细信息 | array | |
| FEntity.FMaterialID | 物料编码 | string | 基础资料 |
| FEntity.FUnitID | 库存单位 | string | 基础资料 |
| FEntity.FRealQty | 实发数量 | string | 数量 |
| FEntity.FPriceUnitId | 计价单位 | string | 基础资料 |
| FEntity.FSalUnitID | 销售单位 | string | 基础资料 |
| FEntity.FTaxPrice | 含税单价 | string | 单价 |
| FEntity.FEntryTaxRate | 税率% | string | 小数 |
| FEntity.FStockID | 仓库 | string | 基础资料 |
| FEntity.FLot | 批次号 | string | |
| FEntity.FProduceDate | 生产日期 | string | |
| FEntity.FExpiryDate | 有效期至 | string | |
| FEntity.FEntrynote | 备注 | string | 文本 |
| FEntity.FSOORDERNO | 订单单号 | string | 金蝶自定义 |
| FEntity.FTHIRDENTRYID | 管易订单单号 | string | 金蝶自定义 |
| FEntity.FORDERNUM | 管易订单单号 | string | 金蝶自定义 |
| FEntity.FPLATFORMNUM | 管易平台单号 | string | 金蝶自定义 |
| FEntity.SubHeadEntity | 财务信息 | object | |
| FEntity.SubHeadEntity.FSettleOrgID | 结算组织 | string | 组织 |
| FEntity.SubHeadEntity.FThirdBillNo | 第三方单据编号 | string | 第三方单据编号 |
| FEntity.SubHeadEntity.FThirdBillId | 第三方单据平台单号 | string | 第三方单据平台单号 |
| FEntity.SubHeadEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如:PUR_PurchaseOrder |
| FEntity.SubHeadEntity.Operation | 执行的操作 | string | |
| FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| FEntity.SubHeadEntity.InterationFlags | 允许负库存 | string |
数据对接效果
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
Copyright Notice
The article "吉客云·奇门对接打通金蝶云星空销售单查询接口与写入空操作接口" is original content owned by 广东轻亿云软件科技有限公司. Reposting is welcome, provided the source (including the original link) is credited in a prominent position.