用户工具

站点工具


7.1_作废申请_itvordersave

差别

这里会显示出您选择的修订版和当前版本之间的差别。

到此差别页面的链接

两侧同时换到之前的修订记录 前一修订版
后一修订版
前一修订版
7.1_作废申请_itvordersave [2021/02/08 06:23]
tiny [7.1.3返回参数]
7.1_作废申请_itvordersave [2024/08/08 07:03] (当前版本)
tiny
行 1: 行 1:
 7.1作废申请(ITVOrderSave) 7.1作废申请(ITVOrderSave)
 +
 +<color #ed1c24>已购买的保险单按是否符合退保规定(产品为可退的、保险保障期仍未开始生效、保险单没有开具报销凭证等)进行退保处理。 废票完成后详情中返回退保信息(如保险单有退保单创建可接入【合作方退保单通知(IMeiyaIROrderNotice)】获取退保单);若无退保信息,请使用【退保申请前检验(IIROrderApplyCheck)】接口判断是否可退保申请 若可申请退保 请使用【退保申请(IIROrderSave)】接口申请退保</color>
 +
  
 ==== 7.1.1请求参数 ==== ==== 7.1.1请求参数 ====
  
  
-^参数         ^类型   ^说明        ^必填        ^备注^ +^ 参数                                     ^ 类型      ^ 说明       ^ 必填  ^ 备注                                          
-|TOOrderID      |String |订单号   |Y |待作废的TO单单号 | +| TOOrderID                              | String  | 订单号      | Y   | 待作废的TO/TC单单号                                
-|PassengerList |Array |乘客组         |Y         | | +| PassengerList                          | Array   | 乘客组      | Y                                               
-|QDOrderID |String |第三方作废单号 |Y | | +| QDOrderID                              | String  | 第三方作废单号  | Y                                               
-|contact         |Object|联系信息 |N |订单联系信息,若不传则默认取原单 |+| contact                                | Object  | 联系信息     | N   | 订单联系信息,若不传则默认取原单                            | 
 +| <color #ed1c24>attachmentList</color>  | Array   | 附件信息     | N   | 2024-08新增 9.5 附件上传(IFileUpload)的requestkey  |
  
  
  
 PassengerList: PassengerList:
-^参数         ^类型     ^说明         ^必填 ^备注^ +^ 参数             ^ 类型   ^ 说明      ^ 必填  ^ 备注                                                                                                                  
-|TOPassengerID |Int         |订单乘客编号 |Y |欲退票的乘客对应的原TO单乘客编号,可从ITOOrderDetailQuery接口查询获取(passengerList列表中的passengerID) |+| TOPassengerID  | Int  | 订单乘客编号  | Y   | 欲票的乘客对应的原TO/TC单乘客编号,可从ITOOrderDetailQuery/ITCOrderDetailQuery接口查询获取(passengerList/TCPassengerList列表中的passengerID)  |
  
 contact: contact:
-^参数         ^类型     ^说明         ^必填 ^备注^ +^参数         ^类型     ^说明         ^必填 ^备注^ 
-|linker         |String   |联系人 |Y | | +|linker         |String   |联系人  |Y  | | 
-|phone          |String   |联系人手机 |Y | | +|phone          |String   |联系人手机    |Y  | | 
-|email          |String   |邮箱   |N | | +|email          |String   |邮箱   |N  | | 
-|content        |String   |备注  |N | | +|content        |String   |备注   |N  | | 
-|isEmail        |Boolean  |退票邮件通知  |N |默认为“false”;若“true”则退票成功发送邮件至上面参数邮箱 | +|isEmail        |Boolean  |票邮件通知   |N  |默认为“false”;若“true”则票成功发送邮件至上面参数邮箱 | 
-|isSMS          |Boolean  |退票短信通知  |N |默认为“false”;若“true”则退票成功发送短信至上面参数联系人手机 |+|isSMS          |Boolean  |票短信通知   |N  |默认为“false”;若“true”则票成功发送短信至上面参数联系人手机 |
  
  
行 43: 行 47:
 ==== 7.1.3返回参数 ==== ==== 7.1.3返回参数 ====
  
-^参数 ^类型 ^说明 ^备注^ +^参数 ^类型 ^说明 ^备注^ 
-|code |String |是否调用接口成功 |20000表示成功,非20000表异常 | +|code   |String |是否调用接口成功   |20000表示成功,非20000表异常 | 
-|detail |Object |结果集  |  | +|detail |Object |结果集     |  | 
-|description |String |描述 |当异常时记录异常信息 |+|description |String    |描述 |当异常时记录异常信息 |
  
 detail: detail:
  
-^参数    ^类型 ^说明    ^备注^ +^ 参数           ^ 类型    ^ 说明            ^ 备注                                                              
-|TVOrderID|String |作废单编号 | | +| TVOrderID      | String  | 作废单编号                                                                        
-|status|String |订单状态 |参考废票单详情 | +| status         Int     | 订单状态        | 参考废票单详情                                                    
-|TVFinanceList|Array |废票单财务信息 | 若为4:待作废,则系统自动作废流程 若为2、3:待审核,则需等待人工报价|+| TVFinanceList  | Array   | 废票单财务信息  | 若为4:待作废,则系统自动作废流程 若为2、3:待审核,则需等待人工报价  |
  
 TVFinanceList:  TVFinanceList: 
  
-^参数    ^类型 ^说明    ^备注^+^参数    ^类型  ^说明    ^备注^
 |passengerType|Int |乘客类型 | 0:成人 \\ 1:儿童 \\ 2:婴儿 \\ 3:老人 \\ 4:学生 \\ 5:劳务 \\ 6:移民 \\ 7:海员 \\ 8:青年 | |passengerType|Int |乘客类型 | 0:成人 \\ 1:儿童 \\ 2:婴儿 \\ 3:老人 \\ 4:学生 \\ 5:劳务 \\ 6:移民 \\ 7:海员 \\ 8:青年 |
-|toPrice| Decimal |原单退款金额 |  | +|toPrice| Decimal   |原单退款金额 |  | 
-|voidedFee|Decimal |作废手续费 |  | +|voidedFee|Decimal  |作废手续费 |  | 
-|Fee|Decimal |服务费 |  | +|Fee|Decimal    |服务费 |  | 
-|saleTotal|Decimal |合计 |  | +|saleTotal|Decimal  |合计 |  | 
  
 ==== 7.1.4返回样例 ==== ==== 7.1.4返回样例 ====
行 70: 行 74:
     "code": "20000",     "code": "20000",
     "detail": {     "detail": {
-              "TVOrderID": "TV16020500617" +        "TVOrderID": "TV16020500617", 
-          }+        "status": 2, 
 +        "TCFinanceList":
 +            { 
 +                "passengerType": 0, 
 +                "toPrice": 999, 
 +                "voidedFee": 0, 
 +                "Fee": 0, 
 +                "saleTotal": 999 
 +            } 
 +        ] 
 +    }
 } }
 </code> </code>
7.1_作废申请_itvordersave.1612765394.txt.gz · 最后更改: 2021/02/08 06:23 由 tiny