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.
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
} 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
}'const response = await fetch("https://ws.evobulut.com/api/FaturaUbl/base/", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
"cmd": "sql",
"UID": "KULLANICI_UID",
"a_id": 18245
})
});
const veri = await response.json();
console.log(veri);using System.Text;
using System.Text.Json;
using var client = new HttpClient();
var json = """
{
"cmd": "sql",
"UID": "KULLANICI_UID",
"a_id": 18245
}
""";
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": "sql",
"UID": "KULLANICI_UID",
"a_id": 18245
}
response = requests.post(url, json=payload)
print(response.json())<?php
$url = "https://ws.evobulut.com/api/FaturaUbl/base/";
$payload = '{
"cmd": "sql",
"UID": "KULLANICI_UID",
"a_id": 18245
}';
$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": "sql",
"UID": "KULLANICI_UID",
"a_id": 18245
}
""";
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": "sql",
"UID": "KULLANICI_UID",
"a_id": 18245
}),
);
print(jsonDecode(response.body)); 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."
}
} Gelen e-Fatura modülündeki diğer servisler