bulut API Dokümantasyonu
Postman
Ana Sayfa › Gelen e-Fatura › Gelen e-Fatura Listesi

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; kimlik doğrulama için Login servisinden alınan Token UID değeri gereklidir.

POSThttps://ws.evobulut.com/api/FaturaUbl/base/
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
UIDKULLANICI_UID
sayfaSayfa numarası // 0'dan başlar, varsayılanı 0'dır.
pagesizeSayfa boyu // Varsayılanı 30, en fazla 200'dür.
min_idKayıt ID // Verilen kimlikten BÜYÜK kayıtları getirir. Artımlı (periyodik) çekim için önerilen yöntemdir.
a_gtarih_basGeliş 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_sonGeliş Bitiş Tarihi // Bitiş günü dahildir.
a_tarih_basBelge Başlangıç Tarihi // Faturanın kendi (belge) tarihine göre filtreler.
a_tarih_sonBelge Bitiş Tarihi // Bitiş günü dahildir.
a_ettnETTN // Faturanın evrensel tekil numarası ile tek kayıt getirir.
a_sbelge_seri_noBelge Seri No // Gönderenin fatura numarası.
a_cari_idMusteri ID // Faturayı gönderen carinin id'sine göre filtreler.
a_fvnoVKN / 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.
aktarildiAktarım Durumu // 0 aktarılmamış, 1 alış faturasına aktarılmış, -1 hepsi (varsayılan -1).
a_arsivArşiv Durumu // 0 arşivde değil, 1 arşivde, -1 hepsi (varsayılan -1).
a_onayOnay Durumu // 0 onaysız, 1 onaylı, -1 hepsi (varsayılan -1).
eslesmeyen_satirEşleşmeyen Satır Filtresi // 1 verildiğinde yalnızca stok kartı ya da birimi eşleşmemiş satırı olan faturaları listeler.
a_edrme-Fatura Durum ID
a_eture-Fatura Tür ID
a_senaryoSenaryo // Metin alanıdır: TEMELFATURA, TICARIFATURA, ILAC_TIBBICIHAZ …
a_sube_idSube ID
a_depo_idDepo ID
a_stok_idStok ID // Fatura satırlarında belirtilen id değerindeki stoğu içeren fatura liste filtresidir.
a_stok_ackStok Aciklamasi // Fatura satırlarında belirtilen satır açıklamasını içeren fatura liste filtresidir.
efat_stokKarsi Stok Adi // Gönderenin kendi stok adında arama yapar.
araGenel Arama Metni // Belge numarası, açıklama, ünvan ve cari adı alanlarında arama yapar.
a_olcutSiralama Kolonu // a_id (varsayılan), a_tarih, a_gtarih, a_vtarih, a_cari, a_tutar, a_sbelge_seri_no
artanSiralama Yonu // 1 artan, 0 azalan (varsayılan 0).

Dönen önemli alanlar

veri.sayfa[0].ADETFiltreye uyan TOPLAM kayıt sayısı. Sayfalama bu değere göre yapılır.
veri.AnaFatura başlıkları.
aktarildi_miFatura alış faturasına aktarıldı mı: 0 hayır, 1 evet.
aktarilan_fatura_idAktarıldıysa oluşan alış faturasının kimliği.
a_alis_islendiAktarım bayrağı (E / boş).
a_arsiv / arsivde_miArş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-ClientIdLogin 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
}
Kod Örnekleri
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
200 OK
{
  "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
200 OK — status: ERR
{
  "status": "ERR",
  "veri": {
    "mesaj": "Bu işlem için yetkiniz yoktur."
  }
}