Gelen fatura detayı

Belirli bir gelen faturayı kalemleri ve hata kayıtlarıyla birlikte almak için bu endpoint kullanılır.

İstek

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

{id}, gelen fatura listesindeki id değeridir. Hesabınıza ait olmayan bir ID için 404 döner.

Örnek istekler

💻 cURL

curl -X GET "https://app.faturaentegrator.com/api/incoming-invoices/57" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

🐘 PHP

<?php
$ch = curl_init('https://app.faturaentegrator.com/api/incoming-invoices/57');
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 res = await fetch('https://app.faturaentegrator.com/api/incoming-invoices/57', {
  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/incoming-invoices/57',
    headers={'Accept': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY'},
)
data = r.json()

🔷 C#

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Accept", "application/json");
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_API_KEY");
var response = await client.GetAsync("https://app.faturaentegrator.com/api/incoming-invoices/57");
var data = await response.Content.ReadFromJsonAsync<JsonElement>();

Örnek yanıt

Başlık alanları listedekiyle aynıdır; detayda ek olarak lines ve errors döner.

{
  "data": {
    "id": 57,
    "source": "einvoice",
    "profile": "TICARIFATURA",
    "document_number": "ABC2026000000123",
    "payable_amount": "1200.00",
    "response": null,
    "can_respond": true,
    "...": "...",
    "lines": [
      {
        "id": 301,
        "line_number": 1,
        "name": "Ofis Sandalyesi",
        "description": null,
        "seller_product_code": "SND-01",
        "buyer_product_code": null,
        "manufacturer_product_code": null,
        "quantity": "2.000000",
        "unit": "C62",
        "unit_price": "500.000000",
        "allowance_amount": "0.00",
        "line_total": "1000.00",
        "vat_rate": "20.00",
        "vat_amount": "200.00",
        "taxes": []
      }
    ],
    "errors": []
  }
}

lines[] alanları

Alan	Açıklama
line_number	Faturadaki satır sırası.
seller_product_code / buyer_product_code / manufacturer_product_code	Satıcı, alıcı ve üretici ürün kodları (faturada varsa).
quantity, unit	Miktar ve birim kodu — bkz. birim kodları.
allowance_amount	Satır indirimi.
line_total	Vergi hariç satır tutarı.
vat_rate, vat_amount	KDV oranı ve tutarı.
taxes	Satırdaki vergi ayrıntıları (faturada varsa).

errors[] alanları

PDF hazırlama veya durum sorgusu gibi arka plan işlemlerinde oluşan hatalar burada birikir; en yeni kayıt en üsttedir. Yapısı fatura hata kayıtlarıyla aynıdır (action, message, created_at).