Veri Türleri ve Rapor Tipleri

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

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 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:

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.

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ı

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

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