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.

Ücretsiz pakette var JSON · Türkçe5 uç Kaynak: VeriApi.Pro

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&para=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&para=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&para=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&para=TRY"

Örnek yanıt

GET https://api.veriapi.pro/v1/cevir/yaziyla?tutar=1250.75&para=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ı

ParametreTürAçı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ığı

ParametreTürAçı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)

ParametreTürAçı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