客户端新团购产品需求文档-20130701

标题：客户端新团购产品需求文档项目编号：文档负责人：左圣烈版本号：V1.3最后修改日期：修改人：页码：左圣烈PAGE61ofNUMPAGES61客户端新团购产品需求文档

修订控制页编号文档版本修订章节修订原因修订日期修订人1V1.0初始版本--2013-6-13左圣烈2V对订单退款部分进行了详细说明2013-6-17左圣烈3V增加了客户端对团购券状态的封装说明2013-6-21左圣烈4V窝窝团购订单一券一用“券号码”取“供应商订单编号“2013-7-1左圣烈5678910

目录TOC\o"1-4"\h\z\u1. 概述 91.1. 文档说明 91.2. 名词说明 91.3. 产品背景及概述 91.4. 需求关联对象 92. 功能总览 92.1. IT总览 102.2. 功能清单 103. 功能详情 113.1. 团购城市列表 113.1.1. 团购城市获取及展示 11. 功能需求描述 11. 核心流程及规则 11. 页面原型及说明 13. 页面处理规则 13. 关联改造说明 13. 接口说明 143.2. 团购产品展示 143.2.1. 团购产品列表 14. 功能需求描述 14. 核心流程及规则 14. 页面原型及说明 15. 页面处理规则 16. 关联改造说明 16. 接口说明 173.2.2. 团购筛选 17. 功能需求描述 17. 核心流程及规则 17. 页面原型及说明 18. 页面处理规则 19. 关联改造说明 19. 接口说明 203.2.3. 团购搜索 20. 功能需求描述 20. 核心流程及规则 20. 页面原型及说明 21. 页面处理规则 22. 关联改造说明 22. 接口说明 223.2.4. 团购产品详情 22. 功能需求描述 22. 核心流程及规则 22. 页面原型及说明 23. 页面处理规则 27. 关联改造说明 28. 接口说明 283.3. 团购下单 283.3.1. 订单提交与创建 28. 功能需求描述 28. 核心流程及规则 28. 页面原型及说明 30. 页面处理规则 31. 关联改造说明 31. 接口说明 313.4. 团购订单支付 313.4.1. 易付宝余额支付 31. 功能需求描述 31. 核心流程及规则 31. 页面原型及说明 33. 页面处理规则 35. 关联改造说明 35. 接口说明 353.4.2. 银联手机支付 35. 功能需求描述 36. 核心流程及规则 36. 页面原型及说明 37. 页面处理规则 38. 关联改造说明 38. 接口说明 383.5. 团购订单展示 393.5.1. 订单列表 39. 功能需求描述 39. 核心流程及规则 39. 页面原型及说明 40. 页面处理规则 40. 关联改造说明 41. 接口说明 413.5.2. 订单筛选 41. 功能需求描述 41. 核心流程及规则 41. 页面原型及说明 42. 页面处理规则 43. 关联改造说明 43. 接口说明 433.5.3. 订单详情 43. 功能需求描述 43. 核心流程及规则 43. 页面原型及说明 44. 页面处理规则 47. 关联改造说明 49. 接口说明 493.6. 团购订单管理 493.6.1. 订单取消 49. 功能需求描述 49. 核心流程及规则 49. 页面原型及说明 50. 页面处理规则 51. 关联改造说明 51. 接口说明 513.6.2. 订单二次支付 52. 功能需求描述 52. 核心流程及规则 52. 页面原型及说明 53. 页面处理规则 53. 关联改造说明 53. 接口说明 543.6.3. 订单退款 54. 功能需求描述 54. 核心流程及规则 54. 页面原型及说明 56. 页面处理规则 58. 关联改造说明 59. 接口说明 593.7. 附：错误信息列表 59

概述文档说明本文档用于定义“客户端新团购”的产品需求，包含功能说明、核心流程及规则、接口说明、页面原型及处理规则等内容，为客户端开发、接口开发及测试提供作业依据。名词说明编号名词说明产品背景及概述电子商务中心去年上线了生活类团购（），包含了自营和代销两部分，代销部分的供应商主要有艺龙和窝窝团两家，酒店团购产品绝大部分都是来自艺龙的需求关联对象编号对象名称对象说明用户易购客户端虚拟团购系统易付宝支付核心银联功能总览IT总览功能清单编号一级功能二级功能对应接口1团购城市列表1.1团购城市获取及展示团购城市列表接口2团购产品展示2.1团购产品列表团购产品列表接口2.2团购筛选2.3团购搜索2.4团购产品详情团购产品详情接口3团购下单3.1订单提交与创建团购提交订单接口4团购订单支付4.1易付宝余额支付团购易付宝余额支付接口4.2银联手机支付团购银联手机支付接口5团购订单展示5.1订单列表团购订单列表接口5.2订单筛选5.3订单详情团购订单详情接口6团购订单管理6.1订单取消团购订单取消接口6.2订单二次支付无6.3订单退款团购订单退款接口功能详情团购城市列表团购城市获取及展示功能需求描述核心流程及规则流程图流程描述用户进入团购频道客户端判断是否存在缓存城市是，则根据缓存城市查询团购产品列表（见3.2.1章节）否，再判断是否存在缓存城市列表是，展示缓存的城市列表否，则调用团购城市列表接口提交查询请求至团购系统团购系统处理查询请求，将团购城市列表返回给客户端客户端展示团购城市列表供用户选择，并将城市列表缓存在客户端本地规则描述团购城市列表由“热门城市”和“所有城市”组成，其中“所有城市”以城市名称首字母进行列表拆分团购城市的缓存机制为始终保存用户最后选择的城市，退出客户端后不清除；团购城市列表的缓存机制是退出客户端后立即清除本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）页面原型及说明11编号名称描述团购城市列表界面字段数据仅供演示页面处理规则从易购首页进入该页面时，点击返回按钮返回到易购客户端首页；从团购产品列表页进入该页面时，点击返回按钮返回到团购产品列表页关联改造说明接口说明编号接口名称接口描述团购城市列表接口提交查询请求，获取团购城市列表团购产品展示团购产品列表功能需求描述核心流程及规则流程图流程描述用户在团购城市列表界面选择团购城市客户端调用团购产品列表接口提交查询请求至团购系统团购系统处理查询请求，将团购产品列表及对应的筛选条件返回给客户端客户端展示团购产品列表（筛选条件供提交筛选请求时使用，见3.2.2章节）规则描述团购产品列表默认展示全部团购，以团购系统的默认序值来排序团购产品列表有大图和列表两种视图，接口则返回了三种规格的图片url，用户切换视图时客户端下载尺寸合适的图片大图视图中团购产品的标题需要由商品描述前缀（原团购所在区域）和团购产品名称拼接，若商品描述前缀返回值为空，客户端将其处理成其他团购列表接口还返回了产品是否为艺龙团购的标示（产品类型），供查询产品详情时使用，详见3.2.4章节旅游、酒店类的团购产品列表不受团购城市控制，查询任意城市都是返回全部产品；电影、美食、生活、娱乐、丽人类的团购产品根据团购城市来动态展示（接口及服务端的逻辑）本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）页面原型及说明2121编号名称描述团购产品列表-列表视图字段数据仅供演示团购产品列表-大图视图字段数据仅供演示页面处理规则团购所在区域分单店和多店，单店直接显示所在区域；非艺龙团购的多店显示为“x店通用”，艺龙团购的多店显示为“多店通用”（接口及服务端的逻辑，客户端直接展示即可）团购产品列表的展示字段为团购产品图片、团购产品名称、团购价格、原价、已购买数、商品描述前缀，列表的分页数量为12条关联改造说明接口说明编号接口名称接口描述团购产品列表接口提交查询请求，获取团购产品列表团购筛选功能需求描述核心流程及规则流程图流程描述用户在团购产品列表页点击侧边栏按钮客户端滑出侧边栏，并展示筛选条件用户点击筛选条件客户端调用团购产品列表接口提交查询请求至团购系统团购系统处理查询请求，将团购产品列表及对应的筛选条件返回给客户端客户端展示团购产品列表规则描述考虑到接口全面性，团购系统每次返回查询结果时都会带上筛选条件，由于接口没有返回“全部分类”，所以需要客户端写死在页面上的（一二级筛选条件都需要加），并默认选中由于旅游、酒店类团购不受团购城市控制，所以无论选择任何城市，这两个一级类目都是存在的，其二级筛选条件是团购城市（接口及服务端的逻辑）电影、美食、生活、娱乐、丽人类团购受到团购城市控制，所以若该城市没有这些类目的团购，则不展示该类目的入口，这五个一级类目下的二级筛选条件是团购二级类目（接口及服务端的逻辑）本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）页面原型及说明2121编号名称描述团购筛选界面-二级类目展开字段数据仅供演示团购筛选界面-二级类目收起字段数据仅供演示页面处理规则用户选择筛选条件后，客户端收起侧边栏展示接口返回的团购产品列表关联改造说明接口说明编号接口名称接口描述团购产品列表接口提交查询请求，获取团购产品列表团购搜索功能需求描述核心流程及规则流程图流程描述用户在团购产品列表页点击搜索框客户端展示团购搜索界面用户输入关键字，确认搜索客户端调用团购产品列表接口提交搜索请求至团购系统，并本地保存搜索记录团购系统处理搜索请求，将搜索结果返回给客户端客户端展示团购产品列表规则描述团购搜索结果不支持筛选和视图切换用户输入关键字点击搜索后，客户端即本地保存搜索记录，上限数量为10条，若超出则按保存时间从旧到新逐条覆盖本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）页面原型及说明2121编号名称描述团购搜索界面字段数据仅供演示团购搜索结果字段数据仅供演示页面处理规则团购搜索结果列表的展示字段与团购产品列表一致，分页数量为12条；搜索无结果时在页面中间显示“没有找到相关团购，请重新搜索”关联改造说明接口说明编号接口名称接口描述团购产品列表接口提交查询请求，获取团购产品列表团购产品详情功能需求描述核心流程及规则流程图流程描述用户点击团购产品列表行项目客户端调用团购产品详情接口提交查询请求至团购系统（输入产品ID、产品类型等参数），同时根据产品类型打开对应的页面模板团购系统处理查询请求，将团购产品详情返回给客户端客户端在对应的页面模板展示团购产品详情规则描述产品类型说明：电影、美食、生活、娱乐、丽人、旅游类团购的产品详情数据及页面展示是一致的，艺龙酒店团购则是单独的，在团购产品列表接口中返回了该标示（是否为艺龙团购）非艺龙团购产品详情中的“本单详情”与艺龙团购中的“团购包含项目“处理成了网页，客户端通过团购详情接口返回的ur来打开页面团购标题需要由商品描述前缀（原团购所在区域）和团购产品描述拼接，若商品描述前缀返回值为空，客户端将其处理成其他团购产品详情接口返回了该团购产品的单次可购买数量，作为提交订单时的检查规则本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）页面原型及说明121233545466编号名称描述非艺龙团购产品详情展示字段为团购图片、团购价格、原价、团购剩余时间、已购买数、团购标题（商品描述前缀+团购产品描述）、是否支持未消费退款标示非艺龙团购产品详情-本单详情网页形式非艺龙团购产品详情-商家地址展示字段为商家名称、地址、电话、交通提示艺龙团购产品详情展示字段为团购图片、团购价格、原价、团购剩余时间、已购买数、团购标题（商品描述前缀+团购产品描述）、是否支持未消费退款标示艺龙团购产品详情-团购包含项目网页形式艺龙团购产品详情-商家信息展示字段为酒店名称、酒店地址、预约电话页面处理规则团购详情页面需要根据接口返回值来进行以下处理判断该团购是否已结束：否，展示“购买“按钮，是，则展示”已结束“按钮且不可点击判断该团购是否支持未消费退款、是否支持过期退款，并展示对应标示，如下图团购详情中的“团购服务热线”和商品信息中的电话号码，点击后可以进行拨号选择关联改造说明接口说明编号接口名称接口描述团购产品详情接口提交查询请求，获取团购产品详情团购下单订单提交与创建功能需求描述核心流程及规则流程图流程描述用户在团购产品详情页点击“购买”按钮客户端判断用户是否登录是，则展示团购下单界面，带出团购产品名称、单价、单次可购买数量及手机号码否，则走登录流程用户在下单界面填写订单信息，确认提交客户端检查表单信息是否合法，具体规则如下：购买数量：需大于0，不超过单次可购买数量，若不符合则提示”购买数量输入有误，请重新输入“手机号码：需为13、14、15、18开头的11位数字，若不符合则提示”手机号码输入有误，请重新输入“表单检查通过后，客户端调用团购提交订单接口申请创建订单团购系统接收客户端下单请求，进行订单检查、订单创建，完毕后将订单处理结果返回给客户端客户端接收订单处理结果，提示用户若处理结果为成功，则展示支付方式选择界面若为失败，则直接展示接口返回的错误描述，常见的错误描述如下（详见3.7章节）对不起，您来晚了，团购已结束，请重新选择商品库存不足，无法满足订单需求规则描述团购单次可购买数量是在团购产品详情接口返回的，设该数量为N，若N小于等于99，则用户单次至多可购买N件；若N大于99，则单次至多可购买99件购买数量输入框默认值为1，程序控制只能输入一到两位数字，不可输入其他字符，若第一位数字输入0则修改成1手机号码从会员信息中带出，可自行修改，如果无手机号信息则为空，输入框只能输入11位数字，不可输入其他字符提交订单接口也需要传入团购产品类型本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）1页面原型及说明1编号名称描述团购下单界面字段数据仅供演示页面处理规则页面上的“总价“由客户端根据产品单价和购买数量计算关联改造说明接口说明编号接口名称接口描述团购提交订单接口申请创建团购订单团购订单支付易付宝余额支付功能需求描述核心流程及规则流程图流程描述用户成功提交订单，进入支付方式选择页面客户端调用易付宝账户查询接口提交查询请求（这个接口是朱德斌调会员组的逻辑，中间的过程省略）会员组处理查询请求，把用户易付宝账户信息返回给客户端（余额、是否激活）客户端根据查询结果进行对应处理（易付宝余额充足标签才可点击，详见下方页面处理规则）用户选择易付宝支付客户端展示易付宝支付界面，带出订单金额及易付宝余额用户输入支付密码，点击确认支付客户端调用团购易付宝余额支付接口申请支付，提交会员编号、订单号、订单金额、支付密码、支付方式等参数虚拟团购系统接收客户端支付请求并处理，检查团购订单是否合法（包括订单中的团购产品是否在售、库存是否充足、价格有无变化、订单状态有无变化等）是，则调用易付宝扣款接口申请支付，提交订单号、支付金额、支付密码等参数否，则将报错信息返回给客户端客户端接收报错信息，提示用户（客户端直接展示接口返回的错误描述即可，详见3.7章节），常见的错误描述如下对不起，您来晚了，团购已结束，请重新选择库存不足，无法满足订单需求易付宝接收团购系统支付请求，检查支付信息（包括商户信息检查、用户信息检查、支付密码检查等），创建支付订单，进行支付后续处理，完毕后更新支付订单，将支付结果通知团购系统团购系统接收支付结果通知，将支付结果返回给客户端（包括是否支付成功、支付密码错误次数等），并异步更新团购订单，进行订单后续处理客户端接收支付结果，提示用户若支付成功，展示支付成功界面若支付失败，展示报错信息支付密码错误3次以内，提示“密码已错误N次，若达到3次账户将被冻结24小时”支付密码错误3次及以上，提示“密码已错误三次，请24小时之后再试”其他错误或异常直接展示接口返回的错误描述，见3.7章节规则描述客户端不对支付密码的字符长度、类型做任何限制，不为空即可本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）页面原型及说明113232编号名称描述支付方式选择界面字段数据仅供演示易付宝付款界面字段数据仅供演示支付成功界面字段数据仅供演示页面处理规则客户端在支付方式选择界面根据用户易付宝账户状态进行如下处理：若易付宝账户未激活，则展示“您的易付宝未激活，无法支付”，易付宝支付标签不可点击若易付宝账户已激活，再判断账户余额是否大于等于订单金额是，则展示“账户余额充足，可以支付”，易付宝支付标签可点击否，则展示“账户余额不足，请选择其他支付方式”，易付宝支付标签不可点击若用户未输入支付密码点击“确认支付“，客户端提示”支付密码不能为空“提交订单成功后，用户在支付方式选择界面点击返回按钮返回到团购产品详情页；在订单详情页通过付款按钮进入支付方式选择界面时，点击返回按钮返回到订单详情页支付方式选择界面的快捷支付是之前的汇付天下，现在不做关联改造说明接口说明编号接口名称接口描述易付宝账户查询接口查询用户易付宝账户信息团购易付宝余额支付接口提交支付请求，接收订单校验结果及易付宝支付处理结果银联手机支付功能需求描述核心流程及规则流程图流程描述用户成功提交订单，选择银联手机支付客户端调用团购银联手机支付接口申请支付，提交会员编号、订单号、订单金额、、支付方式等参数，并打开银联支付控件虚拟团购系统接收客户端支付请求并处理，检查团购订单是否合法（包括订单中的团购产品是否在售、库存是否充足、价格有无变化、订单状态有无变化等）是，则调用易付宝支付接口申请支付，提交订单号、支付金额等参数否，则将报错信息返回给客户端客户端接收报错信息，提示用户（客户端直接展示接口返回的错误描述即可，详见3.7章节），常见的错误描述如下对不起，您来晚了，团购已结束，请重新选择库存不足，无法满足订单需求易付宝接收团购系统支付请求，检查支付信息，创建支付订单，生成银联支付参数（支付回调地址、商户名称、支付金额、签名等），将银联支付参数发送给团购系统，团购系统接收银联支付参数，返回给客户端客户端接收银联支付参数，展示支付界面用户在银联支付控件中输入支付信息，点击确认支付银联支付控件调用银联支付接口申请支付银联检查支付信息，处理支付请求，完毕后将银联支付结果通知到易付宝和银联支付控件易付宝接收银联支付结果通知，进行对应处理，完毕后更新支付订单，将易付宝支付处理结果通知团购系统团购系统接收易付宝支付结果通知，更新团购订单，进行订单后续处理银联支付控件接收支付结果，提示用户若支付成功，关闭银联支付控件，展示客户端支付成功界面若支付失败，银联支付界面展示报错信息规则描述银联支付控件运行过程中出现的错误由银联公司控制，商户无从得知本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）页面原型及说明11编号名称描述银联支付控件字段数据仅供演示页面处理规则若用户未支付完成退出银联支付控件，客户端依然展示支付方式选择界面关联改造说明接口说明编号接口名称接口描述团购银联支付接口提交支付请求，接收订单校验结果及银联支付参数团购订单展示订单列表功能需求描述核心流程及规则流程图流程描述用户进入“我的团购“客户端检查用户是否登录，是则调用团购订单列表接口提交查询请求至团购系统（未登录走登录流程）团购系统处理查询请求，将团购订单列表及订单类型返回给客户端客户端展示团购订单列表（订单类型供查询订单详情时使用，见3.5.3章节）规则描述本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）1页面原型及说明1编号名称描述团购订单列表字段数据仅供演示页面处理规则订单列表按下单时间从近到远排序，默认展示所有状态的订单，分页数量为12条，订单状态有四种：等待付款、支付完成、交易关闭、退款中，展示字段为团购产品名称、购买数量、订单状态、订单金额若没有订单记录，则页面中间显示“没有订单记录关联改造说明接口说明编号接口名称接口描述团购订单列表接口查询团购订单列表订单筛选功能需求描述核心流程及规则流程图流程描述用户在团购订单列表点击筛选条件客户端调用团购订单列表接口提交查询请求至团购系统团购系统处理查询请求，将团购订单列表及订单类型返回给客户端客户端展示团购订单列表（订单类型供查询订单详情时使用，见3.5.3章节）规则描述本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）页面原型及说明11编号名称描述团购订单列表字段数据仅供演示页面处理规则用户可通过订单状态筛选订单：所有状态、等待付款、支付完成、交易关闭、退款中，默认展示所有状态的订单若无订单记录，则页面中间显示“没有订单记录关联改造说明接口说明编号接口名称接口描述团购订单列表接口查询团购订单列表订单详情功能需求描述核心流程及规则流程图流程描述用户点击团购订单列表行项目客户端调用团购订单详情接口提交查询请求至团购系统（输入订单ID、订单类型等参数），同时根据订单类型打开对应的页面模板团购系统处理查询请求，将团购订单详情（包括是否支持退款）返回给客户端客户端在对应的页面模板展示团购订单详情规则描述订单类型说明：电影、美食、生活、娱乐、丽人、旅游类团购的订单详情数据及页面展示是一致的，艺龙酒店团购则是单独的，在团购订单列表接口中返回了该标示（是否为艺龙订单）非艺龙订单又分为一券一用和一券多用，在团购订单详情接口返回了该标示是否支持退款标示便于客户端在订单详情中判断是否展示“退款“按钮，详见3.6.3章节非艺龙团购订单中的“温馨提示”与艺龙订单中的“团购包含项目“处理成了网页，客户端通过订单详情接口返回的ur来打开页面本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）页面原型及说明2121434356568787编号名称描述非艺龙团购订单详情字段数据仅供演示非艺龙团购订单详情-温馨提示网页形式非艺龙团购订单详情-团购券信息-一券一用字段数据仅供演示非艺龙团购订单详情-团购券信息-一券多用字段数据仅供演示艺龙团购订单详情字段数据仅供演示艺龙团购订单详情-团购券信息-一券一用字段数据仅供演示艺龙团购订单详情-团购包含项目网页形式艺龙团购订单详情-团购券信息-商家信息字段数据仅供演示页面处理规则团购券一券一用是指一个团购订单N个商品，生成N个团购券，每个团购券可到商家验证一次；一券多用是指一个团购订单N个商品，生成1个团购券，此团购券可到商家验证N次艺龙团购订单不存在一券多用的情况，都是一券一用；非艺龙团购订单是一券一用和一券多用共存，其中一券一用又分为自营商品团购券（有券号无密码）、供应商团购券（一券号对应多密码）只有支付完成的团购订单才会有团购券信息的入口非艺龙团购订单中“供应商来源“若为“窝窝团”，则一券一用的“券号码”取接口中“供应商订单编号”字段的返回值一券一用在订单详情接口返回的是券系统状态，客户端需要进行封装，便于用户理解（先判断订单类型，再判断券类型）非艺龙订单一券一用的券系统状态有9种返回值与券状态的对应关系如下：（0）未生成（1）待生效（未成团前）（2）已生效（已成团）（3）已过期（4）已使用（5）待退款（6）已退款（7）使用退款中（8）使用退款完成处理规则如下：当返回值为0、1时，页面不展示券为2时，券状态展示为未使用为3时，券状态展示为已过期为4时，券状态展示为已使用为5、6、7、8时：券状态展示为已作废艺龙订单一券一用的券系统状态有6种，返回值与状态的对应关系如下：（0）待生效（1）未使用（2）已使用（3）已失效（4）已作废（5）已退款处理规则如下：当返回值为0时，页面不展示券为1时，券状态展示为未使用为2时，券状态展示为已使用为3时，券状态展示为已过期（PC是处理成已失效，一个意思）为4、5时：券状态展示为已作废一券一用和一券多用都会存在订单已付款而券全部未生成或待生效的情况（很少出现），此时进入团购券信息页面，显示“团购券还未生效，请等待”酒店团购订单中商家信息的电话号码，点击之后可以选择拨号点击项目名称进入对应的团购详情页关联改造说明接口说明编号接口名称接口描述团购订单详情接口查询团购订单详情团购订单管理订单取消功能需求描述核心流程及规则流程图流程描述客户端在订单详情界面根据订单状态进行展示处理，具体如下若团购订单详情接口返回的订单状态为等待付款，则展示“取消“按钮用户点击“取消“按钮客户端调用团购订单取消接口申请关闭订单团购系统进行订单检查、订单关闭，完毕后将处理结果返回给客户端客户端接收处理结果，若处理结果为成功，则提示用户订单取消成功，并返回订单列表界面，重新调用订单列表接口更新订单状态；若失败，则直接展示接口返回的错误描述（详见3.7章节）规则描述本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）页面原型及说明11编号名称描述订单取消界面字段数据仅供演示页面处理规则用户点击取消按钮后，客户端需弹出提示框供用户确认，见上图关联改造说明接口说明编号接口名称接口描述团购订单取消接口申请关闭团购订单订单二次支付功能需求描述核心流程及规则流程图流程描述客户端在订单详情界面根据订单状态进行展示处理，具体如下若团购订单详情接口返回的订单状态为等待付款，则展示“付款“按钮用户点击“付款“按钮客户端展示支付方式选择界面（无需调用接口，直接通关）用户选择支付方式确认支付走正常支付流程（见3.4章节）规则描述本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）1页面原型及说明1编号名称描述订单二次支付界面字段数据仅供演示页面处理规则关联改造说明接口说明编号接口名称接口描述无需调用接口订单退款功能需求描述核心流程及规则流程图流程描述客户端在团购券详情界面根据订单详情接口返回值进行展示处理，具体如下：先判断订单中的团购产品是否支持未消费退款，若是，再判断团购券是一券一用还是一券多用若为一券一用，接着判断团购券的状态是否为“未使用”（判断到每一行），若是，则退款复选框可选择，反之则不可选若为一券多用，接着判断团购券的“未使用数”是否大于0，若是，则展示退款按钮，反之则不展示用户选择团购券，点击“退款“按钮，客户端展示退款申请界面一券一用的退款申请是先勾选团购券再点击退款按钮，一券多用是直接点击退款按钮，两者的退款申请界面也有细微差别，详见页面原型用户选择退款原因，确认退款一券多用的退款还需输入退款数量，退款数量的处理规则如下：设团购券的“未使用数”为A，当A小于5时，单次可退款数等于A；当A大于等于5时，单次可退款数等于5客户端对退款数量输入框进行以下限制：默认值为1，程序控制只能输入一位数字，不可输入其他字符，若输入0则修改成1，若超过单次可退款数则修改为单次可退款数客户端调用团购订单退款接口申请退款团购系统进行订单检查，若通过则将退款请求提交到易付宝（不通过的报错见3.7章节）易付宝检查退款信息，创建退款订单，将退款受理结果返回给团购系统，团购系统再返回给客户端客户端接收退款受理结果，若处理结果为成功，则提示用户“退款申请成功，请等待退款：易付宝付款1个工作日到账，网银或信用卡3-15个工作日到账”，并返回订单列表界面，重新调用订单列表接口更新订单状态；若失败，则直接展示接口返回的错误描述（详见3.7章节）规则描述艺龙团购不支持用户在线退款、不支持过期自动退款，只能电话退款（系统逻辑），客户端团购券详情中的退款复选框不可选非艺龙团购的部分产品支持未消费退款及过期自动退款，在团购产品详情接口和订单详情接口中返回了对应标示本章节中由于客户端自身原因导致的报错统一提示为“网络调用异常，请稍后再试“；当接口返回的处理结果为失败时，客户端直接展示错误描述，无需根据错误码进行报错提示（见3.7章节）页面原型及说明21214343编号名称描述非艺龙团购订单详情-团购券信息-一券一用字段数据仅供演示非艺龙团购订单详情-团购券信息-一券一用退款申请界面字段数据仅供演示非艺龙团购订单详情-团购券信息-一券多用字段数据仅供演示非艺龙团购订单详情-团购券信息-一券多用退款申请界面字段数据仅供演示页面处理规则一券一用和一券多用退款申请界面的退款原因默认选中“现在不想买了”，还可选择“商品价格高”、“错误或者重复下单”、“其他原因”退款申请界面中的退款金额由客户端根据产品单价和退款数量计算