---
title: Faturalar
description: Siparişlere fatura ekleyin, indirin ve kaldırın.
full: true
---

## Siparişe fatura ekle [#addOrderInvoice]

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

Siparişe fatura eklemek için bu mutation'ı kullanın.

Parametreler:

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

Dönen değer: `Order`

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

```graphql
mutation AddOrderInvoice($input: AddOrderInvoiceInput!) {
  addOrderInvoice(input: $input) {
    archived
    createdAt
    currencyCode
    id
    orderNumber
    status
    totalFinalPrice
    updatedAt
  }
}
```

```json
{
  "input": {
    "appId": "3ab4af2c-65e2-4f12-ad71-b8a80325fd34",
    "base64": "JVBERi0xLjQNCiW0tba3DQoxIDAgb2Jq...<kısaltıldı>",
    "createdAt": null,
    "invoiceData": null,
    "invoiceNumber": "IK00000001",
    "orderId": "5fadb84d-7703-4151-81be-a7d3f2400df5",
    "sendNotificationToCustomer": false,
    "type": "COMPANY"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "addOrderInvoice": {
      "archived": false,
      "createdAt": 1735725600000,
      "currencyCode": "TRY",
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "orderNumber": "1001",
      "status": "CANCELLED",
      "totalFinalPrice": 129.9,
      "updatedAt": 1735725600000
    }
  }
}
```

Örnek istek - Siparişe fatura PDF'i ekleme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Fatura uygulaması e-Arşiv faturasını kestikten sonra PDF dosyasını base64 olarak siparişe ekler ve müşteriyi bilgilendirir.

```graphql
mutation AddOrderInvoice($input: AddOrderInvoiceInput!) {
  addOrderInvoice(input: $input) {
    id
    orderNumber
    invoices {
      id
      invoiceNumber
      type
      hasPdf
      createdAt
    }
  }
}
```

```json
{
  "input": {
    "orderId": "aa1a60d5-a351-455c-b8ec-4ca329d2866b",
    "appId": "cb3ea1c9-1584-4fc0-bcaf-682ab17661ac",
    "invoiceNumber": "KTA2026000001234",
    "type": "COMPANY",
    "createdAt": 1791876240000,
    "base64": "JVBERi0xLjcKJeLjz9MKMSAwIG9iago8PC9UeXBlL0NhdGFsb2cvUGFnZXMgMiAwIFI+PgplbmRvYmoK",
    "sendNotificationToCustomer": true
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "addOrderInvoice": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "orderNumber": "1001",
      "invoices": [
        {
          "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
          "invoiceNumber": "string",
          "type": "COMPANY",
          "hasPdf": true,
          "createdAt": 1735725600000
        }
      ]
    }
  }
}
```

## Faturayı indir [#downloadOrderInvoice]

**`downloadOrderInvoice`** (mutation, v2)

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

Parametreler:

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

Dönen değer: `String`

Örnek istek - Faturayı indirme (`POST https://api.myikas.com/api/v2/admin/graphql`):

Siparişe eklenmiş bir faturanın PDF dosyasını indirmek için kullanılacak adresi döner.

```graphql
mutation DownloadOrderInvoice($input: GetOrderInvoicePdfUrlInput!) {
  downloadOrderInvoice(input: $input)
}
```

```json
{
  "input": {
    "orderId": "aa1a60d5-a351-455c-b8ec-4ca329d2866b",
    "invoiceId": "c772b484-f823-408d-bc21-02dbc6bb0ab9"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "downloadOrderInvoice": "string"
  }
}
```

## Fatura PDF adresini al [#getOrderInvoicePdfUrl]

**`getOrderInvoicePdfUrl`** (mutation, v1)

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

Parametreler:

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

Dönen değer: `String`

Örnek istek - Fatura PDF adresini alma (`POST https://api.myikas.com/api/v1/admin/graphql`):

Siparişe eklenmiş bir faturanın PDF adresini döner.

```graphql
mutation GetOrderInvoicePdfUrl($input: GetOrderInvoicePdfUrlInput!) {
  getOrderInvoicePdfUrl(input: $input)
}
```

```json
{
  "input": {
    "orderId": "aa1a60d5-a351-455c-b8ec-4ca329d2866b",
    "invoiceId": "c772b484-f823-408d-bc21-02dbc6bb0ab9"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "getOrderInvoicePdfUrl": "https://ornek.myikas.com"
  }
}
```

## Faturayı kaldır [#removeOrderInvoice]

**`removeOrderInvoice`** (mutation, v2)

Siparişe eklenmiş bir faturayı kaldırmak için bu mutation'ı kullanın.

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

Parametreler:

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

Dönen değer: `Order`

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

Hatalı kesilip iptal edilen bir faturayı siparişten kaldırır.

```graphql
mutation RemoveOrderInvoice($input: RemoveOrderInvoiceInput!) {
  removeOrderInvoice(input: $input) {
    id
    orderNumber
    invoices {
      id
      invoiceNumber
    }
  }
}
```

```json
{
  "input": {
    "orderId": "aa1a60d5-a351-455c-b8ec-4ca329d2866b",
    "invoiceId": "c772b484-f823-408d-bc21-02dbc6bb0ab9"
  }
}
```

Örnek yanıt (temsili):

```json
{
  "data": {
    "removeOrderInvoice": {
      "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
      "orderNumber": "1001",
      "invoices": [
        {
          "id": "0f9d2c3e-6b1a-4c7e-9a52-3d8e1f4b7c21",
          "invoiceNumber": "string"
        }
      ]
    }
  }
}
```