Otel eşleştirme çözümü
Her tesise kalıcı bir HM ID; tedarikçi kodları ve çapraz ID'ler tek kayıtta.
Pansiyon tipi eşleştirme, tedarikçilerin aynı yeme-içme konsepti için gönderdiği farklı yazımları ("ALL INCLUSIVE ULTRA", "Ultra Herşey Dahil", "Ультра всё включено") tek bir standart koda çevirir: RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI veya SAI. Böylece her şey dahil bir teklif ultra her şey dahil bir teklifle aynı ürünmüş gibi karşılaştırılmaz.
{
"hm_id": "HM-1048213",
"boards": [
{ "supplier": "A", "input": "ALL INCLUSIVE ULTRA", "code": "UAI" },
{ "supplier": "B", "input": "Ultra Herşey Dahil", "code": "UAI" },
{ "supplier": "C", "input": "Ультра всё включено", "code": "UAI" },
{ "supplier": "A", "input": "Half Board Plus", "code": "HB+" },
{ "supplier": "B", "input": "Yarım Pansiyon + İçecek", "code": "HB+" },
{ "supplier": "C", "input": "Soft All Inc.", "code": "SAI" }
]
} AI ve UAI teklifleri ayrı kodlarda kalır. Daha ucuz görünen teklifin aslında daha düşük bir konsept olduğu listede açıkça görülür.
RO, BB, HB, HB+, FB, FB+, AI, AI+, UAI ve SAI. Tüm tedarikçi yazımları bu kısa listeye bağlanır; filtreler ve raporlar tek listeyle çalışır.
Türkçe, İngilizce, Almanca ve Rusça yazımlar, yazım hataları ve kısaltmalar sözlükte tutulur: "Herşey Dahil", "Halbpension", "Полупансион".
Sözlükte olmayan bir yazım benzerlik skoruyla bir koda önerilir ve uzman onayından sonra sözlüğe eklenir. Bir kez onaylanan yazım bir daha sorulmaz.
Ultra her şey dahil, soft her şey dahil ve içecekli yarım pansiyon gibi, özellikle Türkiye ve Akdeniz resortlarında yaygın konseptler ayrı kodlarla karşılanır.
Aynı otel için üç tedarikçiden gelen pansiyon yazımları
supplier,hotel_code,rate_code,board
A,HTL-88213,R1,ALL INCLUSIVE ULTRA
B,40917,UAI,Ultra Herşey Dahil
C,TR-ANT-551,UAI-1,Ультра всё включено
A,HTL-88213,R2,Half Board Plus
B,40917,HBP,Yarım Pansiyon + İçecek
C,TR-ANT-551,SAI,Soft All Inc. Standart pansiyon kodları
{
"hm_id": "HM-1048213",
"boards": [
{ "supplier": "A", "input": "ALL INCLUSIVE ULTRA", "code": "UAI" },
{ "supplier": "B", "input": "Ultra Herşey Dahil", "code": "UAI" },
{ "supplier": "C", "input": "Ультра всё включено", "code": "UAI" },
{ "supplier": "A", "input": "Half Board Plus", "code": "HB+" },
{ "supplier": "B", "input": "Yarım Pansiyon + İçecek", "code": "HB+" },
{ "supplier": "C", "input": "Soft All Inc.", "code": "SAI" }
]
} Örnek veridir; otel ve kodlar gerçek bir tesise ait değildir.
Gelen yazım küçük harfe çevrilir; noktalama, fazla boşluk ve "Inc.", "Incl." gibi kısaltmalar açılır. "Herşey" ve "Her Şey" aynı biçime getirilir.
Normalleştirilmiş yazım, her dildeki eş anlamlılar sözlüğünde aranır. Bulunursa doğrudan standart koda bağlanır.
Sözlükte olmayan yazımlar için en yakın kod bir benzerlik skoruyla önerilir. Skor ve yöntem (sözlük veya benzerlik) yanıtta birlikte döner.
Emin olunmayan öneriler kontrol kuyruğuna düşer. Onaylanan yazım sözlüğe eklenir ve bir sonraki istekte doğrudan eşleşir.
Standart kod API yanıtında anında döner. Tedarikçinin gönderdiği orijinal yazım da saklanır, böylece gerektiğinde geriye dönük kontrol yapılabilir.
Pansiyon tipi, otel fiyatını en çok değiştiren alanlardan biridir. Buna rağmen tedarikçiler onu çoğu zaman serbest metin olarak ve kendi dilleriyle gönderir. Sorun en belirgin hâliyle, her şey dahil konseptlerin yaygın olduğu Türkiye ve Akdeniz gibi resort pazarlarında görülür ve dört biçimde ortaya çıkar:
| Kod | Anlamı | Tedarikçide görülen yazımlar |
|---|---|---|
| RO | Sadece oda | Room Only, Sadece Oda, Ohne Verpflegung, Без питания |
| BB | Oda kahvaltı | Bed & Breakfast, Oda Kahvaltı, Frühstück, Завтрак |
| HB | Yarım pansiyon | Half Board, Yarım Pansiyon, Halbpension, Полупансион |
| HB+ | Yarım pansiyon + içecek | Half Board Plus, HB Plus, Yarım Pansiyon + İçecek |
| FB | Tam pansiyon | Full Board, Tam Pansiyon, Vollpension, Полный пансион |
| FB+ | Tam pansiyon + içecek | Full Board Plus, Tam Pansiyon Plus |
| AI | Her şey dahil | All Inclusive, Her Şey Dahil, Herşey Dahil, Всё включено |
| AI+ | Genişletilmiş her şey dahil | All Inclusive Plus, AI Plus, Her Şey Dahil Plus |
| UAI | Ultra her şey dahil | Ultra All Inclusive, Ultra Herşey Dahil, Ультра всё включено |
| SAI | Sınırlı her şey dahil | Soft All Inclusive, Soft AI, Soft Her Şey Dahil |
Kodların ayrıntılı anlatımı pansiyon tipleri rehberinde, AI ile UAI farkı her şey dahil ve ultra her şey dahil farkı yazısındadır. Terim için pansiyon tipi sözlük sayfasına bakabilirsiniz.
Birçok eşleştirme sağlayıcısında pansiyon tipi ayrı bir ürün olarak sunulmaz. hotelmapping.org’da ise pansiyon tipi eşleştirme kendi sözlüğü ve kontrol kuyruğu olan ayrı bir üründür; teklif alırken ayrı bir modül olarak seçebilirsiniz.
Pansiyon tipi eşleştirme yazımı standart koda çevirir. Bir otelin ultra konseptinde hangi içeceklerin hangi saatlerde sunulduğu ise otelin kendi tanımıdır; pansiyon kodunun değil, otel açıklamasının konusudur. Otel açıklamaları için otel içeriği ürününe bakabilirsiniz. Doğru fiyat karşılaştırması için pansiyon kodu, otel eşleştirme ve oda eşleştirme ile birlikte çalışır. Genel çerçeve için otel eşleştirme rehberine, tek bir yazımı denemek için pansiyon kodu çeviriciye bakabilirsiniz.
İstek
curl -X POST https://api.hotelmapping.org/v1/boards/map \
-H "X-API-Key: $HM_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"hm_id": "HM-1048213",
"values": ["Soft All Inc.", "Ultra Herşey Dahil Plus"]
}' Yanıt
{
"results": [
{
"input": "Soft All Inc.",
"code": "SAI",
"score": 0.99,
"decision": "auto_match",
"method": "dictionary"
},
{
"input": "Ultra Herşey Dahil Plus",
"code": "UAI",
"score": 0.88,
"decision": "review",
"method": "similarity"
}
]
} Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir.
AI (her şey dahil) genellikle yemekleri ve yerli içecekleri kapsar. UAI (ultra her şey dahil) buna genellikle ithal içecekler veya à la carte restoran gibi ek hizmetler ekler. Kapsam otelden otele değişir; biz konsepti standart koda çeviririz, konseptin içeriğini otel belirler.
Soft AI ayrı bir kod olan SAI'ye eşleşir. Genellikle her şey dahilin daha sınırlı bir biçimidir; ör. alkollü içecekler hiç sunulmaz ya da belirli saatlerle sınırlıdır. AI veya FB+ olarak kaydedilmesi fiyat karşılaştırmasını bozar.
Half Board Plus (HB+) yarım pansiyona içecek ekler; genellikle akşam yemeğinde yerli içecekler dahildir, kapsam otelden otele değişir. Bir tedarikçi bunu yalnız HB olarak gönderirse içecek bilgisi kaybolur; standart kod bu farkı korur.
Birçok eşleştirme sağlayıcısında pansiyon tipi ayrı bir ürün olarak sunulmaz. hotelmapping.org'da ise pansiyon tipi eşleştirme ayrı bir üründür ve otel ve oda eşleştirmesiyle birlikte çalışır.
Evet. Ücretsiz pansiyon kodu çevirici aracına "Ultra Herşey Dahil Plus" gibi bir yazım girip hangi standart koda eşleştiğini görebilirsiniz.
Teklif al
Talebinizi üç adımda gönderin; teklifi iş e-postanıza iletelim. Talep bağlayıcı değildir.