متد GetHistory
با استفاده از این متد می توان کلیه اطلاعات مربوط به یک رزرو را دریافت نمود
این اطلاعات شامل آخرین وضعیت رزرو، رزرو اولیه و تاریخچه اتفاقات – مثلا سگمنت های کنسل شده یا تغییر اطلاعات میهمانان- را شامل می گردد.
زمان (تاریخ و ساعت) هایی که در این وب سرویس خروجی داده میشود – مثلا فیلد BookingDateTime – بر اساس ناحیه زمانی UTC می باشد و در صورت نیاز باید آنها را به زمان ایران تبدیل نمایید.
API Endpoint
POST https://{SupplierWebsiteUrl}/api/Partners/Hotel/RetrieveBooking/V1/GetHistory
Request Parameters
Usernamestring
required
نام کاربری
Passwordstring
required
رمز عبور به صورت MD5 شده
Pnrstring
required
رفرنس سیستم سپهر که بعد از فراخوانی متد Book دریافت نموده اید
Sample Request
curl -X POST https://SepehrApiTest.ir/api/Partners/Hotel/RetrieveBooking/V1/GetHistory \
-H "Content-Type: application/json; charset=utf-8" \
-H "Accept: application/json" \
-H "Accept-Encoding: gzip, deflate" \
-d '{
"Username": "testdev1",
"Password": "25f9e794323b453885f5181f1b624d0b",
"Pnr": "ES566K"
}'
Response Parameters
LastStatecomplex type
اطلاعات مربوط به آخرین وضعیت رزرو
LastState.RoomListcomplex type
لیست اتاقهای رزرو شده در آخرین وضعیت رزرو
LastState.RoomList.HotelGlobalIdnumber
شناسه یکتای هتل در سیستم سپهر
LastState.RoomList.HotelNamestring
نام هتل
LastState.RoomList.RoomTypeGlobalIdnumber
شناسه یکتای نوع اتاق در سیستم سپهر
LastState.RoomList.RoomTypeNamestring
نام نوع اتاق
LastState.RoomList.BoardTypeCodestring
کد نوع نوبار/تغذیه (Board Type)
LastState.RoomList.ExtrabedsCountnumber
تعداد تختهای اضافه
LastState.RoomList.CheckinDatestring
تاریخ ورود به هتل با فرمت yyyy-MM-dd
LastState.RoomList.CheckoutDatestring
تاریخ خروج از هتل با فرمت yyyy-MM-dd
LastState.RoomList.PassengerListcomplex type
لیست مسافران/میهمانان این اتاق
LastState.RoomList.PassengerList.Idstring
شناسه یکتای مسافر
LastState.RoomList.PassengerList.FirstNamestring
نام مسافر
LastState.RoomList.PassengerList.LastNamestring
نام خانوادگی مسافر
LastState.RoomList.PassengerList.AgeTypestring
نوع سن مسافر (مثلا ADL برای بزرگسال)
LastState.RoomList.PassengerList.Genderstring
جنسیت مسافر (M برای مرد، F برای زن)
LastState.RoomList.PassengerList.Birthdatestring
تاریخ تولد مسافر با فرمت yyyy-MM-dd
LastState.RoomList.PassengerList.NationalityCountrystring
کد ISO ملیت مسافر
LastState.RoomList.PassengerList.IranianCartMellicomplex type
اطلاعات کد ملی مسافر
LastState.RoomList.PassengerList.IranianCartMelli.CodeMellistring
کد ملی مسافر
LastState.RoomList.PassengerList.Passportcomplex type
اطلاعات گذرنامه مسافر
LastState.RoomList.PassengerList.Passport.Numberstring
شماره گذرنامه
LastState.RoomList.PassengerList.Passport.ExpiryDatestring
تاریخ انقضای گذرنامه با فرمت yyyy-MM-dd
LastState.RoomList.PassengerList.Passport.PlaceOfIssueCountrystring
کد ISO کشور محل صدور گذرنامه
LastState.RoomList.RoomPriceListcomplex type
لیست قیمت اتاق به تفکیک هر شب اقامت
LastState.RoomList.RoomPriceList.StayDatestring
تاریخ شب اقامت با فرمت yyyy-MM-dd
LastState.RoomList.RoomPriceList.Room_CommissionPercentnumber
درصد کمیسیون اتاق
LastState.RoomList.RoomPriceList.Room_VAT_Tax_Percentnumber
درصد مالیات بر ارزش افزوده اتاق
LastState.RoomList.RoomPriceList.Room_VAT_Levy_Percentnumber
درصد عوارض اتاق
LastState.RoomList.RoomPriceList.Room_BoardPricedecimal
قیمت پایه اتاق (به ارزش فروش)
LastState.RoomList.RoomPriceList.Room_CalculatedAmountOfCommissionPercentdecimal
مبلغ محاسبه شده کمیسیون اتاق
LastState.RoomList.RoomPriceList.Room_Discountdecimal
مبلغ تخفیف اتاق
LastState.RoomList.RoomPriceList.Room_Surchargedecimal
مبلغ عوارض/اضافهبها اتاق
LastState.RoomList.RoomPriceList.Room_NetPrice_TaxExcludeddecimal
قیمت خالص اتاق بدون مالیات
LastState.RoomList.RoomPriceList.Room_VAT_Tax_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده مالیات بر ارزش افزوده اتاق
LastState.RoomList.RoomPriceList.Room_VAT_Levy_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده عوارض اتاق
LastState.RoomList.RoomPriceList.Room_NetPrice_TaxIncludeddecimal
قیمت خالص اتاق با مالیات
LastState.RoomList.RoomPriceList.Extrabed_CommissionPercentnumber
درصد کمیسیون تخت اضافه
LastState.RoomList.RoomPriceList.Extrabed_VAT_Tax_Percentnumber
درصد مالیات بر ارزش افزوده تخت اضافه
LastState.RoomList.RoomPriceList.Extrabed_VAT_Levy_Percentnumber
درصد عوارض تخت اضافه
LastState.RoomList.RoomPriceList.Extrabed_BoardPricedecimal
قیمت پایه تخت اضافه (به ارزش فروش)
LastState.RoomList.RoomPriceList.Extrabed_CalculatedAmountOfCommissionPercentdecimal
مبلغ محاسبه شده کمیسیون تخت اضافه
LastState.RoomList.RoomPriceList.Extrabed_Discountdecimal
مبلغ تخفیف تخت اضافه
LastState.RoomList.RoomPriceList.Extrabed_Surchargedecimal
مبلغ عوارض/اضافهبها تخت اضافه
LastState.RoomList.RoomPriceList.Extrabed_NetPrice_TaxExcludeddecimal
قیمت خالص تخت اضافه بدون مالیات
LastState.RoomList.RoomPriceList.Extrabed_VAT_Tax_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده مالیات بر ارزش افزوده تخت اضافه
LastState.RoomList.RoomPriceList.Extrabed_VAT_Levy_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده عوارض تخت اضافه
LastState.RoomList.RoomPriceList.Extrabed_NetPrice_TaxIncludeddecimal
قیمت خالص تخت اضافه با مالیات
LastState.TransferListcomplex type
لیست ترانسفرهای رزرو شده در آخرین وضعیت رزرو
LastState.TransferList.HotelGlobalIdnumber
شناسه یکتای هتل در سیستم سپهر
LastState.TransferList.HotelNamestring
نام هتل
LastState.TransferList.IncomingTransferTypestring
نوع ترانسفر ورودی (مثلا Flight، Train، Bus)
LastState.TransferList.IncomingFlightNumberstring
شماره پرواز ورودی
LastState.TransferList.IncomingFlightArrivalTimestring
زمان رسیدن پرواز ورودی
LastState.TransferList.IncomingFlightOriginCitystring
شهر مبدا پرواز ورودی
LastState.TransferList.IncomingFlightAirlineNamestring
نام ایرلاین پرواز ورودی
LastState.TransferList.IncomingTrainNumberstring
شماره حرکت قطار ورودی
LastState.TransferList.IncomingTrainArrivalTimestring
زمان رسیدن قطار ورودی
LastState.TransferList.IncomingTrainOriginCitystring
شهر مبدا قطار ورودی
LastState.TransferList.IncomingTrainCarrierNamestring
نام شرکت ارائه دهنده قطار ورودی
LastState.TransferList.IncomingBusArrivalTimestring
زمان رسیدن اتوبوس ورودی
LastState.TransferList.IncomingBusOriginCitystring
شهر مبدا اتوبوس ورودی
LastState.TransferList.IncomingBusCarrierNamestring
نام شرکت ارائه دهنده اتوبوس ورودی
LastState.TransferList.IncomingBusArrivalTerminalstring
ترمینال رسیدن اتوبوس ورودی
LastState.TransferList.IncomingPrivateVehiclestring
اطلاعات وسیله نقلیه شخصی ورودی
LastState.TransferList.OutgoingTransferTypestring
نوع ترانسفر خروجی (مثلا Flight، Train، Bus)
LastState.TransferList.OutgoingFlightNumberstring
شماره پرواز خروجی
LastState.TransferList.OutgoingFlightTimestring
زمان پرواز خروجی
LastState.TransferList.OutgoingTrainNumberstring
شماره حرکت قطار خروجی
LastState.TransferList.OutgoingTrainTimestring
زمان حرکت قطار خروجی
LastState.TransferList.OutgoingBusTimestring
زمان حرکت اتوبوس خروجی
LastState.TransferList.OutgoingBusDepartureTerminalstring
ترمینال حرکت اتوبوس خروجی
LastState.TransferList.OutgoingPrivateVehiclestring
اطلاعات وسیله نقلیه شخصی خروجی
History_InitialBookingcomplex type
اطلاعات مربوط به رزرو اولیه
History_InitialBooking.BookingDateTimestring
تاریخ و ساعت رزرو اولیه (UTC)
History_InitialBooking.Phonestring
شماره تلفن میهمان
History_InitialBooking.Emailstring
آدرس ایمیل میهمان
History_InitialBooking.Remarksstring
ملاحظات/یادداشتها
History_InitialBooking.HotelSegmentListcomplex type
لیست سگمنتهای هتل در رزرو اولیه
History_InitialBooking.HotelSegmentList.HotelGlobalIdnumber
شناسه یکتای هتل در سیستم سپهر
History_InitialBooking.HotelSegmentList.HotelNamestring
نام هتل
History_InitialBooking.HotelSegmentList.CheckinDatestring
تاریخ ورود به هتل با فرمت yyyy-MM-dd
History_InitialBooking.HotelSegmentList.CheckoutDatestring
تاریخ خروج از هتل با فرمت yyyy-MM-dd
History_InitialBooking.HotelSegmentList.RoomListcomplex type
لیست اتاقهای این سگمنت
History_InitialBooking.HotelSegmentList.RoomList.RoomTypeGlobalIdnumber
شناسه یکتای نوع اتاق در سیستم سپهر
History_InitialBooking.HotelSegmentList.RoomList.RoomTypeNamestring
نام نوع اتاق
History_InitialBooking.HotelSegmentList.RoomList.BoardTypeCodestring
کد نوع نوبار/تغذیه (Board Type)
History_InitialBooking.HotelSegmentList.RoomList.ExtrabedsCountnumber
تعداد تختهای اضافه
History_InitialBooking.HotelSegmentList.RoomList.PassengerListcomplex type
لیست مسافران/میهمانان این اتاق
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.Idstring
شناسه یکتای مسافر
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.FirstNamestring
نام مسافر
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.LastNamestring
نام خانوادگی مسافر
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.AgeTypestring
نوع سن مسافر (مثلا ADL برای بزرگسال)
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.Genderstring
جنسیت مسافر (M برای مرد، F برای زن)
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.Birthdatestring
تاریخ تولد مسافر با فرمت yyyy-MM-dd
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.NationalityCountrystring
کد ISO ملیت مسافر
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.IranianCartMellicomplex type
اطلاعات کد ملی مسافر
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.IranianCartMelli.CodeMellistring
کد ملی مسافر
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.Passportcomplex type
اطلاعات گذرنامه مسافر
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.Passport.Numberstring
شماره گذرنامه
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.Passport.ExpiryDatestring
تاریخ انقضای گذرنامه با فرمت yyyy-MM-dd
History_InitialBooking.HotelSegmentList.RoomList.PassengerList.Passport.PlaceOfIssueCountrystring
کد ISO کشور محل صدور گذرنامه
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceListcomplex type
لیست قیمت اتاق به تفکیک هر شب اقامت
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.StayDatestring
تاریخ شب اقامت با فرمت yyyy-MM-dd
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Room_CommissionPercentnumber
درصد کمیسیون اتاق
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Room_VAT_Tax_Percentnumber
درصد مالیات بر ارزش افزوده اتاق
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Room_VAT_Levy_Percentnumber
درصد عوارض اتاق
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Room_BoardPricedecimal
قیمت پایه اتاق (به ارزش فروش)
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Room_CalculatedAmountOfCommissionPercentdecimal
مبلغ محاسبه شده کمیسیون اتاق
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Room_Discountdecimal
مبلغ تخفیف اتاق
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Room_Surchargedecimal
مبلغ عوارض/اضافهبها اتاق
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Room_NetPrice_TaxExcludeddecimal
قیمت خالص اتاق بدون مالیات
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Room_VAT_Tax_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده مالیات بر ارزش افزوده اتاق
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Room_VAT_Levy_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده عوارض اتاق
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Room_NetPrice_TaxIncludeddecimal
قیمت خالص اتاق با مالیات
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Extrabed_CommissionPercentnumber
درصد کمیسیون تخت اضافه
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Extrabed_VAT_Tax_Percentnumber
درصد مالیات بر ارزش افزوده تخت اضافه
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Extrabed_VAT_Levy_Percentnumber
درصد عوارض تخت اضافه
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Extrabed_BoardPricedecimal
قیمت پایه تخت اضافه (به ارزش فروش)
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Extrabed_CalculatedAmountOfCommissionPercentdecimal
مبلغ محاسبه شده کمیسیون تخت اضافه
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Extrabed_Discountdecimal
مبلغ تخفیف تخت اضافه
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Extrabed_Surchargedecimal
مبلغ عوارض/اضافهبها تخت اضافه
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Extrabed_NetPrice_TaxExcludeddecimal
قیمت خالص تخت اضافه بدون مالیات
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Extrabed_VAT_Tax_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده مالیات بر ارزش افزوده تخت اضافه
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Extrabed_VAT_Levy_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده عوارض تخت اضافه
History_InitialBooking.HotelSegmentList.RoomList.RoomPriceList.Extrabed_NetPrice_TaxIncludeddecimal
قیمت خالص تخت اضافه با مالیات
History_Cancelationcomplex type
تاریخچه مربوط به سگمنتهای کنسل شده
History_Cancelation.HistoryListcomplex type
لیست تاریخچه کنسلشدگیها
History_Cancelation.HistoryList.HistoryTimestampstring
تاریخ و ساعت کنسلشدگی (UTC)
History_Cancelation.HistoryList.HotelSegmentListcomplex type
لیست سگمنتهای هتل کنسل شده
History_Cancelation.HistoryList.HotelSegmentList.HotelGlobalIdnumber
شناسه یکتای هتل در سیستم سپهر
History_Cancelation.HistoryList.HotelSegmentList.HotelNamestring
نام هتل
History_Cancelation.HistoryList.HotelSegmentList.CheckinDatestring
تاریخ ورود به هتل با فرمت yyyy-MM-dd
History_Cancelation.HistoryList.HotelSegmentList.CheckoutDatestring
تاریخ خروج از هتل با فرمت yyyy-MM-dd
History_Cancelation.HistoryList.HotelSegmentList.RoomListcomplex type
لیست اتاقهای این سگمنت
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomTypeGlobalIdnumber
شناسه یکتای نوع اتاق در سیستم سپهر
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomTypeNamestring
نام نوع اتاق
History_Cancelation.HistoryList.HotelSegmentList.RoomList.BoardTypeCodestring
کد نوع نوبار/تغذیه (Board Type)
History_Cancelation.HistoryList.HotelSegmentList.RoomList.ExtrabedsCountnumber
تعداد تختهای اضافه
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerListcomplex type
لیست مسافران/میهمانان این اتاق
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.Idstring
شناسه یکتای مسافر
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.FirstNamestring
نام مسافر
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.LastNamestring
نام خانوادگی مسافر
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.AgeTypestring
نوع سن مسافر (مثلا ADL برای بزرگسال)
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.Genderstring
جنسیت مسافر (M برای مرد، F برای زن)
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.Birthdatestring
تاریخ تولد مسافر با فرمت yyyy-MM-dd
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.NationalityCountrystring
کد ISO ملیت مسافر
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.IranianCartMellicomplex type
اطلاعات کد ملی مسافر
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.IranianCartMelli.CodeMellistring
کد ملی مسافر
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.Passportcomplex type
اطلاعات گذرنامه مسافر
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.Passport.Numberstring
شماره گذرنامه
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.Passport.ExpiryDatestring
تاریخ انقضای گذرنامه با فرمت yyyy-MM-dd
History_Cancelation.HistoryList.HotelSegmentList.RoomList.PassengerList.Passport.PlaceOfIssueCountrystring
کد ISO کشور محل صدور گذرنامه
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceListcomplex type
لیست قیمت اتاق به تفکیک هر شب اقامت
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.StayDatestring
تاریخ شب اقامت با فرمت yyyy-MM-dd
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Room_CommissionPercentnumber
درصد کمیسیون اتاق
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Room_VAT_Tax_Percentnumber
درصد مالیات بر ارزش افزوده اتاق
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Room_VAT_Levy_Percentnumber
درصد عوارض اتاق
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Room_BoardPricedecimal
قیمت پایه اتاق (به ارزش فروش)
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Room_CalculatedAmountOfCommissionPercentdecimal
مبلغ محاسبه شده کمیسیون اتاق
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Room_Discountdecimal
مبلغ تخفیف اتاق
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Room_Surchargedecimal
مبلغ عوارض/اضافهبها اتاق
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Room_NetPrice_TaxExcludeddecimal
قیمت خالص اتاق بدون مالیات
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Room_VAT_Tax_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده مالیات بر ارزش افزوده اتاق
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Room_VAT_Levy_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده عوارض اتاق
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Room_NetPrice_TaxIncludeddecimal
قیمت خالص اتاق با مالیات
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Extrabed_CommissionPercentnumber
درصد کمیسیون تخت اضافه
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Extrabed_VAT_Tax_Percentnumber
درصد مالیات بر ارزش افزوده تخت اضافه
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Extrabed_VAT_Levy_Percentnumber
درصد عوارض تخت اضافه
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Extrabed_BoardPricedecimal
قیمت پایه تخت اضافه (به ارزش فروش)
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Extrabed_CalculatedAmountOfCommissionPercentdecimal
مبلغ محاسبه شده کمیسیون تخت اضافه
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Extrabed_Discountdecimal
مبلغ تخفیف تخت اضافه
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Extrabed_Surchargedecimal
مبلغ عوارض/اضافهبها تخت اضافه
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Extrabed_NetPrice_TaxExcludeddecimal
قیمت خالص تخت اضافه بدون مالیات
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Extrabed_VAT_Tax_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده مالیات بر ارزش افزوده تخت اضافه
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Extrabed_VAT_Levy_CalculatedAmountOfPercentdecimal
مبلغ محاسبه شده عوارض تخت اضافه
History_Cancelation.HistoryList.HotelSegmentList.RoomList.RoomPriceList.Extrabed_NetPrice_TaxIncludeddecimal
قیمت خالص تخت اضافه با مالیات
History_Cancelation.HistoryList.CancellationPenaltyChargedToTheGuestdecimal
مبلغ جریمه کنسلشدگی تحمیل شده به میهمان
History_Cancelation.HistoryList.RefundAmountToTheGuestdecimal
مبلغ استرداد به میهمان
History_Cancelation.HistoryList.RefundReasonAndNotesstring
دلیل و یادداشتهای استرداد
History_PassengerInfoChangedcomplex type
تاریخچه مربوط به تغییرات اسامی و اطلاعات شخصی مسافران
History_PassengerInfoChanged.HistoryListcomplex type
لیست تاریخچه تغییرات اطلاعات مسافران
History_PassengerInfoChanged.HistoryList.HistoryTimestampstring
تاریخ و ساعت تغییر (UTC)
History_PassengerInfoChanged.HistoryList.PassengerListcomplex type
لیست مسافرانی که اطلاعاتشان تغییر کرده
History_PassengerInfoChanged.HistoryList.PassengerList.Idstring
شناسه یکتای مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.AgeTypeCodestring
کد نوع سن مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfocomplex type
اطلاعات قبلی مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfo.FirstNamestring
نام مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfo.LastNamestring
نام خانوادگی مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfo.Genderstring
جنسیت مسافر (M برای مرد، F برای زن)
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfo.Birthdatestring
تاریخ تولد مسافر با فرمت yyyy-MM-dd
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfo.NationalityCountrystring
کد ISO ملیت مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfo.IranianCartMellicomplex type
اطلاعات کد ملی مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfo.IranianCartMelli.CodeMellistring
کد ملی مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfo.Passportcomplex type
اطلاعات گذرنامه مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfo.Passport.Numberstring
شماره گذرنامه
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfo.Passport.ExpiryDatestring
تاریخ انقضای گذرنامه با فرمت yyyy-MM-dd
History_PassengerInfoChanged.HistoryList.PassengerList.OldInfo.Passport.PlaceOfIssueCountrystring
کد ISO کشور محل صدور گذرنامه
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfocomplex type
اطلاعات جدید مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfo.FirstNamestring
نام مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfo.LastNamestring
نام خانوادگی مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfo.Genderstring
جنسیت مسافر (M برای مرد، F برای زن)
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfo.Birthdatestring
تاریخ تولد مسافر با فرمت yyyy-MM-dd
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfo.NationalityCountrystring
کد ISO ملیت مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfo.IranianCartMellicomplex type
اطلاعات کد ملی مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfo.IranianCartMelli.CodeMellistring
کد ملی مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfo.Passportcomplex type
اطلاعات گذرنامه مسافر
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfo.Passport.Numberstring
شماره گذرنامه
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfo.Passport.ExpiryDatestring
تاریخ انقضای گذرنامه با فرمت yyyy-MM-dd
History_PassengerInfoChanged.HistoryList.PassengerList.NewInfo.Passport.PlaceOfIssueCountrystring
کد ISO کشور محل صدور گذرنامه
History_PassengerInfoChanged.HistoryList.PassengerList.PenaltyListcomplex type
لیست جریمههای اعمال شده
History_PassengerInfoChanged.HistoryList.PassengerList.PenaltyList.HotelNamestring
نام هتل
History_PassengerInfoChanged.HistoryList.PassengerList.PenaltyList.PenaltyAmountdecimal
مبلغ جریمه
History_PassengerInfoChanged.HistoryList.PassengerList.PenaltyList.DiscountAmountdecimal
مبلغ تخفیف
History_TransferChangedcomplex type
تاریخچه مربوط به تغییرات ترانسفر هتل
History_TransferChanged.HistoryListcomplex type
لیست تاریخچه تغییرات ترانسفر
History_TransferChanged.HistoryList.HistoryTimestampstring
تاریخ و ساعت تغییر (UTC)
History_TransferChanged.HistoryList.HotelGlobalIdnumber
شناسه یکتای هتل در سیستم سپهر
History_TransferChanged.HistoryList.HotelNamestring
نام هتل
History_TransferChanged.HistoryList.OldDatacomplex type
اطلاعات قبلی ترانسفر
History_TransferChanged.HistoryList.OldData.IncomingTransferTypestring
نوع ترانسفر ورودی (مثلا Flight، Train، Bus)
History_TransferChanged.HistoryList.OldData.IncomingFlightNumberstring
شماره پرواز ورودی
History_TransferChanged.HistoryList.OldData.IncomingFlightArrivalTimestring
زمان رسیدن پرواز ورودی
History_TransferChanged.HistoryList.OldData.IncomingFlightOriginCitystring
شهر مبدا پرواز ورودی
History_TransferChanged.HistoryList.OldData.IncomingFlightAirlineNamestring
نام ایرلاین پرواز ورودی
History_TransferChanged.HistoryList.OldData.IncomingTrainNumberstring
شماره حرکت قطار ورودی
History_TransferChanged.HistoryList.OldData.IncomingTrainArrivalTimestring
زمان رسیدن قطار ورودی
History_TransferChanged.HistoryList.OldData.IncomingTrainOriginCitystring
شهر مبدا قطار ورودی
History_TransferChanged.HistoryList.OldData.IncomingTrainCarrierNamestring
نام شرکت ارائه دهنده قطار ورودی
History_TransferChanged.HistoryList.OldData.IncomingBusArrivalTimestring
زمان رسیدن اتوبوس ورودی
History_TransferChanged.HistoryList.OldData.IncomingBusOriginCitystring
شهر مبدا اتوبوس ورودی
History_TransferChanged.HistoryList.OldData.IncomingBusCarrierNamestring
نام شرکت ارائه دهنده اتوبوس ورودی
History_TransferChanged.HistoryList.OldData.IncomingBusArrivalTerminalstring
ترمینال رسیدن اتوبوس ورودی
History_TransferChanged.HistoryList.OldData.IncomingPrivateVehiclestring
اطلاعات وسیله نقلیه شخصی ورودی
History_TransferChanged.HistoryList.OldData.OutgoingTransferTypestring
نوع ترانسفر خروجی (مثلا Flight، Train، Bus)
History_TransferChanged.HistoryList.OldData.OutgoingFlightNumberstring
شماره پرواز خروجی
History_TransferChanged.HistoryList.OldData.OutgoingFlightTimestring
زمان پرواز خروجی
History_TransferChanged.HistoryList.OldData.OutgoingTrainNumberstring
شماره حرکت قطار خروجی
History_TransferChanged.HistoryList.OldData.OutgoingTrainTimestring
زمان حرکت قطار خروجی
History_TransferChanged.HistoryList.OldData.OutgoingBusTimestring
زمان حرکت اتوبوس خروجی
History_TransferChanged.HistoryList.OldData.OutgoingBusDepartureTerminalstring
ترمینال حرکت اتوبوس خروجی
History_TransferChanged.HistoryList.OldData.OutgoingPrivateVehiclestring
اطلاعات وسیله نقلیه شخصی خروجی
History_TransferChanged.HistoryList.NewDatacomplex type
اطلاعات جدید ترانسفر
History_TransferChanged.HistoryList.NewData.IncomingTransferTypestring
نوع ترانسفر ورودی (مثلا Flight، Train، Bus)
History_TransferChanged.HistoryList.NewData.IncomingFlightNumberstring
شماره پرواز ورودی
History_TransferChanged.HistoryList.NewData.IncomingFlightArrivalTimestring
زمان رسیدن پرواز ورودی
History_TransferChanged.HistoryList.NewData.IncomingFlightOriginCitystring
شهر مبدا پرواز ورودی
History_TransferChanged.HistoryList.NewData.IncomingFlightAirlineNamestring
نام ایرلاین پرواز ورودی
History_TransferChanged.HistoryList.NewData.IncomingTrainNumberstring
شماره حرکت قطار ورودی
History_TransferChanged.HistoryList.NewData.IncomingTrainArrivalTimestring
زمان رسیدن قطار ورودی
History_TransferChanged.HistoryList.NewData.IncomingTrainOriginCitystring
شهر مبدا قطار ورودی
History_TransferChanged.HistoryList.NewData.IncomingTrainCarrierNamestring
نام شرکت ارائه دهنده قطار ورودی
History_TransferChanged.HistoryList.NewData.IncomingBusArrivalTimestring
زمان رسیدن اتوبوس ورودی
History_TransferChanged.HistoryList.NewData.IncomingBusOriginCitystring
شهر مبدا اتوبوس ورودی
History_TransferChanged.HistoryList.NewData.IncomingBusCarrierNamestring
نام شرکت ارائه دهنده اتوبوس ورودی
History_TransferChanged.HistoryList.NewData.IncomingBusArrivalTerminalstring
ترمینال رسیدن اتوبوس ورودی
History_TransferChanged.HistoryList.NewData.IncomingPrivateVehiclestring
اطلاعات وسیله نقلیه شخصی ورودی
History_TransferChanged.HistoryList.NewData.OutgoingTransferTypestring
نوع ترانسفر خروجی (مثلا Flight، Train، Bus)
History_TransferChanged.HistoryList.NewData.OutgoingFlightNumberstring
شماره پرواز خروجی
History_TransferChanged.HistoryList.NewData.OutgoingFlightTimestring
زمان پرواز خروجی
History_TransferChanged.HistoryList.NewData.OutgoingTrainNumberstring
شماره حرکت قطار خروجی
History_TransferChanged.HistoryList.NewData.OutgoingTrainTimestring
زمان حرکت قطار خروجی
History_TransferChanged.HistoryList.NewData.OutgoingBusTimestring
زمان حرکت اتوبوس خروجی
History_TransferChanged.HistoryList.NewData.OutgoingBusDepartureTerminalstring
ترمینال حرکت اتوبوس خروجی
History_TransferChanged.HistoryList.NewData.OutgoingPrivateVehiclestring
اطلاعات وسیله نقلیه شخصی خروجی
Sample Response
{
"LastState": {
"RoomList": [
{
"HotelGlobalId": 1136,
"HotelName": "سارينا",
"RoomTypeGlobalId": 8572,
"RoomTypeName": "يک تخته",
"BoardTypeCode": "RO",
"ExtrabedsCount": 1,
"CheckinDate": "2026-06-28",
"CheckoutDate": "2026-07-01",
"PassengerList": [
{
"Id": "138280c7-268d-493f-86b5-ddab142c39e6",
"FirstName": "SEYED MOHAMMAD AMIN",
"LastName": "TARI MORADI",
"AgeType": "ADL",
"Gender": "M",
"Birthdate": "1996-06-27",
"NationalityCountry": "IR",
"IranianCartMelli": {
"CodeMelli": "0012409235"
},
"Passport": null
},
{
"Id": "94d3a98d-ab64-4441-ad9f-d013b4fe5c67",
"FirstName": "HASSSAN",
"LastName": "HOSSEYNI",
"AgeType": "ADL",
"Gender": "M",
"Birthdate": "1996-06-27",
"NationalityCountry": "IR",
"IranianCartMelli": {
"CodeMelli": "0012015563"
},
"Passport": null
}
],
"RoomPriceList": [
{
"StayDate": "2026-06-28",
"Room_CommissionPercent": 0,
"Room_VAT_Tax_Percent": 0,
"Room_VAT_Levy_Percent": 0,
"Room_BoardPrice": 200000.00,
"Room_CalculatedAmountOfCommissionPercent": 0.00,
"Room_Discount": 0.00,
"Room_Surcharge": 0.00,
"Room_NetPrice_TaxExcluded": 200000.00,
"Room_VAT_Tax_CalculatedAmountOfPercent": 0.00,
"Room_VAT_Levy_CalculatedAmountOfPercent": 0.00,
"Room_NetPrice_TaxIncluded": 200000.00,
"Extrabed_CommissionPercent": 0,
"Extrabed_VAT_Tax_Percent": 0,
"Extrabed_VAT_Levy_Percent": 0,
"Extrabed_BoardPrice": 1000.00,
"Extrabed_CalculatedAmountOfCommissionPercent": 0.00,
"Extrabed_Discount": 0.00,
"Extrabed_Surcharge": 0.00,
"Extrabed_NetPrice_TaxExcluded": 1000.00,
"Extrabed_VAT_Tax_CalculatedAmountOfPercent": 0.00,
"Extrabed_VAT_Levy_CalculatedAmountOfPercent": 0.00,
"Extrabed_NetPrice_TaxIncluded": 1000.00
}
// ... بیشتر تاریخهای اقامت
]
}
],
"TransferList": [
{
"HotelGlobalId": 1136,
"HotelName": "سارينا",
"IncomingTransferType": "Flight",
"IncomingFlightNumber": "7057",
"IncomingFlightArrivalTime": "12:30",
"IncomingFlightOriginCity": "تهران",
"IncomingFlightAirlineName": "کیش ایر",
"IncomingTrainNumber": null,
"IncomingTrainArrivalTime": null,
"IncomingTrainOriginCity": null,
"IncomingTrainCarrierName": null,
"IncomingBusArrivalTime": null,
"IncomingBusOriginCity": null,
"IncomingBusCarrierName": null,
"IncomingBusArrivalTerminal": null,
"IncomingPrivateVehicle": null,
"OutgoingTransferType": "Flight",
"OutgoingFlightNumber": "2323",
"OutgoingFlightTime": "15:45",
"OutgoingTrainNumber": null,
"OutgoingTrainTime": null,
"OutgoingBusTime": null,
"OutgoingBusDepartureTerminal": null,
"OutgoingPrivateVehicle": null
}
]
},
"History_InitialBooking": {
"BookingDateTime": "2026-06-27 14:25:54",
"Phone": "+989352283333",
"Email": "your-email-address@your-domain.com",
"Remarks": "",
"HotelSegmentList": [
{
"HotelGlobalId": 1136,
"HotelName": "سارينا",
"CheckinDate": "2026-06-28",
"CheckoutDate": "2026-07-01",
"RoomList": [
{
"RoomTypeGlobalId": 8572,
"RoomTypeName": "يک تخته",
"BoardTypeCode": "RO",
"ExtrabedsCount": 1,
"PassengerList": [
{
"Id": "138280c7-268d-493f-86b5-ddab142c39e6",
"FirstName": "SEYED MOHAMMAD AMIN",
"LastName": "TARI MORADI",
"AgeType": "ADL",
"Gender": "M",
"Birthdate": "1996-06-27",
"NationalityCountry": null,
"IranianCartMelli": {
"CodeMelli": "0012409235"
},
"Passport": null
},
{
"Id": "94d3a98d-ab64-4441-ad9f-d013b4fe5c67",
"FirstName": "ABED",
"LastName": "HOSSEYNI",
"AgeType": "ADL",
"Gender": "M",
"Birthdate": "1996-06-27",
"NationalityCountry": null,
"IranianCartMelli": {
"CodeMelli": "0012015563"
},
"Passport": null
}
],
"RoomPriceList": [
{
"StayDate": "2026-06-28",
"Room_CommissionPercent": 0,
"Room_VAT_Tax_Percent": 0,
"Room_VAT_Levy_Percent": 0,
"Room_BoardPrice": 200000.00,
"Room_CalculatedAmountOfCommissionPercent": 0.00,
"Room_Discount": 0.00,
"Room_Surcharge": 0.00,
"Room_NetPrice_TaxExcluded": 200000.00,
"Room_VAT_Tax_CalculatedAmountOfPercent": 0.00,
"Room_VAT_Levy_CalculatedAmountOfPercent": 0.00,
"Room_NetPrice_TaxIncluded": 200000.00,
"Extrabed_CommissionPercent": 0,
"Extrabed_VAT_Tax_Percent": 0,
"Extrabed_VAT_Levy_Percent": 0,
"Extrabed_BoardPrice": 1000.00,
"Extrabed_CalculatedAmountOfCommissionPercent": 0.00,
"Extrabed_Discount": 0.00,
"Extrabed_Surcharge": 0.00,
"Extrabed_NetPrice_TaxExcluded": 1000.00,
"Extrabed_VAT_Tax_CalculatedAmountOfPercent": 0.00,
"Extrabed_VAT_Levy_CalculatedAmountOfPercent": 0.00,
"Extrabed_NetPrice_TaxIncluded": 1000.00
}
// ... بیشتر تاریخهای اقامت
]
}
]
}
]
},
"History_Cancelation": {
"HistoryList": []
},
"History_PassengerInfoChanged": {
"HistoryList": [
{
"HistoryTimestamp": "2026-06-27 14:27:05",
"PassengerList": [
{
"Id": "138280c7-268d-493f-86b5-ddab142c39e6",
"AgeTypeCode": "ADL",
"OldInfo": {
"FirstName": "SEYED MOHAMMAD AMIN",
"LastName": "TARI MORADI",
"Gender": "M",
"Birthdate": "1996-06-27",
"NationalityCountry": "IR",
"IranianCartMelli": {
"CodeMelli": "0012409235"
},
"Passport": null
},
"NewInfo": {
"FirstName": "SEYED MOHAMMAD AMIN",
"LastName": "TARI MORADI",
"Gender": "M",
"Birthdate": "1996-06-27",
"NationalityCountry": "IR",
"IranianCartMelli": {
"CodeMelli": "0012409235"
},
"Passport": null
},
"PenaltyList": [
{
"HotelName": "سارينا",
"PenaltyAmount": 500000.00,
"DiscountAmount": 0.00
}
]
},
{
"Id": "94d3a98d-ab64-4441-ad9f-d013b4fe5c67",
"AgeTypeCode": "ADL",
"OldInfo": {
"FirstName": "ABED",
"LastName": "HOSSEYNI",
"Gender": "M",
"Birthdate": "1996-06-27",
"NationalityCountry": "IR",
"IranianCartMelli": {
"CodeMelli": "0012015563"
},
"Passport": null
},
"NewInfo": {
"FirstName": "HASSSAN",
"LastName": "HOSSEYNI",
"Gender": "M",
"Birthdate": "1996-06-27",
"NationalityCountry": "IR",
"IranianCartMelli": {
"CodeMelli": "0012015563"
},
"Passport": null
},
"PenaltyList": [
{
"HotelName": "سارينا",
"PenaltyAmount": 0.00,
"DiscountAmount": 0.00
}
]
}
]
}
]
},
"History_TransferChanged": {
"HistoryList": [
{
"HistoryTimestamp": "2026-06-27 14:26:29",
"HotelGlobalId": 1136,
"HotelName": "سارينا",
"OldData": {
"IncomingTransferType": null,
"IncomingFlightNumber": null,
"IncomingFlightArrivalTime": null,
"IncomingFlightOriginCity": null,
"IncomingFlightAirlineName": null,
"IncomingTrainNumber": null,
"IncomingTrainArrivalTime": null,
"IncomingTrainOriginCity": null,
"IncomingTrainCarrierName": null,
"IncomingBusArrivalTime": null,
"IncomingBusOriginCity": null,
"IncomingBusCarrierName": null,
"IncomingBusArrivalTerminal": null,
"IncomingPrivateVehicle": null,
"OutgoingTransferType": null,
"OutgoingFlightNumber": null,
"OutgoingFlightTime": null,
"OutgoingTrainNumber": null,
"OutgoingTrainTime": null,
"OutgoingBusTime": null,
"OutgoingBusDepartureTerminal": null,
"OutgoingPrivateVehicle": null
},
"NewData": {
"IncomingTransferType": "Flight",
"IncomingFlightNumber": "7057",
"IncomingFlightArrivalTime": "12:30",
"IncomingFlightOriginCity": "تهران",
"IncomingFlightAirlineName": "کیش ایر",
"IncomingTrainNumber": null,
"IncomingTrainArrivalTime": null,
"IncomingTrainOriginCity": null,
"IncomingTrainCarrierName": null,
"IncomingBusArrivalTime": null,
"IncomingBusOriginCity": null,
"IncomingBusCarrierName": null,
"IncomingBusArrivalTerminal": null,
"IncomingPrivateVehicle": null,
"OutgoingTransferType": "Flight",
"OutgoingFlightNumber": "2323",
"OutgoingFlightTime": "15:45",
"OutgoingTrainNumber": null,
"OutgoingTrainTime": null,
"OutgoingBusTime": null,
"OutgoingBusDepartureTerminal": null,
"OutgoingPrivateVehicle": null
}
}
]
}
}
Response common exceptions
در جدول زیر لیستی از خطاهایی که ممکن است بعد از فراخوانی این متد برگشت داده شود، فهرست شده است.
| ExceptionType | توضیح خطا |
|---|---|
| Exception | خطای نامشخص. جهت دریافت اطلاعات بیشتر باید به ErrorMessage داخل json برگشتی مراجعه نمود. |