吉客云·奇门和金蝶云星空接口打通对接实战
吉客云·奇门和金蝶云星空接口打通对接实战
来源系统:吉客云·奇门
吉客云是基于“网店管家”十五年电商ERP行业和技术积累基础上顺应产业发展需求，重新定位、全新设计推出的换代产品，从业务数字化和组织数字化两个方向出发，以构建流程的闭环为依归，致力于为企业的数字化升级提供落地工具。
对接系统：金蝶云星空
金蝶K/3Cloud在总结百万家客户管理最佳实践的基础上，提供了标准的管理模式；通过标准的业务架构：多会计准则、多币别、多地点、多组织、多税制应用框架等，有效支持企业的运营管理；K/3Cloud提供了标准的业务建模：35种标准ERP领域模型、1046种模型元素、21243种模型元素属性组合，288个业务服务构件，让企业及伙伴可快速构建出行业化及个性化的应用。
数据集成方案配置
异构系统具有非常丰富的业务流程、复杂的系统架构和服务接口。在很多情况下，这两个系统都是分别独立部署和运行的，各自拥有不同的技术栈和编程模型，甚至两者在系统平台、技术平台和编程语言上是完全异构的。那么对接就需要根据接口配置对应的规则，例如取数就要根据查询接口获取吉客云·奇门的数据，并且根据对应的条件进行取数，目标系统就必须根据目标系统的格式，以及获取的数据进行加工处理后进行写入到金蝶云星空中。轻易云集成平台的可视化配置轻松实现。
吉客云·奇门接口明细
- 接口：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.goodsDetail_goodsDelivery_batchamount | 对接金额 | string | |
| goodsDetail.tradeOrderPayList.tradeOrderColumnExt.goodsDetail_goodsDelivery_sendCount | 对接数量 | string | |
| goodsDetail.tradeOrderPayList.tradeOrderColumnExt.shopCode | 店铺编号 | string | |
| goodsDetail.tradeOrderPayList.tradeOrderColumnExt.consignTime_new | 发货日期 | 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.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.