旺店通·企业奇门与金蝶云星空对接集成查询退货入库单连通销售退货新增(销售退货)

接入系统:旺店通·企业奇门
慧策(原旺店通)是一家技术驱动型智能零售服务商,基于云计算PaaS、SaaS模式,以一体化智能零售解决方案,帮助零售企业数字化智能化升级,实现企业规模化发展。
目标系统:金蝶云星空
金蝶K/3Cloud结合当今先进管理理论和数十万家国内客户最佳应用实践,面向事业部制、多地点、多工厂等运营协同与管控型企业及集团公司,提供一个通用的ERP服务平台。K/3Cloud支持的协同应用包括但不限于:集中/分散销售、集中/分散采购、B2B电商管理、B2C电商中心、供应商协同、多工厂计划、跨工厂领料、跨工厂加工、工厂间调拨、内部交易及结算、集团财务管理、阿米巴经营等。
数据集成方案配置
集成方案是整个轻易云集成平台的核心,每一个集成方案代表一种业务的对接策略(对接方案借鉴可以在轻易云系统数据集成交流社区bbs.qeasy.cloud 中找到相关信息),用户可以根据业务的不同新建多个不同规则的集成方案。比如:采购订单同步,线上销售出库同步,线下销售出库同步。一个集成方案必须要配置源系统:旺店通·企业奇门,源系统 API:查询退货入库单,目标系统:金蝶云星空,目标系统 API销售退货新增。在新增集成方案之前需要确定两个系统的连接器都已经配置完成。


旺店通·企业奇门接口明细
- 调用接口:wdt.stockin.order.query.refund
- 接口名称:查询退货入库单
- 方法:POST
请求参数
字段 | 字段名称 | 类型 | 配置值 |
start_time | 开始时间 | datetime | {{LAST_SYNC_TIME datetime}} |
end_time | 结束时间 | datetime | {{CURRENT_TIME datetime}} |
status | 状态 | string | |
shop_no | 店铺编号 | string | |
page_size | 分页大小 | string | {{PAGINATION_PAGE_SIZE}} |
page_no | 页号 | string | {{PAGINATION_START_PAGE}} |
响应参数
字段 | 字段名称 | 类型 | 配置值 |
order_no | 入库单号 | string | |
warehouse_no | 仓库编号 | string | |
warehouse_name | 仓库名称 | string | |
shop_no | 店铺编号 | string | |
shop_remark | 店铺备注 | string | |
src_order_no | 上层单据(退换单)编号 | string | |
process_status | 退换单状态 | string | |
status | 退货入库单状态 | string | |
stockin_time | 更新时间 | string | |
created_time | 创建时间 | string | |
trade_no | 订单编号 | string | |
trade_type | 系统订单类别 | string | |
order_type | 单据类别 | string | |
order_type_name | 单据类别名称 | string | |
goods_amount | 货款总额 | string | |
actual_refund_amount | 实际退款金额 | string | |
total_price | 扣除优惠后货款总额 | string | |
post_fee | 邮费 | string | |
other_fee | 其他费用 | string | |
logistics_type | 物流类型 | string | |
logistics_no | 物流编号 | string | |
logistics_name | 物流名称 | string | |
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 | |
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 | |
wms_result | 结果 | string | |
warehouse_id | 仓库id | string | |
src_order_id | 业务单据id | string | |
reason_id | 原因 | string | |
fa_status | 财务同步状态 | string | |
logistics_id | 物流公司d | string | |
post_share_type | 邮资分摊类型 | string | |
operator_id | 操作员id | string | |
check_operator_id | 审核员id | string | |
goods_type_count | 货品种类数 | string | |
note_count | 便签条数 | string | |
flag_id | 标记id | string | |
details_list | 货品列表节点 | array | |
details_list.stockin_id | 入库单主键id | string | |
details_list.remark | 备注 | string | |
details_list.goods_count | 货品数量 | string | |
details_list.discount | 优惠金额 | string | |
details_list.tax_amount | 税后金额 | string | |
details_list.adjust_price | 纠错金额 | string | |
details_list.right_price | 调整后单价 | string | |
details_list.tid | 原订单原始单号 | string | |
details_list.src_order_type | 订单类型 | string | |
details_list.adjust_num | 纠错数量 | string | |
details_list.modified | 最后修改时间 | string | |
details_list.rec_id | 明细表主键id | string | |
details_list.src_order_detail_id | 上层单据(退换单)退回货品明细主键 | string | |
details_list.spec_no | 商家编码 | string | |
details_list.cost_price | 成本价 | string | |
details_list.production_date | 生产日期 | string | |
details_list.validity_days | 有效期天数 | string | |
details_list.expire_date | 有效期 | string | |
details_list.src_price | 原价 | string | |
details_list.tax_price | 税后单价 | string | |
details_list.tax | 税率 | string | |
details_list.total_cost | 总成本 | string | |
details_list.right_num | 调整后数量 | 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 | |
details_list.goods_no | 货品编号 | string | |
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.oid | 原订单原始子单号 | string | |
details_list.org_stockin_detail_id | 原始入库单明细 | string | |
details_list.spec_id | erp商品主键 | string | |
details_list.batch_id | 批次 | string | |
details_list.position_id | 货位id | string | |
details_list.unit_id | 辅助单位 | string | |
details_list.base_unit_id | 基本单位 | string | |
details_list.unit_ratio | 单位比率 | string | |
details_list.expect_num | 期望数量 | string | |
details_list.cost_price2 | 辅助价格 | string | |
details_list.share_post_cost | 邮资分摊成本 | string | |
details_list.share_post_total | 邮资分摊总成本 | string | |
details_list.created | 创建时间 | string | |
金蝶云星空接口明细
- API:batchSave
- NAME:销售退货新增
- METHOD:POST
请求参数
接口字段 | 字段名称 | 预设值 | 描述 |
FBillTypeID | 单据类型 | XSTHD01_SYS | 单据类型 |
FBillNo | 单据编号 | {{order_no}}test1 | 单据编号 |
FSaleOrgId | 销售组织 | findCollection find email from 4cf40fbb-7205-39f0-98f2-b2d1cd4e15cf where shop_no={{shop_no}} | 组织 |
FDate | 日期 | {{stockin_time}} | 日期 |
FStockOrgId | 库存组织 | {{warehouse_no}} | 组织 |
FRetcustId | 退货客户 | {{shop_no}} | 基础资料 |
FHeadNote | 备注 | {{refund_remark}} | 多行文本 |
FEntity | 明细信息 | details_list | |
FEntity.FMaterialId | 物料编码 | _findCollection find FNumber from cdb4b806-7ece-3e84-b575-0d30a831abd4 where FOldNumber={{details_list.goods_no}} | 基础资料 |
FEntity.FRealQty | 实退数量 | {{details_list.goods_count}} | 数量 |
FEntity.FTaxPrice | 含税单价 | {{details_list.tax_price}} | 单价 |
FEntity.FEntryTaxRate | 税率% | | 小数 |
FEntity.FStockId | 仓库 | {{warehouse_no}} | 基础资料 |
FEntity.FNote | 备注 | {{details_list.remark}} | 文本 |
FEntity.SubHeadEntity | 财务信息 | | |
FEntity.SubHeadEntity.FSettleOrgId | 结算组织 | _findCollection find email from 4cf40fbb-7205-39f0-98f2-b2d1cd4e15cf where shop_no={{shop_no}} | 组织 |
FEntity.SubHeadEntity.FormId | 业务对象表单Id | SAL_RETURNSTOCK | 必须填写金蝶的表单ID如😛UR_PurchaseOrder |
FEntity.SubHeadEntity.Operation | 执行的操作 | Save | |
FEntity.SubHeadEntity.IsAutoSubmitAndAudit | 提交并审核 | true | |
FEntity.SubHeadEntity.IsVerifyBaseDataField | 验证基础资料 | false | 是否验证所有的基础资料有效性,布尔类,默认false(非必录) |
FEntity.SubHeadEntity.SubSystemId | 系统模块 | 21 | 默认仓库模块 |
系统数据集成价值
当企业规模逐渐增大时,作为支撑业务运营的IT建设也变得越来越重要,不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程,这样的结果就是,企业上的IT系统很多很全,从ERP到HR、CRM、PDM、OA等,貌似所有的业务都覆盖到了,但实际上因为这些系统的不集成,而形成了企业很多新的信息孤岛,非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看,也不可避免会遇到上述问题,毕竟企业经营的多样化,并不是所有的业务都能在一个系统中完成,所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台,对API进行显性化、可视化,使所有API服务成为企业的数字资产,提升API利用率,发挥业务系统价值,实现企业IT资产的可插拔、可复用、可组成。

