ApivomApivom
Demo Alın

Türmob Mükellef Kartı (GİB) API

Vergi numarasıyla resmî GİB mükellef kaydı; ön ödemeli, sorgu başına fiyatlandırılan REST API: unvan, vergi dairesi, durum, adresler ve NACE faaliyetleri — TÜRMOB üzerinden.

Neler yapabilirsiniz

  • VKN (10 hane) veya TCKN (11 hane) ile GİB kaydından mükellef doğrulama
  • Unvan, şirket türü, vergi dairesi ve mükellef durumu tek kartta
  • Kayıtlı adresler ve mevcutsa NACE faaliyet kodları
  • Geçersiz veya kayıtsız numaralar asla ücretlendirilmez
  • Self-servis ön ödemeli faturalama — tekrarlanan sorgular önbellekten ücretsiz

Kullanım senaryoları

  • Fatura anında mükellef doğrulama — Gelen veya giden faturadaki VKN/TCKN'nin aktif bir GİB mükellefine ait olduğunu, kayıtlı unvan ve vergi dairesiyle birlikte belge kayda alınmadan teyit edin.
  • Müşteri ana verisi hijyeni — CRM veya ERP'nizdeki her Türk hesabın yasal unvanını, şirket türünü ve vergi dairesini serbest metin yerine resmî kayıttan normalleştirin.
  • Mali müşavirler için tedarikçi onboarding — Muhasebe büroları ve SMMM ofisleri yeni müvekkilleri ve karşı taraflarını tek çağrıyla kontrol eder — mevcutsa kayıtlı adresler ve NACE faaliyet kodları dahil.

Apivom Atlas, resmî TÜRMOB mükellef sorgusunu modern bir REST API olarak sunar. Herhangi bir vergi numarası veya T.C. kimlik numarasını sorgulayın; unvan, şirket türü, vergi dairesi, durum, kayıtlı adresler ve NACE faaliyetlerini içeren GİB mükellef kaydını tek kart ve tek fiyatla alın. Yanıtlar sunucu tarafında önbelleğe alınır (tekrarlanan sorgular ücretsizdir), geçersiz veya kayıtsız numaralar ücretlendirilmez ve her sorgu müşteri portalında tam istek/yanıt içerikleriyle kayıt altına alınır.

Kod örneği

YOUR_KEY yerine Apivom Atlas'ta verilen API anahtarınızı yazın ve sunucu tarafınızdan çalıştırın.

curl -X POST https://atlas.apivom.com/one/api/ext/turmob/v1/query/taxpayer-card \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vknTckn":"1234567890"}'
Kimlik doğrulama

Apivom Atlas portalında verilen kiracıya özel API anahtarı (x-api-key başlığı). Ön ödemeli bakiye; yalnızca veri dönen sorgular ücretlendirilir.

Sık sorulan sorular

Kart şirketler kadar gerçek kişiler için de çalışır mı?

Evet. Tüzel kişiler için 10 haneli vergi numarası (VKN), şahıs işletmeleri ve gerçek kişiler için 11 haneli T.C. kimlik numarası (TCKN) gönderin; GİB kaydı aynı kart yapısında döner.

Geçersiz veya kayıtsız bir numarada ne olur?

Geçersiz veya kayıtsız numaralar kayıt döndürmez ve ücretlendirilmez. Aynı numara için tekrarlanan sorgular önbellekten ücretsiz sunulur.

API nasıl ücretlendirilir?

Ön ödemeli ve sorgu başına: Apivom Atlas'ta bakiye yüklersiniz, başarılı her sorgu orada gösterilen rota fiyatını bakiyeden düşer. Aynı parametrelerle tekrarlanan sorgular sunucu tarafı önbellekten ücretsiz döner (yanıtta "cached": true); ?force=true ile rota fiyatına güncel veri çekebilirsiniz. HTTP 402 bakiyenin yüklenmesi gerektiğini gösterir.

Kimlik doğrulama nasıl çalışır, kullanımımı nereden izlerim?

Her istek, x-api-key başlığında kiracı API anahtarınızı taşır; anahtarlar Apivom Atlas'ta oluşturulur ve dilediğinizde yenilenir. Portal her sorguyu tam istek/yanıt içeriğiyle kaydeder; finans ve mühendislik aynı denetim izini paylaşır.

Diğer Atlas entegrasyonları

AI entegrasyon rehberi (llms.txt)

Makine tarafından okunabilir markdown — AI asistanınıza entegrasyon talimatı olarak verin.