訂單導出及訂單信息更新功能說明

1、訂單導出及訂單信息更新功能說明2012年3月背景對于廣大代理商的業(yè)務需求,TTS后臺業(yè)務邏輯現(xiàn)階段還不能做到與所有 OTA的業(yè)務邏輯一致.各代理人可能針對于自己的產(chǎn)品有不同的處理邏 輯.此需求為了盡量適應所有代理的業(yè)務需求，提供更加開放且靈活的訂 單系統(tǒng).接口描述接口概述一年前開發(fā)的訂單導出功能現(xiàn)階段已不能再滿足部分大代理人的需求，所 以需要更新，增加部分功能。新品接口升級后增加以下功能訂單導出功能增加部門需要導出的字段票號回傳接口需要增加部分功能。訂單導出訂單導出功能現(xiàn)有，全量導出，增量導出，精確導出，按狀態(tài)導出（現(xiàn)名稱 叫”支付成訂單導出”）。導出的XML格式需要保持一致。227.訂單導出

2、新加字段說明現(xiàn)有XML結構；-： contactMob=13914O51458 contactEmai payStatus=12 ere a teTi m r=2012-03-07 16:30:08.0 nRRdPS=false15.0 dctirm= 點開了訂單詳話頁罹10.0 dctirm= 點開了訂單詳話頁” /08.0 dL：tirm= ”點擊了【保存并銳定】按鈕 /08.0 dL：tirin=備注】標注為LERR803-012當前航班已存在證件號相同的敢客，或者根據(jù)短則當前族客不可儂訂當前鼠班.1 /51.0 dL：tirin=點開了訂單詳話頁” /35：斗6.CT日匚歸口門=支付寶

3、分賬,交易成功,交易號方2D12D3D72DD6123B,支付金嵌為663.DD仁=46.0 dL：tirin= 將訂單由【訂座成功等待支付】修改為【支付成功等待出票】 原因為支付/30:51.0 actions付前校螯通過“ /30:39.0 dction=付前校螯通過“ /08.0 dL：tirin= %訂單由C1修改為t訂座成功等待支付】原因為生成訂單半loq operutorloq operutorloq operutorclog operutorclog operutorclog operutorclog operutorclog operutorclog operutorclog

4、operutor肖time肖time肖time有time有time：2012-03-07 162012-03-07 162012-03-07 162012-03-07 162012-03-07 164939393937System tirriR=2012-03-07 16tiniR= 2012-03-07 16:35System tirriR=2012-03-07 16System tirriR=2012-03-07 16“用戶“ tiniR= 2012-03-07 16:30現(xiàn)有的字段:result節(jié)點status接口返回相應的狀態(tài),ok是成功,error是失敗msg 節(jié)點（當 result

5、.status=error 時，返回 msg 節(jié)點）content接口返回的錯誤信息order節(jié)點id唯一標識IDorderNo訂單號allPrice訂單金額status訂單狀態(tài)contact聯(lián)系人姓名contactMob聯(lián)系人電話contactEmail聯(lián)系人郵箱payStatus支付方式createTime訂單創(chuàng)建時間needPS是否需要配送kdAddress快遞地址kdPrice快遞費用kdmethod快遞方式kdPhone收件人電話kdReceiver 收件人source訂單來源payTransactionid支付交易流水號pnrHasPinyin旅客姓名是否有拼音refundTran

6、sactionid退款交易流水號policyCode政策編號policyId 政策 iddeadlineDate標注最晚出票時間，格式為yyyy-mm-dd hh:mm:ssflight節(jié)點code航班號cabin艙位dep出發(fā)機場arr到達機場depDay出發(fā)日期depTime出發(fā)時間arrTime到達時間pnr PNRcpnr 兒童 PNRrealCode真實航班號，若不為空則是共享航班viewPrice 票面價price價格constructionFee 機場建設費fuelTax燃油附加費childFuelTax兒童燃油附加費policyType訂單類型id航段idtgq退改簽cabin

7、Desc倉位說明yPrice Y倉價格passenger 節(jié)點name乘機人姓名id乘機人idageType乘機人類型0為成人,1為兒童cardType乘機人證件類型NI=身份證PP=護照ID=其他HX=回鄉(xiāng)證TB=臺胞證GA=港澳通行證HY=國際海員證cardNum乘機人證件號eticketNum 票號insuranceCount 保險數(shù)量insuranceNo保險單號ticketTime出票時間birthday出生日期gender性另川log節(jié)點operator操作人time操作時間action 行為訂單導出功能邏輯更改現(xiàn)在存在的訂單導出方式：全量導出增量導出按狀態(tài)導出4,精確導出全量導出

8、:現(xiàn)有全量導出的邏輯為，一次性導出一年內(nèi)的訂單。這樣出現(xiàn)的問題是部分大代理人 的數(shù)據(jù)量非常大。一次全時導出對系統(tǒng)壓力增加太大。而且受限于服務器環(huán)境的限制，當連接 到達一定時間或包大于某一值是會被切斷連接。所以現(xiàn)在的邏輯修改為：修改為只導出當前時間一個月內(nèi)的訂單。去除一年有效期規(guī)則，用戶需要指定參數(shù)導出相應的訂單。如未添加參數(shù)則按默認導出。默認為當前時間內(nèi)一個月內(nèi)的訂單。增加時間區(qū)間內(nèi)的訂單導出,最大時間區(qū)間不能大于31天。按狀態(tài)導出（又叫支付成功訂單導出）：現(xiàn)有按狀態(tài)導出邏輯為：指定一個訂單狀態(tài)全量導出。這樣存在的問題是例如：訂單取消 這樣的狀態(tài)一次導出的數(shù)據(jù)量非常大。所以需要限制。所以需要修

9、改現(xiàn)在的邏輯：按狀態(tài)導出需求支持時間區(qū)間內(nèi)的訂單導出。默認為當前時間內(nèi)一個月內(nèi)的訂單。最大時間區(qū)間不能大于31個天。按不同的狀態(tài)使用不同的鎖。精確導出：與其他的導出方式使用不同并發(fā)鎖，此導出功能與全量與增量及狀態(tài)導出沒關系。可以 并發(fā).以上所有功能的修改不修改現(xiàn)有導出URL地址及jsp名稱。說明：全量導出：限制：只可導入一個月內(nèi)訂單 需驗證導出時間間隔參數(shù):type=all beginDate endDate如: HYPERLINK /tts/interface/orderExport.jsp?type=all&user=user&pass= /tts/interface/orderExpor

10、t.jsp?type=all&user=user&pass= pass&beginDate=2012-03-01&endDate=2012-03-30增量導出：限制:需驗證導出時間間隔，一次最多導出50條參數(shù):type=incr,lastId=（數(shù)值類型）如: HYPERLINK /tts/interface/orderExportJsp?type=incr&lastId=1000&use /tts/interface/orderExportJsp?type=incr&lastId=1000&use r=user&pass=pass精確導出：限制:需驗證導出時間間隔參數(shù):type=exact,

11、orderNo=（字符串類型）如: HYPERLINK /tts/interface/orderExport.jsp?type=exact&orderNo=de11 /tts/interface/orderExport.jsp?type=exact&orderNo=de11 01110202250147&user=user&pass=pass按訂單狀態(tài)導出限制:需驗證導出時間間隔.beginDate endDate不傳入，則默認查詢近一個月的http:/ttsdev33.qi 】/tts/interface/orderFxport.jsp?type=all&user=user&pass=pa

12、ss&status=2&beginDate=2012-03-01&endDate=2012-03-30status：可以是數(shù)字，英文或中文如：查詢出票完成的訂單有以下3中方式：status=2， status=PAY_OK， status=出票完成訂單狀態(tài)列表NONE（100, ）,APPLY_4_RETURN_PAY（50,”未出票申請退款”），ORDER_SUCCESS_WAIT_4_PRICE_CONFIRM（51,”訂座成功等待價格確認”）,WAIT_CONFIRM（20,等待座位確認”），BOOK_OK（O,”訂座成功等待支付”），CANCEL_OK（12,”訂單取消”），PAY_O

13、K（1,”支付成功等待出票”），TICKET_LOCK（5,”出票中”），TICKET_OK（2,”出票完成”），APPLY_CHANGE（40,”改簽申請中”），CHANGE_OK（42,”改簽完成”），APPLY_REFUNDMENT（30,”退票申請中”），WAIT_REFUNDMENT（31,”退票完成等待退款”），REFUND_OK（39,”退款完成”），訂單更新接口業(yè)務邏輯修改現(xiàn)有訂單更新接口業(yè)務邏輯只有一個功能。將支付成功等待出票的訂單修改為出票完成。在這過程中全部都含有驗證邏輯。所有的驗 證邏輯與前臺手工添加一個票號并修改為出票完成一致。訂單更新接口將增加以下接口功能:修改前邏

14、輯修改后邏輯等待座位確認訂座成功等待支付 或訂單取消訂座成功等待價格確認訂座成功等待支付 或訂單取消改簽申請中改簽完成退款申請中退票完成等待退款退票完成等待退款退款完成未出票申請退款退款完成等待郵寄訂單可通過接口添加郵寄后的內(nèi)容并在我們的系統(tǒng)中標識為已配送。在返回的錯誤中需要使用中文提示，而且所有的錯誤信息都要返回，在保證現(xiàn)有向下兼容的情 況增加中文錯誤提示。例:必須為POST方式 HYPERLINK /tts/interface/updateorder.jsp注意.POST 時要有 3 個參數(shù) username=user&password=pass&orderdata=xml目前支持以下修改

15、前邏輯修改后邏輯等待座位確認訂座成功等待支付或訂單取消訂座成功等待價格確認訂座成功等待支付或訂單取消改簽申請中改簽完成退款申請中退票完成等待退款退票完成等待退款退款完成未出票申請退款退款完成支付成功等待出票未出票申請退款支付成功等待出票出票完成等待郵寄訂單可通過接口添加郵寄后的內(nèi)容并在我們的系統(tǒng)中標識為已配送。orderdata的格式為:OrderDetail 節(jié)點status訂單狀態(tài)no訂單號errorCode錯誤編碼errorMsg錯誤提示passenger 節(jié)點name乘機人姓名no票號cano證件號status票號校驗狀態(tài)1成功2失敗flightSegement節(jié)點（可傳多個，改簽時必

16、須傳）id數(shù)據(jù)庫中的idflightnum航班號depDate出發(fā)日期depTime出發(fā)時間arrTime到達時間returnTicket節(jié)點（退票或退款時必須傳）price退款金額remark退款備注type退款類型1線上2線下express節(jié)點（快遞配送）expressName收件人姓名expressAddr收件人地址phone收件人電話expressCompany 快遞公司expressNo快遞單號expressTime快遞時間xcd是否郵寄行程單bx是否郵寄保險發(fā)票例子等待座位確認=訂座成功等待支付或訂單取消訂座成功等待價格確認=訂座成功等待支付或訂單取消支付成功等待出票=未出票申請退

17、款改簽申請中=改簽完成退票申請中=退票完成等待退款退票完成等待退款=退款完成未出票申請退款=退款完成快遞配送支付成功等待出票=出票完成errorCode的取值范圍如下：傳入?yún)?shù)格式異常傳入?yún)?shù)格式錯誤”訂單號不能為空”112,訂單不存在”訂單狀態(tài)錯誤”傳入?yún)?shù)為空”當前代理商在白名單中不存在”用戶名或密碼錯誤”無效 ip票號校驗失敗”資金解凍失敗”沒有一個乘機人是正確的訂單狀態(tài)錯誤自動K位錯誤退款失敗沒有一個航段信息是正確的傳入快遞對象為空 日期格式錯誤，正確格式為yyyy-mm-dd退款中”退票失敗”快遞配送失敗” 99,”修改成功”支付方式列表payStatusMap.put（0,”未支付）;payStatusMap.put（1,”財付通支付， payStatusMap.put（-1,”財付通退款”）； payStatusMap.put（2,”支付寶支付， payStatusMap.put（-2,”支付寶退款， payStatusMap.put（5,”現(xiàn)金支付， payStatusMap.put（10,快錢支付）; payStatusMap.put（11,快錢分賬”）; payStatusMap.put（-11,”快錢信用卡退款， payStatusMap.put（12,”支付寶分賬， payStatusMap.put（13,”財付通分賬，