availability

متد GetHotelPackageList

کارکرد این متد، ارائه تمام پکیج های تور (ترکیب پروازها و انواع اتاق) برای یک هتل است.

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

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


API Endpoint

POST https://{SupplierWebsiteUrl}/api/Partners/Tour/Availability/V7/GetHotelPackageList

Request Parameters


Sample Request

{
    "UserName": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "HotelSepehrGlobalId": 101,
    "OriginIataCode": "THR",
    "DestinationIataCode": "KIH",
    "DepartureDate": "2025-12-17",
    "ReturningDate": "2025-12-20",
    "TripType": "Roundtrip",
    "RoomList": [{
            "AdultCount": 2,
            "ChildAgeList": []
        }
    ],
    "Culture": "fa-IR"
}

نمونه درخواست - دو اتاق - سه بزرگسال - یک کودک 3 ساله

{
    "UserName": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "HotelSepehrGlobalId": 104,
    "OriginIataCode": "IKA",
    "DestinationIataCode": "IST",
    "DepartureDate": "2025-12-17",
    "ReturningDate": "2025-12-20",
    "TripType": "Roundtrip",
    "RoomList": [{
            "AdultCount": 2,
            "ChildAgeList": []
        }, {
            "AdultCount": 1,
            "ChildAgeList": [3]
        }
    ],
    "Culture": "fa-IR"
}

Response Parameters


Sample Response

{
    "CurrencyCode": "IRR",
    "PackageList": [{
            "DepartureFlight": {
                "FlightNumber": "412",
                "DepartureDateTime": "2025-12-17 18:00",
                "Origin": {
                    "Code": "THR",
                    "Terminal": null
                },
                "Destination": {
                    "Code": "KIH",
                    "Terminal": null
                },
                "Aircraft": "AB4",
                "ArrivalDateTime": "2025-12-17 19:50",
                "Duration": 110,
                "Airline": "NV",
                "Remarks": "",
                "Stop1": null,
                "Stop2": null,
                "CabinType": "Business",
                "BookingCode": "C",
                "FareName": "THRMHD1",
                "AdultFreeBaggage": {
                    "CheckedBaggageQuantity": 0,
                    "CheckedBaggageTotalWeight": 0,
                    "HandBaggageQuantity": 0,
                    "HandBaggageTotalWeight": 0
                },
                "ChildFreeBaggage": {
                    "CheckedBaggageQuantity": 0,
                    "CheckedBaggageTotalWeight": 0,
                    "HandBaggageQuantity": 0,
                    "HandBaggageTotalWeight": 0
                },
                "InfantFreeBaggage": {
                    "CheckedBaggageQuantity": 0,
                    "CheckedBaggageTotalWeight": 0,
                    "HandBaggageQuantity": 0,
                    "HandBaggageTotalWeight": 0
                }
            },
            "ReturningFlight": {
                "FlightNumber": "413",
                "DepartureDateTime": "2025-12-20 10:00",
                "Origin": {
                    "Code": "KIH",
                    "Terminal": null
                },
                "Destination": {
                    "Code": "THR",
                    "Terminal": null
                },
                "Aircraft": "AB4",
                "ArrivalDateTime": "2025-12-20 11:10",
                "Duration": 70,
                "Airline": "HH",
                "Remarks": "",
                "Stop1": null,
                "Stop2": null,
                "CabinType": "Economy",
                "BookingCode": "Y",
                "FareName": "MHD",
                "AdultFreeBaggage": {
                    "CheckedBaggageQuantity": 2,
                    "CheckedBaggageTotalWeight": 20,
                    "HandBaggageQuantity": 1,
                    "HandBaggageTotalWeight": 5
                },
                "ChildFreeBaggage": {
                    "CheckedBaggageQuantity": 2,
                    "CheckedBaggageTotalWeight": 20,
                    "HandBaggageQuantity": 1,
                    "HandBaggageTotalWeight": 5
                },
                "InfantFreeBaggage": {
                    "CheckedBaggageQuantity": 0,
                    "CheckedBaggageTotalWeight": 0,
                    "HandBaggageQuantity": 0,
                    "HandBaggageTotalWeight": 0
                }
            },
            "Hotel": {
                "SepehrGlobalId": 101,
                "Name": "هتل کوهستان تستي",
                "RoomTypeList": [{
                        "SepehrGlobalId": 5003,
                        "Name": "دو تخته استاندارد",
                        "BoardTypeCode": "BB",
                        "AdultCount": 2,
                        "ChildAgeList": [],
                        "ExtrabedAssignedCount": 0
                    }
                ],
                "AmenityList": [{
                        "SepehrGlobalId": 102,
                        "Name": "استخر روباز",
                        "Quantity": 6
                    }, {
                        "SepehrGlobalId": 100,
                        "Name": "استقبال فرودگاهی",
                        "Quantity": 2
                    }, {
                        "SepehrGlobalId": 103,
                        "Name": "بیمه مسافرتی",
                        "Quantity": 2
                    }
                ]
            },
            "TotalFlightNetPrice": 17809900.00,
            "TotalHotelNetPrice": 18366500.00,
            "TotalGrossPrice": 35498500.00,
            "TotalCommission": 582100.0,
            "TotalNetPrice": 36176400.00
        }
        // ... بیشتر پکیج‌ها
    ]
}