# Gelen e-Fatura Listesi

> Gelen e-Fatura Listesi, Evobulut ön muhasebe / ERP yazılımının Gelen e-Fatura modülüne ait bir REST API servisidir. POST yöntemiyle `https://ws.evobulut.com/api/FaturaUbl/base/` adresine JSON gönderilerek çağrılır.

- **Modül:** Gelen e-Fatura
- **Yöntem:** POST
- **Endpoint:** `https://ws.evobulut.com/api/FaturaUbl/base/`
- **Kimlik doğrulama:** Login servisinden alınan Token UID
- **Son güncelleme:** 2026-09-09
- **Doküman:** https://dev.evobulut.com/servis/gelen-e-fatura/gelen-e-fatura-listesi-322

## Açıklama

GİB üzerinden EvoBulut'a düşen gelen e-faturaları sayfalı olarak listeler. Faturaların satırları bu serviste **dönmez**; satırlar için **Gelen e-Fatura Detayı ve Satırları** servisini kullanınız.

| cmd | İlgili komut // jq_list |
| --- | --- |
| UID | KULLANICI_UID |
| sayfa | Sayfa numarası // 0'dan başlar, varsayılanı 0'dır. |
| pagesize | Sayfa boyu // Varsayılanı 30, en fazla 200'dür. |
| min_id | Kayıt ID // Verilen kimlikten BÜYÜK kayıtları getirir. Artımlı (periyodik) çekim için önerilen yöntemdir. |
| a_gtarih_bas | Geliş Başlangıç Tarihi // Faturanın bize DÜŞTÜĞÜ tarihe göre filtreler. Periyodik çekimde belge tarihi değil bu alan kullanılmalıdır; geçmiş tarihli bir fatura bugün düşebilir. |
| a_gtarih_son | Geliş Bitiş Tarihi // Bitiş günü dahildir. |
| a_tarih_bas | Belge Başlangıç Tarihi // Faturanın kendi (belge) tarihine göre filtreler. |
| a_tarih_son | Belge Bitiş Tarihi // Bitiş günü dahildir. |
| a_ettn | ETTN // Faturanın evrensel tekil numarası ile tek kayıt getirir. |
| a_sbelge_seri_no | Belge Seri No // Gönderenin fatura numarası. |
| a_cari_id | Musteri ID // Faturayı gönderen carinin id'sine göre filtreler. |
| a_fvno | VKN / TCKN // Gönderenin vergi ya da TC kimlik numarası. Faturanın kendi üzerindeki değere bakılır; cari kartı henüz açılmamış olabilir. |
| aktarildi | Aktarım Durumu // 0 aktarılmamış, 1 alış faturasına aktarılmış, -1 hepsi (varsayılan -1). |
| a_arsiv | Arşiv Durumu // 0 arşivde değil, 1 arşivde, -1 hepsi (varsayılan -1). |
| a_onay | Onay Durumu // 0 onaysız, 1 onaylı, -1 hepsi (varsayılan -1). |
| eslesmeyen_satir | Eşleşmeyen Satır Filtresi // 1 verildiğinde yalnızca stok kartı ya da birimi eşleşmemiş satırı olan faturaları listeler. |
| a_edrm | e-Fatura Durum ID |
| a_etur | e-Fatura Tür ID |
| a_senaryo | Senaryo // Metin alanıdır: TEMELFATURA, TICARIFATURA, ILAC_TIBBICIHAZ … |
| a_sube_id | Sube ID |
| a_depo_id | Depo ID |
| a_stok_id | Stok ID // Fatura satırlarında belirtilen id değerindeki stoğu içeren fatura liste filtresidir. |
| a_stok_ack | Stok Aciklamasi // Fatura satırlarında belirtilen satır açıklamasını içeren fatura liste filtresidir. |
| efat_stok | Karsi Stok Adi // Gönderenin kendi stok adında arama yapar. |
| ara | Genel Arama Metni // Belge numarası, açıklama, ünvan ve cari adı alanlarında arama yapar. |
| a_olcut | Siralama Kolonu // a_id (varsayılan), a_tarih, a_gtarih, a_vtarih, a_cari, a_tutar, a_sbelge_seri_no |
| artan | Siralama Yonu // 1 artan, 0 azalan (varsayılan 0). |

**Dönen önemli alanlar**

| veri.sayfa[0].ADET | Filtreye uyan TOPLAM kayıt sayısı. Sayfalama bu değere göre yapılır. |
| --- | --- |
| veri.Ana | Fatura başlıkları. |
| aktarildi_mi | Fatura alış faturasına aktarıldı mı: 0 hayır, 1 evet. |
| aktarilan_fatura_id | Aktarıldıysa oluşan alış faturasının kimliği. |
| a_alis_islendi | Aktarım bayrağı (E / boş). |
| a_arsiv / arsivde_mi | Arşiv durumu (0-1 / H-E). |
| a_bag_var | İrsaliye bağlantısı var mı (Var / Yok). |

**Yetki:** Kullanıcıda “Gelen e-Faturalar” menü yetkisi bulunmalıdır. Yetki yoksa servis status = "ERR" ve yetki mesajı döner; admin için ayrıcalık yoktur.

## Header bilgileri

| X-ClientId | Login anında alınan kullanıcı Token UID bilgisi |
| --- | --- |

## İstek gövdesi

```json
{
  "cmd": "jq_list",
  "UID": "KULLANICI_UID",
  "sayfa": 0,
  "pagesize": 100,
  "a_gtarih_bas": "01.09.2026",
  "a_gtarih_son": "09.09.2026",
  "aktarildi": 0
}
```

## Örnek istek (cURL)

```bash
curl -X POST "https://ws.evobulut.com/api/FaturaUbl/base/" \
  -H "Content-Type: application/json" \
  -d '{
  "cmd": "jq_list",
  "UID": "KULLANICI_UID",
  "sayfa": 0,
  "pagesize": 100,
  "a_gtarih_bas": "01.09.2026",
  "a_gtarih_son": "09.09.2026",
  "aktarildi": 0
}'
```

## Başarılı yanıt

```json
{
  "status": "OK",
  "veri": {
    "sayfa": [
      {
        "ADET": "142"
      }
    ],
    "Ana": [
      {
        "a_id": "18245",
        "a_tur": "30",
        "BELGE_TUR": "Alış Faturası",
        "a_sbelge_seri_no": "ABC2026000000123",
        "a_ettn": "52d86ee8-22f4-6413-e2b6-1ac43b08d72d",
        "a_tarih": "05.09.2026 00:00:00",
        "a_gtarih": "05.09.2026 14:22:00",
        "a_vtarih": "05.10.2026 00:00:00",
        "a_cari_id": "987",
        "CARI_ADI": "ÖRNEK TEDARİK A.Ş.",
        "CARI_RESMI_AD": "ÖRNEK TEDARİK ANONİM ŞİRKETİ",
        "a_fvno": "1234567890",
        "a_senaryo": "TICARIFATURA",
        "a_edrm": "1",
        "FAT_DUR": "Başarılı",
        "kdv_haric": "9000",
        "a_kdv_tut": "1800",
        "a_tutar": "10800",
        "a_dov_id": "0",
        "doviz_Adi": "TL",
        "GenelTutarTL": "10800",
        "a_onay": "0",
        "a_arsiv": "0",
        "arsivde_mi": "H",
        "a_alis_islendi": "0",
        "aktarildi_mi": "0",
        "aktarilan_fatura_id": null,
        "a_bag_var": "Yok"
      }
    ]
  }
}
```

## Başarısız yanıt

```json
{
  "status": "ERR",
  "veri": {
    "mesaj": "Bu işlem için yetkiniz yoktur."
  }
}
```