get-passenger-list
متد GetPassengerList
این متد به منظور دریافت لیست مسافران یک پرواز همراه با اطلاعات تکمیلی رزرو هر مسافر اعم از اطلاعات مالی و … مورد استفاده میباشد
API Endpoint
POST https://{SupplierWebsiteUrl}/api/B2M/Bot/Flight/Charter/FlightManagement/Flight/Reports/GetPassengerList/V1
Request Parameters
UserNamestring
[conditional-required]
نام کاربری
در صورت استفاده از روش Username/Password Authentication ارسال این فیلد الزامی است.
Passwordstring
[conditional-required]
رمز عبور به صورت MD5 شده
در صورت استفاده از روش Username/Password Authentication ارسال این فیلد الزامی است.
AccessTokenstring
[conditional-required]
توکن احراز هویت دریافتشده از طریق Single Sign-On (SSO).
در صورت استفاده از روش Token-based Authentication این فیلد را ارسال کنید. در این حالت نیازی به ارسال UserName و Password نیست.
برای آشنایی با روشهای احراز هویت و نحوه انتخاب و استفاده از هر روش، به مستندات Authentication مراجعه کنید.
FlightIdnumber
required
شناسه منحصر به فرد پرواز
Sample Request
curl -X POST https://SepehrApiTest.ir/api/B2M/Bot/Flight/Charter/FlightManagement/Flight/Reports/GetPassengerList/V1 \
-H "Content-Type: application/json; charset=utf-8" \
-H "Accept: application/json" \
-H "Accept-Encoding: gzip, deflate" \
-d '{
"UserName": "testdev1",
"Password": "25f9e794323b453885f5181f1b624d0b",
"FlightId": 844418
}'
Response Parameters
flightNumberstring
شماره پرواز
departureDateTimestring
زمان خروج پرواز از مبدا. با فرمت yyyy-MM-dd HH:mm به صورت میلادی و بر اساس ناحیه زمانی مبدا
originIataCodestring
کد سه حرفی یاتای مبدا
destinationIataCodestring
کد سه حرفی یاتای مقصد
airlineIataCodestring
کد یاتای ایرلاین
passengerListArray Of Passengers
لیست مسافران
passengerList.firstNamestring
نام کوچک مسافر
passengerList.lastNamestring
نام خانوادگی مسافر
passengerList.ageTypeCodestring
کد گروه سنی مسافر: ADL , CHD , INF
passengerList.birthDatestring
تاریخ تولد مسافر با فرمت yyyy-MM-dd به صورت میلادی
passengerList.genderstring
جنسیت مسافر: M , F
passengerList.pnrstring
رفرنس رزرو مسافر
passengerList.ticketNumberstring
شماره بلیت منحصر به فرد این مسافر
passengerList.reserveDateTimestring
زمان انجام رزرو. با فرمت yyyy-MM-dd HH:mm به صورت میلادی و بر اساس ناحیه زمانی UTC
passengerList.phonestring
شماره موبایل مسافر
passengerList.emailstring
آدرس پست الکترونیک مسافر
passengerList.nationalityCountryCodestring
کد دو حرفی ملیت مسافر. مانند : IR , FR و…
passengerList.passportstring
شماره پاسپورت مسافر. این فیلد در صورتی دارای مقدار خواهد بود که یا پرواز بین المللی باشد و یا مسافر غیر ایرانی باشد
passengerList.iranianCodeMellistring
کد ملی مسافر. این فیلد در صورتی دارای مقدار خواهد بود که پرواز داخلی ایران بوده و ضمنا مسافر نیز ایرانی باشد
passengerList.hotelNamestring
درصورتی رزرو مسافر شامل هتل هم باید نام هتل در این فیلد نمایش داده میشود
passengerList.oppositeFlight_Idnumber
درصورتی که رزرو مسافر رفت و برگشتی باشد شناسه منحصر به فرد پرواز مقابل در این فیلد نمایش داده میشود
passengerList.oppositeFlight_Numberstring
درصورتی که رزرو مسافر رفت و برگشتی باشد شماره پرواز مقابل در این فیلد نمایش داده میشود
passengerList.oppositeFlight_DepartureDateTimestring
درصورتی که رزرو مسافر رفت و برگشتی باشد زمان خروج پرواز مقابل در این فیلد با فرمت yyyy-MM-dd HH:mm به صورت میلادی و بر اساس ناحیه زمانی مبدا نمایش داده میشود
passengerList.reserveByUserIdnumber
شناسه منحصر به فرد کاربر صادر کننده رزرو
passengerList.reserveByUserNamestring
نام کاربر صادر کننده رزرو
passengerList.reserveForAgencyIdnumber
شناسه منحصر به فرد آژانس طرف حساب رزرو
passengerList.reserveForAgencyNamestring
نام آژانس طرف حساب رزرو
passengerList.cabinTypestring
نوع کابین. مانند Economy ، Business و…
passengerList.bookingCodestring
بوکینگ کد
passengerList.fareNamestring
نام fare
passengerList.priceBreakdownobject
جزئیات نرخی مربوط به این مسافر
passengerList.priceBreakdown.baseFaredecimal
مبلغ پایه fare
passengerList.priceBreakdown.taxdecimal
مجموع مبالغ مالیاتها
passengerList.priceBreakdown.totalFaredecimal
مبلغ نهایی fare که مجموع baseFare و tax میباشد
passengerList.priceBreakdown.commissiondecimal
مبلغ کمیسیون
passengerList.priceBreakdown.discountdecimal
مبلغ تخفیف
passengerList.priceBreakdown.surchargedecimal
مبلغ اضافه بها
passengerList.priceBreakdown.payabledecimal
مبلغ نهایی قابل پرداخت برای این مسافر
passengerList.priceBreakdown.currencyCodestring
کد سه حرفی ارز این fare. مانند IRR ، USD و…
Sample Response
{
"flightNumber": "3333",
"departureDateTime": "2025-02-25 15:00",
"originIataCode": "IFN",
"destinationIataCode": "AWZ",
"airlineIataCode": "B9",
"passengerList": [
{
"firstName": "AHMAD",
"lastName": "AHMADI",
"ageTypeCode": "ADL",
"birthDate": "1984-08-20",
"gender": "M",
"pnr": "B66U88",
"ticketNumber": "1538051",
"reserveDateTime": "2025-02-03 12:40:10",
"phone": "+989122953473",
"email": "info@sepehrsystems.net",
"nationalityCountryCode": "IR",
"passport": null,
"iranianCodeMelli": "0010420207",
"hotelName": null,
"oppositeFlight_Id": null,
"oppositeFlight_Number": null,
"oppositeFlight_DepartureDatetime": null,
"reserveByUserId": 5277,
"reserveByUserName": "فروش نقدي اينترنتي",
"reserveForAgencyId": 2822,
"reserveForAgencyName": "فروش نقدي اينترنتي",
"cabinType": "Economy",
"bookingCode": "Y",
"fareName": "THRAWZ IS 120",
"priceBreakdown": {
"baseFare": 1200000.00,
"tax": 0.00,
"totalFare": 1200000.00,
"commission": 120000.00,
"discount": 0.00,
"surcharge": 0.00,
"payable": 1080000.00,
"currencyCode": "IRR"
}
}
]
}