flight-bot-b2m
متد Get Flight List
این متد برای دریافت پروازهای موجود در Inventory استفاده میگردد.
کاربرد این متد صرفا جهت اطلاع از جزئیات پروازهای ساخته شده در Inventory میباشد.
زمان پرواز به ناحیه زمانی محلی خروجی داده می شود. مثلا برای یک پرواز تهران استانبول، زمان خروج از مبدا به ناحیه زمانی ایران و زمان رسیدن به مقصد به ناحیه زمانی ترکیه خروجی داده می شود.
اگر در پارامترهای ورودی مقادیر OriginIataCode و DestinationIataCode بصورت یک رشته خالی یا null پاس داده شوند، تمام پروازهای تاریخ مورد نظر در همهی مسیرها خروجی داده خواهد شد.
API Endpoint
POST https://{SupplierWebsiteUrl}/api/B2M/Bot/Flight/Charter/FlightManagement/Flight/GetList/V2
Request Parameters
UserNamestring
required
نام کاربری
Passwordstring
required
رمز عبور
FlightDatestring
required
تاریخ پروازها با فرمت yyyy-MM-dd به صورت میلادی
OriginIataCodestring
optional
کد سه حرفی یاتای مبدا
DestinationIataCodestring
optional
کد سه حرفی یاتای مقصد
Sample Request
{
"UserName": "your username",
"Password": "your MD5 of password",
"FlightDate": "2025-01-25",
"OriginIataCode": "",
"DestinationIataCode": ""
}
Response Parameters
flightListArray of flights
لیست پروازها
flightList.Idnumber
شناسه منحصر به فرد یک پرواز
flightList.flightNumberstring
شماره پرواز
flightList.departureDateTimestring
زمان خروج پرواز از مبدا. با فرمت yyyy-MM-dd HH:mm به صورت میلادی و بر اساس ناحیه زمانی مبدا
flightList.originIataCodestring
کد سه حرفی یاتای مبدا
flightList.destinationIataCodestring
کد سه حرفی یاتای مقصد
flightList.flightDurationInMinutenumber
مدت زمان طول کل پرواز به دقیقه
flightList.arrivalDateTimestring
زمان ورود پرواز به مقصد. با فرمت yyyy-MM-dd HH:mm به صورت میلادی و بر اساس ناحیه زمانی مقصد
flightList.airlineIataCodestring
کد یاتای ایرلاین
flightList.aircraftIataCodestring
کد یاتای هواپیما
flightList.aircraftRegisterstring
کد رجیستر هواپیما
flightList.totalCapacitystring
ظرفیت کلی پرواز
flightList.statusstring
وضعیت فعلی پرواز
flightList.lastUpdateDateTimestring
زمان اعمال آخرین ویرایش روی پرواز. با فرمت yyyy-MM-dd HH:mm:ss به صورت میلادی
flightList.lastUpdateByUserNamestring
کاربری که آخرین ویرایش را روی پرواز اعمال کرده است
flightList.privateRemarksstring
ملاحظات خصوصی که روی پرواز نوشته شده است و فقط توسط کاربران دفترمرکزی قابل مشاهده میباشد
flightList.publicRemarksstring
ملاحظات عمومی که روی پرواز نوشته شده است و قابل مشاهده در صفحه رزرو پرواز میباشد
flightList.eTicketRemarksstring
ملاحظات عمومی که جهت نمایش روی بلیت نوشته شده است. این ملاحظات روی فایل بلیت به رنگ قرمز نمایش داده میشود
flightList.canIssueOpenReturningbool
نشان دهنده امکان رزرو همزمان پرواز برگشت بصورت OPEN با این پرواز است
flightList.preventBookReturningFlightOnOtherAirlinesbool
نشان دهنده امکان رزرو همزمان پرواز برگشت روی ایرلاینی متفاوت با ایرلاین این پرواز میباشد
flightList.stop1IataCodestring
درصورتی که این پرواز حداقل یک استاپ داشته باشد کد یاتای سه حرفی فرودگاهی که در آن استاپ میکنیم نمایش داده میشود. در صورت null بودن یعنی پرواز بدون استاپ انجام میشود
flightList.stop2IataCodestring
درصورتی که این پرواز دو استاپ داشته باشد کد یاتای سه حرفی فرودگاهی که در آن استاپ دوم اتفاق میافتد نمایش داده میشود.
flightList.hideFlightFromSubsidiaryAgenciesbool
نشان دهنده امکان رزرو اختصاصی این پرواز برای کاربران دفترمرکزی است. در صورت true بودن یعنی فقط کاربران دفترمرکزی میتوانند این پرواز را رزرو کنند.
flightList.closeTimeoutInMinutenumber
نشان میدهد که چند دقیقه قبل از ساعت خروج، پرواز به صورت خودکار close میشود. مقدار 0 به معنای عدم close شدن خودکار میباشد
flightList.flightClassListArray Of Flight Classes
لیست کلاسهای پروازی
flightList.flightClassList.Idnumber
شناسه منحصر به فرد یک کلاس پروازی
flightList.flightClassList.capacitystring
ظرفیت این کلاس پروازی
flightList.flightClassList.lockedSeatCountstring
تعداد صندلیهاییکه روی این کلاس پروازی هم اکنون قفل شده و در حال رزرو میباشند
flightList.flightClassList.soldSeatCount_SharedQuotastring
تعداد صندلیهایی که تاکنون روی سهمیه شناوری این کلاس پروازی به فروش رفتهاند
flightList.flightClassList.soldSeatCount_SubsidiaryCharterQuotastring
تعداد صندلیهایی که تاکنون روی سهمیههای این کلاس پروازی به فروش رفتهاند
flightList.flightClassList.soldSeatCount_Totalstring
مجموع تعداد صندلیهایی که تاکنون روی این کلاس پروازی به فروش رفتهاند
flightList.flightClassList.availableSeatCountstring
تعداد صندلیهای موجود و آماده برای فروش روی این کلاس پروازی
flightList.flightClassList.isAllAllowedbool
در صورت true بودن به معنی وجود فیلتر مشاهده برای همه آژانسهاست. به عبارت دیگر همه کاربران و بازدید کنندگان سایت میتوانند این کلاس پروازی را در صفحه رزرو پرواز مشاهده کنند
flightList.flightClassList.extraCommissionPercentnumber
کمیسیون مازاد این کلاس پروازی به درصد
flightList.flightClassList.capacityShowCountnumber
حداکثر تعداد نمایش صندلیهای موجود در صفحه رزرو پرواز برای کاربران و بازدید کنندگان سایت
flightList.flightClassList.ruleListList Of Strings
لیست قوانین ثبت شده روی این کلاس پروازی. مانند مخصوص تور، الزام فروش فقط به صورت رفت و برگشت و...
flightList.flightClassList.fareobject
جزئیات fare این کلاس پروازی
flightList.flightClassList.fare.Idnumber
شناسه منحصر به فرد یک fare
flightList.flightClassList.fare.namestring
نام این fare
flightList.flightClassList.fare.cabinstring
کابین این fare. مانند Economy ، Business و...
flightList.flightClassList.fare.bookingCodestring
booking code این fare
flightList.flightClassList.fare.oneWayAdultdecimal
مبلغ یک بزرگسال برای رزرو یکطرفه
flightList.flightClassList.fare.oneWayChilddecimal
مبلغ یک کودک برای رزرو یکطرفه
flightList.flightClassList.fare.oneWayInfantdecimal
مبلغ یک نوزاد برای رزرو یکطرفه
flightList.flightClassList.fare.roundTripAdultSameOrigindecimal
مبلغ پرواز رفت برای یک بزرگسال در یک رزرو رفت و برگشتی (درصورتی مقدار این فیلد روی یک رزرو رفت و برگشتی اعمال میشود که این fare پیشرفته باشد)
flightList.flightClassList.fare.roundTripChildSameOrigindecimal
مبلغ پرواز رفت برای یک کودک در یک رزرو رفت و برگشتی (درصورتی مقدار این فیلد روی یک رزرو رفت و برگشتی اعمال میشود که این fare پیشرفته باشد)
flightList.flightClassList.fare.roundTripInfantSameOrigindecimal
مبلغ پرواز رفت برای یک نوزاد در یک رزرو رفت و برگشتی (درصورتی مقدار این فیلد روی یک رزرو رفت و برگشتی اعمال میشود که این fare پیشرفته باشد)
flightList.flightClassList.fare.roundTripAdultOppositeOrigindecimal
مبلغ پرواز برگشت برای یک بزرگسال در یک رزرو رفت و برگشتی (درصورتی این مقدار فیلد روی یک رزرو رفت و برگشتی اعمال میشود که این fare پیشرفته باشد)
flightList.flightClassList.fare.roundTripChildOppositeOrigindecimal
مبلغ پرواز برگشت برای یک کودک در یک رزرو رفت و برگشتی (درصورتی مقدار این فیلد روی یک رزرو رفت و برگشتی اعمال میشود که این fare پیشرفته باشد)
flightList.flightClassList.fare.roundTripInfantOppositeOrigindecimal
مبلغ پرواز برگشت برای یک نوزاد در یک رزرو رفت و برگشتی (درصورتی مقدار این فیلد روی یک رزرو رفت و برگشتی اعمال میشود که این fare پیشرفته باشد)
flightList.flightClassList.fare.isAdvancedFarebool
در صورت true بودن یعنی این fare پیشرفته است و در غیر این صورت fare ساده است.
flightList.flightClassList.fare.minimumStayDaynumber
حداقل مدت اقامت. یعنی در رزروهای رفت و برگشتی این فیلد مشخص میکند که بین پرواز رفت با برگشت حداقل چند روز باید فاصله باشد (درصورتی مقدار این فیلد روی یک رزرو رفت و برگشتی اعمال میشود که این fare پیشرفته باشد)
flightList.flightClassList.fare.maximumStayDaynumber
حداکثر مدت اقامت. یعنی در رزروهای رفت و برگشتی این فیلد مشخص میکند که بین پرواز رفت با برگشت حداکثر چند روز باید فاصله باشد (درصورتی مقدار این فیلد روی یک رزرو رفت و برگشتی اعمال میشود که این fare پیشرفته باشد)
flightList.flightClassList.fare.currencyCodestring
کد سه حرفی ارز این fare. مانند IRR ، USD و...
Sample Response
{
"flightList": [
{
"id": 64511,
"flightNumber": "2339",
"departureDateTime": "2025-01-25 20:30",
"originIataCode": "AWZ",
"destinationIataCode": "IFN",
"flightDurationInMinute": 60,
"arrivalDateTime": "2025-01-25 21:30",
"airlineIataCode": "PY",
"aircraftIataCode": "AB6",
"aircraftRegister": "EP-GHT",
"totalCapacity": "100",
"status": "OnTime",
"lastUpdateDateTime": "2025-01-06 05:16:46",
"lastUpdateByUserName": "admin",
"privateRemarks": null,
"publicRemarks": "",
"eTicketRemarks": "",
"canIssueOpenReturning": false,
"preventBookReturningFlightOnOtherAirlines": false,
"stop1IataCode": null,
"stop2IataCode": null,
"hideFlightFromSubsidiaryAgencies": false,
"closeTimeoutInMinute": 0,
"flightClassList": [
{
"id": 843902,
"capacity": "40",
"lockedSeatCount": "0",
"soldSeatCount_SharedQuota": "0",
"soldSeatCount_SubsidiaryCharterQuota": "0",
"soldSeatCount_Total": "0",
"availableSeatCount": "40",
"isAllAllowed": true,
"extraCommissionPercent": 0,
"capacityShowCount": 9,
"ruleList": [],
"fare": {
"id": 4163,
"name": "Fare 720",
"cabin": "Economy",
"bookingCode": "T",
"oneWayAdult": 7200000.00,
"oneWayChild": 5000000.00,
"oneWayInfant": 550000.00,
"roundTripAdultSameOrigin": 0.00,
"roundTripChildSameOrigin": 0.00,
"roundTripInfantSameOrigin": 0.00,
"roundTripAdultOppositeOrigin": 0.00,
"roundTripChildOppositeOrigin": 0.00,
"roundTripInfantOppositeOrigin": 0.00,
"isAdvancedFare": false,
"minimumStayDay": 0,
"maximumStayDay": 0,
"currencyCode": "IRR"
}
}
]
}
]
}