bulut API Dokümantasyonu
Postman
Ana Sayfa › Gelen e-Fatura › Gelen e-Fatura Detayı ve Satırları

Gelen e-Fatura Detayı ve Satırları

Gelen e-Fatura Detayı ve Satırları, 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

Tek bir gelen e-faturanın başlığını ve tüm satırlarını döndürür.

cmdİlgili komut // sql
UIDKULLANICI_UID
a_idKayit ID // Gelen e-fatura kimliği. a_ettn verilmediyse zorunludur.
a_ettnETTN // Faturanın evrensel tekil numarası. a_id verilmediyse zorunludur.

Dönen veri

veri.AnaFatura başlığı (tek satır).
veri.DetFatura satırları.
stok_eslesti_miSatır bazındadır. 0 ise satır EvoBulut stok kartıyla EŞLEŞMEMİŞTİR; e-faturadan gelen ham değerler a_estok_kod, a_estok_adi ve a_ebrm alanlarında durur. Eşleşmemiş satırlar alış faturasına aktarılamaz; önce Gelen e-Fatura Güncelle (Satır Eşleştirme) servisi ile stok kartı ve birim bağlanmalıdır.
a_estok_kod / a_estok_adiGönderenin kendi stok kodu ve adı.
a_ebrmGönderenin birim kodu (UBL birim kodu, ör. C62, KGM).

Yalnızca satırlar gerekiyorsa cmd = satirlar komutu kullanılabilir; a_id alır ve veri.Det döndürür.

Yetki: “Gelen e-Faturalar” menü yetkisi gereklidir.

Header Bilgileri
X-ClientIdLogin anında alınan kullanıcı Token UID bilgisi
İstek Gövdesi (JSON)
{
  "cmd": "sql",
  "UID": "KULLANICI_UID",
  "a_id": 18245
}
Kod Örnekleri
curl -X POST "https://ws.evobulut.com/api/FaturaUbl/base/" \
  -H "Content-Type: application/json" \
  -d '{
  "cmd": "sql",
  "UID": "KULLANICI_UID",
  "a_id": 18245
}'
Başarılı Yanıt
200 OK
{
  "status": "OK",
  "veri": {
    "Ana": [
      {
        "a_id": "18245",
        "a_sbelge_seri_no": "ABC2026000000123",
        "a_ettn": "52d86ee8-22f4-6413-e2b6-1ac43b08d72d",
        "a_tarih": "05.09.2026 00:00:00",
        "a_vtarih": "05.10.2026 00:00:00",
        "a_cari_id": "987",
        "CARI_RESMI_AD": "ÖRNEK TEDARİK ANONİM ŞİRKETİ",
        "CARI_VERGI_NO": "1234567890",
        "CARI_VADE_GUN": "30",
        "a_fcari": "ÖRNEK TEDARİK A.Ş.",
        "a_fadres1": "ÖRNEK MAH. ÖRNEK CAD. NO:1",
        "a_fvda": "ÖRNEK V.D.",
        "a_fvno": "1234567890",
        "a_senaryo": "TICARIFATURA",
        "a_kdv_tut": "1800",
        "a_tutar": "10800",
        "a_bag_var": "Yok",
        "aktarildi_mi": "0"
      }
    ],
    "Det": [
      {
        "a_id": "55501",
        "a_mas_id": "18245",
        "a_sira": "1",
        "a_stok_id": "4410",
        "a_kod": "STK-0001",
        "a_stok_adi": "ÖRNEK ÜRÜN",
        "stok_eslesti_mi": "1",
        "a_estok_kod": "TED-991",
        "a_estok_adi": "ÖRNEK ÜRÜN 500 ML",
        "a_brm": "3",
        "a_brm_adi": "Adet",
        "a_ebrm": "C62",
        "a_mik": "10",
        "a_fiy": "900",
        "a_kdv": "20",
        "a_kdv_tut": "1800",
        "a_tutar": "9000",
        "a_tutar_kdvh": "10800"
      },
      {
        "a_id": "55502",
        "a_mas_id": "18245",
        "a_sira": "2",
        "a_stok_id": "0",
        "a_kod": null,
        "a_stok_adi": null,
        "stok_eslesti_mi": "0",
        "a_estok_kod": "TED-777",
        "a_estok_adi": "EŞLEŞMEMİŞ ÜRÜN",
        "a_brm": "0",
        "a_ebrm": "KGM",
        "a_mik": "5",
        "a_fiy": "100",
        "a_tutar": "500"
      }
    ]
  }
}
Başarısız Yanıt
200 OK — status: ERR
{
  "status": "ERR",
  "veri": {
    "mesaj": "Fatura kimliği (a_id) ya da ETTN (a_ettn) belirtilmelidir."
  }
}