> For the complete documentation index, see [llms.txt](https://doc.vapi.co/tr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.vapi.co/tr/api-klavuzu/ilaclar/ozel-kart.md).

# Özel Kart

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

[API URL](https://doc.vapi.co/tr/api-klavuzu/api-url)

### İstek Metodu: <mark style="color:green;">GET</mark>

### Header Parametreleri

<table><thead><tr><th width="154">parametre</th><th width="108">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>Authorization</td><td>string</td><td>Bearer &#x3C;API Anahtarı><a data-mention href="#curl-istek-oernegi">#curl-istek-oernegi</a> <a data-mention href="/pages/zRc6fGV2hPXt2r6jcjmm">/pages/zRc6fGV2hPXt2r6jcjmm</a></td></tr></tbody></table>

### İstek Parametreleri

<table><thead><tr><th width="153">parametre</th><th width="110">tipi</th><th width="367">açıklama</th><th>zorunlu</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>İlaca ait atanmış olan tekil ürün id bilgisi. Bu bilgiye /products metodunda bulunan id alanından alınabilir.</td><td>hayır</td></tr><tr><td>page</td><td>integer</td><td>Sayfa numarası <a data-mention href="/pages/LCWrIEr2Oa1wcVJ3MAsR">/pages/LCWrIEr2Oa1wcVJ3MAsR</a></td><td>hayır</td></tr><tr><td>per-page</td><td>integer</td><td>Bir sayfada bulunması istenen kayıt sayısı. Üst limit 20. <a data-mention href="/pages/LCWrIEr2Oa1wcVJ3MAsR">/pages/LCWrIEr2Oa1wcVJ3MAsR</a></td><td>hayır</td></tr></tbody></table>

### Cevap Parametreleri

#### <mark style="color:green;">data</mark> [Cevap Yapısı](/tr/api-klavuzu/cevap-yapisi.md)

<table><thead><tr><th width="232">parametre</th><th width="222">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>product</td><td>product</td><td><a data-mention href="#product">#product</a></td></tr><tr><td>card</td><td>card</td><td><a data-mention href="#card">#card</a></td></tr></tbody></table>

#### <mark style="color:green;">card</mark>

<table><thead><tr><th width="235.296875">parametre</th><th width="218.26953125">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>drugType</td><td>drugType </td><td><a data-mention href="#drugtype">#drugtype</a></td></tr><tr><td>licenseeCompany</td><td> company</td><td><a data-mention href="#licenseecompany">#licenseecompany</a></td></tr><tr><td>indication</td><td> text</td><td>İlacın endikasyon bilgisi</td></tr><tr><td>prescriptionType</td><td> prescriptiontype</td><td><a data-mention href="#prescriptiontype">#prescriptiontype</a></td></tr><tr><td>ingredients</td><td>ingredient[]</td><td><a data-mention href="#ingredient">#ingredient</a></td></tr><tr><td>barcodes</td><td>barcode[]</td><td><a data-mention href="#barcode">#barcode</a></td></tr><tr><td>image</td><td>image</td><td><a data-mention href="#image">#image</a></td></tr><tr><td>price</td><td>price</td><td><a data-mention href="#price">#price</a></td></tr></tbody></table>

#### <mark style="color:green;">product</mark>

<table><thead><tr><th width="137">parametre</th><th width="105">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>ürün tekil id'si</td></tr><tr><td>name</td><td>string</td><td><p>ürün ismi (drug + drugform + product şeklinde oluşturulmaktadır).</p><p></p><p><img src="/files/aEWWuFG9nyLGbhsCXD7s" alt="" data-size="original"></p><p> </p></td></tr></tbody></table>

#### <mark style="color:green;">barcode</mark>

<table><thead><tr><th width="117">parametre</th><th width="123">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>barcode</td><td>integer</td><td>ürünün barkodu. 12 veya 13 haneli olabilir.</td></tr><tr><td>skrsStatus</td><td>string</td><td>barkoda ait SKRS durumu. Sağlık Kodlama Referans Sunucusu'nda tanımlı olan barkodu ve barkodun durumunu açıklar. Dönen sonuç <mark style="color:red;">aktif</mark>, <mark style="color:red;">pasif</mark> veya <mark style="color:red;">liste dışı</mark> olacaktır.<br><br>İ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. </td></tr></tbody></table>

#### <mark style="color:green;">drugType</mark>

<table><thead><tr><th width="123">parametre</th><th width="119">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>ürüne ait drugType'ın id'si</td></tr><tr><td>name</td><td>string</td><td><p>drugType'ın ismi.</p><p></p><p>Dönen sonuç; </p><ul><li>İlaç</li><li>Kozmetik</li><li>Besin Desteği</li><li>Mama</li><li>Tıbbi amaçlı oral besin</li><li>Parenteral beslenme ürünü</li><li>Ara ürün</li><li>Enteral beslenme ürünü</li><li>İrigasyon solüsyonu</li><li>Parenteral solüsyon</li><li>İlaç benzeri</li><li>OTC</li><li>Medikal ürün</li><li>Tıbbi cihaz</li><li>Kofre</li><li>GBTÜ</li></ul><p>olabilir. </p></td></tr></tbody></table>

#### <mark style="color:green;">prescriptionType</mark>

<table><thead><tr><th width="124">parametre</th><th width="115">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>ürüne ait prescriptionType'ın id'si</td></tr><tr><td>name</td><td>string</td><td><p>prescriptionType'ın ismi.</p><p><br>Türkiye'de, ilaçlar 7 farklı türde reçetelenebilmektedir. </p><p><em>Beyaz Reçete: Çoğu ilacın yazıldığı, normal reçete türüdür.</em> </p><p><em><strong>Kısıtlanmış Beyaz Reçete:</strong> Uzman hekim tarafından yazılan reçete türüdür.</em></p><p><em><strong>Kontrole Tabi Reçete:</strong> Suistimal edilebilecek ilaçların yazıldığı reçete türüdür.</em></p><p><em><mark style="color:red;">Kırmızı Reçete:</mark> Narkotik ilaçların yazıldığı reçete türüdür.</em> </p><p><em><mark style="color:green;">Yeşil Reçete:</mark> Psikotrop ilaçların yazıldığı reçete türüdür.</em> </p><p><em><mark style="color:purple;">Mor Reçete:</mark> Kan ve kan ürünlerinin yazıldığı reçete türüdür.</em> </p><p><em><mark style="color:orange;">Turuncu Reçete:</mark> Kan faktörlerinin yazıldığı reçete türüdür.</em></p></td></tr></tbody></table>

#### <mark style="color:green;">ingredient</mark>

<table><thead><tr><th width="134">parametre</th><th width="113">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>ü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.</td></tr><tr><td>name</td><td>string</td><td><p>ürüne ait etken maddenin adı. <br><br>İlacın <strong>tedavi edici veya terapötik etkilerini sağlayan</strong> kimyasal bileşendir. Bu madde, ilacın ana aktif bileşeni olarak bilinir (bazı kaynaklarda <strong>etkin madde</strong> olarak da geçmektedir). </p><p></p><p>Bir ilacın etken maddesi, ilacın formülasyonundaki <strong>en önemli bileşendir</strong> 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.<br><br></p><p>Örneğin; "parasetamol 100 mg" için</p><ul><li>etken madde: parasetamol</li><li>amount: 100</li><li>unit: mg</li></ul></td></tr><tr><td>alternativeName</td><td>string</td><td><p>ürüne ait etken maddenin alternatif isimleri. <br><br>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. <br><br>Örneğin </p><ul><li>parasetamol (asetaminofen)</li><li>Asetilsalisilik asit (ASA) </li></ul></td></tr><tr><td>amount</td><td>integer</td><td><p>Ürünün etken maddeyi içerdiği miktar<br></p><p>Örneğin; "parasetamol 100 mg" için</p><ul><li>etken madde: parasetamol</li><li>amount: 100 </li><li>unit: mg</li></ul></td></tr><tr><td>unit</td><td>unit </td><td>etken madde içeriğinin birimi. amount'un tamamlayıcısıdır. detay için <a data-mention href="#unit">#unit</a></td></tr></tbody></table>

#### <mark style="color:green;">unit</mark>

<table><thead><tr><th width="134">parametre</th><th width="112">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>id</td><td>integer</td><td>unit'e ait id</td></tr><tr><td>name</td><td>string</td><td><p>unit'in ismi<br></p><p>Örneğin dönen sonuç</p><ul><li>mg</li><li>ml</li><li>mcg</li><li>L</li><li>kg</li><li>mg/ml</li><li>damla</li></ul><p>olabilir.  <br><br></p><p>Örneğin; "parasetamol 100 mg" için</p><ul><li>etken madde: parasetamol</li><li>amount: 100 </li><li>unit: mg</li></ul></td></tr></tbody></table>

#### <mark style="color:green;">image</mark>

<table><thead><tr><th width="208">parametre</th><th width="222">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>url</td><td>string</td><td>ilacın görseline ait URL</td></tr></tbody></table>

#### <mark style="color:green;">price</mark>

<table><thead><tr><th width="221">parametre</th><th width="222">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>effectiveDate</td><td>date</td><td>ilacın fiyat bilgisinin geçerli olduğu tarih. <br><br>İlaçlar 1'den fazla fiyata sahip olabilirler. Fiyatları güncellendikçe, yeni fiyatlar geçerli olma tarihleriyle birlikte (effectiveDate) kaydedilir. </td></tr><tr><td>factory</td><td>integer</td><td>üretici firmanın, ecza depolarına satış yaptığı fiyat (KDV hariç)</td></tr><tr><td>storage</td><td>integer</td><td>ecza depolarının hastanelere veya eczanelere satış yaptığı fiyat (KDV hariç)</td></tr><tr><td>taxPercent</td><td>integer</td><td>ilacın KDV oranı<br><br>Örneğin<br>"8" = %8</td></tr><tr><td>retail</td><td>integer</td><td>KDV dahil perakende satış fiyatı</td></tr><tr><td>storageBased</td><td>boolean</td><td><mark style="color:green;">true =</mark> 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<br><mark style="color:red;">false =</mark> </td></tr><tr><td>pharmacy</td><td>integer</td><td>KDV hariç eczane satış fiyatı</td></tr><tr><td>publicPrice</td><td>integer</td><td>SGK tarafından belirlenen kamu fiyatı (KDV hariç)</td></tr><tr><td>publicPriceVat</td><td>integer</td><td>KDV dahil kamu fiyatı</td></tr><tr><td>publicPaidPrice</td><td>publicPaidPrice </td><td><a data-mention href="#publicpaidprice">#publicpaidprice</a></td></tr><tr><td>currencyCode</td><td>string</td><td>fiyatın döviz tipi. <br>Dönen cevap; TRY, USD, EUR olabilir</td></tr><tr><td>abroadProduct</td><td>boolean</td><td><mark style="color:green;">true =</mark> yurtdışı ilaç sınıfındadır.<br><mark style="color:red;">false =</mark> Türkiye'de ruhsatlı ilaç sınıfındadır</td></tr><tr><td>abroadPublicPaidPrice</td><td>integer</td><td>yurtdışı ilaçların kamu ödenen fiyatı</td></tr><tr><td>abroadPublicPrice</td><td>integer</td><td>yurtdışı ilaçların kamu fiyatı</td></tr><tr><td>abroadRetail</td><td>integer</td><td>yurtdışı ilaçların perakende satış fiyatı</td></tr></tbody></table>

#### <mark style="color:green;">publicPaidPrice</mark>

<table><thead><tr><th width="222">parametre</th><th width="222">tipi</th><th>açıklama</th></tr></thead><tbody><tr><td>price</td><td>integer</td><td>SGK tarafından geri ödenen kamu fiyatı (KDV hariç)</td></tr><tr><td>priceVatInc</td><td>integer</td><td>KDV dahil SGK tarafından ödenen kamu fiyatı</td></tr><tr><td>discountedPriceVatInc</td><td>integer</td><td></td></tr><tr><td>groupCode</td><td>string</td><td>SGK tarafından belirlenen eşdeğer grup kodu</td></tr><tr><td>groupLowestUnitPrice</td><td>boolean</td><td><mark style="color:green;">true =</mark> eşdeğer grubu içerisinde en düşük birim fiyata sahip ürün<br><mark style="color:red;">false =</mark> </td></tr></tbody></table>

#### <mark style="color:green;">licenseeCompany</mark>

|              |         |                                                                                                                                                        |
| ------------ | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| id           | integer | ilacın ruhsat sahibi olan firmaya ait id                                                                                                               |
| name         | string  | <p>firmanın kısa adı​Örneğin</p><ul><li>Abdi İbrahim</li><li>Berko</li></ul>                                                                           |
| officialname | string  | <p>firmanın uzun adı​Örneğin</p><ul><li>Abdi İbrahim İlaç Sanayi ve Ticaret Anonim Şirketi</li><li>Berko İlaç ve Kimya Sanayi Anonim Şirketi</li></ul> |
| 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                                                                                                                                                   |

#### &#x20; <a href="#curl-istek-ornegi" id="curl-istek-ornegi"></a>

### <mark style="color:blue;">curl</mark> İstek Örneği

```powershell
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ı>'
```

### <mark style="color:blue;">postman</mark> İstek Örneği

**Liste Sorgusu**

<figure><img src="/files/uSGFSYgvWwCewLuE3iAg" alt=""><figcaption></figcaption></figure>

**Tekil Sorgu**

<figure><img src="/files/ZQsaZafXDRAqNCYFdybO" alt=""><figcaption></figcaption></figure>

### Cevap örneği

**Liste Sonucu**

```json
{
   "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":"info@biofarma.com.tr",
               "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ç**

```json
{
    "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": "bilgi@bayer.com.tr",
                "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
}
```

{% content-ref url="/pages/mq0NNhIoyDG6CVwoCqfQ" %}
[Özel Ürün Kartı Kullanımı](/tr/ozellestirme-ve-filtreleme-yontemleri/ozel-urun-karti-kullanimi.md)
{% endcontent-ref %}