旺店通·企业奇门与金蝶云星空对接集成查询采购退货出库单打通采购退货新增

旺店通·企业奇门与金蝶云星空对接集成查询采购退货出库单打通采购退货新增

接通系统：旺店通·企业奇门

旺店通是北京掌上先机网络科技有限公司旗下品牌，国内的零售云服务提供商，基于云计算SaaS服务模式，以体系化解决方案，助力零售企业数字化智能化管理升级。为零售电商企业的订单管理及仓储管理提供解决方案，致力于帮助企业实现数字化转型，企业规模化发展

写入目标:金蝶云星空

金蝶K/3Cloud（金蝶云星空）是移动互联网时代的新型ERP，是基于WEB2.0与云技术的新时代企业管理服务平台。金蝶K/3Cloud围绕着“生态、人人、体验”，旨在帮助企业打造面向新时代的生态互联与协同平台，围绕生态中的每个角色，提供随手可得的云服务，最终实现敏捷协同，智慧运营的企业运营新境界。整个产品采用SOA架构，完全基于BOS平台组建而成，业务架构上贯穿流程驱动与角色驱动思想，结合中国管理模式与中国管理实践积累，精细化支持企业财务管理、供应链管理、生产管理、供应链协同管理、人力资源管理等核心应用。技术架构上该产品采用平台化构建，支持跨数据库应用，支持本地部署、私有云部署与公有云部署三种部署方式，同时还在公有云上开放中国第一款基于ERP的协同开发云平台。任何一家使用金蝶K/3Cloud产品的企业，其拥有的是包含金蝶在内的众多基于同一个平台提供服务的IT服务伙伴。

多系统对接方案配置

通过轻易云系统数据集成平台：数据集成方案。选择开始创建数据集成方案菜单。在方案配置表单中选择对应的源业务系统：旺店通·企业奇门，然后选择对应的连接器。选择对应的wdt.stockout.order.query.return作为数据对接来源。然后再写入目标平台配置目标系统为金蝶云星空，并且选择对应连接器（关于金蝶云星空的接口如何连接可以在轻易云数据集成社区论坛bbs.qeasy.cloud中找到相关信息）。选择好对应的batchSave接口作为数据写入动作完成第一步的接口配置。

旺店通·企业奇门接口明细

• API：wdt.stockout.order.query.return
• NAME：查询采购退货出库单
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
start_time	开始时间	{{LAST_SYNC_TIME datetime}}
end_time	结束时间	{{CURRENT_TIME datetime}}	按最后修改时间增量获取数据,end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
warehouse_no	仓库编号
status	出库单状态		出库单状态5：已取消，50：待审核，55：已审核，95：已发货，110：已完成（默认查已发货已完成单据）
page_no	页号	{{PAGINATION_START_PAGE}}
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	每页返回的数据条数，输入值范围130，不传本参数，输入值默认为30，
src_order_no	上层单据编号

响应参数

接口字段	字段名称	预设值	描述
stockout_id	出库单主键id		出库单主键id
order_no	出库单号		系统出库单号，默认为CK开头
src_order_no	源单号		该源单号为退货单号
warehouse_no	仓库编号		代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
status	状态		出库状态
consign_time	出库时间		出库时间，格式：yyyy-MM-dd HH:mm:ss
order_type	源单据类别		源单据类别 1销售订单, 2调拨出库, 3采购退货出库, 4盘亏出库, 5生产出库, 6现款销售出库, 7其他出库, 8多发出库, 9纠错出库,10保修配件出库, 11初始化出库, 12jit拣货出库 13委外出库
order_type_name	源单据类型名称		源单据类型名称
subtype	出库子类型		出库子类型
goods_total_amount	货品总售价		货品总售价
goods_total_cost	货品总成本		货品总成本
post_fee	邮费		邮费
logistics_no	物流编号		代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
package_fee	包装费		包装费
receiver_name	收件人		该字段已废弃
receiver_country	国家		国家
receiver_province	省份		省份
receiver_city	城市		城市
receiver_district	地区		地区
receiver_address	详细地址		该字段已废弃
receiver_mobile	收件人移动电话		该字段已废弃
receiver_telno	收件人固定电话		该字段已废弃
receiver_zip	邮编		邮编
stockout_reason	出库原因		出库原因
outer_no	外部单号		外部单号
operator_name	操作人		操作人
receiver_area	省市区		省市区空格分开
return_no	采购退货单号		采购退货单号
provider_no	供应商编号		代表供应商所有属性的唯一编码，用于供应商区分，ERP内支持自定义（ERP供应商界面设置）
provider_name	供应商名称		供应商名称
pr_api_outer_no	采购退货单外部单号		采购退货单的外部单号
last_load_purchase_no	最后引用采购单号		最后引用采购单号
picklist_print_status	分拣单打印状态		默认为'0'，分拣单打印状态 0未打印 1打印中 2已打印 3无需打印
logistics_print_status	物流单打印状态		默认为'0'，物流单打印状态，0未打印 1打印中 2已打印 3无需打印
sendbill_print_status	发货单打印状态		默认为'0'，发货单打印状态，0未打印 1待打中 2已打印 3无需打印
stockout_no	出库单号		出库单号
src_order_id	源单据id		源单据id
wms_status	处理状态		处理状态 0 待处理 1 推送失败 2 推送成功 3 接口取消成功系统驳回失败 4 服务器正在处理 5 WMS返回发货信息 6 异步标记,推送申请成功
error_info	错误信息		接口处理错误信息
warehouse_type	仓库类别		默认为'0'，仓库类别  0不限 1普通仓库 2自动流转外部 3京东仓储 4科捷 5百世物流 6 SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 127其他
warehouse_id	出库的仓库id		出库的仓库id
customer_id	客户id		默认为'0'，客户id
freeze_reason	冻结原因		默认为'0'，冻结原因
is_allocated	是否分配		默认为'0'，是否分配
consign_status	出库状态		默认为'0'，出库状态 1验货 2称重 4出库 8物流同步 16分拣 32档口, 64拣货
ebill_status	面单状态		默认为'0'，电子面单,获取状态
operator_id	制单人		默认为'0'，制单人
goods_type_count	货品种类数量		默认为'0'，货品种类数量
md5_str	MD5字符串值		默认为''，MD5字符串值,用于单据排序
raw_goods_count	预留字段		默认为'0'，预留字段
custom_type	出库类别		默认为'0'，其他出库自定义子类别0，1，2，3，4
receiver_ring	接收环		默认为''，京东三环内（未使用）
to_deliver_time	配送时间		默认为''，配送时间
pre_charge_time	配送中心		默认为''，配送中心
logistics_id	物流公司id		默认为'0'，物流公司id
unknown_goods_amount	未知成本销售总额		默认为'0.0000'，未知成本销售总额
calc_post_cost	预估邮费成本		默认为'0.0000'，预估邮费成本
post_cost	邮费成本		默认为'0.0000'，邮费成本
calc_weight	预估重量		默认为'0.0000'，预估重量
post_weight	快递给的重量		默认为'0.0000'，快递给的重量
package_id	包装		默认为'0'，包装
package_cost	包装成本		默认为'0.0000'，包装成本
has_invoice	是否包含发票		默认为'0'，是否包含发票
printer_id	打单员		默认为'0'，打单员
pick_error_count	拣货出错次数		默认为'0'，拣货出错次数
picker_id	拣货操作员id		默认为'0'，拣货操作员id
sorter_id	包裹分拣员id		默认为'0'，包裹分拣员id
examiner_id	验货操作员id		默认为'0'，验货操作员id
consigner_id	发货人id		默认为'0'，发货人id
packager_id	打包员		默认为'0'，打包员
pack_score	打包积分		默认为'0'，打包积分
pick_score	拣货积分		默认为'0'，拣货积分
checkouter_id	签出员工id		默认为'0'，签出员工id
watcher_id	监视员		默认为'0'，监视员
picklist_no	分拣单编号		默认为''，分拣单编号
picklist_seq	分拣单中序号		默认为'0'，订单在分拣单中序号
invoice_print_status	发票打印状态		默认为'0'，发票打印状态
flag_id	颜色标记		默认为'0'，颜色标记
logistics_template_id	物流单模板id		默认为'0'， 物流单模板id
sendbill_template_id	发货单模板id		默认为'0'，发货单模板id
pos_allocate_mode	货位分配方式		默认为'0'，货位分配方式：0系统自动分配, 1手动指定货位分配 2手动指定有效期批次货位
note_count	便签条数		默认为'0'，便签条数
reason_id	出库原因		默认为'0'，其他出库原因
lock_id	锁定策略id		默认为'0'，锁定策略id
reserve	保留		默认为'0'，保留
block_reason	截停原因		默认为'0'，截停原因1申请退款2已退款4地址被修改8发票被修改16物流被修改32仓库变化64备注修改128更换货品256添加货品512放弃抢单1024其他原因2048拦截赠品4096拦截天猫换货8192买家留言变更16384货品平台规格名变更
stock_check_time	出库单审核时间		出库单审核时间
details_list	货品列表节点		响应参数的2级数据节点，包含的采购退货出库单及其明细的数据节点，节点下数据字段详见下述“detail_list”列表
details_list.stockout_id	出库单主键id		出库单主键id
details_list.goods_count	货品数量		货品数量
details_list.weight	重量		重量
details_list.remark	备注		备注
details_list.modified	最后修改时间		最后修改时间
details_list.src_order_type	源单据类别		默认为'1'，源单据类别 1销售订单2,调拨出库3,采购出库4,生产出库5,盘亏出库6,其他出库
details_list.batch_no	批次号		批次号
details_list.rec_id	出库明细主键id		出库明细主键id
details_list.spec_no	商家编码		代表单品（SKU）所有属性的唯一编号，用于系统单品的区分，SKU概念介绍单击这里
details_list.sell_price	销售价		销售价
details_list.brand_no	品牌编号		品牌编号
details_list.brand_name	品牌名称		品牌名称
details_list.goods_name	货品名称		货品名称
details_list.goods_no	货品编号		代表SPU所有属性的唯一编号，用于系统货品的区分，SPU概念介绍单击这里
details_list.spec_name	规格名称		规格名称
details_list.spec_code	规格编号		规格编号
details_list.cost_price	成本价		成本价
details_list.total_amount	总货款		总货款
details_list.goods_type	货品类别		1销售商品 2原材料 3包装 4周转材料5虚拟商品 0其它
details_list.goods_unit	单位名称		单位名称
details_list.batch_remark	批次备注		批次备注
details_list.expire_date	有效期		有效期，格式：yyyy-MM-dd HH:mm:ss
details_list.goods_id	货品id		货品id
details_list.spec_id	规格id		默认为'0'，规格id
details_list.src_order_detail_id	源单据细节id		sales_trade_order表的主键
details_list.base_unit_id	基本单位		默认为'0'，基本单位
details_list.unit_id	辅助单位		默认为'0'，辅助单位
details_list.unit_ratio	单位换算		默认为'1.0000'，单位换算
details_list.num2	辅助数量		默认为'0.0000，辅助数量
details_list.num	货品数量		货品数量
details_list.price	价格		默认为'0.0000，最终价格
details_list.batch_id	出库批次		默认为'0'，指定出库批次
details_list.is_examined	是否验货		默认为'0'，是否验货，用于挂起，已标记为验货的不需要再验货
details_list.is_package	是否包装		默认为'0'，是否包装
details_list.is_zero_cost	是否允许0成本		默认为'0'，是否允许0成本
details_list.scan_type	类型		默认为'0'，0未验货,1扫描验货,2手工验货
details_list.created	创建时间		创建时间
details_list.position_list	货位列表节点		响应参数的3级数据节点，节点下数据字段详见下述“position_list”列表
details_list.position_list.position_id	货位ID		货位ID
details_list.position_list.position_no	货位编号		货位编号
details_list.position_list.position_goods_count	货位出库数量		货位出库数量

金蝶云星空接口明细

• API：batchSave
• NAME：采购退货新增
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
FBillTypeID	单据类型	findCollection find FBillTypeID_Fnumber from 4df2d5ea-503e-3a23-ba07-8f9c63792592 where FBillNo={{pr_api_outer_no}}	单据编号
FBusinessType	业务类型	_findCollection find FBusinessType from 4df2d5ea-503e-3a23-ba07-8f9c63792592 where FBillNo={{pr_api_outer_no}}	业务类型
FBillNo	单据编号	{{order_no}}	单据编号
FDate	退料日期	{{consign_time}}	日期
FStockOrgId	退料组织	findCollection find FAPPORGID_Fnumber from 4df2d5ea-503e-3a23-ba07-8f9c63792592 where FBillNo={{pr_api_outer_no}}	组织
FPurchaseOrgId	采购组织	_findCollection find FPURCHASEORGID_Fnumber from 4df2d5ea-503e-3a23-ba07-8f9c63792592 where FBillNo={{pr_api_outer_no}}	组织
FSupplierID	供应商	{{provider_no}}	基础资料
FDESCRIPTION	备注		多行文本
FMRMODE	退料方式	B	多行文本
FDELIVERYNO	送货单号		文本
FCARRYNO	运输单号		文本
FTAKEDELIVERYNO	提货单号		文本
FPURMRBENTRY	明细信息	details_list	明细信息
FPURMRBENTRY.FMATERIALID	物料编码	{{details_list.spec_no}}	基础资料
FPURMRBENTRY.FBarcode	零售条形码		文本
FPURMRBENTRY.FRMREALQTY	实退数量	{{details_list.goods_count}}	数量
FPURMRBENTRY.FREPLENISHQTY	补料数量		数量
FPURMRBENTRY.FKEAPAMTQTY	扣款数量		数量
FPURMRBENTRY.FSTOCKID	仓库	{{warehouse_no}}	基础资料
FPURMRBENTRY.FNOTE	备注		文本
FPURMRBENTRY.FPrice	单价		单价
FPURMRBENTRY.FGiveAway	是否赠品		复选框
FPURMRBENTRY.FLot	批号		批次
FPURMRBENTRY.FOWNERID	货主	findCollection find FRequireOrgId_Fnumber from 4df2d5ea-503e-3a23-ba07-8f9c63792592 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}}	多类别基础资料
FPURMRBENTRY.FOWNERTYPEID	货主类型	BD_OwnerOrg	多类别基础资料列表
FPURMRBENTRY.FENTRYTAXRATE	税率		小数
FPURMRBENTRY.FDISCOUNTRATE	折扣率(%)		小数
FPURMRBENTRY.FTAXPRICE	含税单价	{{details_list.sell_price}}	单价
FPURMRBENTRY.FSRCBillTypeId	源单类型	PUR_MRAPP	文本
FPURMRBENTRY.FSRCBillNo	源单编号	_findCollection find FBillNo from 4df2d5ea-503e-3a23-ba07-8f9c63792592 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}}	文本
FPURMRBENTRY.FORDERNO	订单单号	findCollection find FORDERNO from 4df2d5ea-503e-3a23-ba07-8f9c63792592 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}}	文本
FPURMRBENTRY.FCONTRACTNO	合同单号		文本
FPURMRBENTRY.FMtoNo	计划跟踪号		文本
FPURMRBENTRY.FPURMRBENTRY_Link	关联关系表
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FRuleId	转换规则	PUR_MRAPP-PUR_MRB
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSTableName	源单表	T_PUR_MRAPPENTRY
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSBillId	源单内码	_findCollection find FID from 4df2d5ea-503e-3a23-ba07-8f9c63792592 where FBillNo={{pr_api_outer_no}}
FPURMRBENTRY.FPURMRBENTRY_Link.FPURMRBENTRY_Link_FSId	源单分录内码	_findCollection find FEntity_FEntryID from 4df2d5ea-503e-3a23-ba07-8f9c63792592 where FBillNo={{pr_api_outer_no}} FMATERIALID_Fnumber={{details_list.spec_no}}
FPURMRBENTRY.FormId	业务对象表单Id	PUR_MRB	必须填写金蝶的表单ID如 UR_PurchaseOrder
FPURMRBENTRY.Operation	执行的操作	batchSave
FPURMRBENTRY.IsAutoSubmitAndAudit	提交并审核	true
FPURMRBENTRY.IsVerifyBaseDataField	验证基础资料	false	是否验证所有的基础资料有效性，布尔类，默认false（非必录）
FPURMRBENTRY.SubSystemId	系统模块	21	默认仓库模块

系统对接概况

当企业规模逐渐增大时，作为支撑业务运营的IT建设也变得越来越重要，不过往往企业的IT建设过程中会发现某一家软件供应商基本不能完全覆盖企业所有的业务运营流程，这样的结果就是，企业上的IT系统很多很全，从ERP到HR、CRM、PDM、OA等，貌似所有的业务都覆盖到了，但实际上因为这些系统的不集成，而形成了企业很多新的信息孤岛，非常不利于企业的后续的管理和战略发展。从现今和往后的发展趋势来看，也不可避免会遇到上述问题，毕竟企业经营的多样化，并不是所有的业务都能在一个系统中完成，所以我们必须在产品架构上支持更好的与外部系统进行协同。通过轻易云集成平台统一的API管理平台，对API进行显性化、可视化，使所有API服务成为企业的数字资产，提升API利用率，发挥业务系统价值，实现企业IT资产的可插拔、可复用、可组成。