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

- **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-detayi-ve-satirlari-323

## 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 |
| --- | --- |
| UID | KULLANICI_UID |
| a_id | Kayit ID // Gelen e-fatura kimliği. a_ettn verilmediyse zorunludur. |
| a_ettn | ETTN // Faturanın evrensel tekil numarası. a_id verilmediyse zorunludur. |

**Dönen veri**

| veri.Ana | Fatura başlığı (tek satır). |
| --- | --- |
| veri.Det | Fatura satırları. |
| stok_eslesti_mi | Satı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_adi | Gönderenin kendi stok kodu ve adı. |
| a_ebrm | Gö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-ClientId | Login anında alınan kullanıcı Token UID bilgisi |
| --- | --- |

## İstek gövdesi

```json
{
  "cmd": "sql",
  "UID": "KULLANICI_UID",
  "a_id": 18245
}
```

## Örnek istek (cURL)

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

```json
{
  "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

```json
{
  "status": "ERR",
  "veri": {
    "mesaj": "Fatura kimliği (a_id) ya da ETTN (a_ettn) belirtilmelidir."
  }
}
```