> ## Documentation Index
> Fetch the complete documentation index at: https://docs.robotpos.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Veri Türleri ve Rapor Tipleri

> Realtime Service API'de kullanılan veri türleri ve rapor tipleri

# Veri Türleri ve Rapor Tipleri

<Info>
  Bu sayfada Realtime Service API'de kullanılan veri türleri ve rapor tipleri hakkında detaylı bilgi bulabilirsiniz. API'yi daha verimli kullanmak için uygun rapor tipini seçmeniz önemlidir.
</Info>

## Rapor Tipleri

Realtime Service API, farklı iş ihtiyaçlarını karşılamak için çeşitli rapor tipleri sunar. Her rapor tipi belirli bir veri kümesini döndürür ve bazı rapor tipleri için belirli parametreler gereklidir.

<Tip>
  Aşağıdaki tabloda tüm rapor tipleri ve gerektirdikleri parametreler listelenmiştir. İhtiyacınıza uygun rapor tipini seçerek API'yi daha verimli kullanabilirsiniz.
</Tip>

| Type Kodu | Rapor Adı                      | Açıklama                                                                                        | Gerekli Parametreler                    |
| :-------: | ------------------------------ | ----------------------------------------------------------------------------------------------- | --------------------------------------- |
|  **101**  | **Şube Listesi**               | Tüm şubelerin detaylı listesi ve bilgileri (Branches\_json)                                     | -                                       |
|  **102**  | **Grup Satışları**             | Ürün gruplarına göre satış analizleri (GroupSales)                                              | BranchCode, StartDate, EndDate          |
|  **103**  | **Ödemeler**                   | Ödeme yöntemlerine göre detaylı ödeme raporları (Payments)                                      | BranchCode, StartDate, EndDate, All     |
|  **104**  | **Tüketim Belgeleri**          | Tüketim belgelerinin detaylı listesi (PosFinansConsumptionDocuments\_json)                      | BranchCodeString, StartDate, EndDate    |
|  **105**  | **Cari Listesi**               | Tüm cari hesapların kapsamlı listesi (PosFinansCurrents\_json)                                  | -                                       |
|  **106**  | **Stok Sayım Belgeleri**       | Stok sayım belgeleri ve sonuçları (PosFinansInventoryCountDocuments\_json)                      | WarehouseCodeString, StartDate, EndDate |
|  **107**  | **Üretim Formülleri**          | Üretim formüllerinin detaylı listesi (PosFinansManafactureFormulas\_json)                       | -                                       |
|  **108**  | **Manuel Tüketim Belgeleri**   | Manuel olarak girilen tüketim belgeleri (PosFinansManuelConsumptionDocuments\_json)             | BranchCodeString, StartDate, EndDate    |
|  **109**  | **Ürün Listesi**               | Tüm ürünlerin detaylı listesi (PosFinansProductList\_json)                                      | -                                       |
|  **110**  | **Satın Alma Faturaları**      | Tedarikçilerden alınan fatura belgeleri (PosFinansPurchaseInvoiceDocuments\_json)               | StartDate, EndDate                      |
|  **111**  | **Satın Alma İade Faturaları** | Tedarikçilere yapılan iade faturaları (PosFinansPurchaseInvoiceReturnDocuments\_json)           | StartDate, EndDate                      |
|  **112**  | **Satış Faturaları**           | Müşterilere kesilen satış faturaları (PosFinansSaleInvoiceDocuments\_json)                      | StartDate, EndDate                      |
|  **113**  | **Yarı Mamül Belgeleri**       | Yarı mamül üretim ve tüketim belgeleri (PosFinansSemiFinishedDocuments\_json)                   | StartDate, EndDate                      |
|  **114**  | **Stok Giriş Fişleri**         | Stok giriş hareketlerini gösteren belgeler (PosFinansStockRecordEntryDocuments\_json)           | StartDate, EndDate                      |
|  **115**  | **Stok Çıkış Fişleri**         | Stok çıkış hareketlerini gösteren belgeler (PosFinansStockRecordIssueDocuments\_json)           | StartDate, EndDate                      |
|  **116**  | **Depo Listesi**               | Tüm depoların detaylı listesi ve bilgileri (PosFinansWarehouses\_json)                          | -                                       |
|  **117**  | **Depo Transfer Belgeleri**    | Depolar arası stok transferlerini gösteren belgeler (PosFinansWarehouseTransferDocuments\_json) | BranchCodeString, StartDate, EndDate    |
|  **118**  | **Ürün Satış Detayları**       | Ürün bazında detaylı satış analizleri (ProductSales\_json)                                      | BranchCode, StartDate, EndDate, All     |
|  **119**  | **İptal Edilen Satışlar**      | İptal edilmiş satışların detaylı listesi (Voids\_json)                                          | BranchCode, StartDate, EndDate          |
|  **255**  | **Ürün Detaylı Satışlar**      | Ürün bazında kapsamlı satış analizleri                                                          | BranchCode, StartDate, EndDate          |

## Rapor Kategorileri

Rapor tipleri işlevlerine göre aşağıdaki kategorilere ayrılabilir:

<div className="grid grid-cols-1 md:grid-cols-2 gap-4">
  <div className="p-4 border rounded-lg shadow-sm">
    <h3 className="text-lg font-semibold">Satış Raporları</h3>

    <ul className="list-disc pl-5">
      <li>102 - Grup Satışları</li>
      <li>118 - Ürün Satış Detayları</li>
      <li>255 - Ürün Detaylı Satışlar</li>
      <li>119 - İptal Edilen Satışlar</li>
    </ul>
  </div>

  <div className="p-4 border rounded-lg shadow-sm">
    <h3 className="text-lg font-semibold">Stok Raporları</h3>

    <ul className="list-disc pl-5">
      <li>106 - Stok Sayım Belgeleri</li>
      <li>114 - Stok Giriş Fişleri</li>
      <li>115 - Stok Çıkış Fişleri</li>
      <li>117 - Depo Transfer Belgeleri</li>
    </ul>
  </div>

  <div className="p-4 border rounded-lg shadow-sm">
    <h3 className="text-lg font-semibold">Fatura Raporları</h3>

    <ul className="list-disc pl-5">
      <li>110 - Satın Alma Faturaları</li>
      <li>111 - Satın Alma İade Faturaları</li>
      <li>112 - Satış Faturaları</li>
    </ul>
  </div>

  <div className="p-4 border rounded-lg shadow-sm">
    <h3 className="text-lg font-semibold">Referans Veriler</h3>

    <ul className="list-disc pl-5">
      <li>101 - Şube Listesi</li>
      <li>105 - Cari Listesi</li>
      <li>109 - Ürün Listesi</li>
      <li>116 - Depo Listesi</li>
    </ul>
  </div>
</div>

## Parametre Türleri

<Note>
  API isteklerinde kullanılan parametrelerin türleri ve formatları aşağıda açıklanmıştır.
</Note>

| Parametre               | Tür     | Format                 | Örnek                              |
| ----------------------- | ------- | ---------------------- | ---------------------------------- |
| **Type**                | Integer | 101-255 arası değerler | `101`                              |
| **StartDate**           | String  | YYYY-MM-DD HH:MM:SS    | `"2025-05-01 00:00:00"`            |
| **EndDate**             | String  | YYYY-MM-DD HH:MM:SS    | `"2025-05-05 23:59:59"`            |
| **BranchCode**          | String  | Şube kodu veya kodları | `"0"` veya `"222,111"` veya `"12"` |
| **All**                 | Integer | 0 veya 1               | `1`                                |
| **BranchCodeString**    | String  | Şube kodu veya kodları | `"222,111"`                        |
| **WarehouseCodeString** | String  | Depo kodu veya kodları | `"100,200,300"`                    |

## Örnek Veri Yapıları

<Tip>
  Aşağıda bazı rapor tiplerinin döndürdüğü veri yapılarının örnekleri verilmiştir.
</Tip>

### Şube Listesi (Type: 101)

```json theme={null}
{
  "data": [
    {
      "BranchID": 222,
      "BranchName": "Merkez Şube",
      "Address": "Ankara Cad. No:1",
      "Phone": "0212 555 1234",
      "IsActive": 1
    },
    {
      "BranchID": 111,
      "BranchName": "Kadıköy Şube",
      "Address": "Bağdat Cad. No:42",
      "Phone": "0216 333 5678",
      "IsActive": 1
    }
  ],
  "totalRows": 2,
  "affectedRows": 0,
  "timestamp": "2025-05-04T14:30:45.123Z",
  "execution_time": 0.021
}
```

### Grup Satışları (Type: 102)

```json theme={null}
{
  "data": [
    {
      "GroupID": 1,
      "GroupName": "İçecekler",
      "TotalSales": 12500.50,
      "ItemCount": 350,
      "AvgPrice": 35.72
    },
    {
      "GroupID": 2,
      "GroupName": "Ana Yemekler",
      "TotalSales": 28750.75,
      "ItemCount": 425,
      "AvgPrice": 67.65
    }
  ],
  "totalRows": 2,
  "affectedRows": 0,
  "timestamp": "2025-05-04T14:35:12.456Z",
  "execution_time": 0.035
}
```

## Veri Tipleri ve Dönüşümler

<Warning>
  API'den dönen verilerin doğru şekilde işlenebilmesi için aşağıdaki veri tipi dönüşümlerine dikkat edilmelidir.
</Warning>

| JSON Veri Tipi | Açıklama                                | Örnek Dönüşüm (JavaScript)                            |
| -------------- | --------------------------------------- | ----------------------------------------------------- |
| **String**     | Metin verisi                            | `const name = data.BranchName;`                       |
| **Number**     | Sayısal değer (tam sayı veya ondalıklı) | `const total = parseFloat(data.TotalSales);`          |
| **Boolean**    | Mantıksal değer (0/1)                   | `const isActive = data.IsActive === 1;`               |
| **Array**      | Dizi                                    | `const items = data.data;`                            |
| **Object**     | Nesne                                   | `const branch = data.data[0];`                        |
| **null**       | Boş değer                               | `const value = data.Value === null ? 0 : data.Value;` |

## Rapor Tipi Seçim Kılavuzu

<Check>
  Aşağıdaki sorulara vereceğiniz cevaplara göre ihtiyacınıza uygun rapor tipini belirleyebilirsiniz:
</Check>

1. **Satış verileri mi arıyorsunuz?**
   * Ürün grubu bazında satışlar → **102**
   * Ürün bazında detaylı satışlar → **118** veya **255**
   * İptal edilen satışlar → **119**

2. **Stok hareketleri mi arıyorsunuz?**
   * Stok sayım sonuçları → **106**
   * Stok giriş hareketleri → **114**
   * Stok çıkış hareketleri → **115**
   * Depolar arası transferler → **117**

3. **Fatura bilgileri mi arıyorsunuz?**
   * Satın alma faturaları → **110**
   * Satın alma iade faturaları → **111**
   * Satış faturaları → **112**

4. **Referans veriler mi arıyorsunuz?**
   * Şube listesi → **101**
   * Cari hesap listesi → **105**
   * Ürün listesi → **109**
   * Depo listesi → **116**