# Otel factsheet çözümü

> URL: https://hotelmapping.org/tr/urunler/otel-factsheet-cozumu/ · Dil: Türkçe

Otel factsheet, bir otelin temel bilgilerini serbest metin yerine ayrı ve filtrelenebilir alanlarda verir: tesis tipi, yıldız, oda sayısı, giriş-çıkış saatleri, plaj ve havuzlar, çocuk ve evcil hayvan politikası, restoranlar ve iletişim bilgileri. Tüm tedarikçilerden gelen bilgi otelin HM ID'si altında birleşir, çelişen değerler işaretlenir; veri API ve dump dosyalarıyla teslim edilir.

## Neler kazanırsınız

- **Filtrelemeye hazır:** Giriş saati, çocuk politikası, plaj tipi ve oda sayısı ayrı alan olduğu için filtre ve karşılaştırmada doğrudan kullanılır.
- **Tek otel, tek doğru:** Bir otelin tüm tedarikçilerdeki bilgisi tek HM ID altında toplanır. Otel sayfası hangi tedarikçiden gelindiğine göre değişmez.
- **Çelişkiler görünür:** Tedarikçiler aynı alan için farklı değer verdiğinde alan işaretlenir. Hangi bilginin kontrol beklediğini yanıtta görürsünüz.
- **Açıklamalarla tutarlı:** Otel açıklamaları aynı factsheet verisinden üretilir; metin ile alanlar birbiriyle çelişmez.

## Önce ve sonra

İki tedarikçiden gelen ham tesis bilgisi

**supplier_facts.txt**

```text
[A / HTL-88213]
Check-in 14:00 / Check-out 12:00. 412 rooms. Private sandy
beach 250m. 3 outdoor pools, 1 indoor pool. Kids 0-6.99 free.
Pets not allowed.

[B / 40917]
Giriş: 15.00, Çıkış: 12.00 - 410 oda - Otele ait kum plaj
(250 mt) - Açık havuz x3 - Çocuk 0-7 yaş arası ücretsiz
```

HM ID altında standart factsheet

**HM-1048213 factsheet**

```json
{
  "hm_id": "HM-1048213",
  "factsheet": {
    "check_in": "14:00",
    "check_out": "12:00",
    "room_count": 412,
    "beach": { "type": "sand", "private": true, "distance_m": 250 },
    "pools": { "outdoor": 3, "indoor": 1 },
    "child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
    "pets_allowed": false,
    "review_flags": ["check_in", "room_count"]
  }
}
```

_Örnek veridir; otel ve kodlar gerçek bir tesise ait değildir. Tedarikçilerin çeliştiği alanlar (burada giriş saati ve oda sayısı) review_flags ile işaretlenir._

## Nasıl çalışır

1. **Kaynakları birleştirme:** Aynı HM ID'ye bağlı tüm tedarikçi kayıtlarındaki otel bilgileri bir araya getirilir. Ham veri olduğu gibi saklanır, değişiklikler sürümlenir.
2. **Alanlara ayırma:** Serbest metindeki saatler, sayılar, mesafeler ve politikalar ayrı alanlara dönüştürülür; saat, mesafe ve yaş biçimleri standartlaştırılır.
3. **Çelişki kontrolü:** Kaynaklar farklı bilgi verdiğinde değerler karşılaştırılır. Belirsiz alanlar işaretlenir ve veri ekibinin kontrol kuyruğuna düşer.
4. **Teslim ve güncelleme:** Factsheet GET /v1/hotels/{hm_id}/content ucundan döner; tüm envanter günlük tam ve delta dump dosyalarında gelir.

## API örneği

**Factsheet isteği**

```bash
curl "https://api.hotelmapping.org/v1/hotels/HM-1048213/content?include=factsheet" \
  -H "X-API-Key: $HM_API_KEY"
```

**200 OK**

```json
{
  "hm_id": "HM-1048213",
  "factsheet": {
    "property": { "type": "resort", "stars": 5, "room_count": 412 },
    "policies": {
      "check_in": "14:00",
      "check_out": "12:00",
      "child_policy": { "free_from_age": 0, "free_to_age": 6.99 },
      "pets_allowed": false
    },
    "beach": { "type": "sand", "private": true, "distance_m": 250 },
    "pools": { "outdoor": 3, "indoor": 1 },
    "dining": [
      { "type": "restaurant", "cuisine": "turkish" },
      { "type": "bar", "location": "pool" }
    ],
    "contact": { "email": "info@sunsetbay.example" },
    "review_flags": ["check_in", "room_count"]
  },
  "updated_at": "2026-11-02T08:14:00Z"
}
```

_Kod örnekleri temsilidir; alan adları v1 yayınında değişebilir._

## Factsheet neden ayrı alanlarda?

Tedarikçiler otel bilgilerini çoğu zaman serbest metin içinde gönderir. Bir tedarikçi giriş saatini 14:00, diğeri 15:00 yazar; biri 412 oda der, öteki 410. Plaj bilgisi bir cümlenin içinde kaybolur, çocuk yaş sınırı farklı biçimlerde gelir. Bu hâliyle "otele ait kum plajı olan oteller" veya "0–6 yaş çocuğu ücretsiz olanlar" filtresi kurulamaz.

Otel factsheet bu bilgileri ayrı alanlara çıkarır ve otelin [HM ID](https://hotelmapping.org/tr/sozluk/hm-id/)'sine bağlar. Bunun ön koşulu oteli doğru eşleştirmektir; yöntemi [otel eşleştirme rehberinde](https://hotelmapping.org/tr/rehber/otel-eslestirme-nedir/), ürünü [otel eşleştirme](https://hotelmapping.org/tr/urunler/otel-eslestirme-cozumu/) sayfasında bulabilirsiniz.

## Factsheet alanları

| Grup | Alanlar | Örnek değer |
| --- | --- | --- |
| Tesis bilgileri | Tesis tipi, yıldız, zincir ve marka, oda ve kat sayısı, açılış ve yenilenme yılı | Resort, 5 yıldız, 412 oda |
| Politikalar | Giriş-çıkış saati; çocuk, evcil hayvan, sigara ve ödeme politikası | 14:00 / 12:00, 0–6,99 yaş ücretsiz |
| Plaj ve havuz | Plaj tipi, otele ait olup olmadığı, mesafe; açık ve kapalı havuz sayısı | Kum, otele ait, 250 m; 3 açık, 1 kapalı |
| Yeme-içme | Restoranlar, barlar, mutfak türleri, açılış saatleri | Türk mutfağı restoranı, havuz barı |
| İletişim ve adres | Doğrulanmış adres, telefon, e-posta, web sitesi | info@sunsetbay.example |

Alan adları ve değerler dilden bağımsızdır; arayüzde kendi dilinizdeki etiketi gösterirsiniz.

## Çelişen bilgiler

Aynı otel için tedarikçiler farklı değer verdiğinde değerler karşılaştırılır. Belirsiz kalan alanlar `review_flags` ile işaretlenir ve veri ekibi tarafından kontrol edilir. Böylece hangi bilginin kesin, hangisinin kontrol beklediğini yanıttan görürsünüz.

## Açıklamalar ve teslim

[Otel açıklamaları](https://hotelmapping.org/tr/urunler/otel-aciklamalari-cozumu/) aynı factsheet verisinden üretilir; metinde geçen bir saat veya mesafe, alandaki değerle çelişmez. Otelin fotoğraf galerisi ise [otel resimleri](https://hotelmapping.org/tr/urunler/otel-resimleri-cozumu/) hizmetindedir; factsheet'te plajı olan bir otelde plaj etiketli resim yoksa içerik ekibine uyarı üretebilirsiniz.

Factsheet otel bazında REST API ile, tüm envanter için günlük tam ve [delta dump](https://hotelmapping.org/tr/sozluk/delta-dump/) dosyalarıyla teslim edilir. Örnekteki `include` parametresi ve alan adları API v1 taslağıdır; kesin şema [geliştirici sayfasında](https://hotelmapping.org/tr/gelistiriciler/) yayımlanır. Kapsam ve fiyat için [teklif alabilirsiniz](https://hotelmapping.org/tr/teklif-al/).

## Sık sorulan sorular

### Otel factsheet nedir?

Bir otelin temel bilgilerinin (tesis tipi, yıldız, oda sayısı, giriş-çıkış saatleri, politikalar, yeme-içme, iletişim) yapılandırılmış alanlar hâlinde sunulmasıdır.

### Factsheet ile otel açıklaması arasındaki fark nedir?

Açıklama okunmak için yazılmış metindir; factsheet ise filtreleme ve karşılaştırma için ayrı alanlardır. İkisi de aynı doğrulanmış veriye dayanır.

### Tedarikçiler farklı bilgi verirse hangisi kullanılır?

Değerler karşılaştırılır; belirsiz kalan alanlar işaretlenir ve veri ekibi tarafından kontrol edilir. Yanıtta hangi alanların kontrol beklediği review_flags ile görünür.

### Factsheet verisini hangi biçimlerde alabilirim?

Otel bazında REST API ile ya da tüm envanter için günlük tam ve delta dump dosyalarıyla (CSV, JSON). Değişiklik bildirimi için webhook planlanıyor.

## İlgili ürünler

- [Otel açıklamaları çözümü](https://hotelmapping.org/tr/urunler/otel-aciklamalari-cozumu/)
- [Otel eşleştirme çözümü](https://hotelmapping.org/tr/urunler/otel-eslestirme-cozumu/)
- [Otel resimleri çözümü](https://hotelmapping.org/tr/urunler/otel-resimleri-cozumu/)

## İlgili makaleler

- [Otel XML entegrasyonu nedir? Statik ve dinamik veri farkı](https://hotelmapping.org/tr/rehber/otel-xml-entegrasyonu-nedir/)
- [Otel eşleştirme (hotel mapping) nedir? Nasıl çalışır? Kapsamlı rehber](https://hotelmapping.org/tr/rehber/otel-eslestirme-nedir/)
- [Mükerrer otel listelemenin acenteye maliyeti: dönüşüm, iptal ve müşteri şikâyeti](https://hotelmapping.org/tr/rehber/mukerrer-otel-maliyeti/)
