← Ana Sayfa

GümrükPro API Dokümantasyonu

Tüm API endpoint'leri https://gumruk.pro üzerinden erişilebilir. Rate limit: Dakikada 20 istek. Yanıtlar JSON formatındadır.

Hızlı Başlangıç

curl -X POST https://gumruk.pro/api/calculate \
  -H "Content-Type: application/json" \
  -d '{"gtip_code":"8471.30.00.00.00","origin_country":"CN","cif_value":1000,"cif_currency":"USD"}'

🧮 Hesaplama

🔍 Sınıflandırma

📊 Arama & Veri

📄 Fatura & Beyanname

⚖️ Mevzuat

🔐 Kimlik Doğrulama

📋 Geçmiş

⚙️ Sistem

📝 Notlar

  • Rate Limiting: Tüm endpoint'ler dakikada 20 istekle sınırlıdır. Aşım durumunda 429 yanıtı döner.
  • Kimlik Doğrulama: 🔒 işaretli endpoint'ler JWT cookie gerektirir. /api/auth/login ile giriş yapıldığında cookie otomatik ayarlanır.
  • Döviz Kurları: Hesaplamalarda canlı USD/TRY kuru kullanılır (4 saat önbellek).
  • GTIP Formatı: Noktalı (8471.30.00.00.00) veya noktasız (847130000000) kabul edilir.
  • Menşe Grupları: eu, efta, mfn, bk, gkore, eagü, ötdü, gyü ve diğer STA grupları.
  • Vergi Türleri: Gümrük Vergisi, İlave Gümrük Vergisi (İGV), Dampinge Karşı Vergi, ÖTV, KDV, KKDF, TRT Bandrol, KOSGEB Payı, Damga Vergisi.
  • TRT Bandrol: Cep telefonu %12, Tablet/PC %4, TV %10, Akıllı saat %14, Radyo %2, Taşıt %0.8. Matrah: GV matrahı + GV.
  • KOSGEB Payı: Tüm ithalatlarda ‰1 (binde bir) oranında.
  • Gözetim: CIF birim fiyatı referans fiyatın altındaysa, vergiler referans fiyat üzerinden hesaplanır.
GümrükPro API v1.0 — Arven Digital © 2026