訂單導(dǎo)出及訂單信息更新功能說明

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

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

3、分賬,交易成功,交易號(hào)方2D12D3D72DD6123B,支付金嵌為663.DD仁=46.0 dL：tirin= 將訂單由【訂座成功等待支付】修改為【支付成功等待出票】 原因?yàn)橹Ц?30:51.0 actions付前校螯通過“ /30:39.0 dction=付前校螯通過“ /08.0 dL：tirin= %訂單由C1修改為t訂座成功等待支付】原因?yàn)樯捎唵伟雔oq 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é)點(diǎn)status接口返回相應(yīng)的狀態(tài),ok是成功,error是失敗msg 節(jié)點(diǎn)（當(dāng) result

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

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

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

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

9、改現(xiàn)在的邏輯：按狀態(tài)導(dǎo)出需求支持時(shí)間區(qū)間內(nèi)的訂單導(dǎo)出。默認(rèn)為當(dāng)前時(shí)間內(nèi)一個(gè)月內(nèi)的訂單。最大時(shí)間區(qū)間不能大于31個(gè)天。按不同的狀態(tài)使用不同的鎖。精確導(dǎo)出：與其他的導(dǎo)出方式使用不同并發(fā)鎖，此導(dǎo)出功能與全量與增量及狀態(tài)導(dǎo)出沒關(guān)系?？梢?并發(fā).以上所有功能的修改不修改現(xiàn)有導(dǎo)出URL地址及jsp名稱。說明：全量導(dǎo)出：限制：只可導(dǎo)入一個(gè)月內(nèi)訂單 需驗(yàn)證導(dǎo)出時(shí)間間隔參數(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增量導(dǎo)出：限制:需驗(yàn)證導(dǎo)出時(shí)間間隔，一次最多導(dǎo)出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精確導(dǎo)出：限制:需驗(yàn)證導(dǎo)出時(shí)間間隔參數(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)導(dǎo)出限制:需驗(yàn)證導(dǎo)出時(shí)間間隔.beginDate endDate不傳入，則默認(rèn)查詢近一個(gè)月的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,”訂座成功等待價(jià)格確認(rèn)”）,WAIT_CONFIRM（20,等待座位確認(rèn)”），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è)務(wù)邏輯修改現(xiàn)有訂單更新接口業(yè)務(wù)邏輯只有一個(gè)功能。將支付成功等待出票的訂單修改為出票完成。在這過程中全部都含有驗(yàn)證邏輯。所有的驗(yàn) 證邏輯與前臺(tái)手工添加一個(gè)票號(hào)并修改為出票完成一致。訂單更新接口將增加以下接口功能:修改前邏

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

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

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

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