Download the PHP package aad/fatura without Composer
On this page you can find all versions of the php package aad/fatura. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package fatura
🧾 Fatura
Bu paket Fatih Kadir Akın'ın hazırlamış olduğu fatura paketinin PHP dili ile yazılmış versiyonudur.
eFatura sistemi üzerinde fatura oluşturmanızı sağlar.
Bu sistem https://earsivportal.efatura.gov.tr/ adresini kullanarak bu sistem üzerinden fatura oluşturmanızı sağlar.
Bu sistem GİB'e tabi şahış şirketi ya da şirket hesapları ile çalışır ve bu kişilikler adına resmi fatura oluşturur. Kesilen faturaları https://earsivportal.efatura.gov.tr/ adresinden görüntüleyebilir ya da bu kütüphane ile indirebilirsiniz.
Kullanıcı Adı ve Parola Bilgileri
https://earsivportal.efatura.gov.tr/intragiris.html adresindeki parola ekranında kullanılan kullanıcı kodu ve parola ile bu paketi kullanabilirsiniz. ℹ️ Bu kullanıcı kodu ve parola bilgilerini muhasebecinizden ya da GİB - İnteraktif Vergi Dairesi'nden edinebilirsiniz.
Kurulum
Kullanım
Service sınıfının constructor ına konfigürasyon bilgilerini vererek kullanabilirsiniz.
Örnek fatura bilgileri ve servis ayarları
Aşağıdaki şekilde fatura detaylarını kullanacağınız metoda parametre olarak verip faturanın bu bilgiler ile oluşmasını sağlayabilirsiniz. Bu bilgiler anlatılan örneklerde kullanılacaktır.
Aşağıda servis ayarlarına ilişkin olması gereken bilgiler örnek olarak belirtilmiştir.
base_url
veservice_type
bilgileri gönderilmediği durumda e-arşiv portalı test ortam bilgileri baz alınacaktır. Bu bilgiler anlatılan örneklerde kullanılacaktır.
createInvoiceAndGetDownloadURL
Bu metod imzalanmış faturayı oluşturur ve indirme adresi döner.
createInvoiceAndGetHTML
Bu metod imzalanmış faturayı oluşturur ve fatura çıktısını HTML formatta döner. Bu HTML'i iframe
içerisinde gösterip yazdırılmasını sağlayabilirsiniz.
Diğer Kullanım Örnekleri
getToken
eFatura Portal'ını kullanabileceğiniz token
'ı döner.
createDraftInvoice
eFatura.gov.tr'de fatura direkt oluşmaz. Önce Taslak fatura oluşturmak gerekir. createDraftInvoice size taslak bir fatura oluşturacaktır. $fatura_detaylari
değişkeninde olması gereken bilgiler kullanım
başlığı altında belirtilmiştir.
findDraftInvoice
Taslak olarak oluşturulan her fatura içerisinde uuid
ve date
bilgisi yer alır. Bu metod aracılığı ile belirtilen tarih aralığındaki taslak faturalar aranır. Arama sonuçlarında belirtilen uuid
yi içeren fatura bilgisi var ise detaylarını döner. Şayet belirtilen uuid
ve date
bilgileriyle eşleşen bir taslak fatura bulunamaz ise boş array
döner.
Belirtilen
uuid
vedate
bilgisi ile eşleşen kayıt sonucu aşağıdaki şekilde dönmektedir.Dönen bilgiler arasındaki GIB Belge Numarası (
ettn
) bilgisi taslak durumdaki faturanınimzalanması
için kullanılacaktır.
signDraftInvoice
☢️ Fatura imzalama faturanın kesilmesi işlemidir ve vergi sisteminde mali veri oluşturur. Bu nedenle dikkatli kullanınız.
findDraftInvoice()
metodundan dönen bilgi doğrudan signDraftInvoice()
metoduna parametre olarak verilip imzalanması sağlanabilir.
İmzalama işleminin başarılı olması durumunda aşağıdaki şekilde yanıt dönmektedir.
getDownloadURL
İmzalanmış faturanın indirme bağlantısını bu metod aracılığı ile oluşturabilirsiniz.
Henüz imzalanmamış bir faturanın indirme bağlantısına erişmek için getDownloadURL
metodunun ikinci parametresine false
değerini gönderebilirsiniz.
getInvoiceHTML
İmzalanmış faturanın HTML çıktısını bu metod aracılığı ile oluşturabilirsiniz.
Henüz imzalanmamış bir faturanın HTML çıktısını oluşturmak için getInvoiceHTML
metodunun ikinci parametresine false
değerini gönderebilirsiniz.
cancelDraftInvoice
Taslak durumdaki faturanın iptalini bu metod ile gerçekleştirebilirsiniz.
setUuid
Fatura işlemlerinde özelleştirilmiş uuid
tanımlamak için bu metodu kullanabilirsiniz.
getAllInvoicesByDateRange
Belirttiğiniz tarih aralığına göre taslak durumdaki faturaları listelemek için bu metodu kullanabilirsiniz.
getRecipientDataByTaxIDOrTRID
T.C. kimlik numarası veya vergi numarası ile ünvan, ad, soyad ve vergi dairesi bilgilerini öğrenmek için aşağıdaki metodu kullanabilirsiniz.
sendSignSMSCode / verifySignSMSCode
SMS dogrulama işlemini başlatmak için aşağıdaki metodu kullanabilirsiniz.
Bu işlemin sonucunda dönecek olan
oid
bilgisi doğrulama adımında kullanılacaktır.
SMS dogrulama işlemini başlatmak için aşağıdaki metodu kullanabilirsiniz.
getUserData
Firma bilgilerini getirmek için aşağıdaki metodu kullanabilirsiniz.
updateUserData
Firma bilgilerini güncellemek için aşağıdaki metodu kullanabilirsiniz.
$firma_bilgileri
array i içerisinde getUserData metodundan dönen bilgiler yer almalıdır. Güncellemek istediğiniz bilgiyi array içerisinden değiştirek updateUserData metoduna parametre olarak verebilirsiniz.Kullanım örneklerine examples/index.php dosyasından da erişebilirsiniz.
Lisans
MIT
☢️ BU PAKET VERGİYE TABİ OLAN MALİ VERİ OLUŞTURUR. BU PAKET NEDENİYLE OLUŞABİLECEK SORUNLARDAN BU PAKET SORUMLU TUTULAMAZ, RİSK KULLANANA AİTTİR. RİSKLİ GÖRÜYORSANIZ KULLANMAYINIZ.