İrsaliye detayı

Giden veya gelen bir irsaliyeyi taraflar, kalemler, hata kayıtları ve bağlı faturasıyla birlikte almak için bu endpoint kullanılır.

İstek

GET /api/waybills/{id}
Accept: application/json
Authorization: Bearer YOUR_API_KEY

{id} hem giden hem gelen irsaliyeler için aynı endpoint'le sorgulanır. Hesabınıza ait olmayan bir ID için 404 döner.

Örnek istekler

💻 cURL

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

🐘 PHP

<?php
$ch = curl_init('https://app.faturaentegrator.com/api/waybills/214');
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/waybills/214', {
  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/214',
    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/waybills/214");
var data = await response.Content.ReadFromJsonAsync<JsonElement>();

Örnek yanıt

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

{
  "data": {
    "id": 214,
    "direction": "outgoing",
    "document_number": "IRS2026000000101",
    "status": "failed",
    "invoice_id": null,
    "invoice": null,
    "parties": [
      { "role": "delivery", "identifier_number": "1234567890", "title": "Örnek Ticaret A.Ş.", "...": "..." }
    ],
    "lines": [
      {
        "id": 811,
        "line_number": 1,
        "name": "Örnek Ürün",
        "seller_product_code": "SKU-001",
        "quantity": "2.000000",
        "unit": "C62",
        "unit_price": "100.000000",
        "line_total": "200.00",
        "tax_rate": "20.00",
        "...": "..."
      }
    ],
    "errors": [
      {
        "id": 12,
        "waybill_id": 214,
        "action": "checkStatus",
        "message": "Alıcı VKN'si geçersiz.",
        "created_at": "2026-09-30T10:33:02.000000Z"
      }
    ],
    "...": "..."
  }
}

lines[] alanları

Gelen irsaliyelerde quantity teslim edilen miktarı gösterir. outstanding_quantity (eksik kalan) ve oversupply_quantity (fazla gönderilen) alanları da gönderici tarafından doldurulabilir. İrsaliye yanıtında kalemleri line_number ile eşleştirirsiniz.

errors[] alanları

İrsaliye failed durumuna geçtiğinde hatanın nedeni buraya yazılır; en yeni kayıt en üsttedir. action değeri hatanın oluştuğu adımı gösterir: create (sağlayıcıya iletim) veya checkStatus (durum sorgusu). Yapısı fatura hata kayıtlarıyla aynıdır.

Hatalı giden irsaliyenin hakkı otomatik iade edilir. Düzelttiğiniz bilgilerle yeni bir irsaliye oluşturabilir, hatalı kaydı da silebilirsiniz.