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
1-) API hesabınız, yetkisiz erişimlere ikinci bir önlem olarak IP Adresi ile sınırlandırılmıştır.
1-a) IP Adresi kısıtı sadece Canlı Mod için geçerlidir. Postman testlerinizi Demo Mod'da IP Sınırlandırması olmadan gerçekleştirebilirsiz.
2-) Girdiğiniz IP Adresinin doğruluğuna emin olduktan sonra girişinizi onaylayın.
3-) API Gizli Anahtarımı Oluştur butonuna tıklayarak API hesabınızın kurulumunu tamamlayın.
e-Arşiv Fatura API Bilgilerinizi Edinin
1-) API hesabınızın modunu Canlı veya Demo olarak değiştirebilirsiniz. Canlı Mod, resmi E-Arşiv veya E-Fatura oluşturacağından, test aşamasında kullanmamanız tavsiye edilir. Demo Mod'dayken yaptığınız testler JSON Array tipinde bir sonuç üretecektir. JSON'un doğruluğunu teyit ettikten sonra API'nızı Canlı Mod'a alabilirsiniz.
2-) API isteklerinizde Basic Auth Username alanında kullanacağınız anahtar, aynı zamanda Lisans ID'nizdir.
3-) API İsteklerinizde Basic Auth Password alanında kullanacağınız benzersiz, gizli API anahtarınızdır.
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
1-) Fatura oluşturma Endpoint:
2-) Authorization tipi: Basic Auth seçilmelidir.
3 ve 4-) API hesabınızı oluştururken edindiğiniz API Anahtarı (1309 İle Başlayan Lisans ID) ve Gizli anahtar.
{
"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/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(
'Basic : *********',
'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 = [
'Basic' => '************',
'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.
