​
Veri Türleri ve Rapor Tipleri

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.

​
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.
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.
Type KoduRapor AdıAçıklamaGerekli Parametreler
101Şube ListesiTüm şubelerin detaylı listesi ve bilgileri (Branches_json)-
102Grup 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
104Tüketim BelgeleriTüketim belgelerinin detaylı listesi (PosFinansConsumptionDocuments_json)BranchCodeString, StartDate, EndDate
105Cari ListesiTüm cari hesapların kapsamlı listesi (PosFinansCurrents_json)-
106Stok Sayım BelgeleriStok sayım belgeleri ve sonuçları (PosFinansInventoryCountDocuments_json)WarehouseCodeString, StartDate, EndDate
107Üretim FormülleriÜretim formüllerinin detaylı listesi (PosFinansManafactureFormulas_json)-
108Manuel Tüketim BelgeleriManuel olarak girilen tüketim belgeleri (PosFinansManuelConsumptionDocuments_json)BranchCodeString, StartDate, EndDate
109Ürün ListesiTüm ürünlerin detaylı listesi (PosFinansProductList_json)-
110Satın Alma FaturalarıTedarikçilerden alınan fatura belgeleri (PosFinansPurchaseInvoiceDocuments_json)StartDate, EndDate
111Satın Alma İade FaturalarıTedarikçilere yapılan iade faturaları (PosFinansPurchaseInvoiceReturnDocuments_json)StartDate, EndDate
112Satış FaturalarıMüşterilere kesilen satış faturaları (PosFinansSaleInvoiceDocuments_json)StartDate, EndDate
113Yarı Mamül BelgeleriYarı mamül üretim ve tüketim belgeleri (PosFinansSemiFinishedDocuments_json)StartDate, EndDate
114Stok Giriş FişleriStok giriş hareketlerini gösteren belgeler (PosFinansStockRecordEntryDocuments_json)StartDate, EndDate
115Stok Çıkış FişleriStok çıkış hareketlerini gösteren belgeler (PosFinansStockRecordIssueDocuments_json)StartDate, EndDate
116Depo ListesiTüm depoların detaylı listesi ve bilgileri (PosFinansWarehouses_json)-
117Depo Transfer BelgeleriDepolar 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ış analizleriBranchCode, StartDate, EndDate

​
Rapor Kategorileri

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

​
Satış Raporları

  • 102 - Grup Satışları
  • 118 - Ürün Satış Detayları
  • 255 - Ürün Detaylı Satışlar
  • 119 - İptal Edilen Satışlar

​
Stok Raporları

  • 106 - Stok Sayım Belgeleri
  • 114 - Stok Giriş Fişleri
  • 115 - Stok Çıkış Fişleri
  • 117 - Depo Transfer Belgeleri

​
Fatura Raporları

  • 110 - Satın Alma Faturaları
  • 111 - Satın Alma İade Faturaları
  • 112 - Satış Faturaları

​
Referans Veriler

  • 101 - Şube Listesi
  • 105 - Cari Listesi
  • 109 - Ürün Listesi
  • 116 - Depo Listesi

​
Parametre Türleri

API isteklerinde kullanılan parametrelerin türleri ve formatları aşağıda açıklanmıştır.
ParametreTürFormatÖrnek
TypeInteger101-255 arası değerler101
StartDateStringYYYY-MM-DD HH:MM:SS"2025-05-01 00:00:00"
EndDateStringYYYY-MM-DD HH:MM:SS"2025-05-05 23:59:59"
BranchCodeStringŞube kodu veya kodları"0" veya "222,111" veya "12"
AllInteger0 veya 11
BranchCodeStringStringŞube kodu veya kodları"222,111"
WarehouseCodeStringStringDepo kodu veya kodları"100,200,300"

​
Örnek Veri Yapıları

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

​
Şube Listesi (Type: 101)

{
  "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)

{
  "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

API’den dönen verilerin doğru şekilde işlenebilmesi için aşağıdaki veri tipi dönüşümlerine dikkat edilmelidir.
JSON Veri TipiAçıklamaÖrnek Dönüşüm (JavaScript)
StringMetin verisiconst name = data.BranchName;
NumberSayısal değer (tam sayı veya ondalıklı)const total = parseFloat(data.TotalSales);
BooleanMantıksal değer (0/1)const isActive = data.IsActive === 1;
ArrayDiziconst items = data.data;
ObjectNesneconst branch = data.data[0];
nullBoş değerconst value = data.Value === null ? 0 : data.Value;

​
Rapor Tipi Seçim Kılavuzu

Aşağıdaki sorulara vereceğiniz cevaplara göre ihtiyacınıza uygun rapor tipini belirleyebilirsiniz:
  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