订单导出及订单信息更新功能说明

ID:22383409

大小:94.50 KB

页数:12页

时间:2018-10-28

上传者:U-23001
订单导出及订单信息更新功能说明_第1页
订单导出及订单信息更新功能说明_第2页
订单导出及订单信息更新功能说明_第3页
订单导出及订单信息更新功能说明_第4页
订单导出及订单信息更新功能说明_第5页
资源描述:

《订单导出及订单信息更新功能说明》由会员上传分享,免费在线阅读,更多相关内容在行业资料-天天文库

订单导出及订单信息更新功能说明2012年3月12/12 1.背景l对于广大代理商的业务需求,TTS后台业务逻辑现阶段还不能做到与所有OTA的业务逻辑一致.各代理人可能针对于自己的产品有不同的处理逻辑.此需求为了尽量适应所有代理的业务需求,提供更加开放且灵活的订单系统.2.接口描述2.1.接口概述一年前开发的订单导出功能现阶段已不能再满足部分大代理人的需求,所以需要更新,增加部分功能。l新品接口升级后增加以下功能1.订单导出功能增加部门需要导出的字段2.票号回传接口需要增加部分功能。2.2.订单导出订单导出功能现有,全量导出,增量导出,精确导出,按状态导出(现名称叫”支付成订单导出”)。导出的XML格式需要保持一致。2.2.1.订单导出新加字段说明现有XML结构;现有的字段:12/12 result节点·status接口返回相应的状态,ok是成功,error是失败msg节点(当result.status=error时,返回msg节点)·content接口返回的错误信息order节点·id唯一标识ID·orderNo订单号·allPrice订单金额·status订单状态·contact联系人姓名·contactMob联系人电话·contactEmail联系人邮箱·payStatus支付方式·createTime订单创建时间·needPS是否需要配送·kdAddress快递地址·kdPrice快递费用·kdmethod快递方式·kdPhone收件人电话·kdReceiver收件人·source订单来源·payTransactionid支付交易流水号·pnrHasPinyin旅客姓名是否有拼音·refundTransactionid退款交易流水号·policyCode政策编号·policyId政策id·deadlineDate标注最晚出票时间,格式为yyyy-mm-ddhh:mm:ssflight节点·code航班号·cabin舱位·dep出发机场·arr到达机场·depDay出发日期·depTime出发时间·arrTime到达时间·pnrPNR·cpnr儿童PNR12/12 ·realCode真实航班号,若不为空则是共享航班·viewPrice票面价·price价格·constructionFee机场建设费·fuelTax燃油附加费·childFuelTax儿童燃油附加费·policyType订单类型·id航段id·tgq退改签·cabinDesc仓位说明·yPriceY仓价格passenger节点·name乘机人姓名·id乘机人id·ageType乘机人类型0为成人,1为儿童·cardType乘机人证件类型·NI=身份证·PP=护照·ID=其他·HX=回乡证·TB=台胞证·GA=港澳通行证·HY=国际海员证·cardNum乘机人证件号·eticketNum票号·insuranceCount保险数量·insuranceNo保险单号·ticketTime出票时间·birthday出生日期·gender性别log节点·operator操作人·time操作时间·action行为1.1.订单导出功能逻辑更改现在存在的订单导出方式:1.全量导出2.增量导出3.按状态导出12/12 1.精确导出全量导出:现有全量导出的逻辑为,一次性导出一年内的订单。这样出现的问题是部分大代理人的数据量非常大。一次全时导出对系统压力增加太大。而且受限于服务器环境的限制,当连接到达一定时间或包大于某一值是会被切断连接。所以现在的逻辑修改为:1.修改为只导出当前时间一个月内的订单。2.去除一年有效期规则,用户需要指定参数导出相应的订单。如未添加参数则按默认导出。默认为当前时间内一个月内的订单。3.增加时间区间内的订单导出.最大时间区间不能大于31天。按状态导出(又叫支付成功订单导出):现有按状态导出逻辑为:指定一个订单状态全量导出。这样存在的问题是例如:订单取消这样的状态一次导出的数据量非常大。所以需要限制。所以需要修改现在的逻辑:1.按状态导出需求支持时间区间内的订单导出。2.默认为当前时间内一个月内的订单。3.最大时间区间不能大于31个天。4.按不同的状态使用不同的锁。精确导出:与其他的导出方式使用不同并发锁,此导出功能与全量与增量及状态导出没关系。可以并发.以上所有功能的修改不修改现有导出URL地址及jsp名称。说明:·全量导出:限制:只可导入一个月内订单需验证导出时间间隔·参数:type=allbeginDateendDate如:http://ttsdev33.qunar.com/tts/interface/orderExport.jsp?type=all&user=user&pass=pass&beginDate=2012-03-01&endDate=2012-03-30·增量导出:限制:需验证导出时间间隔,一次最多导出50条参数:type=incr,lastId=(数值类型)如:http://ttsdev33.qunar.com/tts/interface/orderExport.jsp?type=incr&lastId=1000&user=user&pass=pass·精确导出:限制:需验证导出时间间隔参数:type=exact,orderNo=(字符串类型)如:http://ttsdev33.qunar.com/tts/interface/orderExport.jsp?type=exact&orderNo=de1101110202250147&user=user&pass=pass·按订单状态导出限制:需验证导出时间间隔.12/12 beginDateendDate不传入,则默认查询近一个月的http://ttsdev33.qunar.com/tts/interface/orderExport.jsp?type=all&user=user&pass=pass&status=2&beginDate=2012-03-01&endDate=2012-03-30status:可以是数字,英文或中文如:查询出票完成的订单有以下3中方式:status=2,status=PAY_OK,status=出票完成订单状态列表NONE(100,""),APPLY_4_RETURN_PAY(50,"未出票申请退款"),ORDER_SUCCESS_WAIT_4_PRICE_CONFIRM(51,"订座成功等待价格确认"),WAIT_CONFIRM(20,"等待座位确认"),BOOK_OK(0,"订座成功等待支付"),CANCEL_OK(12,"订单取消"),PAY_OK(1,"支付成功等待出票"),TICKET_LOCK(5,"出票中"),TICKET_OK(2,"出票完成"),APPLY_CHANGE(40,"改签申请中"),CHANGE_OK(42,"改签完成"),APPLY_REFUNDMENT(30,"退票申请中"),WAIT_REFUNDMENT(31,"退票完成等待退款"),REFUND_OK(39,"退款完成"),1.1.订单更新接口业务逻辑修改现有订单更新接口业务逻辑只有一个功能。将支付成功等待出票的订单修改为出票完成。在这过程中全部都含有验证逻辑。所有的验证逻辑与前台手工添加一个票号并修改为出票完成一致。订单更新接口将增加以下接口功能:修改前逻辑修改后逻辑等待座位确认订座成功等待支付或订单取消订座成功等待价格确认订座成功等待支付或订单取消改签申请中改签完成12/12 退款申请中退票完成等待退款退票完成等待退款退款完成未出票申请退款退款完成等待邮寄订单可通过接口添加邮寄后的内容并在我们的系统中标识为已配送。在返回的错误中需要使用中文提示,而且所有的错误信息都要返回,在保证现有向下兼容的情况增加中文错误提示。例:必须为POST方式http://ttsdev3.qunar.com/tts/interface/updateorder.jsp注意:POST时要有3个参数username=user&password=pass&orderdata=xml目前支持以下修改前逻辑修改后逻辑等待座位确认订座成功等待支付或订单取消订座成功等待价格确认订座成功等待支付或订单取消改签申请中改签完成退款申请中退票完成等待退款退票完成等待退款退款完成未出票申请退款退款完成支付成功等待出票未出票申请退款支付成功等待出票出票完成等待邮寄订单可通过接口添加邮寄后的内容并在我们的系统中标识为已配送。orderdata的格式为:12/12 OrderDetail节点status订单状态no订单号errorCode错误编码errorMsg错误提示passenger节点name乘机人姓名no票号cano证件号status票号校验状态1成功2失败flightSegement节点(可传多个,改签时必须传)12/12 id数据库中的idflightnum航班号depDate出发日期depTime出发时间arrTime到达时间returnTicket节点(退票或退款时必须传)price退款金额remark退款备注type退款类型1线上2线下express节点(快递配送)expressName收件人姓名expressAddr收件人地址phone收件人电话expressCompany快递公司expressNo快递单号expressTime快递时间xcd是否邮寄行程单bx是否邮寄保险发票例子等待座位确认==》订座成功等待支付或订单取消12/12 订座成功等待价格确认==》订座成功等待支付或订单取消支付成功等待出票==》未出票申请退款改签申请中==》改签完成退票申请中==》退票完成等待退款退票完成等待退款==》退款完成未出票申请退款==》退款完成12/12 快递配送支付成功等待出票==》出票完成errorCode的取值范围如下:100,"传入参数格式异常"101,"传入参数格式错误"102,"订单号不能为空"112,"订单不存在"103,"订单状态错误"104,"传入参数为空"105,"当前代理商在白名单中不存在"106,"用户名或密码错误"107,"无效ip"108,"票号校验失败"109,"资金解冻失败"110,"没有一个乘机人是正确的"111,"订单状态错误"112,"自动K位错误"113,"退款失败"114,"没有一个航段信息是正确的"115,"传入快递对象为空"116,"日期格式错误,正确格式为12/12 yyyy-mm-dd"117,"退款中"118,"退票失败"119,"快递配送失败"99,"修改成功"支付方式列表payStatusMap.put(0,"未支付");payStatusMap.put(1,"财付通支付");payStatusMap.put(-1,"财付通退款");payStatusMap.put(2,"支付宝支付");payStatusMap.put(-2,"支付宝退款");payStatusMap.put(5,"现金支付");payStatusMap.put(10,"快钱支付");payStatusMap.put(11,"快钱分账");payStatusMap.put(-11,"快钱信用卡退款");payStatusMap.put(12,"支付宝分账");payStatusMap.put(13,"财付通分账");payStatusMap.put(14,"无线支付");payStatusMap.put(15,"招商银行信用卡支付");payStatusMap.put(16,"汇付天下分账");payStatusMap.put(17,"银联在线分账");payStatusMap.put(18,"网银在线wap");payStatusMap.put(19,"快钱wap");payStatusMap.put(20,"招商直连wap");payStatusMap.put(21,"快捷支付");//联动优势payStatusMap.put(22,"QUNAR代收-无线");----------专业最好文档,专业为你服务,急你所急,供你所需-------------文档下载最佳的地方----------专业最好文档,专业为你服务,急你所急,供你所需-------------文档下载最佳的地方12/12

当前文档最多预览五页,下载文档查看全文

此文档下载收益归作者所有

当前文档最多预览五页,下载文档查看全文
正文描述:

《订单导出及订单信息更新功能说明》由会员上传分享,免费在线阅读,更多相关内容在行业资料-天天文库

订单导出及订单信息更新功能说明2012年3月12/12 1.背景l对于广大代理商的业务需求,TTS后台业务逻辑现阶段还不能做到与所有OTA的业务逻辑一致.各代理人可能针对于自己的产品有不同的处理逻辑.此需求为了尽量适应所有代理的业务需求,提供更加开放且灵活的订单系统.2.接口描述2.1.接口概述一年前开发的订单导出功能现阶段已不能再满足部分大代理人的需求,所以需要更新,增加部分功能。l新品接口升级后增加以下功能1.订单导出功能增加部门需要导出的字段2.票号回传接口需要增加部分功能。2.2.订单导出订单导出功能现有,全量导出,增量导出,精确导出,按状态导出(现名称叫”支付成订单导出”)。导出的XML格式需要保持一致。2.2.1.订单导出新加字段说明现有XML结构;现有的字段:12/12 result节点·status接口返回相应的状态,ok是成功,error是失败msg节点(当result.status=error时,返回msg节点)·content接口返回的错误信息order节点·id唯一标识ID·orderNo订单号·allPrice订单金额·status订单状态·contact联系人姓名·contactMob联系人电话·contactEmail联系人邮箱·payStatus支付方式·createTime订单创建时间·needPS是否需要配送·kdAddress快递地址·kdPrice快递费用·kdmethod快递方式·kdPhone收件人电话·kdReceiver收件人·source订单来源·payTransactionid支付交易流水号·pnrHasPinyin旅客姓名是否有拼音·refundTransactionid退款交易流水号·policyCode政策编号·policyId政策id·deadlineDate标注最晚出票时间,格式为yyyy-mm-ddhh:mm:ssflight节点·code航班号·cabin舱位·dep出发机场·arr到达机场·depDay出发日期·depTime出发时间·arrTime到达时间·pnrPNR·cpnr儿童PNR12/12 ·realCode真实航班号,若不为空则是共享航班·viewPrice票面价·price价格·constructionFee机场建设费·fuelTax燃油附加费·childFuelTax儿童燃油附加费·policyType订单类型·id航段id·tgq退改签·cabinDesc仓位说明·yPriceY仓价格passenger节点·name乘机人姓名·id乘机人id·ageType乘机人类型0为成人,1为儿童·cardType乘机人证件类型·NI=身份证·PP=护照·ID=其他·HX=回乡证·TB=台胞证·GA=港澳通行证·HY=国际海员证·cardNum乘机人证件号·eticketNum票号·insuranceCount保险数量·insuranceNo保险单号·ticketTime出票时间·birthday出生日期·gender性别log节点·operator操作人·time操作时间·action行为1.1.订单导出功能逻辑更改现在存在的订单导出方式:1.全量导出2.增量导出3.按状态导出12/12 1.精确导出全量导出:现有全量导出的逻辑为,一次性导出一年内的订单。这样出现的问题是部分大代理人的数据量非常大。一次全时导出对系统压力增加太大。而且受限于服务器环境的限制,当连接到达一定时间或包大于某一值是会被切断连接。所以现在的逻辑修改为:1.修改为只导出当前时间一个月内的订单。2.去除一年有效期规则,用户需要指定参数导出相应的订单。如未添加参数则按默认导出。默认为当前时间内一个月内的订单。3.增加时间区间内的订单导出.最大时间区间不能大于31天。按状态导出(又叫支付成功订单导出):现有按状态导出逻辑为:指定一个订单状态全量导出。这样存在的问题是例如:订单取消这样的状态一次导出的数据量非常大。所以需要限制。所以需要修改现在的逻辑:1.按状态导出需求支持时间区间内的订单导出。2.默认为当前时间内一个月内的订单。3.最大时间区间不能大于31个天。4.按不同的状态使用不同的锁。精确导出:与其他的导出方式使用不同并发锁,此导出功能与全量与增量及状态导出没关系。可以并发.以上所有功能的修改不修改现有导出URL地址及jsp名称。说明:·全量导出:限制:只可导入一个月内订单需验证导出时间间隔·参数:type=allbeginDateendDate如:http://ttsdev33.qunar.com/tts/interface/orderExport.jsp?type=all&user=user&pass=pass&beginDate=2012-03-01&endDate=2012-03-30·增量导出:限制:需验证导出时间间隔,一次最多导出50条参数:type=incr,lastId=(数值类型)如:http://ttsdev33.qunar.com/tts/interface/orderExport.jsp?type=incr&lastId=1000&user=user&pass=pass·精确导出:限制:需验证导出时间间隔参数:type=exact,orderNo=(字符串类型)如:http://ttsdev33.qunar.com/tts/interface/orderExport.jsp?type=exact&orderNo=de1101110202250147&user=user&pass=pass·按订单状态导出限制:需验证导出时间间隔.12/12 beginDateendDate不传入,则默认查询近一个月的http://ttsdev33.qunar.com/tts/interface/orderExport.jsp?type=all&user=user&pass=pass&status=2&beginDate=2012-03-01&endDate=2012-03-30status:可以是数字,英文或中文如:查询出票完成的订单有以下3中方式:status=2,status=PAY_OK,status=出票完成订单状态列表NONE(100,""),APPLY_4_RETURN_PAY(50,"未出票申请退款"),ORDER_SUCCESS_WAIT_4_PRICE_CONFIRM(51,"订座成功等待价格确认"),WAIT_CONFIRM(20,"等待座位确认"),BOOK_OK(0,"订座成功等待支付"),CANCEL_OK(12,"订单取消"),PAY_OK(1,"支付成功等待出票"),TICKET_LOCK(5,"出票中"),TICKET_OK(2,"出票完成"),APPLY_CHANGE(40,"改签申请中"),CHANGE_OK(42,"改签完成"),APPLY_REFUNDMENT(30,"退票申请中"),WAIT_REFUNDMENT(31,"退票完成等待退款"),REFUND_OK(39,"退款完成"),1.1.订单更新接口业务逻辑修改现有订单更新接口业务逻辑只有一个功能。将支付成功等待出票的订单修改为出票完成。在这过程中全部都含有验证逻辑。所有的验证逻辑与前台手工添加一个票号并修改为出票完成一致。订单更新接口将增加以下接口功能:修改前逻辑修改后逻辑等待座位确认订座成功等待支付或订单取消订座成功等待价格确认订座成功等待支付或订单取消改签申请中改签完成12/12 退款申请中退票完成等待退款退票完成等待退款退款完成未出票申请退款退款完成等待邮寄订单可通过接口添加邮寄后的内容并在我们的系统中标识为已配送。在返回的错误中需要使用中文提示,而且所有的错误信息都要返回,在保证现有向下兼容的情况增加中文错误提示。例:必须为POST方式http://ttsdev3.qunar.com/tts/interface/updateorder.jsp注意:POST时要有3个参数username=user&password=pass&orderdata=xml目前支持以下修改前逻辑修改后逻辑等待座位确认订座成功等待支付或订单取消订座成功等待价格确认订座成功等待支付或订单取消改签申请中改签完成退款申请中退票完成等待退款退票完成等待退款退款完成未出票申请退款退款完成支付成功等待出票未出票申请退款支付成功等待出票出票完成等待邮寄订单可通过接口添加邮寄后的内容并在我们的系统中标识为已配送。orderdata的格式为:12/12 OrderDetail节点status订单状态no订单号errorCode错误编码errorMsg错误提示passenger节点name乘机人姓名no票号cano证件号status票号校验状态1成功2失败flightSegement节点(可传多个,改签时必须传)12/12 id数据库中的idflightnum航班号depDate出发日期depTime出发时间arrTime到达时间returnTicket节点(退票或退款时必须传)price退款金额remark退款备注type退款类型1线上2线下express节点(快递配送)expressName收件人姓名expressAddr收件人地址phone收件人电话expressCompany快递公司expressNo快递单号expressTime快递时间xcd是否邮寄行程单bx是否邮寄保险发票例子等待座位确认==》订座成功等待支付或订单取消12/12 订座成功等待价格确认==》订座成功等待支付或订单取消支付成功等待出票==》未出票申请退款改签申请中==》改签完成退票申请中==》退票完成等待退款退票完成等待退款==》退款完成未出票申请退款==》退款完成12/12 快递配送支付成功等待出票==》出票完成errorCode的取值范围如下:100,"传入参数格式异常"101,"传入参数格式错误"102,"订单号不能为空"112,"订单不存在"103,"订单状态错误"104,"传入参数为空"105,"当前代理商在白名单中不存在"106,"用户名或密码错误"107,"无效ip"108,"票号校验失败"109,"资金解冻失败"110,"没有一个乘机人是正确的"111,"订单状态错误"112,"自动K位错误"113,"退款失败"114,"没有一个航段信息是正确的"115,"传入快递对象为空"116,"日期格式错误,正确格式为12/12 yyyy-mm-dd"117,"退款中"118,"退票失败"119,"快递配送失败"99,"修改成功"支付方式列表payStatusMap.put(0,"未支付");payStatusMap.put(1,"财付通支付");payStatusMap.put(-1,"财付通退款");payStatusMap.put(2,"支付宝支付");payStatusMap.put(-2,"支付宝退款");payStatusMap.put(5,"现金支付");payStatusMap.put(10,"快钱支付");payStatusMap.put(11,"快钱分账");payStatusMap.put(-11,"快钱信用卡退款");payStatusMap.put(12,"支付宝分账");payStatusMap.put(13,"财付通分账");payStatusMap.put(14,"无线支付");payStatusMap.put(15,"招商银行信用卡支付");payStatusMap.put(16,"汇付天下分账");payStatusMap.put(17,"银联在线分账");payStatusMap.put(18,"网银在线wap");payStatusMap.put(19,"快钱wap");payStatusMap.put(20,"招商直连wap");payStatusMap.put(21,"快捷支付");//联动优势payStatusMap.put(22,"QUNAR代收-无线");----------专业最好文档,专业为你服务,急你所急,供你所需-------------文档下载最佳的地方----------专业最好文档,专业为你服务,急你所急,供你所需-------------文档下载最佳的地方12/12

显示全部收起
温馨提示:
1. 部分包含数学公式或PPT动画的文件,查看预览时可能会显示错乱或异常,文件下载后无此问题,请放心下载。
2. 本文档由用户上传,版权归属用户,天天文库负责整理代发布。如果您对本文档版权有争议请及时联系客服。
3. 下载前请仔细阅读文档内容,确认文档内容符合您的需求后进行下载,若出现内容与标题不符可向本站投诉处理。
4. 下载文档时可能由于网络波动等原因无法下载或下载错误,付费完成后未能成功下载的用户请联系客服处理。
关闭
关闭