İrsaliye listesi

Giden ve gelen irsaliyeler ayrı endpoint'lerden listelenir. Filtre, sıralama ve sayfalama parametreleri iki endpoint'te de aynıdır.

İstek

GET /api/waybills/outgoing
GET /api/waybills/incoming
Accept: application/json
Authorization: Bearer YOUR_API_KEY

Endpoint	Döndürdüğü kayıtlar
/api/waybills/outgoing	Sizin oluşturduğunuz giden irsaliyeler.
/api/waybills/incoming	Tedarikçilerinizin size gönderdiği gelen irsaliyeler.

Gelen irsaliyeler nasıl listeye düşer?

Gelen irsaliyeler, fatura hesabınızın sağlayıcısından 15 dakikada bir otomatik aktarılır. Bunun için sağlayıcının gelen irsaliyeyi desteklemesi ve panelde ilgili hesabın ayarlarında gelen irsaliye aktarımının açık olması gerekir. Aktarılan her yeni irsaliye planınızdan 1 hak düşer; hakkınız bittiyse yeni irsaliyeler aktarılmaz. Gelen irsaliyeler completed durumuyla kaydedilir.

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 kaydedilen irsaliye en üstte olacak şekilde sıralanır.

Sıralanabilir alan	Örnek
issue_date	?sort=issue_date: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.

Alan	Açıklama
status	İrsaliye durumu — bkz. Sabitler.
provider_status	Sağlayıcıdaki ham durum metni.
invoice_integration_id	İrsaliyenin bağlı olduğu fatura hesabı.
document_number	İrsaliye numarası.
ettn	ETTN (UUID).
issue_date	Düzenlenme tarihi.
created_at	Kaydın oluşturulma zamanı.
parties	Taraf alt alanları (örn. parties][identifier_number, parties][role).

Örnek: belirli bir alıcıya kesilmiş, hatalı giden irsaliyeler:

GET /api/waybills/outgoing?filters[status][$eq]=failed&filters[parties][identifier_number][$eq]=1234567890

Örnek istekler

💻 cURL

curl -G "https://app.faturaentegrator.com/api/waybills/incoming" \
  --data-urlencode "filters[issue_date][\$gte]=2026-09-01" \
  --data-urlencode "sort=issue_date:desc" \
  --data-urlencode "per_page=50" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

🐘 PHP

<?php
$q = http_build_query([
    'filters[issue_date][$gte]' => '2026-09-01',
    'sort' => 'issue_date:desc',
    'per_page' => 50,
]);
$ch = curl_init('https://app.faturaentegrator.com/api/waybills/incoming?' . $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);

🟢 Node.js

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

🐍 Python

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

Örnek yanıt

Listede her irsaliye; fatura hesabı, taraflar (parties) ve hata kayıtlarıyla (errors) birlikte döner. Kalemler (lines) ve bağlı fatura (invoice) yalnızca irsaliye detayında yer alır.

{
  "data": [
    {
      "id": 305,
      "invoice_integration_id": 9,
      "invoice_id": null,
      "direction": "incoming",
      "ettn": "1c9e7f20-3b4a-4d5e-8f6a-7b8c9d0e1f2a",
      "document_number": "IRS2026000000045",
      "profile": "TEMELIRSALIYE",
      "type": "SEVK",
      "issue_date": "2026-09-29",
      "actual_dispatch_date": "2026-09-29",
      "license_plate": "06XYZ789",
      "status": "completed",
      "provider_status": "...",
      "pdf_url": "https://app.faturaentegrator.com/storage/waybills/45/305.pdf",
      "receipt_ettn": null,
      "receipted_at": null,
      "invoice_integration": { "id": 9, "invoice_integration": "mysoft", "...": "..." },
      "parties": [
        { "role": "supplier", "identifier_number": "9876543210", "title": "Tedarikçi Lojistik Ltd.", "...": "..." },
        { "role": "delivery", "identifier_number": "1234567890", "title": "Örnek Ticaret A.Ş.", "...": "..." }
      ],
      "errors": [],
      "...": "..."
    }
  ],
  "links": { "first": "...", "last": "...", "prev": null, "next": "..." },
  "meta": { "current_page": 1, "per_page": 15, "total": 8, "last_page": 1 }
}

Alan	Açıklama
direction	outgoing (giden) veya incoming (gelen).
status	Platformdaki durum; provider_status ise sağlayıcının ham durum metnidir.
invoice_id	Giden irsaliye faturalandırıldıysa oluşan faturanın ID'si.
receipt_ettn, receipt_document_number, receipted_at	Gelen irsaliyeye irsaliye yanıtı verildiyse dolar.
parties[].role	Tarafın rolü — bkz. Sabitler.