# Ö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 500. <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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.vapi.co/tr/api-klavuzu/ilaclar/ozel-kart.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.