availability

Download Markdown for LLM

متد GetCheapestPrice

کارکرد این متد، نمایش ارزان‌ترین نرخ تور قابل ارائه برای هر هتل است.

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


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


API Endpoint

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

Request Parameters


Sample Request

{
    "UserName": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "OriginIataCode": "THR",
    "DestinationIataCode": "KIH",
    "DepartureDate": "2026-01-09",
    "ReturningDate": "2026-01-12",
    "TripType": "Roundtrip",
    "RoomList": [{
            "AdultCount": 2,
            "ChildAgeList": []
        }
    ],
    "Filter": {
        "HotelGlobalIdList": [],
        "BoardTypeCodeList": [],
        "HotelStarList": [],
        "RoomBedCapacity": [],
        "DepartureFlight": {
            "AirlineIataCodeList": [],
            "DepartureTimeRangeList": [],
            "ArrivalTimeRangeList": []
        },
        "ReturningFlight": {
            "AirlineIataCodeList": [],
            "DepartureTimeRangeList": [],
            "ArrivalTimeRangeList": []
        }
    },
    "Culture": "fa-IR"
}

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

{
    "UserName": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "OriginIataCode": "IKA",
    "DestinationIataCode": "IST",
    "DepartureDate": "2026-01-09",
    "ReturningDate": "2026-01-12",
    "TripType": "Roundtrip",
    "RoomList": [{
            "AdultCount": 2,
            "ChildAgeList": []
        }, {
            "AdultCount": 1,
            "ChildAgeList": [3]
        }
    ],
    "Filter": {
        "HotelGlobalIdList": [],
        "BoardTypeCodeList": [],
        "HotelStarList": [],
        "RoomBedCapacity": [],
        "DepartureFlight": {
            "AirlineIataCodeList": [],
            "DepartureTimeRangeList": [],
            "ArrivalTimeRangeList": []
        },
        "ReturningFlight": {
            "AirlineIataCodeList": [],
            "DepartureTimeRangeList": [],
            "ArrivalTimeRangeList": []
        }
    },
    "Culture": "fa-IR"
}

نمونه درخواست - با فیلترهای مختلف

{
    "UserName": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "OriginIataCode": "THR",
    "DestinationIataCode": "KIH",
    "DepartureDate": "2026-01-09",
    "ReturningDate": "2026-01-12",
    "TripType": "Roundtrip",
    "RoomList": [{
            "AdultCount": 2,
            "ChildAgeList": []
        }
    ],
    "Filter": {
        "HotelGlobalIdList": [101, 1030],
        "BoardTypeCodeList": ["BB", "FB"],
        "HotelStarList": [4, 3],
        "RoomBedCapacity": [2, 3],
        "DepartureFlight": {
            "AirlineIataCodeList": ["NV", "PY"],
            "DepartureTimeRangeList": [{
                    "From": "06:00",
                    "To": "11:59"
                }, {
                    "From": "12:00",
                    "To": "17:59"
                }
            ],
            "ArrivalTimeRangeList": [{
                    "From": "06:00",
                    "To": "11:59"
                }, {
                    "From": "12:00",
                    "To": "17:59"
                }
            ]
        },
        "ReturningFlight": {
            "AirlineIataCodeList": ["VR", "HH"],
            "DepartureTimeRangeList": [{
                    "From": "06:00",
                    "To": "11:59"
                }, {
                    "From": "12:00",
                    "To": "17:59"
                }
            ],
            "ArrivalTimeRangeList": [{
                    "From": "06:00",
                    "To": "11:59"
                }, {
                    "From": "12:00",
                    "To": "17:59"
                }
            ]
        }
    },
    "Culture": "fa-IR"
}

Response Parameters


Sample Response

{
    "CurrencyCode": "IRR",
    "CheapestPriceList": [{
            "DepartureFlight": {
                "FlightNumber": "412",
                "DepartureDateTime": "2026-01-09 18:00",
                "Origin": {
                    "Code": "THR",
                    "Terminal": null
                },
                "Destination": {
                    "Code": "KIH",
                    "Terminal": null
                },
                "Aircraft": "AB4",
                "ArrivalDateTime": "2026-01-09 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": "2026-01-12 10:00",
                "Origin": {
                    "Code": "KIH",
                    "Terminal": null
                },
                "Destination": {
                    "Code": "THR",
                    "Terminal": null
                },
                "Aircraft": "AB4",
                "ArrivalDateTime": "2026-01-12 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
        },
        // ... بیشتر هتل‌ها
    ],
    "FilterOption": {
        "DepartureFlight_AirlineIataCodeList": ["NV", "PY", "IR", "B9"],
        "ReturningFlight_AirlineIataCodeList": ["VR", "HH"],
        "HotelGlobalIdList": [101, 1030],
        "BoardTypeCodeList": ["BB", "FB", "RO", "FF"],
        "HotelStarList": [4, 3],
        "RoomBedCapacity": [2, 1, 3]
    }
}