Siparişin fatura verisi

Bir siparişten hangi fatura gövdesinin üretileceğini görmek için bu endpoint kullanılır. Yanıt, doğrudan fatura oluşturma isteğine gönderebileceğiniz hazır bir gövdedir: sipariş alanları fatura alanlarına eşlenir, eksik kalanlar panelinizdeki varsayılan ayarlarla tamamlanır.

İstek

GET /api/order/{id}/invoice-data
Accept: application/json
Authorization: Bearer YOUR_API_KEY

Yol /api/order (tekil) ile başlar

Listeleme ve güncelleme /api/orders (çoğul) altındayken bu endpoint ve siparişten fatura oluşturma /api/order/{id}/... yolunu kullanır.

Ne işe yarar?

Sipariş ile fatura arasındaki eşleme sunucu tarafında yapılır. Bu endpoint, faturayı kesmeden önce sonucu önizlemenizi ve gerekirse birkaç alanı değiştirip POST /api/order/{id}/invoice ile göndermenizi sağlar.

Eşleme sırasında uygulanan kurallar:

Fatura alanı	Nereden gelir
type	Her zaman SATIS.
issue_date / issue_time	Panel ayarınıza göre: bugünün tarihi, sipariş tarihi veya ödeme tarihi.
order_id, order_d_id, order_created_at	Siparişin platform_id, platform_d_id, platform_date alanları.
invoice_integration_id	Hesabınızdaki varsayılan fatura entegrasyonu.
customer.id	Siparişin platform_customer_id alanı.
customer.*	Siparişin billingAddress bilgileri (email için platform_customer_email).
lines[].id	Sipariş satırının platform_id alanı.
lines[].exemption_code / exemption_reason	Satırın KDV oranı 0 ise varsayılan ayarlardaki istisna kodu/gerekçesi; değilse boş.
is_internet_sale / internet_sale	Siparişte platform_url varsa internet satışı kabul edilir; ödeme bilgileri siparişten alınır.
is_need_shipment / shipment	Siparişte kargo bilgisi varsa doldurulur; eksikler varsayılan ayarlardan tamamlanır.
cash_sale	Her zaman true.

KDV %0 satırlar için varsayılan istisna kodunu tanımlayın

Sipariş satırlarında istisna kodu tutulmaz. tax_rate: 0 olan bir satır varsa ve panelde Ayarlar → Varsayılanlar altında istisna kodu/gerekçesi tanımlı değilse, üretilen gövdedeki exemption_code ve exemption_reason boş gelir; bu gövdeyi olduğu gibi gönderirseniz fatura oluşturma KDV oranı 0 olan ürünlerde istisna kodu zorunludur. hatası verir. Bu durumda alanları göndermeden önce elle doldurun — kod listesi: Sabitler.

Örnek istekler

💻 cURL

curl -X GET "https://app.faturaentegrator.com/api/order/30/invoice-data" \
  -H "Accept: application/json" -H "Authorization: Bearer YOUR_API_KEY"

🐘 PHP

<?php
$ch = curl_init('https://app.faturaentegrator.com/api/order/30/invoice-data');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => ['Accept: application/json', 'Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_RETURNTRANSFER => true,
]);
$invoiceBody = json_decode(curl_exec($ch), true);
curl_close($ch);

// İstenirse alanlar düzenlenip siparişten fatura endpoint'ine gönderilir.
$invoiceBody['description'] = 'Web siparişi';

🟢 Node.js

const res = await fetch('https://app.faturaentegrator.com/api/order/30/invoice-data', {
  headers: { Accept: 'application/json', Authorization: 'Bearer YOUR_API_KEY' },
});
const invoiceBody = await res.json();

🐍 Python

import requests
r = requests.get(
    'https://app.faturaentegrator.com/api/order/30/invoice-data',
    headers={'Accept': 'application/json', 'Authorization': 'Bearer YOUR_API_KEY'},
)
invoice_body = r.json()

Örnek yanıt

Yanıt data sarmalayıcısı kullanmaz; doğrudan fatura gövdesidir.

{
  "type": "SATIS",
  "currency": "TRY",
  "currency_rate": 1,
  "issue_date": "2026-07-31",
  "issue_time": "09:20",
  "order_id": "ORD-2026-1001",
  "order_d_id": "1001",
  "order_created_at": "2026-07-30",
  "waybill_number": "",
  "waybill_date": "",
  "description": null,
  "sale_channel_id": 5,
  "invoice_integration_id": 9,
  "cash_sale": true,
  "payment_date": "2026-07-30",
  "customer": {
    "id": "CUST-555",
    "tax_number": "11111111111",
    "tax_office": null,
    "title": null,
    "name": "Ahmet",
    "surname": "Yılmaz",
    "phone": "+905551234567",
    "email": "musteri@example.com",
    "address": "Örnek Mah. Test Sok. No:1 D:2",
    "city": "İstanbul",
    "district": "Kadıköy",
    "country": "TÜRKİYE",
    "postcode": "",
    "type": "person",
    "iban": ""
  },
  "lines": [
    {
      "id": "ITEM-001",
      "name": "Kablosuz Kulaklık",
      "description": null,
      "quantity": 2,
      "sku": "SKU-001",
      "unit": "C62",
      "unit_price": "500.00",
      "discount_type": "amount",
      "discount": "50.00",
      "tax_rate": 20,
      "exemption_code": "",
      "exemption_reason": ""
    }
  ],
  "is_internet_sale": true,
  "internet_sale": {
    "web_address": "https://ornek-magaza.com/siparis/ORD-2026-1001",
    "payment_method": "credit_or_debit",
    "payment_platform": "iyzico",
    "payment_date": "2026-07-30"
  },
  "is_need_shipment": true,
  "shipment": {
    "company_title": "Yurtiçi Kargo",
    "company_tax_number": "9860008925",
    "courier_name": null,
    "courier_tax_number": null,
    "delivery_date": "2026-08-02"
  }
}