GTIP Kodu ile Ara

GTİP Kodu ile Arama

Bu servis, verilen bir GTİP koduna karşılık gelen Türkiye Gümrük Tarife Cetveli verilerini getirir. Kod ile başlayan tüm eşleşen kayıtlar, açıklama bilgileriyle birlikte listelenir. Böylece doğru ürüne ait detaylara erişim sağlanabilir.

Endpoint Bilgileri

• URL: {{APP_URL}}/api/v1/gtip/search/code/{code}
• HTTP Metodu: GET
• İçerik Türü: application/json
• Kimlik Doğrulama Tipi: APIKEY

İstek Parametreleri

Path Parametreleri

Örnek Kullanım

API İsteği

Aşağıda, API isteği için bir örnek HTTP raw request yer almaktadır. Bu örnekte, 0203 kodu ile başlayan tüm GTİP kayıtları sorgulanmaktadır. Bu kod, domuz eti ile ilgili ürünleri temsil eder.

GET {{APP_URL}}/api/v1/gtip/search/code/0203
Content-Type: application/json
APIKEY: {{APIKEY}}

API Cevabı

Başarılı bir istekte, API aşağıdaki gibi bir yanıt döndürecektir:

{
    "status": true,
    "message": null,
    "data": [
        {
            "id": "10",
            "code": "0203",
            "description": "Domuz eti (taze, soğutulmuş veya dondurulmuş):",
            "description_en": "Domuz eti (taze, soğutulmuş veya dondurulmuş):"
        },
        {
            "id": "1155",
            "code": "020311100000",
            "description": "Domuz eti (taze, soğutulmuş veya dondurulmuş): > Karkas veya yarım karkas : > Evcil domuz eti",
            "description_en": "Domuz eti (taze, soğutulmuş veya dondurulmuş): > Carcases and half-carcases: > Of domestic swine"
        }
    ]
}

Yanıt Özeti: Arama sonucunda, 0203 kodu ile başlayan GTİP kayıtlarının tamamı döndürülür. Bu kayıtlar arasında hem 4 haneli ana başlık hem de ona bağlı 12 haneli alt ürün sınıflandırmaları yer alır.

Hata Cevapları

API isteği başarısız olursa, API aşağıdaki gibi bir hata yanıtı döndürecektir:

{
    "status": false,
    "errors": [
        {
            "message": "code:This value is not valid.",
        }
    ]
}