e-Fatura Karekod API
Fatura fotoğrafındaki e-Fatura / e-Arşiv karekodunu okuyun, alanlarını ayrıştırın ve tutarlılığını denetleyin.
POST /v1/fatura/karekod/oku fatura fotoğrafını (multipart, base64 ya da görsel gövdesi, en çok 5 MB) alır, görseldeki karekodları okur ve e-Fatura / e-Arşiv karekod standardına uyanları ayrıştırır. POST /v1/fatura/karekod/dogrula aynı denetimi zaten okunmuş karekod metni ya da nesnesiyle yapar.
Denetimler: satıcı ve alıcı VKN / TCKN kontrol haneleri (nihai tüketici ve yurt dışı özel değerleri tanınır), tarih, fatura numarası biçimi (3 seri + 4 yıl + 9 sıra) ve yılın tarihle uyumu, ETTN, para birimi, her KDV oranında matrah × oran ve mal / hizmet + KDV = vergiler dahil toplam. Faturanın sistemde kayıtlı olup olmadığı sorgulanmaz. Fatura yazan yazılımlar için /v1/cevir/yaziyla tutarı "YALNIZ: …" biçiminde yazıya, /v1/dogrula/firma alıcının vergi numarası, vergi dairesi ve unvanını denetler.
Hızlı başlangıç
Anahtarınızı X-API-Key başlığında gönderin (ücretsiz anahtar al).
Anahtarı tarayıcı koduna koymayın; sunucunuzdan çağırıp sonucu önbelleğe alın.
<?php
$ch = curl_init('https://api.veriapi.pro/v1/cevir/yaziyla?tutar=1250.75¶=TRY');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
CURLOPT_HTTPHEADER => ['X-API-Key: va_ANAHTARINIZ'],
]);
$yanit = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($yanit['veri']);
const yanit = await fetch("https://api.veriapi.pro/v1/cevir/yaziyla?tutar=1250.75¶=TRY", {
headers: { "X-API-Key": "va_ANAHTARINIZ" },
});
const { veri, kaynak } = await yanit.json();
console.log(veri);
import requests
r = requests.get("https://api.veriapi.pro/v1/cevir/yaziyla?tutar=1250.75¶=TRY",
headers={"X-API-Key": "va_ANAHTARINIZ"}, timeout=10)
print(r.json()["veri"])
curl -H "X-API-Key: va_ANAHTARINIZ" \ "https://api.veriapi.pro/v1/cevir/yaziyla?tutar=1250.75¶=TRY"
Örnek yanıt
GET https://api.veriapi.pro/v1/cevir/yaziyla?tutar=1250.75¶=TRY — gerçek veriyle; listeler kısaltıldı.
{
"veri": {
"metin": "bin iki yüz elli Türk lirası yetmiş beş kuruş",
"buyuk": "BİN İKİ YÜZ ELLİ TÜRK LİRASI YETMİŞ BEŞ KURUŞ",
"bitisik": "BinİkiYüzElliTürkLirasıYetmişBeşKuruş",
"fatura": "YALNIZ: BİN İKİ YÜZ ELLİ TÜRK LİRASI YETMİŞ BEŞ KURUŞ",
"tutar": "1250.75",
"para_birimi": "TRY",
"ana": 1250,
"alt": 75
},
"kaynak": [
{
"kod": "veriapi",
"ad": "VeriApi.Pro",
"lisans": "VeriApi.Pro kullanım koşulları (https://veriapi.pro/kosullar)",
"atif": "Veri: VeriApi.Pro",
"url": "https://veriapi.pro"
}
],
"guncelleme": null,
"bayat": false
}
Uçlar ve parametreler
POST /v1/fatura/karekod/oku
ücretli paket
3 birim
Fatura fotoğrafından e-Fatura / e-Arşiv karekodunu oku ve denetle
POST /v1/fatura/karekod/dogrula
ücretsiz pakette
1 birim
e-Fatura / e-Arşiv karekod içeriğini ayrıştır ve denetle
GET /v1/cevir/yaziyla
ücretsiz pakette
1 birim
Sayıyı yazıya çevir: fatura satırı (YALNIZ), bitişik, sıra sayısı
| Parametre | Tür | Açıklama |
|---|---|---|
| tutar* | metin | Sayı: 1250,50 · 1250.50 · 1.250,50 |
| para | metin | TRY (TL), USD, EUR, GBP, CHF; düz sayı için boş bırakın varsayılan: TRY |
GET /v1/dogrula/firma
ücretsiz pakette
1 birim
Firma bilgisi doğrulama: VKN, vergi dairesi, il, unvan ve MERSİS tutarlılığı
| Parametre | Tür | Açıklama |
|---|---|---|
| vergi_no* | metin | VKN (10) ya da şahıs için TCKN (11) |
| vergi_dairesi | metin | Daire adı ("Kızılbey", "Düzce VD") ya da 5 haneli kod |
| il | metin | İl adı ya da plaka |
| unvan | metin | Ticari unvan (şirket türü buradan anlaşılır) |
| mersis | metin | MERSİS numarası (16 hane) |
GET /v1/vergi/daireler
ücretsiz pakette
1 birim
Vergi daireleri ve muhasebe birim kodları (il / ilçe / ad)
| Parametre | Tür | Açıklama |
|---|---|---|
| il | metin | İl adı ya da plaka |
| ilce | metin | İlçe adı (büyükşehirde merkez daireleri de bakılır) |
| ara | metin | Ad, ilçe ya da kod |
| tur | metin |
Konum alan uçlarda konum (slug), il + ilce (ad, slug ya da plaka) ya da enlem + boylam kullanılabilir.
Tüm parametreler: OpenAPI belgesi.
Nerelerde kullanılır?
- ✓Gider ve masraf uygulamalarında fişi fotoğraftan otomatik doldurma
- ✓Muhasebe yazılımında gelen faturanın tutar ve vergi numarası denetimi
- ✓Fatura kesen sistemlerde tutarı yazıya çevirme ve alıcı bilgisi doğrulama
- ✓Sahte / hatalı fatura ön kontrolü
Veri kaynağı
Veriler lisanslı ve izinli kaynaklardan VeriApi.Pro tarafından derlenir; yanıtların kaynak alanı VeriApi.Pro döner.
Sık sorulan sorular
e-Fatura karekod API'si ücretsiz mi?
Karekod metni doğrulama, yazıya çevirme ve firma doğrulama her pakette açıktır. Fotoğraftan okuma (3 birim) ücretli paketlerdedir.
Fatura gerçekten kesilmiş mi, bunu söyler mi?
Hayır. API karekodun biçimini ve tutarların kendi içinde tutarlılığını denetler; faturanın kayıtlı olup olmadığını sorgulamaz.
Fotoğraf saklanıyor mu?
Hayır; görsel yalnızca okuma için bellekte işlenir, diske ve günlüğe yazılmaz.
İskonto, ÖTV ya da tevkifat olan faturalar?
Okunur ve ayrıştırılır; bu kalemler toplam denetimini etkileyebileceği için yanıtta uyarı olarak belirtilir.
Bu sayfa şu aramalar için de: e-arşiv karekod okuma api · fatura qr kod okuma · e-fatura doğrulama api · fiş fotoğrafından okuma api