API

Listeleme ve Çıktı API Referansı

Listeleme, özet, önizleme, PDF ve ZIP çıktısı endpointleri.

Listeleme endpointleri açılış ve kapanış kayıtlarını operasyon veya ERP mutabakatı için sunar. Önizleme endpointleri aynı kaydın insan tarafından okunabilir görünümünü ya da indirilebilir teknik dosyasını döndürür. Liste sonucu, GİB onaylı beratın arşivlendiğini tek başına kanıtlamaz.

Listeleme ve Özet

Metot	Endpoint	Kullanım
POST	`/api/InventoryList/GetEntityPage`	Tarih filtresi ve sayfalama ile envanter dönemlerini listeler.
POST	`/api/InventoryList/GetEntityDetailPage`	Seçilen envanterin detay satırlarını listeler.
POST	`/api/InventorySummary/GetEntityPage`	Özet kayıtları sayfalı döndürür.
POST	`/api/FirmInventory/GetEntityPage`	Firma bazlı envanter dosyalarını listeler.

Liste İstekleri

GetEntityPage çağrısı PageQuery<InventoryListRequestModel> gövdesi alır. Sayfa numarası sıfır tabanlıdır; PageSize değeri 250'yi aşmamalıdır.

{
  "Filter": {
    "BeginDate": "2026-01-01T00:00:00",
    "EndDate": "2026-12-31T00:00:00"
  },
  "CurrentPageNumber": 0,
  "PageSize": 50,
  "SortExpression": "PeriodStart",
  "SortDirection": "desc"
}

Bir açılış veya kapanış kaydının satırlarını almak için liste cevabındaki gerçek Uuid kullanılır:

{
  "Uuid": "33333333-3333-3333-3333-333333333333"
}

Önizleme ve Çıktılar

Aşağıdaki endpointler uuid query parametresi alır ve ServiceResponse<string> döndürür. HTML endpointlerinin Data alanı işaretleme metnidir; PDF ve ZIP endpointlerinin Data alanı Base64 dosya içeriğidir.

Çıktı	HTML	PDF	ZIP
Envanter	`GetEnvanterHtml`	`GetEnvanterPdf`	`GetEnvanterZipDownload`
Mükellef beratı	`GetEnvanterBeratHtml`	`GetEnvanterBeratPdf`	`GetEnvanterBeratZipDownload`
GİB onaylı berat	`GetGibEnvanterBeratHtml`	`GetGibEnvanterBeratPdf`	`GetGibEnvanterBeratZipDownload`

Çağrı biçimi GET /api/InventoryPreview/{işlem}?uuid={uuid} şeklindedir. Base64 değer istemcide byte dizisine çevrilerek ilgili PDF veya ZIP dosya uzantısıyla kaydedilir. Firma bazlı toplu ZIP çıktısı yetkili işlem olarak /api/FirmInventory/GetFirmsInventorysZip üzerinden sunulur.

İhtiyaç	Tercih edilen çıktı	Kullanım notu
Onay öncesi gözle kontrol	HTML	`Data` güvenli bir önizleme alanında gösterilir; dosya değildir.
Kullanıcıya okunabilir belge sunma	PDF	Base64 çözülerek `.pdf` kaydedilir; yasal XML'in yerine geçmez.
İmzalı veya GİB onaylı teknik dosyayı saklama	ZIP	Base64 çözülerek `.zip` kaydedilir; dosya türü değiştirilmez.

UUID seçimi: Özet kaydının Uuid değeri ile liste detayındaki belge/parça UUID'leri aynı amaçla kullanılmayabilir. Endpointin döndürdüğü kayıt türüne ait UUID'yi kullanın.