Fatura Arama

GET /v1/invoicing/invoices?q=<değer>

Belgeyi kimliğiyle arar. Yanıtını kaybettiğiniz bir kesimi bulmak için tarih aralığı tarayıp istemci tarafında eşleştirmeniz gerekmez — bkz. Eşleştirme.

İstek

curl "https://sandbox-api.finansfatura.com/v1/invoicing/invoices?q=FA02026000002668" \
  -H "X-Api-Key: $FF_KEY"

q üç kimlikte birden arar:

Kimlik	Eşleşme biçimi
ETTN	parçalı + harf duyarsız
Fatura numarası	parçalı + harf duyarsız
Belge UUID'si	tam eşleşme

GET /v1/invoicing/invoices?q=05CF936E-D493-5010-A6C8-BDBE9FD619D3
GET /v1/invoicing/invoices?q=FA02026000002668
GET /v1/invoicing/invoices?q=1bed7456-e6bc-457d-b3dd-37ec0e1de9df

Mevcut filtrelerle birlikte

q diğer filtrelerin yerine geçmez, onlarla birlikte çalışır:

Parametre	Açıklama
q	Kimlik araması (yukarısı)
status	Belge durumu — bkz. Durum Sorgula
document_type	EFATURA | EARSIV | …
date_from, date_to	Kesim tarihi aralığı
page, page_size	Sayfalama

Yanıt

200 OK

{
  "results": [
    {
      "id": "1bed7456-e6bc-457d-b3dd-37ec0e1de9df",
      "ettn": "05CF936E-D493-5010-A6C8-BDBE9FD619D3",
      "invoice_number": "FA02026000002668",
      "document_type": "EFATURA",
      "status": "ACCEPTED",
      "fk_transaction_header_id": "9f1c2d3e-4a5b-6c7d-8e9f-0a1b2c3d4e5f",
      "issued_at": "2026-10-01T00:00:00Z",
      "pdf_url": "https://fnsf.tr/f/...",
      "created_at": "2026-10-01T00:00:03Z"
    }
  ],
  "page": 1,
  "page_size": 20
}

Alan	Açıklama
id	Finans Fatura belge kimliği (document_id).
ettn	GİB ETTN.
fk_transaction_header_id	Belgenin bağlı olduğu satışın kimliği.
issued_at	Belgenin kesildiği an.

Toplu indirme ile birlikte

POST /v1/invoicing/invoices/bulk aynı q alanını kabul eder — belirli bir arama kümesinin PDF/XML'lerini tek seferde indirmek için kullanın. Biçim seçenekleri için bkz. Fatura İndir.