用户工具

站点工具


7.1_作废申请_itvordersave

这是本文档旧的修订版!


7.1作废申请(ITVOrderSave)

已购买的保险单按是否符合退保规定进行退保处理。 废票完成后详情中返回退保信息;若无退保信息,请使用【退保申请前检验(IIROrderApplyCheck)】接口判断是否可退保申请 若可申请退保 请使用【退保申请(IIROrderSave)】接口申请退保

7.1.1请求参数

参数 类型 说明 必填 备注
TOOrderID String 订单号 Y 待作废的TO/TC单单号
PassengerList Array 乘客组 Y
QDOrderID String 第三方作废单号 Y
contact Object 联系信息 N 订单联系信息,若不传则默认取原单

PassengerList:

参数 类型 说明 必填 备注
TOPassengerID Int 订单乘客编号 Y 欲废票的乘客对应的原TO/TC单乘客编号,可从ITOOrderDetailQuery/ITCOrderDetailQuery接口查询获取(passengerList/TCPassengerList列表中的passengerID)

contact:

参数 类型 说明 必填 备注
linker String 联系人 Y
phone String 联系人手机 Y
email String 邮箱 N
content String 备注 N
isEmail Boolean 废票邮件通知 N 默认为“false”;若“true”则废票成功发送邮件至上面参数邮箱
isSMS Boolean 废票短信通知 N 默认为“false”;若“true”则废票成功发送短信至上面参数联系人手机

7.1.2请求样例

{
    "TOOrderID": "TO16020574887",
    "PassengerList": [
        {
            "TOPassengerID": "836953"
        }
    ],
    "QDOrderID": "1"
}

7.1.3返回参数

参数 类型 说明 备注
code String 是否调用接口成功 20000表示成功,非20000表异常
detail Object 结果集
description String 描述 当异常时记录异常信息

detail:

参数 类型 说明 备注
TVOrderID String 作废单编号
status Int 订单状态 参考废票单详情
TVFinanceList Array 废票单财务信息 若为4:待作废,则系统自动作废流程 若为2、3:待审核,则需等待人工报价

TVFinanceList:

参数 类型 说明 备注
passengerTypeInt 乘客类型 0:成人
1:儿童
2:婴儿
3:老人
4:学生
5:劳务
6:移民
7:海员
8:青年
toPrice Decimal 原单退款金额
voidedFeeDecimal 作废手续费
FeeDecimal 服务费
saleTotalDecimal 合计

7.1.4返回样例

{
    "code": "20000",
    "detail": {
        "TVOrderID": "TV16020500617",
        "status": 2,
        "TCFinanceList": [
            {
                "passengerType": 0,
                "toPrice": 999,
                "voidedFee": 0,
                "Fee": 0,
                "saleTotal": 999
            }
        ]
    }
}
7.1_作废申请_itvordersave.1625033090.txt.gz · 最后更改: 2021/06/30 06:04 由 tiny