1- Ücretsiz veya Premium eafatura.com e-Arşiv Fatura Entegrasyon Lisansı
2- Panelinizden Edineceğiniz API Bilgileriniz
3- Düşük Düzeyde Kodlama Bilgisi
Ücretsiz Pazaryeri & WooCommerce e-Arşiv Entegrasyon Hesabınızı Oluşturun
Entegrasyon Lisansına Kayıtlı Değilseniz Kaydolmak İçin Trendyol, Hepsiburada, WooCommerce e-Arşiv Fatura Entegrasyonu Hesap Oluşturma linkine tıklayarak kaydolabilirsiniz.
e-Arşiv Fatura API Bilgilerinizi Oluşturun
Okla belirtilen API Gizli Anahtarımı Oluştur butonuna tıkladığınızda gerekli ve size özel API Bilgileriniz hızlıca oluşacaktır.
e-Arşiv Fatura API Bilgilerinizi Edinin
Entegrason anahtarlarınız artık hazır! Lisans ID'niz ve API Gizli Anahtarınızı dilediğiniz zaman Kopyala butonuna tıklayarak kullanabilirsiniz.
Kendi Websiteme Nasıl Entegre Ederim?
Servis Metodu: POST
Fatura Oluşturma API Servis Endpoint: https://www.eafatura.com/api/satis-fatura-olustur
API Yetkilendirme
POST isteğinde 2 adet Header değeri eklemelisiniz. LisansID anahtarını Header alanına ekleyin ve değer olarak API Gizli Anahtarınızı oluşturduğunuz sayfadaki Lisans ID'nizi yazın. 2. alan olarak da SecretKey anahtarını ekleyerek API Gizli Anahtarınızı değer olarak yazın.
Örnek Request JSON Body
{
"musteri": {
"ad": "Özkan", // STRING - Müşteri Adı, LTD ve AŞ'lerde Boş Gönderilir
"soyad": "Şahin", //STRING - Müşteri Soyadı, LTD ve AŞ'lerde Boş Gönderilir
"unvan": "Özkan Şahin", // STRING - LTD ve AŞ'lerde Şirket Ünvanı, Şahıslarda Ad Soyad
"tcVkn": "12345678901", // STRING - TC veya Vergi Numarası, Boş Gönderilirse 11 Adet 1 Değeri Alır
"vd": "Hızırbey", // STRING - Vergi Dairesi, Yoksa Boş Gönderilir
"adres": "Fener Mahallesi", // STRING - Müşteri Fatura Adresi
"ilce": "Çarşıbaşı", // STRING - Müşteri Fatura İlçesi
"il": "Trabzon", // STRING - Müşteri Fatura İli
"eposta": "ozkansahin.api@gmail.com" // STRING - Müşteri E-Postası, Yoksa Boş Gönderilir
},
"urunler": [
{
"urun_adi": "Örnek 1. Ürün", // STRING - 1. Ürünün Adı
"urun_adet": 1, // INT - 1. Ürünün Adedi
"birim_fiyat": "199.90", // STRING - 1. Ürünün Fiyatı
"urun_kdv": 20 // INT - 1. Ürünün KDV Oranı
},
{
"urun_adi": "Örnek 2. Ürün", // STRING - 2. Ürünün Adı
"urun_adet": 2, // INT - 2. Ürünün Adedi
"birim_fiyat": "349.90", // STRING - 2. Ürünün Fiyatı
"urun_kdv": 20 // INT - 2. Ürünün KDV Oranı
}
],
"detay": {
"not": "Fatura Not Bilgileri", // STRING - Fatura Not Alanı, Boş Gönderilebilir
"internetSatisi": 1, // BOOLEAN - İnternet Satışıysa 1, Değilse 0 Gönderilir
"siparisNumarasi": "2131464502", // STRING - Sipariş Numarası, Boş Gönderilebilir
"siparisTarihi": "25-05-2023", // STRING - Sipariş Tarihi, Boş Gönderilebilir
"sanalPos": "iyzico" // STRING - Ödeme Yapılan Sanal POS (iyzico, paytr, parampos) Değilse Boş Gönderilebilir
}
}
$requrest =
array(
'musteri' => array(
'ad' => 'Özkan', // STRING - Müşteri Adı, LTD ve AŞ'lerde Boş Gönderilir
'soyad' => 'Şahin', //STRING - Müşteri Soyadı, LTD ve AŞ'lerde Boş Gönderilir
'unvan' => 'Özkan Şahin', // STRING - LTD ve AŞ'lerde Şirket Ünvanı, Şahıslarda Ad Soyad
'tcVkn' => '12345678901', // STRING - TC veya Vergi Numarası, Boş Gönderilirse 11 Adet 1 Değeri Alır
'vd' => 'Hızırbey', // STRING - Vergi Dairesi, Yoksa Boş Gönderilir
'adres' => 'Fener Mahallesi', // STRING - Müşteri Fatura Adresi
'ilce' => 'Çarşıbaşı', // STRING - Müşteri Fatura İlçesi
'il' => 'Trabzon', // STRING - Müşteri Fatura İli
'eposta' => 'ozkansahin.api@gmail.com' // STRING - Müşteri E-Postası, Yoksa Boş Gönderilir
),
'urunler' => array(
0 => array(
'urun_adi' => 'Örnek 1. Ürün', // STRING - 1. Ürünün Adı
'urun_adet' => 1, // INT - 1. Ürünün Adedi
'birim_fiyat' => "199.90", // STRING - 1. Ürünün Fiyatı
'urun_kdv' => 20 // INT - 1. Ürünün KDV Oranı
),
1 => array(
'urun_adi' => 'Örnek 2. Ürün', // STRING - 2. Ürünün Adı
'urun_adet' => 2, // INT - 2. Ürünün Adedi
'birim_fiyat' => "349.90", // STRING - 2. Ürünün Fiyatı
'urun_kdv' => 20 // INT - 2. Ürünün KDV Oranı
),
),
'detay' => array(
'not' => 'Fatura Not Bilgileri', // STRING - Fatura Not Alanı, Boş Gönderilebilir
'internetSatisi' => 1, // BOOLEAN - İnternet Satışıysa 1, Değilse 0 Gönderilir
'siparisNumarasi' => '2131464502', // STRING - Sipariş Numarası, Boş Gönderilebilir
'siparisTarihi' => '25-05-2023', // STRING - Sipariş Tarihi, Boş Gönderilebilir
'sanalPos' => 'iyzico' // STRING - Ödeme Yapılan Sanal POS (iyzico, paytr, parampos) Değilse Boş Gönderilebilir
)
);
PHP diliyle yazılmış web sitenizde dilerseniz aşağıda paylaşacağımız örnek kodu da kullanabilirsiniz. Yukarıda verdiğimiz Array'i kendi sisteminizde kolayca hazırlayarak json_encode ile JSON'a dönüştürerek cURL isteği gönderebilirsiniz. Aşağıdaki örnekte kullanım örneğini inceleyin.
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://www.eafatura.com/api/satis-fatura-olustur',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS => json_encode($request), // Fatura Oluşturacağımız Bilgileri Depoladığımız $request Arrayi
CURLOPT_HTTPHEADER => array(
'LisansID: xxxxxxxxx', // eafatura.com e-Arşiv Lisans ID niz
'SecretKey: MB-yKxxxxxxxxxxxxxxxxxxx', // API Gizli Anahtarınız
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
$result = json_decode($response); // Servisten Dönen JSON u Object e Dönüştür.
print_r($result); // Object i Yazdır -- Alt kısımdaki alanda servisten dönen cevabı nasıl kullanacağınızı görebilirsiniz
PHP Guzzle Kütüphanesini kullanarak örnek e-Arşiv Fatura oluşturmak için aşağıdaki örnek kodu inceleyebilirsiniz.
$client = new Client();
$headers = [
'LisansID' => 'xxxxxxxxx',
'SecretKey' => 'MB-yKxxxxxxxxxxxxxxxxxxx',
'Content-Type' => 'application/json'
];
$body = '{
"musteri": {
"ad": "Özkan",
"soyad": "Şahin",
"unvan": "Özkan Şahin",
"adres": "Fener Mahallesi",
"ilce": "Çarşıbaşı",
"il": "Trabzon",
"eposta": "ozkansahin.api@gmail.com"
},
"urunler": [
{
"urun_adi": "Örnek 1. Ürün",
"urun_adet": 1,
"birim_fiyat": "199.90",
"urun_kdv": 20
},
{
"urun_adi": "Örnek 2. Ürün",
"urun_adet": 2,
"birim_fiyat": "349.90",
"urun_kdv": 20
}
],
"detay": {
"not": "Fatura Not Bilgileri",
"internetSatisi": 1,
"siparisNumarasi": "2131464502",
"siparisTarihi": "25-05-2023",
"sanalPos": "iyzico"
}
}';
$request = new Request('POST', 'https://www.eafatura.com/api/satis-fatura-olustur', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();
{
"sonuc": 1, // fatura oluşturma başarılı
"islem_id": "785ea8-bbd5e3-ae7e", // istek IDniz
"ettn": "b70xxxx-xxxx-xxxx-xxxx-059069xxxxx", // fatura ettn
"pdf_url": "https://www.eafatura.com/fatura-pdf-url.pdf" // public e-Arşiv PDF fatura adresi
}
eafatura.com e-Arşiv Fatura Entegrasyon Lisansınız ile kullanabileceğiniz ücretsiz API servisimiz için ihtiyaca bağlı diğer geliştirmeler de eklenecektir. SATIŞ tipinde e-Arşiv Fatura oluşturabilmeniz için gerekli tüm işlemleri en basit haliyle anlatmaya çalıştık.
eafatura.com, tüm müşterilerine 7/24 Kurumsal Ücretsiz Teknik Destek sunmaktadır. Teknik Destek ihtiyacınız olduğunda bize ulaşmaktan çekinmeyin.
