GTİP API: Yapay Zekâ ile GTİP Sınıflandırma ve Gümrük Vergisi API'si

Üç adımda başlayın

Üye olun. Üyelik ücretsizdir; ilk analiz hakkı hediye.
Anahtar üretin. Çalışma alanında Şirket ayarları → Panel bağlantısı → Bağlantı anahtarı üret. Anahtar lgk_ ile başlar ve yalnız üretildiği anda gösterilir; kaybederseniz iptal edip yenisini üretin.
İsteği gönderin. Anahtarı Authorization: Bearer başlığıyla gönderin.

curl -sS https://www.logisourcing.com/api/gtip-motor \
  -H "Authorization: Bearer lgk_…" \
  -H "Content-Type: application/json" \
  -d '{"urun":"Dolap içi LED aydınlatma armatürü",
       "metin":"12 V, alüminyum profil, difüzörlü, entegre LED modül",
       "zorla":true}'

Yanıt (kısaltılmış):

{
  "durum": "karar",
  "karar": {
    "gtip": "940542390000",
    "tanim": "…",
    "ozet": "Neden bu kod: …",
    "kosullu": [ { "kosul": "…", "gtip": "…" } ],
    "eksik_bilgi": [ … ]
  },
  "guven": { "skor": 79, "seviye": "orta", "oneri": "…" },
  "kanitlar": { "emsaller": [ … ], "ab": [ … ] },
  "kredi": 398
}

İstek

POST https://www.logisourcing.com/api/gtip-motor · Content-Type: application/json · Authorization: Bearer lgk_…

Alan	Tür	Açıklama
`urun`	metin, ≤ 200	Ürün adı. `urun` ya da en az 20 karakterlik `metin` gerekir.
`metin`	metin	Açıklama, malzeme, teknik özellikler; föy metni de olabilir.
`fotolar`	dizi	En çok 6 görsel, `data:image/jpeg;base64,…` biçiminde (~1280 px JPEG önerilir).
`cevaplar`	dizi	Motorun sorduğu soruların cevapları: `[{"id":"…","soru":"…","cevap":"…"}]`, en çok 8.
`zorla`	true / false	`true`: motor soru sormaz, eldeki bilgiyle karar verir; eksik bilgiyi raporda yazar.

Yanıt durumları

`durum`	Anlamı	Ücret
`soru`	Kritik bilgi eksik; `sorular` listesi döner. Cevapları `cevaplar` ile gönderip yeniden çağırın ya da `zorla: true` kullanın.	Ücretsiz
`karar`, `kontrol_gerekli`	Rapor: `karar.gtip` (12 hane), tanım, gerekçe, koşullu alternatif kodlar, eksik bilgi, `guven` (skor, seviye, öneri), kanıtlar (notlar, İzahname, emsaller). `kontrol_gerekli`: kod kesin değil, müşavirle kontrol edin.	1 analiz hakkı
`aday_yok`	Ürün tanımından pozisyon bulunamadı; tanımı ayrıntılandırıp yeniden deneyin.	Ücretsiz

kredi alanı kalan analiz hakkını verir (sözleşmeli, sınırsız şirkette gelmez). Analiz teknik hatayla biterse düşen hak kendiliğinden iade edilir.

Vergi oranları: anahtarsız uç nokta

GTİP'i bulduktan sonra vergileri resmî TARA özetinden alın. Anahtar gerekmez, ücretsizdir.

GET https://www.logisourcing.com/api/tara?gtip=940542390000&ulke=720

gtip 12 hane, ulke 3 haneli TARA ülke kodudur (örneğin Çin 720). Kod ya da ülke hatalıysa 400, TARA o kod için vergi satırı döndürmezse 422 gelir.

Hatalar

HTTP	Ne zaman
400	Ürün adı, en az 20 karakterlik metin ya da görsel yok.
401	Anahtar geçersiz ya da iptal edilmiş (`LINK_KEY_INVALID`).
402	Şirketin analiz hakkı bitti (`NO_CREDITS`); çalışma alanından paket alın.
403	Şirket salt okunur ya da süresi dolmuş; ya da istekte sitenin dışından bir `Origin` başlığı var (tarayıcı dışı istemci göndermez).
429	Kota doldu. `Retry-After` başlığı ve `retry_after` alanı bekleme süresini saniye olarak verir.
504	Analiz uzun sürdü. Aynı gövdeye `"sadeceDepo": true` ekleyip yeniden çağırın: son 10 dakikadaki sonuç hak düşürmeden döner.

Hata yanıtı {"error": "Türkçe açıklama", "code": "MAKİNE_KODU"} biçimindedir; kararı code ve HTTP durumuna göre verin.

Sınırlar ve güvenlik

Kota: şirket başına günde en çok 200 analiz.
Süre: bir analiz genellikle 1–3 dakika sürer; istemci zaman aşımını en az 300 saniye tutun.
Kayıt: API analizleri şirketin analiz geçmişine yazılmaz, rapor yalnız çağırana döner. Her çağrı denetim kaydına düşer; anahtarın son kullanım zamanı çalışma alanında görünür.
Anahtarın yetkisi dar: analiz yapar, panelden ürün gönderir ve maliyet sonucu okur; kayıt silemez, kullanıcı ya da ayar değiştiremez. Şirket başına en çok 5 etkin anahtar olabilir.
Saklama: anahtarı kaynak koduna ya da günlüklere yazmayın; sunucu tarafındaki gizli ayarlarda tutun. Tarayıcıdan doğrudan çağırmayın.

Ücret

Karar dönen her çağrı şirketin analiz hakkından 1 düşer. Haklar çalışma alanındaki paketlerle alınır; abonelik ve otomatik yenileme yoktur. Sitedeki analizler ve API analizleri aynı haktan düşer.

Paket	Analiz hakkı	Fiyat (KDV dâhil)	Analiz başına
Başlangıç	10 analiz	290,00 TL	29,00 TL / analiz
Standart	50 analiz	1.190,00 TL	23,80 TL / analiz
Profesyonel	200 analiz	3.490,00 TL	17,45 TL / analiz

Sık sorulan sorular

GTİP API anahtarını nereden alırım?

Ücretsiz üye olun, çalışma alanında Şirket ayarları → Panel bağlantısı → Bağlantı anahtarı üret adımını izleyin. Anahtar lgk_ ile başlar ve yalnız üretildiği anda gösterilir.

GTİP API ücretli mi?

Karar dönen her çağrı şirketin analiz hakkından 1 düşer; soru turu ve "ürün bulunamadı" yanıtı ücretsizdir. Vergi oranları için /api/tara uç noktası anahtarsız ve ücretsizdir.

Bir analiz ne kadar sürer?

Genellikle 1–3 dakika. İstemci zaman aşımını en az 300 saniye tutun. Bağlantınız koparsa aynı gövdeyle sadeceDepo: true göndererek son 10 dakikadaki sonucu hak düşürmeden alabilirsiniz.

API sonucu bağlayıcı mı?

Hayır. Sonuç karar desteğidir. Resmî bağlayıcılık için Ticaret Bakanlığı'na Bağlayıcı Tarife Bilgisi (BTB) başvurusu gerekir; beyandan önce gümrük müşavirinizle teyit edin.

Toplu (çok ürünlü) gönderim var mı?

Her istek bir ürün içindir. Çok ürünü sırayla gönderin; kota şirket başına günde 200 analizdir. Çalışma alanındaki "Toplu analiz" ekranı aynı işi tablo yükleyerek yapar.

Tam alan listesi, panel bağlantısı eylemleri ve örnek istemci için iletişime geçin; sözleşme belgesini gönderelim.