旺店通·企业奇门与金蝶云星空对接集成查询退货入库单打通调拨单新增
数据源系统:旺店通·企业奇门
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
对接目标平台:金蝶云星空
金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。
多系统对接方案配置
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将旺店通·企业奇门、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。
旺店通·企业奇门接口明细
- 接口：wdt.stockin.order.query.refund
- 接口名称：查询退货入库单
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| start_time | 开始时间 | datetime | 增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss |
| end_time | 结束时间 | datetime | 增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss |
| status | 状态 | string | 入库单状态 10已取消20编辑中30待审核60待结算80已完成（默认查询80已完成单据） |
| shop_no | 店铺编号 | string | 代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息 |
| stockin_no | 入库单号 | string | |
| page_size | 分页大小 | string | 每页返回的数据条数，输入值范围1~50，不传本参数，输入值默认为40，使用举例单击这里 |
| page_no | 页号 | string | 不传值默认从0页开始 |
响应参数
| 字段 | 名称 | 类型 | 描述 |
|---|---|---|---|
| stockin_id | 入库单主键id | string | 入库单主键id |
| order_no | 入库单号 | string | 入库单号 |
| warehouse_no | 仓库编号 | string | 代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置） |
| warehouse_name | 仓库名称 | string | 仓库名称 |
| shop_no | 店铺编号 | string | 代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺数据信息 |
| shop_remark | 店铺备注 | string | 店铺备注 |
| src_order_no | 上层单据（退换单）编号 | string | |
| process_status | 退换单状态 | string | 10已取消,20待审核,30已同意,40已拒绝,50待财审,60待收货,63待推送,64推送失败,65委外待收货,69待收货(已结算),70部分到货,71部分到货(已结算),80待结算 ,90已完成。ERP版本V2.3.8.4及以上才可返回 |
| status | 退货入库单状态 | string | 入库单状态 10已取消20编辑中30待审核60待结算80已完成 |
| stockin_time | 更新时间 | string | 更新时间 格式：yyyy-MM-dd HH:mm:ss |
| created_time | 创建时间 | string | 创建时间 格式：yyyy-MM-dd HH:mm:ss |
| remark | 备注 | string | 备注 |
| trade_no | 订单编号 | string | 系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置） |
| trade_type | 系统订单类别 | string | 系统订单类别（1网店销售,2线下零售,3售后换货,4批发业务,5保修换新,6保修完成,7订单补发 .. 101自定义类型1,102自定义类型2,103自定义类型3,104自定义类型4 ,105自定义类型5,106自定义类型6） |
| order_type | 单据类别 | string | 单据类别，默认返回3 |
| order_type_name | 单据类别名称 | string | 单据类别名称，默认为“退货入库” |
| goods_count | 货品数量 | string | 货品数量 |
| goods_amount | 货款总额 | string | 退回货款收入 |
| actual_refund_amount | 实际退款金额 | string | 实际退款金额 |
| total_price | 扣除优惠后货款总额 | string | 退回货品成本 |
| discount | 优惠金额 | string | 优惠金额 |
| tax_amount | 税后金额 | string | 税后金额 |
| post_fee | 邮费 | string | 退货入库单的“邮资” |
| other_fee | 其他费用 | string | 退货入库单的“其它金额” |
| adjust_price | 纠错金额 | string | 纠错金额 |
| right_price | 调整后总金额 | string | 调整后总金额 |
| logistics_type | 物流类型 | string | 响应值为代表物流类型的数字，数字对应的物流类型名称单击这里 |
| logistics_no | 物流编号 | string | 代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置） |
| logistics_name | 物流名称 | string | ERP设置的物流公司名称 |
| logistics_code | 物流单号 | string | 物流单单号 |
| refund_no | 退换单编号 | string | 退换单编号 |
| check_time | 入库审核时间 | string | |
| customer_no | 客户编号 | string | 客户编号 |
| customer_name | 客户名称 | string | 退货人的姓名 |
| nick_name | 客户网名 | string | 客户网名 |
| shop_name | 店铺名称 | string | 店铺名称 |
| stockin_reason | 入库原因 | string | 入库原因 |
| flag_name | 退货单标记 | string | 退换单界面的标记 |
| platform_id | 平台id | string | 平台id |
| tid | 订单原始单号 | string | |
| stockin_operator_name | 入库操作人姓名 | string | 默认为''，入库操作人姓名 |
| check_operator_name | 审核人姓名 | string | 默认为''，审核人姓名 |
| refund_remark | 退换备注 | string | 默认为''，退换备注 |
| refund_operator_name | 退货员姓名 | string | 默认为''，退货员姓名 |
| stockin_no | 入库单号 | string | 入库单号 |
| wms_outer_no | 外部仓库单号 | string | 默认为''，对应外部仓库的单号 |
| wms_status | 外部仓库状态 | string | 默认为'0'，外部状态,与wms对接使用 0初始化 1失败 2成功' |
| wms_result | 结果 | string | 默认为''，错误信息 |
| warehouse_id | 仓库id | string | 默认为'0'，仓库id |
| src_order_type | 入库单类型 | string | 默认为'0'，入库单类型 3退货入库 |
| src_order_id | 业务单据id | string | 默认为'0'，业务单据id |
| reason_id | 原因 | string | 原因 |
| fa_status | 财务同步状态 | string | 默认为'0'，财务同步状态 |
| logistics_id | 物流公司d | string | 默认为'0'，物流公司id |
| post_share_type | 邮资分摊类型 | string | 默认为'0'，邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊' |
| operator_id | 操作员id | string | 操作员id |
| check_operator_id | 审核员id | string | |
| goods_type_count | 货品种类数 | string | 默认为'0'，货品种类数 |
| adjust_num | 调整数量 | string | 默认为'0'，调整数量 |
| note_count | 便签条数 | string | 默认为'0'，便签条数 |
| flag_id | 标记id | string | 默认为'0'，标记id |
| modified | 最后修改时间 | string | |
| details_list | 货品列表节点 | array | 退回货品列表节点 |
| details_list.rec_id | 明细表主键id | string | 明细表主键id |
| details_list.stockin_id | 入库单主键id | string | 入库单主键id |
| details_list.src_order_detail_id | 上层单据（退换单）退回货品明细主键 | string | 上层单据（退换单）退回货品明细主键，ERP版本V2.3.8.3及以上才可返回 |
| details_list.spec_no | 商家编码 | string | 代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍,单击这里 |
| details_list.goods_count | 货品数量 | string | 货品数量 |
| details_list.discount | 优惠金额 | string | 优惠金额 |
| details_list.cost_price | 成本价 | string | 成本价 |
| details_list.production_date | 生产日期 | string | 生产日期，格式：yyyy-MM-dd HH:mm:ss |
| details_list.validity_days | 有效期天数 | string | 有效期天数 |
| details_list.expire_date | 有效期 | string | 有效期，格式：yyyy-MM-dd HH:mm:ss |
| details_list.src_price | 原价 | string | 原价 |
| details_list.tax_price | 税后单价 | string | 税后单价 |
| details_list.tax_amount | 税后金额 | string | 税后金额 |
| details_list.tax | 税率 | string | 税率 |
| details_list.total_cost | 总成本 | string | 总成本 |
| details_list.remark | 备注 | string | 备注 |
| details_list.adjust_num | 纠错数量 | string | 纠错数量 |
| details_list.adjust_price | 纠错金额 | string | 纠错金额 |
| details_list.right_num | 调整后数量 | string | 调整后数量 |
| details_list.right_price | 调整后单价 | string | 调整后单价 |
| details_list.num | 入库数量 | string | 入库数量 |
| details_list.num2 | 辅助数量 | string | 辅助数量 |
| details_list.right_cost | 调整后总金额 | string | 调整后总金额 |
| details_list.brand_no | 品牌编号 | string | 品牌编号 |
| details_list.brand_name | 品牌名称 | string | 品牌名称 |
| details_list.goods_name | 货品名称 | string | 货品名称 |
| details_list.prop2 | 单品自定义属性2 | string | 单品自定义属性2 |
| details_list.goods_no | 货品编号 | string | 代表货品(spu)所有属性的唯一编号，用于系统货品区分，，SPU概念介绍,单击这里 |
| details_list.spec_name | 规格名称 | string | 规格名称 |
| details_list.spec_code | 规格编号 | string | 规格编号 |
| details_list.goods_unit | 基本单位 | string | 基本单位 |
| details_list.batch_no | 入库批次 | string | 入库批次 |
| details_list.batch_remark | 批次备注 | string | 批次备注 |
| details_list.position_no | 货位编号 | string | 货位编号 |
| details_list.tid | 原订单原始单号 | string | 原订单原始单号 |
| details_list.oid | 原订单原始子单号 | string | 原订单原始子单号 |
| details_list.src_order_type | 订单类型 | string | 1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 |
| details_list.org_stockin_detail_id | 原始入库单明细 | string | 默认为'0'，原始入库单明细 |
| details_list.spec_id | erp商品主键 | string | erp内商品主键 |
| details_list.batch_id | 批次 | string | 默认为'0'，批次 |
| details_list.position_id | 货位id | string | 默认为'0'，货位ID，入库时默认ID |
| details_list.unit_id | 辅助单位 | string | 默认为'0'，辅助单位 |
| details_list.base_unit_id | 基本单位 | string | 默认为'0'，基本单位 |
| details_list.unit_ratio | 单位比率 | string | 默认为'1.0000'，单位换算关系 |
| details_list.expect_num | 期望数量 | string | 默认为'0.0000'，预期入库数量（基本单位数量，显示可自动转换成辅助单位） |
| details_list.cost_price2 | 辅助价格 | string | 默认为'0.0000'，辅助成本价 |
| details_list.share_post_cost | 邮资分摊成本 | string | 默认为'0.0000'，邮资分摊成本 |
| details_list.share_post_total | 邮资分摊总成本 | string | 默认为'0.0000'，邮资分摊总成本 |
| details_list.modified | 最后修改时间 | string | 最后修改时间 |
| details_list.created | 创建时间 | string | 创建时间 |
金蝶云星空接口明细
- API：batchSave
- NAME：调拨单新增
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|---|---|---|
| FBillNo | 单据编号 | {{order_no}} | 单据编号 |
| FBillTypeID | 单据类型 | ZJDB09_SYS | 单据类型 |
| FBizType | 业务类型 | NORMAL | 下拉列表 |
| FTransferDirect | 调拨方向 | GENERAL | 下拉列表 |
| FTransferBizType | 调拨类型 | InnerOrgTransfer | 下拉列表 |
| FSaleOrgId | 销售组织 | _function case when '{{shop_name}}' like '%古神%' then 102 when '{{shop_name}}' like '%广州格物%' then 101 when '{{shop_name}}' like '%广西格物%' then 103 ELSE 100 end | 组织 |
| FSettleOrgId | 结算组织 | _function case when '{{shop_name}}' like '%古神%' then 102 when '{{shop_name}}' like '%广州格物%' then 101 when '{{shop_name}}' like '%广西格物%' then 103 ELSE 100 end | 组织 |
| FStockOutOrgId | 调出库存组织 | 100 | 组织 |
| FOwnerTypeOutIdHead | 调出货主类型 | BD_OwnerOrg | 多类别基础资料列表 |
| FOwnerOutIdHead | 调出货主 | _function case when '{{shop_name}}' like '%古神%' then 102 when '{{shop_name}}' like '%广州格物%' then 101 when '{{shop_name}}' like '%广西格物%' then 103 ELSE 100 end | 多类别基础资料 |
| FStockOrgId | 调入库存组织 | 100 | 组织 |
| FSETTLECURRID | 结算币别 | PRE001 | 基础资料 |
| FDate | 日期 | {{check_time}} | 日期 |
| FNote | 备注 | {{remark}} | 多行文本 |
| FBaseKeHu | 客户 | {{shop_no}} | |
| FBillEntry | 明细信息 | details_list | 1 |
| FBillEntry.FMaterialId | 物料编码 | {{details_list.spec_no}} | 基础资料 |
| FBillEntry.FCMKBarCode | 零售条形码 | 文本 | |
| FBillEntry.FQty | 调拨数量 | {{details_list.num}} | 数量 |
| FBillEntry.FLot | 调出批号 | 批次 | |
| FBillEntry.FSrcStockId | 调出仓库 | {{shop_no}} | 基础资料 |
| FBillEntry.FSrcStockLocId | 调出仓位 | 维度关联字段 | |
| FBillEntry.FDestStockId | 调入仓库 | {{warehouse_no}} | 基础资料 |
| FBillEntry.FDestStockLocId | 调入仓位 | 维度关联字段 | |
| FBillEntry.FNoteEntry | 备注 | 多行文本 | |
| FBillEntry.FISFREE | 赠品 | 复选框 | |
| FBillEntry.FSrcStockStatusId | 调出库存状态 | KCZT01_SYS | |
| FBillEntry.FormId | 业务对象表单Id | STK_TransferDirect | 必须填写金蝶的表单ID如:PUR_PurchaseOrder |
| FBillEntry.IsAutoSubmitAndAudit | 提交并审核 | true | |
| FBillEntry.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| FBillEntry.Operation | 执行的操作 | Save |
数据对接效果
当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。
