网店管家·奇门与金蝶云星空对接集成查询订单信息打通销售出库新增
数据源系统:网店管家·奇门
网店管家是一款面向B2C企业、C2C团队卖家的企业级电子商务C/S架构ERP软件，是业内应用广泛的电子商务后台系统。以订单处理为主线，进销存为核心，涵盖了订单处理、CRM、WMS、SCM、办公OA、售后服务等业务模块。
接入系统：金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
数据接口配置方案
通过轻易云系统数据集成平台新增创建集成方案，然后在数据源平台中选择对应的源平台为：网店管家·奇门，并且选择对应的连接器（关于网店管家·奇门的接口连接器如何配置可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息）。选择对应的查询订单信息接口作为数据对接来源。然后再通过写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器。选择对应的销售出库新增接口作为数据写入动作，既可以完成第一步的数据对接配置；打破跨系统连接，让数据轻易互通成为现实。
网店管家·奇门接口明细
- API：wdgj.tradenosensitiveinfo.list.get
- NAME：查询订单信息
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| searchtype | searchtype | | 0：未归档订单，1查询已归档订单 |
| begintime | 开始时间 | {{LAST_SYNC_TIME datetime}} | 开始时间 |
| endtime | 结束时间 | {{CURRENT_TIME datetime}} | 结束时间 |
| pageno | 页码 | 1 | 页码 |
| pagesize | 每页条数 | 100 | 每页条数，取值范围 1 ~ 100 |
| timetype | 查询时间类型 | 4 | 查询时间类型（0：登记时间 1：成交时间(索引字段 可以缩减查询时间) 2：审核时间 3：验货时间 4：发货时间 不填, 按订单成交时间查询） |
| searchstatus | 订单状态 | 11 | 订单状态 0 被取消 1 等待单(已停用) 2 待审核 3 预订单 4 待结算 5 打单出库 6 生产等待 7 待发货(已停用) 8 发货在途 9 代销发货 10 委外发货 11 已完成 |
| operationtype | 订单类型 | | 订单类型 "零售业务","批发业务","现款现货","售后换货","代发货","代销售","试销业务","补发货" |
| searchno | 订单编号 | | 订单编号 |
| relationno | 关联单号 | | 关联单号（原始单号） |
| warehouseno | 仓库编码 | | 仓库编码 |
| querymarkup | 单据查询标记 | | 单据查询标记 |
| reservedword | reservedword | | 等于1时候，查询出来的 货品会自动关联上拆分前的 原始单单号，解析不到的赋值为空 |
| searchname | 店铺名 | | 店铺名 |
| PostID | 货运单号 | | |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| tradeid | 单号ID | | 单号ID |
| regtime | 登记时间 | | 登记时间 |
| regoperator | 登记人 | | 登记人 |
| tradetime | 交易时间 | | 交易时间 |
| tradestatus | 订单状态 | | 订单状态 |
| tradeno | 管家订单号 | | 管家订单号 |
| shopid | 店铺id | | 店铺id |
| warehouseid | 仓库id | | 仓库id |
| seller | 业务员 | | 业务员 |
| tradetype | 订单类型 | | 订单类型 |
| tradeno2 | 原始单号 | | 原始单号 |
| shopname | 店铺名 | | 店铺名 |
| warehousename | 仓库名 | | 仓库名 |
| warehouseno | 仓库编号 | | 仓库编号 |
| logisticid | 物流id | | 物流id |
| logisticlistno | 物流编号 | | 物流编号 |
| logisticname | 物流名 | | 物流名 |
| postid | 快递单号 | | 快递单号 |
| goodstotal | 货款合计 | | 货款合计 |
| postagetotal | 应收邮资 | | 应收邮资 |
| taxvalue | 客付税额 | | 客付税额 |
| couponvalue | 抵扣金额 | | 抵扣金额 |
| favourabletotal | 优惠金额 | | 优惠金额 |
| alltotal | 合计应收 | | 合计应收 |
| rcvtotal | 实际结算 | | 实际结算 |
| goodscost | 货品成本 | | 货品成本 |
| goodsweight | 货品重量 | | 货品重量 |
| othercost | 其他成本 | | 其他成本 |
| totalprofit | 订单利润 | | 订单利润 |
| commissionvalue | 交易佣金 | | 交易佣金 |
| customerremark | 买家留言 | | 买家留言 |
| remark | 客服备注 | | 客服备注 |
| cancelreason | 取消原因 | | 取消原因 |
| confirmtime | 审核时间 | | 审核时间 |
| confirmoperator | 审核人 | | 审核人 |
| sndtime | 发货时间 | | 发货时间 |
| sndoperator | 发货人 | | 发货人 |
| invoicetitle | 发票抬头 | | 发票抬头 |
| binvoice | binvoice | | 0不开发票，1纸质普票，2电子普票，3电子专票，4纸质专票，5冠名发票 |
| country | 国家 | | 国家 |
| postage | 实际邮资 | | 实际邮资 |
| shoptype | 平台类型 | | 平台类型 |
| chargetype | 结算方式 | | 结算方式 |
| customerid | 顾客id | | 顾客id |
| shopno | 店铺编号 | | 店铺编号 |
| province | 省 | | 省 |
| city | 市 | | 市 |
| town | 区 | | 区 |
| zip | 邮编 | | 邮编 |
| reserved1 | 自定义字段1 | | 自定义字段1 |
| reserved2 | 自定义字段2 | | 自定义字段2 |
| reserved3 | 自定义字段3 | | 自定义字段3 |
| reserved4 | 自定义字段4 | | 自定义字段4 |
| chargeid | 支付单号 | | 支付单号 |
| chktime | 验货时间 | | 验货时间 |
| chkoperator | 验货人 | | 验货人 |
| currencyrate | 汇率 | | 汇率 |
| currencytype | 币种 | | 币种 |
| freezereason | 冻结原因 | | 冻结原因 |
| packagedweight | 包裹重量 | | 包裹重量 |
| packageoperator | 打包员 | | 打包员 |
| picker | 拣货员 | | 拣货员 |
| providerid | 供应商ID | | 供应商ID |
| providername | 供应商姓名 | | 供应商姓名 |
| providerno | 供应商编号 | | 供应商编号 |
| tradefrom | 订单来源 | | 订单来源 |
| goodslist | 货品列表 | | 货品列表 |
| goodslist.recid | 记录id | | 记录id |
| goodslist.goodsid | 货品ID | | 货品ID |
| goodslist.specid | 规格ID | | 规格ID，单规格为0 |
| goodslist.goodsno | 货品编号 | | 货品编号 |
| goodslist.goodsname | 品名 | | 品名 |
| goodslist.bfit | 是否组合装 | | 是否组合装 True/False |
| goodslist.specname | 规格名 | | 规格名 |
| goodslist.unit | 单位 | | 单位 |
| goodslist.goodscount | 数量 | | 数量 |
| goodslist.price | 单价 | | 单价 |
| goodslist.goodsmoney | 金额 | | 金额 |
| goodslist.remark | 备注 | | 备注 |
| goodslist.barcode | 条码 | | 条码 （条码+附加码） |
| goodslist.bgift | 是否赠品 | | 是否赠品 True/False |
| goodslist.positionsname | 货位 | | 货位 |
| goodslist.sn | 序列号 | | 序列号 |
| goodslist.originalno | originalno | | 和此订单货品关联的原始单单号（也适用于拆分前的原始单，有多个原始单用逗号隔开，等于1时候，查询出来的 货品会自动关联上拆分前的 原始单单号，解析不到的赋值为空） |
| goodslist.ShareTradeCost | 分摊费用 | | 分摊费用 |
| goodslist.ShareTradeFavorable | 分摊优惠 | | 分摊优惠 |
| goodslist.sharemoney | 实付金额 | | 实付金额 |
| goodslist.platgoodsid | 平台商品ID | | 平台商品ID |
| goodslist.flagname | 订单的标记名称 | | 订单的标记名称 |
| goodslist.predate | 激活日期 | | 激活日期 |
| goodslist.invoicepayerphone | 消费者电话 | | 消费者电话 |
| goodslist.invoicepayeraddr | 消费者地址 | | 消费者地址 |
| goodslist.invoicepayerbankno | 消费者银行卡号 | | 消费者银行卡号 |
| goodslist.invoicepayerregno | 税号 | | 税号 |
| goodslist.packagename | 包装名称 | | 包装名称 |
| goodslist.tel | 电话 | | 电话 |
| goodslist.sndto | 收件人 | | 收件人 |
| goodslist.tradenick | 客户网名 | | 客户网名 |
| goodslist.adr | 收货地址 | | 收货地址 |
| goodslist.cardtype | 证件类型 | | 证件类型 |
| goodslist.idcard | 证件号 | | 证件号 |
| goodslist.cardname | 证件名称 | | 证件名称 |
| goodslist.type | type | | type为“his”代表已归档的订单,“arc”代表未归档已完成订单,“”代表未归档今天的订单或未完成的订单 |
| goodslist.pricespec | 执行价格 | | 执行价格 |
| goodslist.pricedis | 折扣 | | 折扣 |
| goodslist.appendremark | 追加备注 | | 追加备注 |
| goodslist.F_RVUO_TEXT_HYDH | 货运单号 | | |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：销售出库新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBillTypeID | 单据类型 | string | 单据类型 |
| FBillNo | 单据编号 | string | 单据编号 |
| F_RVUO_Text_YSDH | 原始单号 | string | |
| FDate | 日期 | string | 日期 |
| FSaleOrgId | 销售组织 | string | 组织 |
| FCustomerID | 客户 | string | 基础资料 |
| FStockOrgId | 发货组织 | string | 组织 |
| FOwnerTypeIdHead | 货主类型 | string | 基础资料 |
| FOwnerIdHead | 货主 | string | 基础资料 |
| FCarriageNO | 运输单号 | string | 文本 |
| FLinkPhone | 联系电话 | string | 文本 |
| FLinkMan | 收货人姓名 | string | 文本 |
| FReceiveAddress | 收货方地址 | string | 文本 |
| SubHeadEntity | 财务信息 | object | |
| SubHeadEntity.FSettleOrgID | 结算组织 | string | 组织 |
| SubHeadEntity.FEntity | 明细信息 | array | |
| SubHeadEntity.FEntity.FMaterialID | 物料编码 | string | 基础资料 |
| SubHeadEntity.FEntity.FRealQty | 实发数量 | string | 数量 |
| SubHeadEntity.FEntity.FPrice | 单价 | string | 单价 |
| SubHeadEntity.FEntity.FTaxPrice | 含税单价 | string | 单价 |
| SubHeadEntity.FEntity.FProduceDate | 生产日期 | string | 日期 |
| SubHeadEntity.FEntity.FExpiryDate | 有效期至 | string | 日期 |
| SubHeadEntity.FEntity.FEntryTaxRate | 税率% | string | 小数 |
| SubHeadEntity.FEntity.FEntryTaxAmount | 税额 | string | 金额 |
| SubHeadEntity.FEntity.FAmount | 金额 | string | 金额 |
| SubHeadEntity.FEntity.FIsFree | 是否赠品 | string | |
| SubHeadEntity.FEntity.FStockID | 仓库 | string | 基础资料 |
| SubHeadEntity.FEntity.FStockLocID | 仓位 | string | 维度关联字段 |
| SubHeadEntity.FEntity.FSoorDerno | 订单单号 | string | 文本 |
| SubHeadEntity.FEntity.F_RVUO_TEXT_HYDH | 货运单号 | string | |
| SubHeadEntity.FEntity.F_RVUO_TEXT_WLFS | 物流方式 | string | |
| SubHeadEntity.FEntity.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| SubHeadEntity.FEntity.Operation | 执行的操作 | string | |
| SubHeadEntity.FEntity.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| SubHeadEntity.FEntity.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| SubHeadEntity.FEntity.SubSystemId | 系统模块 | string | 默认仓库模块 |
数据对接价值
可视化配置，即便是普通业务人员也可以快速轻松对接多个平台，解决企业面临的数据孤岛，数据混乱等问题，实现数据可见、可用、可运营。进行统一化，模块化，标准化的服务能力和输出，实现对业务端数据需求的精准满足和高效响应，也可以在业务数据需求的不断增加下，让企业有整套的可复用的api资产以更换，支持业务的正常运转，节省开发成本。在不同的着重点和应用上解决数据共享，实现平台之间的独立管理。
