用友U8和旺店通·企业奇门单据接口对接

用友U8和旺店通·企业奇门单据接口对接

来源系统:旺店通·企业奇门

慧策（原旺店通）是一家技术驱动型智能零售服务商，基于云计算PaaS、SaaS模式，以一体化智能零售解决方案，帮助零售企业数字化智能化升级，实现企业规模化发展。

接通系统：用友U8

用友ERP-U8是一套企业级的解决方案，可满足不同的制造、商务模式下，不同运营模式下的企业经营管理，U8全面集成了财务、生产制造及供应链的成熟应用，延伸客户管理至客户关系管理（CRM），并对于零售、分销领域实现了全面整合。同时通过实现人力资源管理（HR），办公自动化（OA），保证行政办公事务、人力管理和业务管理的有效结合。用友ERP－U9是以集成的信息管理为基础，以规范企业运营，改善经营成果为目标，最终实现从企业日常运营、人力资源管理到办公事务处理等全方位的产品解决方案。

数据集成方案配置

通过轻易云系统数据集成平台新增创建集成方案，通过轻易云的方案市场可以一键复制，并且可以借鉴其他的方案配置完成方案制作，方案制作只需要两步，第一步先确定好对应的数据来源；源系统：旺店通·企业奇门接口：查询退货入库单通过请求调度者配置对应的请求参数即可获取到对应的数据。目标系统：用友U8接口：新增一张发货单，通过写入调度者匹配获取到的数据和写入的映射关系，即可自动生成符合目标系统：用友U8写入的数据自动产生写入队列，通过运行概况，系统会自动帮你诊断方案的运行情况。实时监控到方案的运行情况

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

• API：wdt.stockin.order.query.refund
• NAME：查询退货入库单
• METHOD：POST

请求参数

接口字段	字段名称	预设值	描述
start_time	开始时间		增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
end_time	结束时间		增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
status	状态		入库单状态 10已取消20编辑中30待审核60待结算80已完成（默认查询80已完成单据）
shop_no	店铺编号		代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息
page_size	分页大小	{{PAGINATION_PAGE_SIZE}}	每页返回的数据条数，输入值范围150，不传本参数，输入值默认为40，使用举例单击这里
page_no	页号	{{PAGINATION_START_PAGE}}	不传值默认从0页开始

响应参数

接口字段	字段名称	预设值	描述
order_no	入库单号		入库单号
warehouse_no	仓库编号		代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）
warehouse_name	仓库名称		仓库名称
shop_no	店铺编号		代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺数据信息
shop_remark	店铺备注		店铺备注
src_order_no	上层单据（退换单）编号
process_status	退换单状态		10已取消,20待审核,30已同意,40已拒绝,50待财审,60待收货,63待推送,64推送失败,65委外待收货,69待收货(已结算),70部分到货,71部分到货(已结算),80待结算 ,90已完成。ERP版本V2.3.8.4及以上才可返回
status	退货入库单状态		入库单状态 10已取消20编辑中30待审核60待结算80已完成
stockin_time	更新时间		更新时间 格式：yyyy-MM-dd HH:mm:ss
created_time	创建时间		创建时间 格式：yyyy-MM-dd HH:mm:ss
trade_no	订单编号		系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）
trade_type	系统订单类别		系统订单类别（1网店销售,2线下零售,3售后换货,4批发业务,5保修换新,6保修完成,7订单补发 .. 101自定义类型1,102自定义类型2,103自定义类型3,104自定义类型4 ,105自定义类型5,106自定义类型6）
order_type	单据类别		单据类别，默认返回3
order_type_name	单据类别名称		单据类别名称，默认为“退货入库”
goods_amount	货款总额		退回货款收入
actual_refund_amount	实际退款金额		实际退款金额
total_price	扣除优惠后货款总额		退回货品成本
post_fee	邮费		退货入库单的“邮资”
other_fee	其他费用		退货入库单的“其它金额”
logistics_type	物流类型		响应值为代表物流类型的数字，数字对应的物流类型名称单击这里
logistics_no	物流编号		代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
logistics_name	物流名称		ERP设置的物流公司名称
logistics_code	物流单号		物流单单号
refund_no	退换单编号		退换单编号
check_time	入库审核时间
customer_no	客户编号		客户编号
customer_name	客户名称		退货人的姓名
nick_name	客户网名		客户网名
shop_name	店铺名称		店铺名称
stockin_reason	入库原因		入库原因
flag_name	退货单标记		退换单界面的标记
platform_id	平台id		平台id
stockin_operator_name	入库操作人姓名		默认为''，入库操作人姓名
check_operator_name	审核人姓名		默认为''，审核人姓名
refund_remark	退换备注		默认为''，退换备注
refund_operator_name	退货员姓名		默认为''，退货员姓名
stockin_no	入库单号		入库单号
wms_outer_no	外部仓库单号		默认为''，对应外部仓库的单号
wms_status	外部仓库状态		默认为'0'，外部状态,与wms对接使用 0初始化 1失败 2成功'
wms_result	结果		默认为''，错误信息
warehouse_id	仓库id		默认为'0'，仓库id
src_order_id	业务单据id		默认为'0'，业务单据id
reason_id	原因		原因
fa_status	财务同步状态		默认为'0'，财务同步状态
logistics_id	物流公司d		默认为'0'，物流公司id
post_share_type	邮资分摊类型		默认为'0'，邮费分摊类型0,不分摊 1,按数量分摊2,按照金额分摊'
operator_id	操作员id		操作员id
check_operator_id	审核员id
goods_type_count	货品种类数		默认为'0'，货品种类数
note_count	便签条数		默认为'0'，便签条数
flag_id	标记id		默认为'0'，标记id
details_list	货品列表节点		退回货品列表节点
details_list.stockin_id	入库单主键id		入库单主键id
details_list.remark	备注		备注
details_list.goods_count	货品数量		货品数量
details_list.discount	优惠金额		优惠金额
details_list.tax_amount	税后金额		税后金额
details_list.adjust_price	纠错金额		纠错金额
details_list.right_price	调整后单价		调整后单价
details_list.tid	原订单原始单号		原订单原始单号
details_list.src_order_type	订单类型		1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库
details_list.adjust_num	纠错数量		纠错数量
details_list.modified	最后修改时间		最后修改时间
details_list.rec_id	明细表主键id		明细表主键id
details_list.src_order_detail_id	上层单据（退换单）退回货品明细主键		上层单据（退换单）退回货品明细主键，ERP版本V2.3.8.3及以上才可返回
details_list.spec_no	商家编码		代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍,单击这里
details_list.cost_price	成本价		成本价
details_list.production_date	生产日期		生产日期，格式：yyyy-MM-dd HH:mm:ss
details_list.validity_days	有效期天数		有效期天数
details_list.expire_date	有效期		有效期，格式：yyyy-MM-dd HH:mm:ss
details_list.src_price	原价		原价
details_list.tax_price	税后单价		税后单价
details_list.tax	税率		税率
details_list.total_cost	总成本		总成本
details_list.right_num	调整后数量		调整后数量
details_list.num	入库数量		入库数量
details_list.num2	辅助数量		辅助数量
details_list.right_cost	调整后总金额		调整后总金额
details_list.brand_no	品牌编号		品牌编号
details_list.brand_name	品牌名称		品牌名称
details_list.goods_name	货品名称		货品名称
details_list.prop2	单品自定义属性2		单品自定义属性2
details_list.goods_no	货品编号		代表货品(spu)所有属性的唯一编号，用于系统货品区分，，SPU概念介绍,单击这里
details_list.spec_name	规格名称		规格名称
details_list.spec_code	规格编号		规格编号
details_list.goods_unit	基本单位		基本单位
details_list.batch_no	入库批次		入库批次
details_list.batch_remark	批次备注		批次备注
details_list.position_no	货位编号		货位编号
details_list.oid	原订单原始子单号		原订单原始子单号
details_list.org_stockin_detail_id	原始入库单明细		默认为'0'，原始入库单明细
details_list.spec_id	erp商品主键		erp内商品主键
details_list.batch_id	批次		默认为'0'，批次
details_list.position_id	货位id		默认为'0'，货位ID，入库时默认ID
details_list.unit_id	辅助单位		默认为'0'，辅助单位
details_list.base_unit_id	基本单位		默认为'0'，基本单位
details_list.unit_ratio	单位比率		默认为'1.0000'，单位换算关系
details_list.expect_num	期望数量		默认为'0.0000'，预期入库数量（基本单位数量，显示可自动转换成辅助单位）
details_list.cost_price2	辅助价格		默认为'0.0000'，辅助成本价
details_list.share_post_cost	邮资分摊成本		默认为'0.0000'，邮资分摊成本
details_list.share_post_total	邮资分摊总成本		默认为'0.0000'，邮资分摊总成本
details_list.created	创建时间		创建时间

用友U8接口明细

• 接口：api/returnorder/add
• 接口名称：新增一张发货单
• 接口方法：POST

请求参数

字段	名称	类型	描述
code	单据号	string	单据号
date	单据日期	string	单据日期
operation_type	业务类型	string	业务类型
saletype	销售类型编码	string	销售类型编码
saletypename	销售类型	string	销售类型
state	订单状态	string	订单状态
custcode	客户编码	string	客户编码
cusname	客户	string	客户
cusabbname	客户简称	string	客户简称
deptcode	部门编码	string	部门编码
deptname	部门名称	string	部门名称
personcode	人员编码	string	人员编码
personname	人员	string	人员
cdeliverunit	收货单位	string	收货单位
ccontactname	收货联系人	string	收货联系人
cofficephone	收货联系电话	string	收货联系电话
cmobilephone	收货联系人手机	string	收货联系人手机
cdeliveradd	收货地址	string	收货地址
define1	单据头自定义项1	string	单据头自定义项1
define2	单据头自定义项2	string	单据头自定义项2
define3	单据头自定义项3	string	单据头自定义项3
define4	单据头自定义项4	string	单据头自定义项4
define5	单据头自定义项5	string	单据头自定义项5
define6	单据头自定义项6	string	单据头自定义项6
define7	单据头自定义项7	string	单据头自定义项7
define8	单据头自定义项8	string	单据头自定义项8
define9	单据头自定义项9	string	单据头自定义项9
define10	单据头自定义项10	string	单据头自定义项10
define11	单据头自定义项11	string	单据头自定义项11
define12	单据头自定义项12	string	单据头自定义项12
define13	单据头自定义项13	string	单据头自定义项13
define14	单据头自定义项14	string	单据头自定义项14
define15	单据头自定义项15	string	单据头自定义项15
define16	单据头自定义项16	string	单据头自定义项16
remark	备注	string	备注
maker	制单人	string	制单人
verifier	审核人	string	审核人
closer	关闭人	string	关闭人
entry	分录	array	分录
entry.unit_code	辅计量单位	string	辅计量单位
entry.num	件数	string	件数
entry.unitrate	换算率	string	换算率
entry.free1	自由项1	string	自由项1
entry.free2	自由项2	string	自由项2
entry.free3	自由项3	string	自由项3
entry.free4	自由项4	string	自由项4
entry.free5	自由项5	string	自由项5
entry.free6	自由项6	string	自由项6
entry.free7	自由项7	string	自由项7
entry.free8	自由项8	string	自由项8
entry.free9	自由项9	string	自由项9
entry.free10	自由项10	string	自由项10
entry.define22	单据体自定义项1	string	单据体自定义项1
entry.define23	单据体自定义项2	string	单据体自定义项2
entry.define24	单据体自定义项3	string	单据体自定义项3
entry.define25	单据体自定义项4	string	单据体自定义项4
entry.define26	单据体自定义项5	string	单据体自定义项5
entry.define27	单据体自定义项6	string	单据体自定义项6
entry.define28	单据体自定义项7	string	单据体自定义项7
entry.define29	单据体自定义项8	string	单据体自定义项8
entry.define30	单据体自定义项9	string	单据体自定义项9
entry.define31	单据体自定义项10	string	单据体自定义项10
entry.define32	单据体自定义项11	string	单据体自定义项11
entry.define33	单据体自定义项12	string	单据体自定义项12
entry.define34	单据体自定义项13	string	单据体自定义项13
entry.define35	单据体自定义项14	string	单据体自定义项14
entry.define36	单据体自定义项15	string	单据体自定义项15
entry.define37	单据体自定义项16	string	单据体自定义项16
entry.rowno	行号	string	行号
entry.inventory_code	存货编码	string	存货编码
entry.inventory_name	存货名称	string	存货名称
entry.warehouse_code	仓库编码	string	仓库编码
entry.warehouse_name	仓库名称	string	仓库名称
entry.invstd	存货规格	string	存货规格
entry.ccomunitcode	主计量单位编码	string	主计量单位编码
entry.cinvm_unit	主计量单位	string	主计量单位
entry.quantity	数量	string	数量
entry.price	单价	string	单价，传入会自动重新计算相关价格及金额。如果传入了含税单价，以含税单价为准自动计算。
entry.quotedprice	报价	string	报价
entry.taxprice	含税单价	string	含税单价，传入会自动重新计算相关价格及金额。
entry.money	无税金额	string	无税金额
entry.sum	价税合计	string	价税合计
entry.taxrate	税率	string	税率
entry.tax	税额	string	税额
entry.natprice	本币单价	string	本币单价
entry.natmoney	本币金额	string	本币金额
entry.nattax	本币税额	string	本币税额
entry.natsum	本币价税合计	string	本币价税合计
entry.discount	折扣额	string	折扣额
entry.natdiscount	本币折扣额	string	本币折扣额
entry.discount1	扣率（%）	string	扣率（%）
entry.discount2	扣率2（%）	string	扣率2（%）
entry.socode	销售订单号	string	销售订单号
entry.batch	批号	string	批号
entry.ExpirationDate	有效期至	string	有效期至
entry.cmassunit	保质期单位	string	保质期单位
entry.ExpirationItem	有效期计算项	string	有效期计算项
entry.dmdate	生产日期	string	生产日期
entry.overdate	失效日期	string	失效日期
entry.ExpiratDateCalcu	有效期推算方式	string	有效期推算方式
entry.imassdate	保质期	string	保质期
entry.item_code	项目编码	string	项目编码
entry.paramsKey	请求参数key	string

系统对接概况

数据集成中台设计中心Web界面以“拖拽”式交互设计，使用鼠标即可构建设计多异构系统数据集成流程，低代码平台大大降低流程设计者上手门槛。还有丰富的组件库快速满足复杂业务需求，结合不同模块即可生成不同业务流程，提升流程设计效率。平台支持多种高度灵活部署，高并发、高性能、高可用，可以通过多节点组成集群实现性能的横向扩展。适度集群配置其数据集成处理能力可达GB级/秒，为业务流提供更高数据吞吐量。平台已集成数据回压、优先级队列等能力，保障运行稳定性。完善的企业API运营管理机制帮助您构建“API生产者、API管理者、API消费者”三者结合的统一API数字化生态。支持市面上主流厂家软件如：金蝶、用友、SAP、泛微、蓝凌、旺店通、聚水潭、马帮、小满CRM等等。