{
  "info": {
    "name": "eFaturan Fatura API'si v1",
    "description": "Değişkenler: baseUrl (ör. https://panel.efaturan.com/api/v1), apiKey (ef_test_… ile başlayın), invoiceId, vknTckn.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://panel.efaturan.com/api/v1"
    },
    {
      "key": "apiKey",
      "value": "ef_test_..."
    },
    {
      "key": "invoiceId",
      "value": ""
    },
    {
      "key": "vknTckn",
      "value": "1234567890"
    }
  ],
  "item": [
    {
      "name": "Fatura kes ya da taslak oluştur",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiKey}}"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{$guid}}",
            "description": "Zorunlu"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/invoices",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "invoices"
          ]
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"buyer\": {\n    \"taxOrIdNumber\": \"1234567890\",\n    \"title\": \"Örnek Ticaret Ltd. Şti.\",\n    \"taxOffice\": \"Kadıköy\",\n    \"city\": \"İstanbul\",\n    \"district\": \"Kadıköy\",\n    \"address\": \"Caferağa Mah. Örnek Sok. No: 1\",\n    \"email\": \"muhasebe@ornek.com.tr\"\n  },\n  \"lines\": [\n    {\n      \"name\": \"Danışmanlık hizmeti\",\n      \"quantity\": 1,\n      \"unit\": \"C62\",\n      \"unitPriceExcl\": 1000,\n      \"vatRate\": 20\n    }\n  ],\n  \"note\": \"Sipariş no: 1001\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "e-Fatura / e-Arşiv belgesini numaralandırıp keser. Belge türü alıcının e-Fatura mükellefiyetine göre kendiliğinden seçilir (İhracat her zaman e-Fatura). `mode: \"draft\"` yalnızca panelde taslak oluşturur. Idempotency-Key ZORUNLU: aynı anahtarla yinelenen istek ikinci belge kesmez, ilk yanıtı döner.\n\nKapsam: invoices:write"
      }
    },
    {
      "name": "Faturaları listele",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiKey}}"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/invoices?limit=25",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "invoices"
          ],
          "query": [
            {
              "key": "limit",
              "value": "25",
              "disabled": false
            },
            {
              "key": "from",
              "value": "",
              "disabled": true
            },
            {
              "key": "to",
              "value": "",
              "disabled": true
            },
            {
              "key": "status",
              "value": "",
              "disabled": true
            },
            {
              "key": "documentType",
              "value": "",
              "disabled": true
            },
            {
              "key": "cursor",
              "value": "",
              "disabled": true
            }
          ]
        },
        "description": "Anahtarın ortamındaki giden faturalar; yeniden eskiye (oluşturulma sırası). Süzgeçler fatura tarihine göredir. İmleçli sayfalama: nextCursor → cursor.\n\nKapsam: invoices:read"
      }
    },
    {
      "name": "Fatura ayrıntısı",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiKey}}"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/invoices/{{invoiceId}}",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "invoices",
            "{{invoiceId}}"
          ]
        },
        "description": "Kalemler ve alıcı bilgisiyle fatura; ya da API ile oluşturulmuş, henüz kesilmemiş taslak. Başka hesabın ya da öbür ortamın belgesi 404.\n\nKapsam: invoices:read"
      }
    },
    {
      "name": "Fatura PDF'i",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiKey}}"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/invoices/{{invoiceId}}/pdf",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "invoices",
            "{{invoiceId}}",
            "pdf"
          ]
        },
        "description": "Entegratördeki belgenin PDF görüntüsü. Yeni kesilmiş belgede dosya hazır değilse 409.\n\nKapsam: invoices:read"
      }
    },
    {
      "name": "Fatura XML'i (UBL-TR)",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiKey}}"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/invoices/{{invoiceId}}/xml",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "invoices",
            "{{invoiceId}}",
            "xml"
          ]
        },
        "description": "Belgenin imzalı UBL-TR XML'i. Yeni kesilmiş belgede dosya hazır değilse 409.\n\nKapsam: invoices:read"
      }
    },
    {
      "name": "e-Arşiv faturasını iptal et",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiKey}}"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{$guid}}",
            "description": "İsteğe bağlı"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/invoices/{{invoiceId}}/cancel",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "invoices",
            "{{invoiceId}}",
            "cancel"
          ]
        },
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "Yalnızca e-Arşiv faturası iptal edilir (e-Fatura iptal edilemez → 409 INVALID_STATE). İptal kontörü geri vermez. Gövde boş olabilir.\n\nKapsam: invoices:write"
      }
    },
    {
      "name": "Faturayı e-postayla gönder",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiKey}}"
          },
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Idempotency-Key",
            "value": "{{$guid}}",
            "description": "İsteğe bağlı"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/invoices/{{invoiceId}}/send-email",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "invoices",
            "{{invoiceId}}",
            "send-email"
          ]
        },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"emails\": [\n    \"muhasebe@ornek.com.tr\"\n  ]\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        },
        "description": "PDF ve XML ekli e-posta; her adrese ayrı. Hesap başına saatte 30 gönderim (panelden gönderilenlerle birlikte sayılır). Test ortamı belgesi yalnızca hesabın doğrulanmış e-posta adreslerine gider (başka adres 422); konuda \"DENEME\" yazar.\n\nKapsam: invoices:write"
      }
    },
    {
      "name": "e-Fatura mükellef sorgusu",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiKey}}"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/taxpayers/{{vknTckn}}",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "taxpayers",
            "{{vknTckn}}"
          ]
        },
        "description": "VKN/TCKN'nin GİB e-Fatura kayıtlı kullanıcı listesinde olup olmadığı, kayıtlı unvan ve posta kutusu etiketleri. Adres ve vergi dairesi döndürülmez. Hesap başına 10 dakikada 120 sorgu.\n\nKapsam: taxpayers:read"
      }
    },
    {
      "name": "Hesap, paket ve kontör",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiKey}}"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/account",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "account"
          ]
        },
        "description": "Paket, abonelik, kontör bakiyesi, aylık kota, ortam ve anahtar bilgisi.\n\nKapsam: account:read"
      }
    },
    {
      "name": "Fatura serileri",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Authorization",
            "value": "Bearer {{apiKey}}"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/series",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "series"
          ]
        },
        "description": "Anahtarın ortamındaki etkin e-Fatura ve e-Arşiv serileri (POST /invoices › seriesId).\n\nKapsam: account:read"
      }
    }
  ]
}
