Gelen fatura listesi

Tedarikçilerinizin size kestiği e-Fatura ve e-Arşiv faturalarını listelemek için bu endpoint kullanılır. Filtre, sıralama ve sayfalama parametreleri query string ile iletilir.

İstek

GET /api/incoming-invoices
Accept: application/json
Authorization: Bearer YOUR_API_KEY

Gelen faturalar nasıl listeye düşer?

Gelen faturalar API ile oluşturulmaz; fatura hesabınızın sağlayıcısından 15 dakikada bir otomatik aktarılır. Aktarımın çalışması için:

Fatura hesabınızın sağlayıcısı gelen fatura aktarımını desteklemelidir.
Panelde ilgili fatura hesabının ayarlarında gelen fatura aktarımı açık olmalıdır.
Aktarılan her yeni fatura, planınızdan 1 hak düşer. Hakkınız bittiyse yeni faturalar, hak tanımlanana kadar aktarılmaz.

Sayfalama

Parametre	Varsayılan	Açıklama
`per_page`	`15`	Sayfa başına kayıt sayısı.
`page`	`1`	Sayfa numarası.

Yanıt, Laravel sayfalama zarfıyla (data, links, meta) döner.

Sıralama

sort parametresi alan:yön biçiminde verilir. Gönderilmezse en son aktarılan fatura en üstte olacak şekilde sıralanır.

Sıralanabilir alan	Örnek
`issue_date`	`?sort=issue_date:desc`
`payable_amount`	`?sort=payable_amount:desc`
`created_at`	`?sort=created_at:asc`
`updated_at`	`?sort=updated_at:desc`

Filtreleme

Filtreler, fatura listesindeki ile aynı köşeli parantez sözdizimini ($eq, $contains, $in, $or …) kullanır. Yalnızca aşağıdaki alanlarda filtreleme yapılabilir; listede olmayan bir alan gönderirseniz filtre uygulanmaz.

Alan	Açıklama
`source`	`einvoice` (e-Fatura) veya `earchive` (e-Arşiv) — bkz. Sabitler.
`profile`	Fatura profili (örn. `TICARIFATURA`, `TEMELFATURA`).
`provider_status`	Sağlayıcıdaki ham durum metni (örn. `KABUL`, `RED`).
`response`	Verilen yanıt: `accepted`, `rejected`. Yanıtlanmamışlar için `$null`.
`invoice_integration_id`	Faturanın aktarıldığı fatura hesabı.
`document_number`	Fatura numarası.
`ettn`	ETTN (UUID).
`supplier_identifier_number`	Tedarikçinin VKN/TCKN'si.
`supplier_title`	Tedarikçinin ünvanı veya ad soyadı.
`issue_date`	Fatura tarihi.
`created_at`	Faturanın panele aktarıldığı zaman.

Örnek: yanıt bekleyen ticari faturalar, fatura tarihine göre yeniden eskiye:

GET /api/incoming-invoices?filters[profile][$eq]=TICARIFATURA&filters[response][$null]=true&sort=issue_date:desc

Örnek istekler

💻 cURL
🐘 PHP
🟢 Node.js
🐍 Python

curl -G "https://app.faturaentegrator.com/api/incoming-invoices" \
  --data-urlencode "filters[supplier_identifier_number][\$eq]=1234567890" \
  --data-urlencode "sort=issue_date:desc" \
  --data-urlencode "per_page=50" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

<?php
$q = http_build_query([
    'filters[supplier_identifier_number][$eq]' => '1234567890',
    'sort' => 'issue_date:desc',
    'per_page' => 50,
]);
$ch = curl_init('https://app.faturaentegrator.com/api/incoming-invoices?' . $q);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Accept: application/json', 'Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

const params = new URLSearchParams({
  'filters[supplier_identifier_number][$eq]': '1234567890',
  sort: 'issue_date:desc',
  per_page: '50',
});
const res = await fetch(`https://app.faturaentegrator.com/api/incoming-invoices?${params}`, {
  headers: { Accept: 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
});
const data = await res.json();

import requests
r = requests.get(
    'https://app.faturaentegrator.com/api/incoming-invoices',
    params={
        'filters[supplier_identifier_number][$eq]': '1234567890',
        'sort': 'issue_date:desc',
        'per_page': 50,
    },
    headers={'Accept': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY'},
)
data = r.json()

Örnek yanıt

Listede faturanın başlık bilgileri ve fatura hesabı özeti döner. Kalemler (lines) ve hata kayıtları (errors) yalnızca gelen fatura detayında yer alır.

{
  "data": [
    {
      "id": 57,
      "invoice_integration_id": 9,
      "source": "einvoice",
      "ettn": "3f2b8c1e-9a4d-4e7b-8c2a-1d5e6f7a8b9c",
      "document_number": "ABC2026000000123",
      "profile": "TICARIFATURA",
      "type": "SATIS",
      "issue_date": "2026-09-28",
      "issue_time": "14:05:00",
      "due_date": null,
      "currency": "TRY",
      "currency_rate": "1.000000",
      "supplier_identifier_number": "1234567890",
      "supplier_title": "Örnek Tedarik A.Ş.",
      "supplier": { "identifier_number": "1234567890", "title": "Örnek Tedarik A.Ş.", "...": "..." },
      "line_extension_amount": "1000.00",
      "tax_exclusive_amount": "1000.00",
      "tax_inclusive_amount": "1200.00",
      "allowance_total_amount": "0.00",
      "tax_total_amount": "200.00",
      "withholding_tax_amount": "0.00",
      "payable_amount": "1200.00",
      "provider_status": "KABUL",
      "response": "accepted",
      "response_reason": null,
      "responded_at": "2026-09-28T12:40:11.000000Z",
      "pdf_url": "https://app.faturaentegrator.com/storage/incoming-invoices/45/57.pdf?v=1790596800",
      "can_respond": false,
      "created_at": "2026-09-28T11:15:02.000000Z",
      "invoice_integration": { "id": 9, "invoice_integration": "mysoft", "...": "..." },
      "...": "..."
    }
  ],
  "links": { "first": "...", "last": "...", "prev": null, "next": "..." },
  "meta": { "current_page": 1, "per_page": 15, "total": 42, "last_page": 3 }
}

Alan	Açıklama
`source`	`einvoice` veya `earchive`. e-Arşiv faturalarda sağlayıcıdan durum sorgulanmaz.
`provider_status`	Sağlayıcının döndürdüğü ham durum. `KABUL` / `RED` geldiğinde `response` alanı da otomatik güncellenir.
`response`	Faturaya verilen yanıt: `accepted`, `rejected` ya da `null` (yanıtlanmamış). Yanıt paneldeki veya sağlayıcı portalındaki işlemle de dolabilir.
`can_respond`	`true` ise fatura kabul / red edilebilir.
`pdf_url`	Hazırlanmışsa PDF adresi; `null` ise PDF endpoint'i ile alınır.

İstek​

Sayfalama​

Sıralama​

Filtreleme​

Örnek istekler​

Örnek yanıt​