وب سرویس فروش بلیط هواپیما | راهنمای استفاده از وب سرویس های فروش بلیت هواپیما در بستر NRS (هواپیمایی زاگرس)

 

 

 

وب سرویس فروش بلیط هواپیما

راهنمای استفاده از وب سرویس های فروش بلیت هواپیما در بستر NRS (هواپیمایی زاگرس)


فهرست کلی مطالب ارائه شده در این راهنما

  • مقدمه                                         

  • سیستم های فروش بلیت                                                                                               

  • فلوچارت فرایند فروش بلیت                                                                                                  

  • فلوچارت فرایند استرداد بلیت                                              

  • توابع و پارامترها                                                                                                       

  • Availability                                                                                                                                

  • Fare                                                                                                                                         

  • Reserv                                                                                                    

  • RT                                                                                                    

  • CancelPNR

  • CancelSeat

  • ETIssue

  • ETRefund

 

نگاه کلی :

این مستند جهت خرید های  غیر حضوری در بستر های مختلف میباشد که به صورت آنلاین با سیستم رزرواسیون شرکت نیرا در ارتباط می باشد . این ارتباط منجربه رزرو و صدور بلیت در سیستم رزرواسیون Airline  و دریافت وجه در سمت دیگر (انواع بستر های فروش بلیت) می شود.

در این راهنما روش ها و دستورات مورد نیاز برنامه نویسان جهت بهره وری از سیستم رزرواسیون شرح داده شده است .

مقدمه :

برای یکنواختی در اصطلاحلات و واژه های استفاده شده در راهنما با یکدیگر پیشنهاد میشود ابتدا با واژه های زیر آشنا شویم .

شرکت هواپیمایی :  به هر یک از شرکت های هواپیمایی اطلاق می گردد . هر شرکت دارای یک شناسه منحصر به فرد می باشد و در ادامه راهنما هر جا نیاز به معرفی شرکت هواپیمایی باشد تنها به استفاده از شناسه آن اکتفا خواهیم کرد.

پرواز : در شرکت های هوایپمایی برای پرواز ها از قبل برنامه ریزی هایی صورت می گردد مشخص می شود از چه مبدا به چه مقصد در چه روز و ساعت آن شرکت پرواز خواهد داشت .

مسافر : مسافر فردی می باشد که اطلاعات رزرو یا خرید انجام شده مربوط به ایشان می باشد که ممکن است در سمت شما مشتری نام گیرد .

کد رزرو  : در زمان رزرو سیستم یک شناسه ۵ کاراکتری ، ترکیبی از عدد و حرف به عنوان کد رزرو در اختیار شما قرار می دهد . توجه داشته باشید که برای هر تعداد مسافر مربوط به یک فرایند صدور بلیت تنها یک کد رزرو اختصاص داده خواهد شد.

شماره تیکت  : منظور از شماره تیکت ، شناسه ای می باشد که در انتهای فرایند صدور بلیت به هر مسافر اختصاص داده خواهد شد.

پس نتیجه خواهیم گرفت که اگر صدور بلیتی برای یک مشتری با ۳ مسافر داشته باشیم ، سیستم یک کد رزرو و سه شماره تیکت در اختیار شما قرار می دهد .

استرداد  : فرایند انصراف از سفر توسط مسافر و برگشت کل یا بخشی از مبلغ پرداختی را استرداد گویند .

جریمه استرداد :   فرایند استرداد دارای قوانینی می باشد که براساس زمان خرید و زمان حرکت ، جریمه ای محاسبه و از مبلغ برگشتی کسرمی شود .

تفکیک سنی مسافر :   در صدور بلیت برای پرواز مسافر به لحاظ سنی دارای تقسیم بندی می باشد که در ذیل به حضور شما شرح داده می شود.

بزرگسال : به هر مسافر که سن وی بالاتر از ۱۱ سال باشد اطلاق می گردد.

خردسال : به مسافرین که سن آنها بین ۲ تا ۱۱ سال باشد ، خردسال گویند .

طفل : به مسافرین دارای سن کمتر از۲ سال ، طفل گویند.

توجه داشته باشید که سن مسافر در صدور بلیت مهم بوده و در نرخ پرواز تاثیر خواهد داشت.

 

برای راه اندازی این سرویس (فروش آنلاین) ما سعی کرده ایم از روشی استفاده نماییم تا ضمن برخوردار بودن از سرعت بالا در تبادل اطلاعات ، در بخش پیاده سازی نیز با تمام سیستم های نرم افزاری به راحتی سازگاری داشته باشد تا برنامه نویسان محترم با روشی آسان بتوانند در اسرع وقت ارتباط لازم را برقرار نمایند. از این رو از روش HTTP Service استفاده کرده ایم.

توجه ! لطفا قبل از تماس با واحد پشتیبانی حتما این مستند را به صورت کامل مطالعه فرمایید.

 

 

فلوچارت فرایند خرید بلیت :

شروع
انتخاب مبدا ، مقصد، تاریخ و تعداد
دریافت لیست پروازها
انتخاب پرواز
دریافت اطلاعات نرخ پرواز
ورود اطلاعات مسافر
عملیات رزرو
رزرو موفق
خیر
فرایند دریاف وجه
پرداخت موفق
فرایند تکمیل خرید
حذف رزرو
فرایند موفق
پایان
استرداد وجه دریافتی
نمایش اطلاعات خرید و رزرو به مسافر
خیر
بله
خیر
بله
بله

 

در فلوچارت فوق بخش هایی از عملیات که مربوط به سیستم فروش می باشد را توضیح خواهیم داد و بخش های فرایند دریافت وجه و بازگشت به عهده شما می باشد .

مبدا ، مقصد :

در این مرحله کاربر می بایست مبدا و مقصد مد نظر خود را از لیست ارائه شده انتخاب نماید. آیتم های تاریخ و تعداد از نوع بزرگسال ، خردسال و طفل نیز در این مرحله می بایست از مسافر دریافت شود.

دریافت لیست پرواز ها :

برای دریافت لیست پرواز ها می بایست از تابع Availability که در بخش توابع توضیح داده شده است ، استفاده نمایید .

در این تابع شما با توجه به مبدا و مقصد و تاریخ حرکت لیستی از سرویس های موجود را در شرکت انتخاب شده که به آن مقصد پرواز دارد را دریافت می نمائید . هر پرواز دارای یک شماره مشخص بوده که در مراحل بعدی نیز مورد استفاده قرار می گیرد و به واسطه اطلاعات پرواز می باشد که در فرایند های بعدی مشخص می نمایید که قصد رزرو یا صدور از کدامیک را خواهید داشت .

انتخاب پرواز و ساعت حرکت :

بعد از دریافت لیست پرواز ها دربخش نمایش می باست برای مسافر امکانی را فراهم نمایید که قابلیت انتخاب یک پرواز را داشته باشد و شماره پرواز را به مرحله بعد ارسال نمایید .

دریافت اطلاعات نرخ پرواز :

بعد از انتخاب پرواز توسط مسافر شما نیاز خواهید داشت نرخ کلاس های موجود در این پرواز را بدست آورید . توجه داشته باشید که ممکن است در یک پرواز چندین کلاس پروازی با نرخ های متفاوت وجود داشته باشد .

برای دریافت اطلاعات نرخ می توانید از تابع Fare استفاده نمایید .

ورود اطلاعات مسافر :

با توجه به تعداد درخواستی در مرحله اول می بایست در این مرحله امکانی را فراهم نمایید تا به همان تعداد اطلاعات مسافر قابل ثبت و ورود باشد .

توجه داشته باشید که در زمان صدور بلیت ما نوع مسافر(بزرگسال ، خردسال ، طفل) را از روی پارامتر سن دریافت می نماییم. در این بخش می توایند برای مسافر قرار دهید تا انتخاب نماید یا در سمت خودتان با توجه به انتخاب مسافر عدد لازم را برای ما ارسال نمایید .

فرایند رزرو :

در این مرحله با توجه به اطلاعات پرواز و مسافر رزرو را انجام می دهید . در صورت موفقیت آمیز بودن سیستم به ازای مسافرین شما اختصاص جا داده و در انتظار تکمیل فرایند می باشد .

توجه داشته باشید بعد از رزرو حتما یکی از دو فرایند حذف رزرو یا تکمیل فرایند را باید انجام دهید . در صورتی که رزرو به حالت خود باقی بماند و حتی اگر تکمیل فرایند هم نشود ، باز هم شرکت شما را جریمه خواهد کرد.

برای ثبت رزرو و اختصاص جا می توایند از تابع Reserv استفاده نمایید. در صورت موفقیت آمیز بودن فرایند رزرو به ازای تمام مسافرین یک کدرزرو اختصاص داده خواهد شد که در مراحل بعدی مورد استفاده قرار می گیرد.

فرایند دریافت وجه :

این مرحله کاملا تحت نظر شما می باشد  و به هر نحوی که  تمایل داشته باشید می توانید برنامه ریزی نمایید .

 توجه داشته باشید که ما بر اساس بلیت های صادر شده و استرداد شده با شما تسویه خواهیم کرد و نیازی به اطلاعات دریافت وجه شما نخواهیم داشت .

البته در خصوص روال های مالی می بایست با بخش مالی شرکت هواپیمایی مربوطه تماس داشته باشید.

فرایند تکمیل خرید :

در صورت دریافت وجه می بایست تکمیل فرایند را انجام دهید تا بلیت برای مسافر صادر شود . در صورتی که تکمیل فرایند انجام نشود مسافر در پرواز جایی نخواهد داشت و تنها به تعداد مسافر مد نظر شما ظرفیت اشغال شده است .

در فرایند صدور بلیت در صورتی که موفقیت آمیز باشد می بایست اطلاعات پرداخت و رزرو بلیت را به مسافر نمایش دهید ولی اگر صدور بلیت با خطا مواجه شد می بایست ضمن استرداد وجه دریافتی ، حذ رزرو را نیز انجام دهید تا ظرفیت اشغال شده آزاد شود.

برای تکمیل فرایند صدور بلیت می بایست از تابع ETIssue استفاده نمایید .

 

توجه داشته باشید فرایند برگشت وجه توسط شما طراحی و مورد استفاده قرار می گیرد و در زمان هایی که نیاز به استفاده باشد از سوی شما فراخوانی می شود.

 

فلوچارت فرایند استرداد بلیت :

 
شروع
دریافت اطلاعات بلیت از مسافر
دریافت اطلاعات بلیت
وضعیت استرداد
نمایش جریمه استرداد
تایید و ادامه استرداد
پایان
عملیات استرداد بلیت
استرداد موفق
برگشت وجه مربوطه
نشده
شده
خیر
بله
خیر
بله

 

دریافت اطلاعات بلیت خریداری شده از مسافر :

این مرحله از فرایند استرداد مربوط به شما می باشد و می بایست فرمی را طراحی فرمایید تا مسافر بتواند بلیت خود را بازیابی نماید و در صورت تمایل برای استرداد اقدام نماید .

دریافت اطلاعات بلیت :

برای دریافت اطلاعات یک بلیت می توانید از تابع RT استفاده نمایید . در خروجی این تابع وضعیت بلیت و مسافر های مربوط به آن مشخص می شود.

نمایش جریمه استرداد :

برای مشاهده جریمه استرداد می بایست با توجه به قوانین مربوطه محاسبه نموده و به مسافر نمایش دهید . البته در مدت کوتاهی یک تابع جهت دریافت جریمه استرداد استاندارد مربوط به یک بلیت ارائه خواهد شد .

عملیات استرداد بلیت :

این عملیات از دو فرایند تشکیل می شود . فرایند اول آزادسازی ظرفیت اشغال شده و فرایند دوم ثبت استرداد وجه و تکمیل فرایند های مالی مربوط به بلیت مد نظر . از این رو برای فرایند استرداد به ترتیب می بایست دو تابع CancelSeat  و ETRefund را فراخوانی نمایید .

برگشت وجه :

در این بخش با توجه به مبلغ قابل برگشت می بایست امکانی فرمایید تا برگشت وجه به حساب کاربر صورت پذیرد . این بخش همانند دریافت وجه کاملا در اختیار شما می باشد .

 

توابع و پارامتر ها :

تابع Availability

همانظور که از عنوان این تابع مشخص می باشد جهت دریافت لیست پرواز های دارای ظرفیت فروش مورد استفاده قرار می گیرد.

نمونه کد زیر نحوه فراخوانی و بارگذاری پارامتر های لازم برای این تابع را نمایش می دهد .

http://http://book.zagrosairlines.com/cgi-bin/NRSWeb.cgi/AvailabilityJS? AirLine=ZV& cbSource=THR&cbTarget=MHD&cbDay1=1&cbMonth1=11&cbAdultQty=1&cbChildQty=0&cbInfantQty=0&OfficeUser=NiraUser&OfficePass=1234

پارامتر های ورودی :

شناسه شرکت هواپیمایی Airline
کد استاندارد شهر مبدا  cbSource
کد استاندارد شهر مقصد cbTarget
روز cbDay1
ماه cbMonth1
تعداد بزرگسال cbAdultQty
تعداد خردسال cbChildQty
تعداد طفل cbInfantQty
نام کاربری OfficeUser
کلمه عبور OfficePass

با توجه به پارامترهای ورودی ، سیستم پرواز های موجود و دارای ظرفیت لازم را برای شما ارائه می نماید.

نحوه خروجی تابع لیست پرواز ها :

توجه داشته باشید خروجی تمام توابع به صورت JSON می باشد.

{“AvailableFlights”:[{“AirLine”:”ZV”,”Origin”:”تهران/مهر آباد”,”OriginIATACODE”:”THR”,”Destination”:”مشهد”,”DestinationIATACODE”:”MHD”,”DepartureDateShamsi”:”1/11/1395″,”DepartureDateMiladi”:”20/1/2017″,”DepartureTime”:”08:05″,”ArrivalTime”:”09:05″,”PlaneType”:”DEF”,”PlaneTypeCode”:”DEF”,”FlightNo”:”8060″,”FlightClasses”:”/YA ZA”},{“AirLine”:”ZV”,”Origin”:”تهران/مهر آباد”,”OriginIATACODE”:”THR”,”Destination”:”مشهد”,”DestinationIATACODE”:”MHD”,”DepartureDateShamsi”:”1/11/1395″,”DepartureDateMiladi”:”20/1/2017″,”DepartureTime”:”12:25″,”ArrivalTime”:”13:25″,”PlaneType”:”DEF”,”PlaneTypeCode”:”DEF”,”FlightNo”:”966″,”FlightClasses”:”/YC ZC”},{“AirLine”:”ZV”,”Origin”:”تهران/مهر آباد”,”OriginIATACODE”:”THR”,”Destination”:”مشهد”,”DestinationIATACODE”:”MHD”,”DepartureDateShamsi”:”1/11/1395″,”DepartureDateMiladi”:”20/1/2017″,”DepartureTime”:”16:50″,”ArrivalTime”:”17:50″,”PlaneType”:”DEF”,”PlaneTypeCode”:”DEF”,”FlightNo”:”8066″,”FlightClasses”:”/YC ZC”},{“AirLine”:”ZV”,”Origin”:”تهران/مهر آباد”,”OriginIATACODE”:”THR”,”Destination”:”مشهد”,”DestinationIATACODE”:”MHD”,”DepartureDateShamsi”:”1/11/1395″,”DepartureDateMiladi”:”20/1/2017″,”DepartureTime”:”21:50″,”ArrivalTime”:”22:50″,”PlaneType”:”DEF”,”PlaneTypeCode”:”DEF”,”FlightNo”:”8062″,”FlightClasses”:”/YC ZC”},{“AirLine”:”ZV”,”Origin”:”تهران/مهر آباد”,”OriginIATACODE”:”THR”,”Destination”:”مشهد”,”DestinationIATACODE”:”MHD”,”DepartureDateShamsi”:”1/11/1395″,”DepartureDateMiladi”:”20/1/2017″,”DepartureTime”:”22:55″,”ArrivalTime”:”23:55″,”PlaneType”:”DEF”,”PlaneTypeCode”:”DEF”,”FlightNo”:”8068″,”FlightClasses”:”/YC ZC”}]}

در صورتی که برای مبدا و مقصد در تاریخ ارسال شده ، پروازی موجود نباشد با خروجی زیر مواجه خواهید شد .

{“AvailableFlights”:[]}

 

 پارامتر های خروجی :

کد شرکت  هواپیمایی Airline
نام مبدا Orirgin
کد استاندارد فرودگاه مبدا  OriginIATACode
نام مقصد Destination
کد استاندارد فرودگاه مقصد DestionationIATACode
تاریخ پرواز شمسی DepartureDateShamsi
تاریخ پرواز میلادی DepartureDateMiladi
ساعت پرواز DepartureTime
ساعت پایان پرواز ArrivalTime
نوع هواهپیما PlaneTye
شناسه نوع هواپیما PlaneTypeCode
شماره پرواز FlightNo
کلاس موجود در پرواز FlightClasses

 

*** در خروجی این متد دو پارامتر Airline و FlightNo بسیار مهم بوده و در متد های دیگر مورد نیاز می باشد .

 

توجه داشته باشید با توجه به برخی شرایط ، قابلیت خرید بلیت رفت و برگشت فعلا میسر نمی باشد . برای اینگونه موارد لطفا طی دو درخواست جدا از هم اقدام به خرید نمایید . شایان ذکر است تمامی توابع با قابلیت رفت و برگشت طراحی گردیده است و بعد از مدت کوتاهی این امکان نیز در اختیار شما قرار خواهد گرفت .

تابع Fare

این تابع برای برای دریافت اطلاعات نرخ مورد استفاده قرار می گیرد.

نمونه کد زیر نحوه فراخوانی و بارگذاری پارامتر های لازم برای این تابع را نمایش می دهد .

http://http://book.zagrosairlines.com/cgi-bin/NRSWeb.cgi/FareJS?AirLine=ZV&cbSource=THR&cbTarget=MHD&DepartureDay=1&DepartureMonth=11&ReturnDay=22&ReturnMonth=9&FlightClassCode=y&OfficeUser=NiraUser&OfficePass=1234

پارامتر های ورودی :

شناسه شرکت هواپیمایی Airline
کد استاندارد شهر مبدا  cbSource
کد استاندارد شهر مقصد cbTarget
روز تاریخ پرواز DepartureDay
ماه تاریخ پرواز DepartureMonth
روز تاریخ برگشت ReturnDay
ماه تاریخ برگشت ReturnMonth
کلاس پروازی FlightClassCode
نام کاربری OfficeUser
کلمه عبور OfficePass

 

توجه داشته باشید پارامتر های تاریخ برگشت برای زمان هایی می باشد که نیاز به نرخ رفت و برگشت خواهید داشت و ممکن است تاریخ برگشت در زمانی باشد که با تغییر نرخ مواجه شده باشد . از این رو می توانید در حالت های عادی همان تاریخ پرواز را نیز برای پارامتر های برگشت ارائه دهید .

برای دریافت نرخ کلاس های مختلف در یک پرواز می بایست به ازای هریک از کلاس ها این تابع را فراخوانی نمایید .

نحوه خروجی تابع اطلاعات نرخ :

{“AirFare”:[“AdultFare”:”1571000″,”ChildFare”:”821000″,”InfantFare”:”221000″]}

پارامتر های خروجی :

نرخ بزرگسال  AdultFare
نرخ خردسال ChildFare
نرخ طفل InfantFare

 

همانطور که در مثال خروجی مشاهده می نمایید نرخ را بر مبنای انواع مسافر برای کلاس مورد نظر ارائه می نماید.

تابع Reserv

از این تابع برای ثبت رزرو استفاده می شود . با توجه به دو تابع قبلی و اطلاعات مسافر می بایست پارامتر های مربوطه را تکمیل نموده و فراخوانی لازم را انجام دهید . در ذیل نمونه فراخوانی شده را مشاده می نمایید .

http://http://book.zagrosairlines.com/cgi-bin/NRSWeb.cgi/ReservJS?AirLine=ZV&cbSource=THR&cbTarget=MHD&FlightClass=Z&FlightNo=8060&Day=20&Month=1&No=1&edtName1=test&edtLast1=test&edtAge1=30&edtID1=0055275397&edtContact=09121013660&OfficeUser=NiraUser&OfficePass=1234

پارامتر های ورودی :

شناسه شرکت هواپیمایی Airline
کد استاندارد شهر مبدا  cbSource
کد استاندارد شهر مقصد cbTarget
کلاس FlightClass
شماره پرواز FlightNo
روز Day
ماه Month
نام مسافر ۱ edtName1
نام خانوادگی مسافر ۱ edtLast1
سن مسافر ۱ edtAge1
کد ملی / گذرنامه مسافر۱ edtID1
شماره موبایل / تلفن edtContact
نام کاربری OfficeUser
کلمه عبور OfficePass

 

در پارامتر های ورودی به ازای هر مسافر بیشتر گزینه های edtName ، edtLast ، edtAge و edtID اضافه خواهد شد .

edtName2=test&edtLast2=lotfiiii&edtAge2=30&edtID2=009988776655

نحوه خروجی تابع رزرو  :

{“AirReserve”:[“Error”:”No Err”,”PNR”:”N7Z2K”]}

پارامتر های خروجی :

وضعیت خطا Error
کد رزرو  PNR

در خروجی تابع فوق در صورت موفق بودن و انجام رزرو می بایست مقدار کد رزرو یا PNR را دریافت نمایید .

در صورتی که مقدار Error برابر با “No Err” باشد نشان دهنده موفقیت آمیز بودن آن می باشد در غیر اینصورت رزرو انجام نشده است

تابع RT

از این تابع برای مشاهده اطلاعات رزرو انجام شده استفاده می شود . در ذیل نمونه کد فراخوانی این تابع را مشاهده می نمایید .

 

http://http://book.zagrosairlines.com/cgi-bin/NRSWeb.cgi/RTJS?AirLine=ZV&PNR=N7Z2K&OfficeUser=NiraUser&OfficePass=1234

پارامتر های ورودی :

شناسه شرکت هواپیمایی  Airline
شناسه رزرو / کد رزرو PNR
نام کاربری OfficeUser
کلمه عبور OfficePAss

 

نحوه خروجی تابع مشاهده اطلاعات خرید / رزرو :

{“AirNRSPNR”:[“PNR”:”N7Z2K”,”Cancelled”:”NO”,”CONTACTS”:”09121013660″,”SEGMENTS”:[{“Origin”:”THR”,”Destination”:”MHD”,”FlightNo”:”8060″,”FlightClasse”:”Z””PassengerName”:”TEST/TEST”}]]}

در خروجی فوق SEGMENTS اطلاعات رزرو را در پرواز های اشغال شده را نمایش می دهد .

پارامتر های خروجی :

کد رزرو  PNR
وضعیت کنسلی                  Cancelled
شماره تماس Contacts
کد استاندارد مبدا Origin
کد استاندارد مقصد Destination
شماره پرواز FlightNo
کلاس پرواز FlightClasse
نام مسافر PassengerName

در صورتی که مقدار پارامتر Cancelled مخالف با “NO” باشد بدین معنی می باشد که این رزرو کنسل شده است .

تابع CancelPNR

از این تابع برای حذف رزرو مورد استفاده قرار می گیرد.

نمونه کد زیر نحوه فراخوانی این تابع را نمایش می دهد .

 

http://http://book.zagrosairlines.com/cgi-bin/NRSWeb.cgi/CancelPNRJS?Airline=ZV&PNR=N7YZ6&OfficeUser=NiraUser&OfficePass=1234

پارامتر های ورودی :

شناسه شرکت هواپیمایی  Airline
کد رزرو PNR
نام کاربری OfficeUser
کلمه عبور OfficePass

 

نمونه خروجی تابع  :

{“AirCancelPNR”:[“Error”:”No Error”]}

 پارامتر های خروجی :

وضعیت خطا Error

در صورتی که مقدار پارامتر Error برابر با “No Error” نباشد بدین معنی می باشد که حذف رزرو با خطا مواجه شده است .

تابع ETIssue

از این تابع برای تکمیل فرایند صدور بلیت استفاده می شود .

نمونه کد زیر نحوه فراخوانی این تابع را نمایش می دهد .

http://http://book.zagrosairlines.com/cgi-bin/NRSWeb.cgi/ETIssueJS?AirLine=ZV&PNR=N7Z2Q&EMail=Lotfi@nirasoftware.com&OfficeUser=NiraUser&OfficePass=1234

پارامتر های ورودی :

پارامتر های ورودی :

شناسه شرکت هواپیمایی Airline
کد رزرو  PNR
آدرس پست الکترونیکی Email
نام کاربری OfficeUser
کلمه عبور OfficePass

 

توجه داشته باشید نسخه الکترونیکی بلیت صادر شده به آدرس Email معرفی شده ارسال می شود .

خروجی تابع استرداد به شکل زیر می باشد :

{“AirNRSTICKETS”:[“Tickets”:”TEST/TEST=4912491660302″]} 

توجه داشته باشید در خروجی تابع ETIssue به ازای هر کدام از نام ها که بعنوان مسافر معرفی کرده اید یک شناسه (TicketNo)  معرفی می شود . این شناسه در توابع دیگر مورد استفاده قرار می گیرد.

در ذیل نمونه تصویر ایمیل ارسال از سیستم مشاهده می نمایید.

Iran Airtour Airline – ELECTRONIC TICKET RECEIPT

 

TKT NBR: 4912491660302  ISSUING CITY: THR   ISSUING OFFICE: THR001  ()

Name: TEST/TEST

ORIG/DEST:THRMHD    NBR OF TKTS ISSUED:001

CPN FROM/TO FLT      DATE    TIME     CLS    STATUS

۱  THR MHD ZV 8060 20JAN17 08:05     Z      OPEN FOR USE

 

**ENDORSEMENTS/FARE CALCULATION**

 

FARE  IRR 1000000

TFC   IRR 130000

TOTAL IRR 1130000

————- TAXES DETAIL ————

۶۰۰۰۰٫۰        IRR KU / MUNICIPALITI TAX

۷۰۰۰۰٫۰        IRR LP / AIRPORT TAX

 

 

 

تابع CancelSeat

همانظور که از عنوان این تابع مشخص می باشد جهت آزاد سازی ظرفیت اشغال شده مورد استفاده قرار می گیرد.

نمونه کد زیر نحوه فراخوانی و بارگذاری پارامتر های لازم برای این تابع را نمایش می دهد .

http://http://book.zagrosairlines.com/cgi-bin/NRSWeb.cgi/CancelSeatJS?Airline=ZV&PNR=N7Z2K&PassengerName=TEST&PassengerLastName=TEST&DepartureDate=2017-01-20&FlightNo=8060&OfficeUser=NiraUser&OfficePass=1234

پارامتر های ورودی :

شناسه شرکت هواپیمایی Airline
کد رزرو PNR
نام مسافر PassengerName
نام خانوادگی PassengerLastName
تاریخ حرکت DepartureDate
شماره پرواز FlightNo
نام کاربری OfficeUser
کلمه عبور OfficePass

 

همانطور که مشاهده می نمایید در پارامتر های ورودی نام و نام خانوادگی مسافر مد نظر جهت آزاد شدن صندلی اختصاص داده شده مد نظر می باشد . در صورتی که تعداد مسافر مربوط به یک رزرو بیش از یک نفر باشد می بایست به ازای هر کدام از مسافرین به صورت جداگانه فراخوانی نمایید.

نمونه خروجی تابع  :

{“AirCancelSeat”:[“Done”:”true”]}

 پارامتر های خروجی :

نتیجه درخواست Done

همانطور که از نمونه خروجی فوق مشاهده می نمایید در صورتی که خروجی برابر با True باشد نشان دهنده این می باشد که درخواست با موفقیت انجام شده است .

تابع ETRefund

از این تابع برای تکمیل فرایند استرداد بلیت و ثبت فرایند مالی استرداد استفاده می شود.

نمونه کد زیر نحوه فراخوانی و بارگذاری پارامتر های لازم برای این تابع را نمایش می دهد .

http://http://book.zagrosairlines.com/cgi-bin/NRSWeb.cgi/ETRefundJS?AirLine=ZV&TicketNo=4912491660250&Fare=1000&KU=10&LP=10&Penalty=200&OfficeUser=NiraUser&OfficePass=1234

پارامتر های ورودی :

شناسه شرکت هواپیمایی Airline
شناسه خرید مسافر TicketNo
نرخ بلیت Fare
  KU
  LP
مبلغ جریمه Penalty
نام کاربری OfficeUser
کلمه عبور OfficePass

 

پارامتر شناسه خرید مسافر را در زمان ETIssue دریافت کرده اید . برای هر مسافر می بایست به طور جداگانه این تابع را فراخوانی نمایید.

نمونه خروجی تابع  :

{“AirNRSRefund”:[“Done”:”0″]}

 پارامتر های خروجی :

نتیجه درخواست Done

همانطور که از نمونه خروجی فوق مشاهده می نمایید در صورتی که خروجی برابر با ۰ باشد نشان دهنده این می باشد که درخواست با موفقیت انجام شده است .

 

دیدگاه خود را بیان کنید

نشانی ایمیل شما منتشر نخواهد شد.

شما میتوانید از تگ های روبرو در نظر خود استفاده نمایید: <a href="" title=""> <abbr title=""> <acronym title=""> <b> <blockquote cite=""> <cite> <code> <del datetime=""> <em> <i> <q cite=""> <s> <strike> <strong>