金蝶云星空与旺店通·旗舰奇门对接集成销售退货单查询连通销售退货新增(12-销售退货单)
接入系统：旺店通·旗舰奇门
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
接通系统：金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据接口配置
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将旺店通·旗舰奇门、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。
旺店通·旗舰奇门接口明细
- API：wdt.wms.stockin.refund.querywithdetail
- NAME：销售退货单查询
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| pager | 分页参数 | | |
| pager.page_size | 分页大小 | 50 | |
| pager.page_no | 页号 | 1 | |
| pager.params | 业务参数 | | |
| pager.params.start_time | 开始时间 | {{LAST_SYNC_TIME datetime}} | |
| pager.params.end_time | 结束时间 | {{CURRENT_TIME datetime}} | |
| pager.params.status | 入库单状态 | 80 | 英文逗号拼接的状态值:10=已取消；20=编辑中；30=待审核；37=待质检；40=质检确认； |
| 60=待结算；70=暂估结算；80=已完成 |
| pager.params.time_type | 时间条件类型 | 1 | 查询的时间条件类型, 0:修改时间; 1:入库时间 不传默认为0 |
| pager.params.warehouse_no | 仓库编码 | | |
| pager.params.shop_nos | 店铺编号 | | 多个店铺编号使用英文逗号分隔 |
响应参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| order_no | 入库单号 | | |
| status | 入库单状态 | | |
| warehouse_no | 仓库编号 | | |
| warehouse_name | 仓库名称 | | |
| created_time | 入库单创建时间 | | |
| fenxiao_nick | 分销商昵称 | | |
| operator_name | 退换建单人 | | |
| logistics_type | 物流方式 | | |
| check_time | 审核时间 | | |
| refund_no | 退换单号 | | |
| goods_count | 货品总数 | | |
| actual_refund_amount | 退换单实际退款金额 | | |
| customer_no | 客户编码 | | |
| customer_name | 退货人姓名 | | |
| nick_name | 客户网名 | | |
| shop_name | 店铺名称 | | |
| shop_no | 店铺编号 | | |
| shop_remark | 店铺备注 | | |
| flag_name | 标记名称 | | |
| trade_no_list | 订单编号 | | |
| total_price | 入库单总金额 | | |
| modified | 最后修改时间 | | |
| details_list | 入库单明细 | | |
| details_list.remark | 明细备注 | | |
| details_list.rec_id | 明细id(主键) | | |
| details_list.stockin_id | 入库单id | | |
| details_list.num | 数量 | | |
| details_list.total_cost | 总成本 | | |
| details_list.right_num | 调整后数量 | | |
| details_list.goods_name | 货品名称 | | |
| details_list.goods_no | 货品编码 | | |
| details_list.spec_no | 商家编码 | | |
| details_list.defect | 是否残次品 | | |
| details_list.prop2 | 自定义属性2 | | |
| details_list.spec_name | 规格名 | | |
| details_list.spec_code | 规格码 | | |
| details_list.brand_no | 品牌编号 | | |
| details_list.brand_name | 品牌名称 | | |
| details_list.goods_unit | 入库单位名称 | | |
| details_list.basic_unit_name | 基本单位名称 | | |
| details_list.batch_no | 批次号 | | |
| details_list.expire_date | 有效期 | | |
| details_list.position_no | 货位 | | |
金蝶云星空接口明细
- API：batchSave
- NAME：销售退货新增
- METHOD：POST
请求参数
| 接口字段 | 字段名称 | 预设值 | 描述 |
|---|
| FBillTypeID | 单据类型 | XSTHD01_SYS | 单据类型 |
| FBillNo | 单据编号 | {{refund_no}} | 单据编号 |
| FSaleOrgId | 销售组织 | 100 | 组织 |
| FDate | 日期 | {{created_time datetime}} | 日期 |
| FStockOrgId | 库存组织 | 100 | 组织 |
| FRetcustId | 退货客户 | {{shop_no}} | 基础资料 |
| FEntity | 明细信息 | details_list | |
| FEntity.FMaterialId | 物料编码 | {{details_list.spec_no}} | 基础资料 |
| FEntity.FRealQty | 实退数量 | {{details_list.num}} | 数量 |
| FEntity.FPrice | 单价 | | 单价 |
| FEntity.FTaxPrice | 含税单价 | function {{details_list.total_cost}}/{{details_list.num}} | 单价 |
| FEntity.FIsFree | 是否赠品 | | 复选框 |
| FEntity.FEntryTaxRate | 税率% | | 小数 |
| FEntity.FStockId | 仓库 | {{warehouse_no}} | 基础资料 |
| FEntity.FLot | 批号 | | 批次 |
| FEntity.FNote | 备注 | | 文本 |
| FEntity.FSTOCKSTATUSID | 库存状态 | _function case '{{defect}}' when true then 'KCZT08_SYS' else 'KCZT01_SYS' end | |
| FEntity.FormId | 业务对象表单Id | SAL_RETURNSTOCK | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FEntity.Operation | 执行的操作 | Save | |
| FEntity.IsAutoSubmitAndAudit | 提交并审核 | true | |
| FEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| FEntity.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
系统数据对接
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通旺店通·旗舰奇门到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。
