🧩Özel Kart

Uç-nokta: /custom-product-card/:id

API URL

İstek Metodu: GET

Header Parametreleri

parametre
tipi
açıklama

Authorization

string

Bearer <API Anahtarı>Özel Kart Kimlik Doğrulama

İstek Parametreleri

parametre
tipi
açıklama
zorunlu

id

integer

İlaca ait atanmış olan tekil ürün id bilgisi. Bu bilgiye /products metodunda bulunan id alanından alınabilir.

hayır

page

integer

Sayfa numarası Cevap Yapısı

hayır

per-page

integer

Bir sayfada bulunması istenen kayıt sayısı. Üst limit 500. Cevap Yapısı

hayır

Cevap Parametreleri

parametre
tipi
açıklama

product

product

card

card

card

parametre
tipi
açıklama

drugType

drugType

licenseeCompany

company

indication

text

İlacın endikasyon bilgisi

prescriptionType

prescriptiontype

ingredients

ingredient[]

barcodes

barcode[]

image

image

price

price

product

parametre
tipi
açıklama

id

integer

ürün tekil id'si

name

string

ürün ismi (drug + drugform + product şeklinde oluşturulmaktadır).

barcode

parametre
tipi
açıklama

barcode

integer

ürünün barkodu. 12 veya 13 haneli olabilir.

skrsStatus

string

barkoda ait SKRS durumu. Sağlık Kodlama Referans Sunucusu'nda tanımlı olan barkodu ve barkodun durumunu açıklar. Dönen sonuç aktif, pasif veya liste dışı olacaktır. İlaçların barkodu, belirli koşullarda değişebilir. Bu sebeple 1 ilacın 1'den fazla barkodu olabilir (aynı ilaç farklı barkodlarla piyasada olabilir) ve her barkodun SKRS durumu farklı olabilir.

drugType

parametre
tipi
açıklama

id

integer

ürüne ait drugType'ın id'si

name

string

drugType'ın ismi.

Dönen sonuç;

  • İlaç

  • Kozmetik

  • Besin Desteği

  • Mama

  • Tıbbi amaçlı oral besin

  • Parenteral beslenme ürünü

  • Ara ürün

  • Enteral beslenme ürünü

  • İrigasyon solüsyonu

  • Parenteral solüsyon

  • İlaç benzeri

  • OTC

  • Medikal ürün

  • Tıbbi cihaz

  • Kofre

  • GBTÜ

olabilir.

prescriptionType

parametre
tipi
açıklama

id

integer

ürüne ait prescriptionType'ın id'si

name

string

prescriptionType'ın ismi.

Türkiye'de, ilaçlar 7 farklı türde reçetelenebilmektedir.

Beyaz Reçete: Çoğu ilacın yazıldığı, normal reçete türüdür.

Kısıtlanmış Beyaz Reçete: Uzman hekim tarafından yazılan reçete türüdür.

Kontrole Tabi Reçete: Suistimal edilebilecek ilaçların yazıldığı reçete türüdür.

Kırmızı Reçete: Narkotik ilaçların yazıldığı reçete türüdür.

Yeşil Reçete: Psikotrop ilaçların yazıldığı reçete türüdür.

Mor Reçete: Kan ve kan ürünlerinin yazıldığı reçete türüdür.

Turuncu Reçete: Kan faktörlerinin yazıldığı reçete türüdür.

ingredient

parametre
tipi
açıklama

id

integer

ürüne ait etken maddenin id'si. Bir ürün 1'den fazla etken madde içerebilir. Bu durumda her etken maddenin id'si farklı olacak şekilde sonuç dönecektir.

name

string

ürüne ait etken maddenin adı. İlacın tedavi edici veya terapötik etkilerini sağlayan kimyasal bileşendir. Bu madde, ilacın ana aktif bileşeni olarak bilinir (bazı kaynaklarda etkin madde olarak da geçmektedir).

Bir ilacın etken maddesi, ilacın formülasyonundaki en önemli bileşendir ve tedavi edici etkileri sağlar. Bu nedenle, ilaçların etiketlerinde genellikle etken madde belirtilir ve doktorlar, eczacılar veya sağlık uzmanları reçete ederken bu maddeye dikkat ederler.

Örneğin; "parasetamol 100 mg" için

  • etken madde: parasetamol

  • amount: 100

  • unit: mg

alternativeName

string

ürüne ait etken maddenin alternatif isimleri. Etken maddeler farklı alanlarda alternatif isimleriyle bilinebilirler. Örneğin Avrupa ülkelerinde parasetamol ismiyle bilinen etken madde ABD'de asetaminofen olarak bilinmektedir. Veya asetilsalisilik asit bazı kaynaklarda ASA olarak kısaltılabilmektedir. Örneğin

  • parasetamol (asetaminofen)

  • Asetilsalisilik asit (ASA)

amount

integer

Ürünün etken maddeyi içerdiği miktar

Örneğin; "parasetamol 100 mg" için

  • etken madde: parasetamol

  • amount: 100

  • unit: mg

unit

unit

etken madde içeriğinin birimi. amount'un tamamlayıcısıdır. detay için unit

unit

parametre
tipi
açıklama

id

integer

unit'e ait id

name

string

unit'in ismi

Örneğin dönen sonuç

  • mg

  • ml

  • mcg

  • L

  • kg

  • mg/ml

  • damla

olabilir.

Örneğin; "parasetamol 100 mg" için

  • etken madde: parasetamol

  • amount: 100

  • unit: mg

image

parametre
tipi
açıklama

url

string

ilacın görseline ait URL

price

parametre
tipi
açıklama

effectiveDate

date

ilacın fiyat bilgisinin geçerli olduğu tarih. İlaçlar 1'den fazla fiyata sahip olabilirler. Fiyatları güncellendikçe, yeni fiyatlar geçerli olma tarihleriyle birlikte (effectiveDate) kaydedilir.

factory

integer

üretici firmanın, ecza depolarına satış yaptığı fiyat (KDV hariç)

storage

integer

ecza depolarının hastanelere veya eczanelere satış yaptığı fiyat (KDV hariç)

taxPercent

integer

ilacın KDV oranı Örneğin "8" = %8

retail

integer

KDV dahil perakende satış fiyatı

storageBased

boolean

true = ilaç depocu fiyatlı ürün sınıfındadır. Bu ürünlerin perakende satışları olmaz. Sadece hastanelerde satılan ürünler bu sınıftadır false =

pharmacy

integer

KDV hariç eczane satış fiyatı

publicPrice

integer

SGK tarafından belirlenen kamu fiyatı (KDV hariç)

publicPriceVat

integer

KDV dahil kamu fiyatı

publicPaidPrice

publicPaidPrice

currencyCode

string

fiyatın döviz tipi. Dönen cevap; TRY, USD, EUR olabilir

abroadProduct

boolean

true = yurtdışı ilaç sınıfındadır. false = Türkiye'de ruhsatlı ilaç sınıfındadır

abroadPublicPaidPrice

integer

yurtdışı ilaçların kamu ödenen fiyatı

abroadPublicPrice

integer

yurtdışı ilaçların kamu fiyatı

abroadRetail

integer

yurtdışı ilaçların perakende satış fiyatı

publicPaidPrice

parametre
tipi
açıklama

price

integer

SGK tarafından geri ödenen kamu fiyatı (KDV hariç)

priceVatInc

integer

KDV dahil SGK tarafından ödenen kamu fiyatı

discountedPriceVatInc

integer

groupCode

string

SGK tarafından belirlenen eşdeğer grup kodu

groupLowestUnitPrice

boolean

true = eşdeğer grubu içerisinde en düşük birim fiyata sahip ürün false =

licenseeCompany

id

integer

ilacın ruhsat sahibi olan firmaya ait id

name

string

firmanın kısa adı​Örneğin

  • Abdi İbrahim

  • Berko

officialname

string

firmanın uzun adı​Örneğin

  • Abdi İbrahim İlaç Sanayi ve Ticaret Anonim Şirketi

  • Berko İlaç ve Kimya Sanayi Anonim Şirketi

website

string

web sitesi

fax

string

fax numarası

phone

string

telefon numarası

address

string

açık adres

email

string

e-posta adresi

city

string

il

district

string

ilçe

curl İstek Örneği

curl --location 'https://api.vapi.co/custom-product-card' \
--header 'Authorization: Bearer <API Anahtarı>'
curl --location 'https://api.vapi.co/custom-product-card/3195' \
--header 'Authorization: Bearer <API Anahtarı>'

postman İstek Örneği

Liste Sorgusu

Tekil Sorgu

Cevap örneği

Liste Sonucu

{
   "data":[
      {
         "product":{
            "id":4222,
            "name":"KATARİN Kapsül 250 mg/100 mg/2 mg 30 kapsüllük ambalaj"
         },
         "card":{
            "drugType":{
               "id":1,
               "name":"İlaç"
            },
            "licenseeCompany":{
               "id":18,
               "name":"Biofarma",
               "officialName":"Biofarma İlaç Sanayi ve Ticaret Anonim Şirketi",
               "website":"http://www.biofarma.com.tr",
               "fax":"0216 398 10 20",
               "phone":"0216 398 10 63",
               "address":"Akpınar Mah. Osmangazi Cad. No:156",
               "email":"[email protected]",
               "city":"İstanbul",
               "district":"Sancaktepe"
            },
            "indication":"Analjezik, antipiretik, dekonjestan ve antitüssif etkilidir. Ağrı kesici ve ateş düşürücü olarak soğuk algınlığı, nezle, grip, rinit, farenjit, sinüzit, bronşit ve larenjit gibi üst solunum yollarının akut enfeksiyonlarında semptomatik tedavide endikedir.",
            "prescriptionType":{
               "id":1,
               "name":"Beyaz Reçete"
            },
            "ingredients":[
               {
                  "id":1536,
                  "name":"Oksolamin",
                  "alternativeName":[
                     "Oksolamin"
                  ],
                  "amount":100,
                  "unit":{
                     "id":1,
                     "name":"mg"
                  }
               },
               {
                  "id":417,
                  "name":"Klorfeniramin",
                  "alternativeName":[
                     "Klorfeniramin",
                     "Klorfenamin"
                  ],
                  "amount":2,
                  "unit":{
                     "id":1,
                     "name":"mg"
                  }
               },
               {
                  "id":1565,
                  "name":"Parasetamol",
                  "alternativeName":[
                     "Parasetamol",
                     "Asetaminofen"
                  ],
                  "amount":250,
                  "unit":{
                     "id":1,
                     "name":"mg"
                  }
               }
            ],
            "barcodes":[
               {
                  "barcode":"8699578152215",
                  "skrsStatus":"Aktif"
               }
            ],
            "image":[
               {
                  "url":"https://files.vademecumonline.com.tr/PictureFile/middle/4222_8699578152215_1623577218.jpg",
                  "thumbnailUrl":"https://files.vademecumonline.com.tr/PictureFile/middle/thumbnail/4222_8699578152215_1623577218.jpg"
               }
            ],
            "price":{
               "effectiveDate":"2025-05-20",
               "factory":55.16,
               "storage":59.57,
               "taxPercent":10,
               "retail":83.87,
               "storageBased":false,
               "pharmacy":76.25,
               "discountRate":0,
               "publicPrice":76.25,
               "publicPriceVat":83.87,
               "publicPaidPrice":[
                  {
                     "price":76.25,
                     "priceVatInc":83.87,
                     "discountedPriceVatInc":80.93,
                     "groupCode":null,
                     "groupLowestUnitPrice":false
                  }
               ],
               "currencyCode":"TRY",
               "abroadProduct":false,
               "abroadPublicPaidPrice":null,
               "abroadPublicPrice":null,
               "abroadRetail":null
            }
         }
         ....
      }
   ],
   "_links":{
      "self":{
         "href":"https://api.vapi.co/custom-product-card?page=1"
      },
      "first":{
         "href":"https://api.vapi.co/custom-product-card?page=1"
      },
      "last":{
         "href":"https://api.vapi.co/custom-product-card?page=4"
      },
      "next":{
         "href":"https://api.vapi.co/custom-product-card?page=2"
      }
   },
   "_meta":{
      "totalCount":76,
      "pageCount":4,
      "currentPage":1,
      "perPage":20
   },
   "success":true
}

Tekil Sonuç

{
    "data": {
        "product": {
            "id": 3195,
            "name": "ASPİRİN Tablet 100 mg (Çocuklar için) 20 tabletlik ambalaj"
        },
        "card": {
            "drugType": {
                "id": 1,
                "name": "İlaç"
            },
            "licenseeCompany": {
                "id": 14,
                "name": "Bayer",
                "officialName": "Bayer Türk Kimya Sanayi Limited Şirketi",
                "website": "http://www.bayer.com.tr",
                "fax": "0216 527 87 00",
                "phone": "0216 528 36 00",
                "address": "Fatih Sultan Mehmet Mah. Balkan Cad. No:53",
                "email": "[email protected]",
                "city": "İstanbul",
                "district": "Ümraniye"
            },
            "indication": "<p>Analjezik, antipiretik, antiromatizmal ve antiagregandır. </p> <p> </p>",
            "prescriptionType": {
                "id": 1,
                "name": "Beyaz Reçete"
            },
            "ingredients": [
                {
                    "id": 2247,
                    "name": "Asetilsalisilik asit",
                    "alternativeName": [
                        "Asetilsalisilik asit"
                    ],
                    "amount": 100,
                    "unit": {
                        "id": 1,
                        "name": "mg"
                    }
                }
            ],
            "barcodes": [
                {
                    "barcode": "8699546010028",
                    "skrsStatus": "Aktif"
                },
                {
                    "barcode": "8699546010028",
                    "skrsStatus": "Aktif"
                }
            ],
            "image": [
                {
                    "url": "https://files.vademecumonline.com.tr/PictureFile/middle/ASPIRIN_100_mg_20_tab_cocuk.png",
                    "thumbnailUrl": "https://files.vademecumonline.com.tr/PictureFile/middle/thumbnail/ASPIRIN_100_mg_20_tab_cocuk.png"
                }
            ],
            "price": {
                "effectiveDate": "2024-10-25",
                "factory": 44.28,
                "storage": 47.82,
                "taxPercent": 10,
                "retail": 67.33,
                "storageBased": false,
                "pharmacy": 61.21,
                "discountRate": 0,
                "publicPrice": 61.21,
                "publicPriceVat": 67.33,
                "publicPaidPrice": [
                    {
                        "price": 32.15,
                        "priceVatInc": 35.37,
                        "discountedPriceVatInc": 34.13,
                        "groupCode": "TR-020B",
                        "groupLowestUnitPrice": false
                    }
                ],
                "currencyCode": "TRY",
                "abroadProduct": false,
                "abroadPublicPaidPrice": null,
                "abroadPublicPrice": null,
                "abroadRetail": null
            }
        }
    },
    "success": true
}
🧩Özel Ürün Kartı Kullanımı

Last updated