---
title: Sipariş etiketleri
description: Sipariş etiketlerini yönetin ve siparişlere etiket atayın.
full: true
---

## OrderTag nesnesi [#OrderTag]

**`OrderTag`** (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!` |  |
| `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",
  "updatedAt": 1735725600000
}
```

## Sipariş etiketlerini listele [#listOrderTag]

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

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `id` | `StringFilterInput` | Kaydın ID değeri. |
| `includeDeleted` | `Boolean` | `true` gönderilirse silinmiş kayıtlar da listelenir. |
| `name` | `StringFilterInput` |  |
| `search` | `String` | Serbest metin araması. |
| `updatedAt` | `DateFilterInput` | Kaydın son güncellenme zamanı (milisaniye cinsinden Unix zaman damgası). |

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

Örnek istek - Sipariş Etiketlerini Listeleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Siparişlere etiket atayarak, bu siparişleri hem kendiniz, hem de yönetim panelini kullanan kullanıcılar filtreleyebilir.

```graphql
query ListOrderTag {
  listOrderTag {
    createdAt
    deleted
    id
    name
    updatedAt
  }
}
```

Örnek yanıt (temsili):

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

## Sipariş etiketi oluştur [#createOrderTag]

**`createOrderTag`** (mutation, v2)

OrderTag oluşturan mutation.

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

Parametreler:

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

Dönen değer: `OrderTag!`

Örnek istek - Sipariş Etiketi Oluşturma (`POST https://api.myikas.com/api/v2/admin/graphql`):

```graphql
mutation CreateOrderTag($input: CreateOrderTagInput!) {
  createOrderTag(input: $input) {
    createdAt
    deleted
    id
    name
    updatedAt
  }
}
```

```json
{
  "input": {
    "name": "Entegrasyona Aktarıldı"
  }
}
```

Örnek yanıt (temsili):

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

## Sipariş etiketini güncelle [#updateOrderTag]

**`updateOrderTag`** (mutation, v2)

OrderTag güncelleyen mutation.

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

Parametreler:

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

Dönen değer: `OrderTag!`

Örnek istek - Sipariş etiketini güncelleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

```graphql
mutation UpdateOrderTag($input: UpdateOrderTagInput!) {
  updateOrderTag(input: $input) {
    id
    name
    updatedAt
  }
}
```

```json
{
  "input": {
    "id": "b0275fd2-1191-4a1f-9ffb-426e19c4a0b8",
    "name": "Öncelikli kargo"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "updateOrderTag": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "name": "Örnek",
      "updatedAt": 1735725600000
    }
  }
}
```

## Sipariş etiketi kaydet [#saveOrderTag]

**`saveOrderTag`** (mutation, v1)

OrderTag kaydeden mutation.

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

Parametreler:

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

Dönen değer: `OrderTag!`

Örnek istek - Sipariş etiketi kaydetme (`POST https://api.myikas.com/api/v1/admin/graphql`):

Yeni bir sipariş etiketi oluşturur; `id` gönderilirse mevcut etiketi günceller.

```graphql
mutation SaveOrderTag($input: OrderTagInput!) {
  saveOrderTag(input: $input) {
    id
    name
    createdAt
    updatedAt
  }
}
```

```json
{
  "input": {
    "name": "Hediye paketi"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "saveOrderTag": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "name": "Örnek",
      "createdAt": 1735725600000,
      "updatedAt": 1735725600000
    }
  }
}
```

## Sipariş etiketlerini sil [#deleteOrderTagList]

**`deleteOrderTagList`** (mutation, v1 · v2)

OrderTag silen mutation.

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `idList` (zorunlu) | `[String!]!` | İşlem yapılacak kayıtların ID listesi. |

Dönen değer: `Boolean!`

Örnek istek - Sipariş etiketlerini silme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Artık kullanılmayan sipariş etiketlerini toplu olarak siler.

```graphql
mutation DeleteOrderTagList($idList: [String!]!) {
  deleteOrderTagList(idList: $idList)
}
```

```json
{
  "idList": [
    "4e99843f-442c-44da-8825-740ee0d6219b",
    "10f24e1b-394e-4081-b3b6-c45b41f1685c"
  ]
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "deleteOrderTagList": true
  }
}
```

## Siparişe etiket ekle [#addOrderTag]

**`addOrderTag`** (mutation, v1 · v2)

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `input` (zorunlu, yalnızca v2) | `SaveOrderTagInput!` | İşlemin girdi nesnesi. |
| `input` (zorunlu, yalnızca v1) | `UpdateOrderTagInput!` | İşlemin girdi nesnesi. |

Dönen değer: `Boolean!`

Örnek istek - Siparişe Etiket Ekleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

```graphql
mutation AddOrderTag($input: SaveOrderTagInput!) {
  addOrderTag(input: $input)
}
```

```json
{
  "input": {
    "name": "Entegrasyona Aktarıldı",
    "orderId": "5fadb84d-7703-4151-81be-a7d3f2400df5"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "addOrderTag": true
  }
}
```

## Siparişten etiket kaldır [#removeOrderTag]

**`removeOrderTag`** (mutation, v1 · v2)

Parametreler:

| Alan | Tip | Açıklama |
| --- | --- | --- |
| `input` (zorunlu, yalnızca v2) | `SaveOrderTagInput!` | İşlemin girdi nesnesi. |
| `input` (zorunlu, yalnızca v1) | `UpdateOrderTagInput!` | İşlemin girdi nesnesi. |

Dönen değer: `Boolean!`

Örnek istek - Siparişten etiket kaldırma (`POST https://api.myikas.com/api/v2/admin/graphql`):

Toptan satış sürecinden çıkan bir siparişten `Toptan` etiketini adıyla kaldırır.

```graphql
mutation RemoveOrderTag($input: SaveOrderTagInput!) {
  removeOrderTag(input: $input)
}
```

```json
{
  "input": {
    "orderId": "83019c3a-47b7-4b56-bcd0-95399f3f7937",
    "name": "Toptan"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "removeOrderTag": true
  }
}
```