Eafatura.com API
Eafatura.com API
v2.0 Fatura İşlemleri / Fatura Oluştur

Fatura Oluştur API

Bu servis, müşterileriniz için anında fatura oluşturmanızı sağlar. İstek gövdesi detay, müşteri ve kalemler olmak üzere 3 ana düğümden (node) oluşur.

Hangi Belge Oluşturulur?

Tek uç iki belge tipini de üretir ve seçim sizin hesabınıza göre yapılır: e-Fatura mükellefiyseniz e-Fatura, değilseniz e-Arşiv fatura oluşturulur. Gövde her iki durumda da aynıdır; yalnızca aşağıda "yalnız e-Fatura" olarak işaretlenen alanlar e-Arşiv tarafında yok sayılır.

Önemli Validasyon Kuralları
  • • customer.name alanı zorunludur. VKN (10 hane) için firma unvanı, TCKN (11 hane) için ad soyad tek alanda gönderilmelidir.
  • • İl, ilçe, açık adres ve ürün detayları (fiyat, miktar, kdv oranı) kesinlikle boş bırakılamaz.
  • • Fiyatlar KDV Dahil (unitPriceIncludingVat) olarak iletilmelidir. Sistem matrahı otomatik hesaplar.
  • • e-Fatura mükellefiyseniz internet üzerinden yapılan satışlarda taşıyıcı ve gönderi bilgisinin faturada yer alması kanunen zorunludur. Bunun için detail.internetSale ile birlikte taşıyıcı alanlarını gönderin.
  • • Tarih alanlarında gg/aa/yyyy ve yyyy-aa-gg yazımlarının ikisi de kabul edilir; sistem belge tipine göre kendisi dönüştürür.
POST https://www.eafatura.com/api/v2/create-invoice
Kopyalandı

Header Parametreleri

Body Parametreleri (Müşteri & Kalemler)

customer (Müşteri Bilgileri)
detail.invoiceDate
string (gg/aa/yyyy Formatında)

Fatura Tarihi (opsiyonel, varsayılan: bugünkü tarih)
detail.orderNumber
string

Sipariş numarası (opsiyonel). Gönderirseniz faturada bu numara görünür ve aynı numarayla ikinci bir fatura kesilmez; canlı modda bu numaraya ait fatura zaten varsa istek, mevcut fatura numarasıyla birlikte reddedilir. Boş bırakırsanız o anın tarihinden otomatik üretilir (örn. 15 Ekim 2026 18:58 için 151020261858). Sipariş numarasını notes içine yazmak bu alanın yerine geçmez.
customer.taxOrIdentityNumber Zorunlu
string (10 veya 11 Hane)

TCKN (Şahıs) veya VKN (Firma).
customer.name Zorunlu
string

Şahıs için ad soyad, firma için unvan bilgisini tek alanda gönderin.
customer.city / district Zorunlu
string
customer.address Zorunlu
string

Açık adres bilgisi.
items (Fatura Kalemleri - Array)
items[0].name Zorunlu
string
items[0].quantity / unitCode Zorunlu
float / string
items[0].unitPriceIncludingVat / vatRate Zorunlu
float / int

Birim fiyat KDV Dahil gönderilmelidir.
detail (İnternet Satışı — yalnız e-Fatura Mükellefleri için)
detail.internetSale
boolean

Satış internet üzerinden yapıldıysa true gönderin. Aşağıdaki alanlar yalnızca bu değer true iken gövdeye eklenir — true yapıp sağdaki örnek isteğin nasıl değiştiğini görebilirsiniz.
detail.carrierName
string

Taşıyıcı unvanı. Firma adı (Yurtiçi Kargo) veya kısa anahtar (yurtici) kabul edilir. Taşıyıcının vergi numarası bu addan otomatik çözülür, ayrıca göndermenize gerek yoktur.
detail.shipmentDate
string (gg/aa/yyyy veya yyyy-aa-gg)

Gönderi (sevk) tarihi.
detail.purchaseUrl
string

Satışın gerçekleştiği web adresi.
detail.paymentMeans
string

Ödeme şekli.
detail.paymentDate
string (gg/aa/yyyy veya yyyy-aa-gg)

Ödeme tarihi.
Fatura Notu (ARRAY)
notes[0]
string

Kod Örnekleri


        

    






    
Yanıt Örnekleri