---
title: Satış kanalları
description: Satış kanallarını sorgulayın ve güncelleyin.
full: true
---

## SalesChannel nesnesi [#SalesChannel]

**`SalesChannel`** (v1 · v2)

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `createdAt` | `Timestamp` | Kaydın oluşturulma zamanı (milisaniye cinsinden Unix zaman damgası). |
| `deleted` | `Boolean!` | Kaydın silinmiş olup olmadığı. |
| `id` | `String!` | Kaydın ID değeri. |
| `name` | `String!` | Satış kanalı adı alanı. |
| `paymentGateways` | `[SalesChannelPaymentGateway!]` | Satış kanalı ödeme altyapısı (payment gateway) alanı. |
| `priceListId` | `String` | Satış kanalı priceList alanı. |
| `stockLocations` | `[SalesChannelStockLocation!]` | Satış kanalı stok lokasyonları alanı. |
| `type` | `SalesChannelTypeEnum!` | Değerler: `ADMIN`, `APP`, `B2B_STOREFRONT`, `FACEBOOK`, `FIRSAT`, `GOOGLE`, `POS`, `STOREFRONT`, `STOREFRONT_APP`. |
| `updatedAt` | `Timestamp` | Kaydın son güncellenme zamanı (milisaniye cinsinden Unix zaman damgası). |

Örnek (temsili):

```json
{
  "createdAt": 1735725600000,
  "deleted": false,
  "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
  "name": "Örnek",
  "paymentGateways": [
    {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "order": 1
    }
  ],
  "priceListId": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
  "stockLocations": [
    {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "order": 1
    }
  ],
  "type": "ADMIN",
  "updatedAt": 1735725600000
}
```

## Satış kanallarını listele [#listSalesChannel]

**`listSalesChannel`** (query, v1 · v2)

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `id` | `StringFilterInput` | Kaydın ID değeri. |

Dönen değer: `[SalesChannel!]!`

Örnek istek - Satış Kanallarını Listeleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

```graphql
query ListSalesChannel {
  listSalesChannel {
    createdAt
    deleted
    id
    name
    paymentGateways {
      id
      order
    }
    priceListId
    stockLocations {
      id
      order
    }
    type
    updatedAt
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "listSalesChannel": [
      {
        "createdAt": 1735725600000,
        "deleted": false,
        "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
        "name": "Örnek",
        "paymentGateways": [
          {
            "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
            "order": 1
          }
        ],
        "priceListId": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
        "stockLocations": [
          {
            "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
            "order": 1
          }
        ],
        "type": "ADMIN",
        "updatedAt": 1735725600000
      }
    ]
  }
}
```

Örnek istek - Satış kanallarını listeleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

```graphql
{
  listSalesChannel {
    createdAt
    deleted
    id
    name
    priceListId
    stockLocations {
      order
    }
    paymentGateways {
      order
    }
    type
    updatedAt
  }
}
```

Örnek yanıt:

```json
{
  "data": {
    "listSalesChannel": [
      {
        "createdAt": 1631194974624,
        "deleted": false,
        "id": "b61fd49c-ebd5-49fa-9c80-d547c167d084",
        "name": "Online Mağaza",
        "priceListId": null,
        "stockLocations": [
          {
            "order": 1
          }
        ],
        "paymentGateways": [
          {
            "order": 0
          }
        ],
        "type": "STOREFRONT",
        "updatedAt": 1631195159983
      }
    ]
  }
}
```

## Satış kanalını getir [#getSalesChannel]

<Callout type="info" title="Uygulamanın kendi satış kanalı">
`getSalesChannel`, `updateSalesChannel` ve `saveSalesChannel` uygulamanın kendi satış kanalı üzerinde çalışır. Uygulama satış kanalı olarak tanımlı değilse `APP_IS_NOT_A_SALES_CHANNEL` hatası döner. v1 `saveSalesChannel` gönderilmeyen `priceListId` ve `stockLocations` alanlarını temizler; değiştirmek istemediğiniz değerleri de gönderin.
</Callout>

**`getSalesChannel`** (query, v1 · v2)

Bu API ile satış kanalınızı görüntüleyebilirsiniz.

Parametreler:

_Parametre yok._

Dönen değer: `SalesChannel`

Örnek istek - Satış kanalı detayını getirme (`POST https://api.myikas.com/api/v2/admin/graphql`):

```graphql
{
  getSalesChannel {
    createdAt
    deleted
    id
    name
    priceListId
    type
    updatedAt
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "getSalesChannel": {
      "createdAt": 1735725600000,
      "deleted": false,
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "name": "Örnek",
      "priceListId": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "type": "ADMIN",
      "updatedAt": 1735725600000
    }
  }
}
```

## Satış kanalını güncelle [#updateSalesChannel]

**`updateSalesChannel`** (mutation, v2)

Bu API ile satış kanalının adını, priceList ID'sini ve stockLocations özelliklerini güncelleyebilirsiniz.

Yalnızca v2 endpoint'inde: `https://api.myikas.com/api/v2/admin/graphql`

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `input` (zorunlu) | `UpdateSalesChannelInput!` | İşlemin girdi nesnesi. |

Dönen değer: `SalesChannel!`

Örnek istek - Satış kanalını güncelleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Satış kanalı olarak kurulan bir pazaryeri uygulaması, kendi satış kanalının adını, fiyat listesini ve stok lokasyonlarının öncelik sırasını günceller. Uygulama satış kanalı olarak kurulmamışsa `APP_IS_NOT_A_SALES_CHANNEL` hatası döner.

```graphql
mutation UpdateSalesChannel($input: UpdateSalesChannelInput!) {
  updateSalesChannel(input: $input) {
    id
    name
    type
    priceListId
    stockLocations {
      id
      order
    }
    updatedAt
  }
}
```

```json
{
  "input": {
    "name": "Kuzey Pazaryeri",
    "priceListId": "46f8debb-cf61-4035-8647-db73e75902f5",
    "stockLocations": [
      {
        "id": "dbd52e9e-7068-45b5-9097-8f466c5f56cf",
        "order": 1
      },
      {
        "id": "dcdb78a2-1433-4aeb-8e66-59d44fd6f56e",
        "order": 2
      }
    ]
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "updateSalesChannel": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "name": "Örnek",
      "type": "ADMIN",
      "priceListId": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "stockLocations": [
        {
          "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
          "order": 1
        }
      ],
      "updatedAt": 1735725600000
    }
  }
}
```

## Satış kanalı kaydet [#saveSalesChannel]

**`saveSalesChannel`** (mutation, v1)

Bu API ile satış kanalının adını, priceList ID'sini ve stockLocations özelliklerini güncelleyebilirsiniz.

Yalnızca v1 endpoint'inde: `https://api.myikas.com/api/v1/admin/graphql`. v2 karşılığı: `updateSalesChannel`.

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `input` (zorunlu) | `SalesChannelInput!` | İşlemin girdi nesnesi. |

Dönen değer: `SalesChannel`

Örnek istek - Satış kanalını kaydetme (`POST https://api.myikas.com/api/v1/admin/graphql`):

Satış kanalı olarak kurulan uygulamanın kendi satış kanalını günceller; yeni bir satış kanalı oluşturmaz. Gönderilmeyen `priceListId` boşaltılır ve `stockLocations` listesi tamamen değiştirilir. v2 üzerinde `updateSalesChannel` mutation'ını kullanın.

```graphql
mutation SaveSalesChannel($input: SalesChannelInput!) {
  saveSalesChannel(input: $input) {
    id
    name
    type
    priceListId
    stockLocations {
      id
      order
    }
    createdAt
    updatedAt
  }
}
```

```json
{
  "input": {
    "name": "Kuzey Pazaryeri",
    "priceListId": "46f8debb-cf61-4035-8647-db73e75902f5",
    "stockLocations": [
      {
        "id": "dbd52e9e-7068-45b5-9097-8f466c5f56cf",
        "order": 1
      },
      {
        "id": "dcdb78a2-1433-4aeb-8e66-59d44fd6f56e",
        "order": 2
      }
    ]
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "saveSalesChannel": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "name": "Örnek",
      "type": "ADMIN",
      "priceListId": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "stockLocations": [
        {
          "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
          "order": 1
        }
      ],
      "createdAt": 1735725600000,
      "updatedAt": 1735725600000
    }
  }
}
```