旺店通·企业奇门与金蝶云星空对接集成查询采购退货单打通采购退货新增
对接系统：旺店通·企业奇门
慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。
写入目标:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践，面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司，提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于：集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
接口方案配置
通过可视化界面的拖、拉、拽即可轻松快速构建数据集成流程，将旺店通·企业奇门、金蝶云星空之间接口数据联通，支持数据在线预览、数据集成流程全过程调试，Web界面追踪调试日志等功能。 平台兼具实时数据处理和数据集成分发功能，用户通过可视化的拖、拽即可完成数据处理逻辑，将数据加工处理后分发到下游业务系统或其他异构存储中。
旺店通·企业奇门接口明细
- 调用接口：wdt.purchase.return.query
- 接口名称：查询采购退货单
- 方法：POST
请求参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| start_time | 开始时间 | datetime | {{DAYS_AGO_1 datetime}} |
| end_time | 结束时间 | datetime | {{CURRENT_TIME datetime}} |
| status | 状态 | string | |
| warehouse_no | 仓库编号 | string | |
| page_size | 分页大小 | string | {{PAGINATION_PAGE_SIZE}} |
| page_no | 页号 | string | {{PAGINATION_START_PAGE}} |
响应参数
| 字段 | 字段名称 | 类型 | 配置值 |
|---|
| return_no | 退货单号 | string | |
| provider_name | 供应商 | string | |
| status | 采购单状态 | string | |
| warehouse_no | 仓库编号 | string | |
| warehouse_name | 仓库 | string | |
| purchaser_id | 采购员id | string | |
| purchaser_name | 采购员名称 | string | |
| logistics_type | 物流类型 | string | |
| other_fee | 其它费用 | string | |
| post_fee | 邮费 | string | |
| goods_fee | 总货款 | string | |
| goods_count | 退货开单量 | string | |
| goods_type_count | 货品种类数 | string | |
| goods_out_count | 退货出库量 | string | |
| api_outer_no | 外部接口单号 | string | |
| outer_no | 外部单号 | string | |
| prop1 | 自定义属性1 | string | |
| prop2 | 自定义属性2 | string | |
| provider_no | 供应商编号 | string | |
| purchase_no | 引用采购单号 | string | |
| creator_id | 制单员id | string | |
| creator_name | 制单员姓名 | string | |
| type | 类型 | string | |
| flag_id | 颜色标记 | string | |
| warehouse_id | 出库id | string | |
| provider_id | 供应商id | string | |
| contact | 联系人姓名 | string | |
| telno | 联系电话 | string | |
| receive_address | 退货地址 | string | |
| check_operator_id | 审核人 | string | |
| check_time | 审核时间 | string | |
| note_count | 便签条数 | string | |
| province | 省份 | string | |
| city | 城市 | string | |
| district | 地区 | string | |
| wms_outer_no | 外部仓库的单号 | string | |
| wms_status | 处理状态 | string | |
| error_info | 错误信息 | string | |
| version_id | 版本号 | string | |
| last_load_purchase_id | 最后一次引用的采购单id | string | |
| detail_list | 采购退货单货品列表节点 | array | |
| detail_list.return_id | 采购退货单id | string | |
| detail_list.remark | 备注 | string | |
| detail_list.created | 创建时间 | string | |
| detail_list.modified | 最后修改时间 | string | |
| detail_list.provider_goods_no | 供应商货品编号 | string | |
| detail_list.spec_no | 商家编码 | string | |
| detail_list.goods_no | 货品编码 | string | |
| detail_list.goods_name | 货品名称 | string | |
| detail_list.spec_name | 规格名称 | string | |
| detail_list.spec_code | 规格码 | string | |
| detail_list.num | 退货数量 | string | |
| detail_list.num2 | 辅助退货量 | string | |
| detail_list.unit_id | 出库单位 | string | |
| detail_list.unit_ratio | 单位变换率 | string | |
| detail_list.base_unit_id | 基本单位 | string | |
| detail_list.price | 单价 | string | |
| detail_list.discount | 折扣 | string | |
| detail_list.amount | 税前金额 | string | |
| detail_list.unit_name | 出库单位名称 | string | |
| detail_list.base_unit_name | 基本单位名称 | string | |
| detail_list.tax | 税率 | string | |
| detail_list.tax_amount | 税后金额 | string | |
| detail_list.rec_id | 明细id | string | |
| detail_list.spec_id | 规格id | string | |
| detail_list.out_num | 退货出库数量 | string | |
| detail_list.out_amount | 退货出库金额 | string | |
| detail_list.tax_price | 税后单价 | string | |
金蝶云星空接口明细
- 接口：batchSave
- 接口名称：采购退货新增
- 接口方法：POST
请求参数
| 字段 | 名称 | 类型 | 描述 |
|---|
| FBillNo | 单据编号 | string | 单据编号 |
| FDate | 退料日期 | string | 日期 |
| FSupplierID | 供应商 | string | 基础资料 |
| FPURMRBENTRY | 明细信息 | array | 明细信息 |
| FPURMRBENTRY.FMATERIALID | 物料编码 | string | 基础资料 |
| FPURMRBENTRY.FRMREALQTY | 实退数量 | string | 数量 |
| FPURMRBENTRY.FSTOCKID | 仓库 | string | 基础资料 |
| FPURMRBENTRY.FPrice | 单价 | string | 单价 |
| FPURMRBENTRY.FormId | 业务对象表单Id | string | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
| FPURMRBENTRY.Operation | 执行的操作 | string | |
| FPURMRBENTRY.IsAutoSubmitAndAudit | 提交并审核 | bool | |
| FPURMRBENTRY.IsVerifyBaseDataField | 验证基础资料 | bool | 是否验证所有的基础资料有效性，布尔类，默认false（非必录） |
| FPURMRBENTRY.SubSystemId | 系统模块 | string | 默认仓库模块 |
系统集成总览
从API层面解决企业烟囱式业务系统集成现状,实现深度的业务流程拉通旺店通·企业奇门到金蝶云星空之间数据集成；通过API连接各业务系统，复用已有的业务系统能力，让集成架构、服务关系更清晰。使用统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升复用率和价值。全面管控企业的API资产，梳理现有业务系统的API。实现API文档的统一管理，建立API的上线、下线、监控的统一管理体系及标准规范。已链接和打通主流SaaS系统超过100+，快速对接各种API接口，实现云上云下的互联互通。将SaaS和本地业务系统联接起来，打破时间与空间界限，打通原有核心数据及SaaS应用，构建可平滑演进的企业IT架构。
