PMS Services
1st Stage Login
Login Method
Başarılı bir requestin sonucunda token bilgisi dönmektedir. Bir hata oluşması durumunda Unauthorized dönmektedir.
| Last Update Date: |
06.03.2017 |
| Method Adress |
/api/system/login |
| Method Type |
GET |
| Token Required |
NO |
Note: Login sonrası dönen token bilgisini requestlerinize header olarak eklemeniz gerekmektedir.
request.Headers.Add(“cookie”, “29147ccf-a15e-47a2-93d4-a595d8ad444b”);
Response Sample
eccb3171-8b55-4b44-840c-90f6718e360f
Query Parameters
| Parameter Name |
Bound |
Shape Definition |
Data Type |
Description |
| user |
yes |
URI |
string |
Login için gerekli kullanıcı bilgisi |
| pass |
yes |
URI |
string |
Login için gerekli şifre bilgisi |
2nd Stage Preparation
GetHotelAgencies
Otel Acentelerinin Çekilmesi : Hotel2sejour’da otelinize bağlı olan acente listesini “gethotelagencies” metodunu kullanarak çekebilirsiniz
| Last Update Date: |
06.03.2017 |
| Method Adress |
/api/pax/gethotelagencies |
| Method Type |
GET |
| Token Required |
YES |
Request Sample
http://admin.stage.hotel2sejour.com/api/pax/gethotelagencies?format=xml
Response Sample
<ServiceResultOfArrayOfDefinitionHotelAgency>
<Data>
<DefinitionHotelAgency xmlns="">
<Id>8dc82479-495e-46e9-a060-03da9fceba60</Id>
<Name>Zem Expert</Name>
</DefinitionHotelAgency>
<DefinitionHotelAgency xmlns="">
<Id>d226f2d4-7cc1-4648-94f2-0515d8db03b4</Id>
<Name>Northern Travel</Name>
</DefinitionHotelAgency>
</Data>
<Error>
<Code/>
<Message/>
</Error>
<InfoMessage>2 data item returned</InfoMessage>
<IsSuccessful>true</IsSuccessful>
</ServiceResultOfArrayOfDefinitionHotelAgency>
URL Parameters
| Parameter Name |
Bound |
Shape Definition |
Data Type |
Description |
| format |
no |
URI |
string |
response dönüş formatı Örnek:xml,json |
GetNotConfirMessages
Not Konfirme Mesajlarının Çekilmesi : Hotel2sejour’da otelinize bağlı olan not konfirme mesajlarını “getnotconfirmmessages” metodunu kullanarak çekebilirsiniz
| Last Update Date: |
06.03.2017 |
| Method Adress |
/api/pax/getnotconfirmmessages |
| Method Type |
GET |
| Token Required |
YES |
Request Sample
http://admin.stage.hotel2sejour.com/api/pax/getnotconfirmmessages?paximumId=2222&format=xml&langId=tr-TR
Response Sample
<ServiceResultOfArrayOfNotConfirmMessage>
<Data>
<NotConfirmMessage>
<Id>2508d966-56e6-46ff-b98d-13940f9f5ddb</Id>
<Name>Kontenjan aşımı</Name>
</NotConfirmMessage>
<NotConfirmMessage>
<Id>a860847a-3abf-48f2-9396-3859ea187277</Id>
<Name>Doluluk</Name>
</NotConfirmMessage>
</Data>
<Error>
<Code/>
<Message/>
</Error>
<InfoMessage>2 data item returned</InfoMessage>
<IsSuccessful>true</IsSuccessful>
</ServiceResultOfArrayOfNotConfirmMessage>
URL Parameters
| Parameter Name |
Bound |
Shape Definition |
Data Type |
Description |
| format |
no |
URI |
string |
response dönüş formatı Örnek:xml, json |
| paximumId |
no |
URI |
int |
otelinize ait olan hotel2sejour sistemindeki unique bir değer |
| langId |
no |
URI |
string |
Türkçe için = tr-TR , İngilizce için en-US |
Sejour Tanımlamalarının Çekilmesi : Hotel2Sejour’da acentelerin sizin için kullandıkları Oda, Oda Tipi, Pansiyon gibi tanımlamaları çaprazlama/eşleştirme yapmak için önceden “GetSejourCodesForMapping” metodunu kullanarak çekebilirsiniz
| Last Update Date: |
06.03.2017 |
| Method Adress |
/api/pax/getsejourformapping |
| Method Type |
GET |
| Token Required |
YES |
Request Sample
http://admin.stage.hotel2sejour.com/api/pax/getsejourformapping?agencyId=873B1E6A-C5D0-4E52-ABBD-634CC9CFF1D7&paximumId=2222&format=xml
Response Sample
<ServiceResultOfArrayOfSejourCodesForMapping xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HotelWeb.Web.Framework">
<Data>
<SejourCodesForMapping xmlns="">
<SejourBoards/>
<SejourNationals/>
<SejourRoomTypes/>
<SejourRooms/>
</SejourCodesForMapping>
</Data>
<Error>
<Code/>
<Message/>
</Error>
<InfoMessage/>
<IsSuccessful>true</IsSuccessful>
</ServiceResultOfArrayOfSejourCodesForMapping>
URL Parameters
| Parameter Name |
Bound |
Shape Definition |
Data Type |
Description |
| paximumId |
yes |
URI |
int |
otelinize ait olan hotel2sejour sistemindeki unique bir değer |
| agencyId |
yes |
URI |
Guid |
Gethotelagencies metodundan dönen acentelerin Id bilgisi |
| format |
no |
URI |
string |
response dönüş formatı Örnek:xml,json |
3rd Stage Reservation
GetReservationList
Otel Rezervasyonlarının Hotel2sejour’dan Çekilmesi: Otelinizin Hotel2Sejour üzerindeki beklemede olan rezervasyonlarını “getReservationList” metodunu kullanarak çekebilirsiniz. Bütün metodların response yapısı gibi Data , Error ,InfoMessage ve IsSuccessful olarak 4 kısımdan oluşmaktadır. Başarılı bir requestin sonucunda IsSuccessful true dönmekte ve sonuç kümesi Data altında listelenmektedir. Bir hata oluşması durumunda IsSuccessful false dönmekte ve hata detayı Error altında listelenmetedir.
| Last Update Date: |
06.03.2017 |
| Method Adress |
/api/pax/getReservationList |
| Method Type |
GET |
| Token Required |
YES |
Request Sample
http://admin.stage.hotel2sejour.com/api/pax/getReservationList?checkInStart=10.01.2014&checkInEnd=10.08.2014&agencyId=873B1E6A-C5D0-4E52-ABBD-634CC9CFF1D7&format=xml
Response Sample
<?xml version="1.0" encoding="utf-8"?>
<ServiceResultOfArrayOfReservationPms xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HotelWeb.Web.Framework">
<Data>
<ReservationPms xmlns="">
<AccomId>AI</AccomId>
<AccomName>ALL INCLUSIVE (AI)</AccomName>
<Adults>2</Adults>
<AgencyId>dd5896c9-ff9c-4f43-bab6-85fa2f820f39</AgencyId>
<AgencyName>stage_db_test_1</AgencyName>
<CheckIn>2014-06-08T00:00:00</CheckIn>
<CheckOut>2014-06-15T00:00:00</CheckOut>
<Childs>0</Childs>
<ConfirmDate i:nil="true" />
<ConfirmationNo></ConfirmationNo>
<ConfirmationStatus>W</ConfirmationStatus>
<ConfirmeNote></ConfirmeNote>
<Customers>
<CustomerPms>
<Age>63</Age>
<Arrival>ARR?</Arrival>
<ArrivalTime i:nil="true" />
<BirthDate i:nil="true" />
<Departure>DEP?</Departure>
<DepartureTime i:nil="true" />
<MusNo>95</MusNo>
<MusTakipNo></MusTakipNo>
<Name>BERG, WILHELMIENA N</Name>
<Nationality></Nationality>
<NationalityString></NationalityString> <ReservationKeyField>H2S|0042|44|H2S|f3ba442b-9d2e-4315-b3ed-20224837fcde|e76e1cf7-0c8a-42d6-a163-65f8d848dff5|0|f01819aa-df05-48ec-8683-572eaa354ad0|16.9.2015 17:21:51</ReservationKeyField>
<Title>Mrs</Title>
</CustomerPms>
<CustomerPms>
<Age>61</Age>
<Arrival>ARR?</Arrival>
<ArrivalTime i:nil="true" />
<BirthDate i:nil="true" />
<Departure>DEP?</Departure>
<DepartureTime i:nil="true" />
<MusNo>96</MusNo>
<MusTakipNo></MusTakipNo>
<Name>SMEUR, ANTONIUS N</Name>
<Nationality></Nationality>
<NationalityString></NationalityString> <ReservationKeyField>H2S|0042|44|H2S|f3ba442b-9d2e-4315-b3ed-20224837fcde|e76e1cf7-0c8a-42d6-a163-65f8d848dff5|0|f01819aa-df05-48ec-8683-572eaa354ad0|16.9.2015 17:21:51</ReservationKeyField>
<Title>Mr</Title>
</CustomerPms>
</Customers>
<ExtraBed>0</ExtraBed>
<ExtraServices />
<FisNo>0</FisNo>
<FreeOfCharge>N</FreeOfCharge>
<HoneyMoon>N</HoneyMoon>
<HotelId>00000000-0000-0000-0000-000000000000</HotelId>
<HotelName>H2S Test Hotel</HotelName>
<Infants>0</Infants>
<KeyField>H2S|0042|44|H2S|f3ba442b-9d2e-4315-b3ed-20224837fcde|e76e1cf7-0c8a-42d6-a163-65f8d848dff5|0|f01819aa-df05-48ec-8683-572eaa354ad0|16.9.2015 17:21:51</KeyField>
<LastChangeUser>ADMIN</LastChangeUser>
<LogId>44</LogId>
<Nights>7</Nights>
<Note></Note>
<OriginalHotelCode>OTELL</OriginalHotelCode>
<Pax>2</Pax>
<PaximumId>100826</PaximumId>
<PmsStatus>0</PmsStatus>
<PromosyonRoom>N</PromosyonRoom>
<QuotaType>1</QuotaType>
<ReservationStatus>0</ReservationStatus>
<RoomCount>1</RoomCount>
<RoomId>DBL</RoomId>
<RoomName>DOUBLE ROOM (DBL)</RoomName>
<RoomNo i:nil="true" />
<RoomTypeId>STD</RoomTypeId>
<RoomTypeName>STANDARD ROOM (STD)</RoomTypeName>
<SejourHotelName>H2S TEST OTEL</SejourHotelName>
<SellDate i:nil="true" />
<ServiceId>f3ba442b-9d2e-4315-b3ed-20224837fcde</ServiceId>
<SoldCurrency>-</SoldCurrency>
<SoldPrice>0</SoldPrice>
<TourOpCode>H2S</TourOpCode>
<TourOpName>-</TourOpName>
<VoucherNo>0042</VoucherNo>
</ReservationPms>
</Data>
<Error>
<Code></Code>
<Message></Message>
</Error>
<InfoMessage>1 data item returned</InfoMessage>
<IsSuccessful>true</IsSuccessful>
</ServiceResultOfArrayOfReservationPms>
URL Parameters
| Parameter Name |
Bound |
Shape Definition |
Data Type |
Description |
| checkInStart |
yes |
URI |
datetime |
Otel giriş başlangıç tarihidir. tarih formatı : (mm.dd.yyyy) |
| checkInEnd |
yes |
URI |
datetime |
Otel giriş bitiş tarihidir.tarih formatı : (mm.dd.yyyy) |
| paximumId |
no |
URI |
int |
Otelinize ait olan hotel2sejour sistemindeki unique bir değer |
| agencyId |
no |
URI |
Guid |
Acente Id, gönderilmemesi durumunda tüm acente rezervasyonları listelenir. |
| status |
no |
URI |
string |
Bekleyen rezervasyonlar için gerekli bir alan değildir. Eğer gönderilecek ise; ‘W’ gönderilmesi gerekmektedir. |
| format |
no |
URI |
string |
response dönüş formatı Örnek:xml,json |
| IsSendRequired |
no |
URI |
bool |
True gönderilmesi durumunda “postsentlogids” metodu ile gönderilen rezervasyonlar bir değişiklik olmadığı sürece tekrar gönderilmez. |
CheckReservationFile
FileCode’a Göre Oluşturulan Otel Rezervasyon Listesinin Url Bilgisi :
Oluşturulan rezervasyon listesinin URL bilgisine “checkreservationfile” metodunu kullanarak ulaşabilirsiniz.
| Last Update Date: |
06.03.2017 |
| Method Adress |
/api/Pax/checkreservationfile |
| Method Type |
GET |
| Token Required |
YES |
Note : Parametre olarak gönderilen formata göre dosya içeriği oluşturulmuş ve url adresi cevap olarak dönmüştür.
Belirtilen url’den dosyayı indirebilirsiniz
Request Sample
http://admin.stage.hotel2sejour.com/api/pax/checkreservationfile?fileCode=25267891-4999-4949-b04c-9dda5626065f&format=xml
Response Sample
<ServiceResultOfArrayOfCheckReservationFile>
<Data/>
<Error>
<Code/>
<Message/>
</Error>
<InfoMessage>Reservation list is not ready</InfoMessage>
<IsSuccessful>false</IsSuccessful>
</ServiceResultOfArrayOfCheckReservationFile>
URL Parameters
| Parameter Name |
Bound |
Shape Definition |
Data Type |
Description |
| fileCode |
yes |
URI |
guid |
“getreservations” metodundan “FileCode” ile dönen Guid değer |
| format |
no |
URI |
string |
response dönüş formatı Örnek:xml,json |
4th Stage Confirm / Not Confirm
SendConfirmation
Konfirme veya Not Konfirme gönderme işlemleri : Otelinizin konfirme bekleyen rezervasyonlarına “sendconfirmation” metodunu kullanarak konfirme veya not konfirme verebilirsiniz
| Last Update Date: |
06.03.2017 |
| Method Adress |
/api/pax/sendconfirmation |
| Method Type |
GET |
| Token Required |
YES |
Note: 0 PmsStatus “0” (yeni gönderilen rezervasyon),”2” ( tekrar gönderilen rezervasyon - değişiklik) , “3” (Iptal) dönebilmektedir. W ConfirmationStatus “W” (beklemede) 0 ReservationStatus “0” (Ok), “1” (OnRequest), “2” (NoShow), “3”(GoShow), “4”(Option) dönebilmektedir. 1 “0” (Guarantee), “1” (Normal), “2” (OnRequest) dönebilmektedir.
H2S|0997063|1|ATHENA|f679b28f-eec8-495f-8720-5f47f5d19f13|99806343-6a9a-45d9-9e2f-cd7f2f69d1d6|0 Her rezervasyon için üretilen sendconfirmation metodu için gerekli bir alandır. N FreeOfCharge “N“ (hayır),”Y” (evet) dönebilmektedir. N PromosyonRoom “N“ (hayır),”Y” (evet) dönebilmektedir.
Request Sample
http://admin.stage.hotel2sejour.com/api/pax/sendconfirmation?keyField=H2S|0997063|1|ATHENA|f679b28f-eec8-495f-8720-5f47f5d19f13|99806343-6a9a-45d9-9e2f-cd7f2f69d1d6|0&AgencyId=a3e131e1-8818-4b2c-8144-b1651b92151a&paximumId=2222&confirmationStatus=H& notconfirmationNote=2508d966-56e6-46ff-b98d-13940f9f5ddb &pmsUser=test_deneme&format=xml
Response Sample
<ServiceResultOfArrayOfSendConfirmation>
<Data>
<SendConfirmation>
<KeyField>H2S|0997063|1|ATHENA|f679b28f-eec8-495f-8720-5f47f5d19f13|99806343-6a9a-45d9-9e2f-cd7f2f69d1d6|0</KeyField>
<Status>H</Status>
</SendConfirmation>
</Data>
<Error>
<Code/>
<Message/>
</Error>
<InfoMessage>1 data item returned</InfoMessage>
<IsSuccessful>true</IsSuccessful>
</ServiceResultOfArrayOfSendConfirmation>
URL Parameters
| Parameter Name |
Bound |
Shape Definition |
Data Type |
Description |
| agencyId |
yes |
URI |
Guid |
Acente Id |
| paximumId |
yes |
URI |
int |
Otelinize ait olan hotel2sejour sistemindeki unique bir değer |
| confirmationNote |
no |
URI |
string |
Konfirme edilen rezervasyonlar için gönderilecek note alanıdır.Önemli Not : 500 karakterden fazla olamaz. |
| confirmationStatus |
yes |
URI |
string |
Konfirme edilen rezervasyon için “E” Not Konfirme edilen rezervasyon için “H” Gönderilmelidr. |
| notconfirmationNote |
Sadece not konfirme gönderilen rezervasyonlarda zorunlu |
URI |
Guid |
Konfirme edilen rezervasyonlar için gönderilecek note bilgisidir. Önemli Not : “getnotconfirmmessages” metodundan dönen sonuçlardan birinin Idsi gönderilmelidir. |
| pmsUser |
no |
URI |
string |
İşlemi gerçekleştiren kullanıcının ismi |
| format |
no |
URI |
string |
response dönüş formatı Örnek:xml,json |
SendConfirmationV2
Note: Yukardaki sendconfirmation dan tek farkı response daki VoucherUrl dir.
VoucherUrl: Oluşturulan pdf in url i dir.
Response Sample
<ServiceResultOfArrayOfSendConfirmation>
<Data>
<SendConfirmation>
<KeyField>H2S|0997063|1|ATHENA|f679b28f-eec8-495f-8720-5f47f5d19f13|99806343-6a9a-45d9-9e2f-cd7f2f69d1d6|0</KeyField>
<Status>H</Status>
<VoucherUrl>http://tmp.voucherurl.com</VoucherUrl>
</SendConfirmation>
</Data>
<Error>
<Code/>
<Message/>
</Error>
<InfoMessage>1 data item returned</InfoMessage>
<IsSuccessful>true</IsSuccessful>
</ServiceResultOfArrayOfSendConfirmation>
5th Stage Control List
GetReservationList
Otel Rezervasyonlarının Hotel2sejour’dan Çekilmesi: Otelinizin Hotel2Sejour üzerinden konfirme edilmiş rezervasyonlarınızı “getReservationList” metodunu kullanarak çekebilirsiniz
| Last Update Date: |
06.03.2017 |
| Method Adress |
/api/pax/getReservationList |
| Method Type |
GET |
| Token Required |
YES |
Request Sample
http://admin.stage.hotel2sejour.com/api/pax/getReservationList?checkInStart=10.01.2014&checkInEnd=10.08.2014&agencyId=873B1E6A-C5D0-4E52-ABBD-634CC9CFF1D7&status=E&format=xml
Response Sample
<ServiceResultOfArrayOfPmsResListExceedNcCATIYq xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HotelWeb.Web.Framework">
<Data>
<PmsResListExceed xmlns="">
<FileCode>685a9d6d-ed1f-4ea3-a5fc-d26827afbe13</FileCode>
</PmsResListExceed>
</Data>
<Error>
<Code></Code>
<Message></Message>
</Error>
<InfoMessage>Reservation list limit is exceeded</InfoMessage>
<IsSuccessful>true</IsSuccessful>
</ServiceResultOfArrayOfPmsResListExceedNcCATIYq>
URL Parameters
| Parameter Name |
Bound |
Shape Definition |
Data Type |
Description |
| checkInStart |
yes |
URI |
datetime |
Otel giriş başlangıç tarihidir. tarih formatı : (mm.dd.yyyy) |
| checkInEnd |
yes |
URI |
datetime |
Otel giriş bitiş tarihidir.tarih formatı : (mm.dd.yyyy) |
| paximumId |
yes |
URI |
int |
Otelinize ait olan hotel2sejour sistemindeki unique bir değer |
| agencyId |
no |
URI |
Guid |
Acente Id, gönderilmemesi durumunda tüm acente rezervasyonları listelenir. |
| status |
yes |
URI |
string |
Bekleyen rezervasyonlar için gerekli bir alan değildir. Eğer gönderilecek ise; ‘W’ gönderilmesi gerekmektedir. |
| format |
no |
URI |
string |
response dönüş formatı Örnek:xml,json |
CheckReservationFile
FileCode’a Göre Oluşturulan Otel Rezervasyon Listesinin Url Bilgisi :
Oluşturulan rezervasyon listesinin URL bilgisine “checkreservationfile” metodunu kullanarak ulaşabilirsiniz
| Last Update Date: |
06.03.2017 |
| Method Adress |
/api/Pax/checkreservationfile |
| Method Type |
GET |
| Token Required |
YES |
Note : Parametre olarak gönderilen formata göre dosya içeriği oluşturulmuş ve url adresi cevap olarak dönmüştür.
Belirtilen url’den dosyayı indirebilirsiniz
Request Sample
http://admin.stage.hotel2sejour.com/api/pax/checkreservationfile?fileCode=25267891-4999-4949-b04c-9dda5626065f&format=xml
Response Sample(Dosya hazır değil ise)
<ServiceResultOfArrayOfCheckReservationFile>
<Data/>
<Error>
<Code/>
<Message/>
</Error>
<InfoMessage>Reservation list is not ready</InfoMessage>
<IsSuccessful>false</IsSuccessful>
</ServiceResultOfArrayOfCheckReservationFile>
Response Sample(Dosya hazır ise)
<ServiceResultOfArrayOfCheckReservationFile>
<Data>
<CheckReservationFile>
<FileUrl>http://uploads.stage.hotel2sejour.com/temp/25267891-4999-4949-b04c-9dda5626065f.txt</FileUrl>
</CheckReservationFile>
</Data>
<Error>
<Code/>
<Message/>
</Error>
<InfoMessage>1 data item returned</InfoMessage>
<IsSuccessful>true</IsSuccessful>
</ServiceResultOfArrayOfCheckReservationFile>
URL Parameters
| Parameter Name |
Bound |
Shape Definition |
Data Type |
Description |
| fileCode |
yes |
URI |
guid |
“getreservations” metodundan “FileCode” ile dönen Guid değer |
| format |
no |
URI |
string |
response dönüş formatı Örnek:xml,json |
GetReservationList-PostSentLogIds
GetReservationList metodu ile çekilen rezervasyonların bildirimi:
“postsentlogids” metodu ile bildirilen rezervasyonlar bir değişiklik olmadığı sürece “getreservationList” metodu ile birdaha gönderilmez
| Last Update Date: |
06.03.2017 |
| Method Adress |
/api/Pax/postsentlogids |
| Method Type |
POST |
| Token Required |
YES |
Note : İstek başarılı bir şekilde post edilirse response True dönecektir
Request Sample
http://admin.stage.hotel2sejour.com/api/pax/postsentlogids?serviceId=25267891-4999-4949-b04c-9dda5626065f
Response Sample(Dosya hazır değil ise)
<ServiceResultOfArrayOfCheckReservationFile>
<Data/>
<Error>
<Code/>
<Message/>
</Error>
<InfoMessage>Reservation list is not ready</InfoMessage>
<IsSuccessful>false</IsSuccessful>
</ServiceResultOfArrayOfCheckReservationFile>
Response Sample(Dosya hazır ise)
<ServiceResultOfArrayOfCheckReservationFile>
<Data>
<CheckReservationFile>
<FileUrl>http://uploads.stage.hotel2sejour.com/temp/25267891-4999-4949-b04c-9dda5626065f.txt</FileUrl>
</CheckReservationFile>
</Data>
<Error>
<Code/>
<Message/>
</Error>
<InfoMessage>1 data item returned</InfoMessage>
<IsSuccessful>true</IsSuccessful>
</ServiceResultOfArrayOfCheckReservationFile>
URL Parameters
| Parameter Name |
Bound |
Shape Definition |
Data Type |
Description |
| serviceId |
yes |
URI |
guid |
“getreservationList” metodundan dönen “ServiceId” alanındaki Guid değer |
| logIds |
no |
body |
string |
“getreservationList” metodundan dönen “LogId” alanındaki int değer |