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.
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
} 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
}'const response = await fetch("https://ws.evobulut.com/api/FaturaUbl/base/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"cmd": "jq_list",
"UID": "KULLANICI_UID",
"sayfa": 0,
"pagesize": 100,
"a_gtarih_bas": "01.09.2026",
"a_gtarih_son": "09.09.2026",
"aktarildi": 0
})
});
const veri = await response.json();
console.log(veri);using System.Text;
using System.Text.Json;
using var client = new HttpClient();
var 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
}
""";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://ws.evobulut.com/api/FaturaUbl/base/", content);
var veri = await response.Content.ReadAsStringAsync();
Console.WriteLine(veri);import requests
url = "https://ws.evobulut.com/api/FaturaUbl/base/"
payload = {
"cmd": "jq_list",
"UID": "KULLANICI_UID",
"sayfa": 0,
"pagesize": 100,
"a_gtarih_bas": "01.09.2026",
"a_gtarih_son": "09.09.2026",
"aktarildi": 0
}
response = requests.post(url, json=payload)
print(response.json())<?php
$url = "https://ws.evobulut.com/api/FaturaUbl/base/";
$payload = '{
"cmd": "jq_list",
"UID": "KULLANICI_UID",
"sayfa": 0,
"pagesize": 100,
"a_gtarih_bas": "01.09.2026",
"a_gtarih_son": "09.09.2026",
"aktarildi": 0
}';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;import java.net.URI;
import java.net.http.*;
HttpClient client = HttpClient.newHttpClient();
String 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
}
""";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://ws.evobulut.com/api/FaturaUbl/base/"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString(json))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());import 'dart:convert';
import 'package:http/http.dart' as http;
final response = await http.post(
Uri.parse('https://ws.evobulut.com/api/FaturaUbl/base/'),
headers: {'Content-Type': 'application/json'},
body: jsonEncode({
"cmd": "jq_list",
"UID": "KULLANICI_UID",
"sayfa": 0,
"pagesize": 100,
"a_gtarih_bas": "01.09.2026",
"a_gtarih_son": "09.09.2026",
"aktarildi": 0
}),
);
print(jsonDecode(response.body)); 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."
}
} Gelen e-Fatura modülündeki diğer servisler