Download the PHP package argist/laravel-invoice-webhook without Composer
On this page you can find all versions of the php package argist/laravel-invoice-webhook. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download argist/laravel-invoice-webhook
More information about argist/laravel-invoice-webhook
Files in argist/laravel-invoice-webhook
Package laravel-invoice-webhook
Short Description Laravel altyapılı sistemlerde oluşturulan fatura ve satış kayıtlarını Argist platformuna güvenli şekilde aktaran, e-Arşiv ve e-Fatura uyumlu webhook entegrasyonu.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-invoice-webhook
Argist Laravel Invoice Webhook
Laravel altyapılı sistemlerde oluşturulan fatura ve satış kayıtlarını Argist platformuna güvenli şekilde aktaran, e-Arşiv ve e-Fatura uyumlu webhook entegrasyonu.
Özellikler
- ✅ JWT Token Management - Otomatik token yönetimi ve caching
- ✅ Ayrı Servisler - JWT token servisi ve fatura gönderimi servisleri ayrı çalışır
- ✅ Production Ready - Hata yönetimi, validasyon ve logging
- ✅ Configuration Management - Merkezi yapılandırma dosyası
- ✅ Timeout Protection - HTTP istek timeout'ları
- ✅ Error Handling - Detaylı hata mesajları ve yanıtları
Kurulum
1. Composer ile Yükleme
2. Konfigürasyon Yayınlama
Bu komut, config/argist.php dosyasını projenize kopyalayacaktır.
3. Environment Değişkenlerini Ayarlama
.env dosyasına aşağıdaki değişkenleri ekleyin:
Kullanım
Fatura Gönderme
Option 1: Direct Service Call
Option 2: HTTP Request
Test Endpoint
Sistem kurulumunu test etmek için:
Response Format
Success Response (200):
Validation Error (422):
Server Error (500):
Servis Mimarisi
JwtTokenService
JWT token almandan sorumludur.
Özellikler:
- Token caching (50 dakika)
- Otomatik yenileme
- Error handling
Kullanım:
InvoiceApiService
Fatura gönderme işleminden sorumludur.
Özellikler:
- Veri validasyonu
- JWT token integration
- Response handling
- Error formatting
Metotlar:
Hata Yönetimi
Paket tüm hataları yapılandırılmış bir array formatında döndürür:
Olası Hatalar
| Durum | Status | Sebep |
|---|---|---|
| JWT Token Hatası | 401 | API anahtarları yanlış ya da yapılandırılmamış |
| Validasyon Hatası | 422 | Gerekli alanlar eksik veya yanlış format |
| Server Hatası | 500 | Bağlantı sorunu veya API hatası |
Gelişmiş Ayarlar
Timeout Ayarı
Custom API Domain
Custom Bill Endpoint
Logging
Paket tüm istekleri Laravel logging sistemi ile kaydeder. config/logging.php dosyanızda loglama seviyesini ayarlayabilirsiniz.
Testing
Test endpointini kullanarak sistem kurulumunu doğrulayın:
Security Best Practices
- ✅ Environment değişkenlerinde API anahtarlarını saklayın
- ✅ Production ortamında HTTPS kullanın
- ✅ API istieyim rate limiting ile koruyun
- ✅ İstekleri düzenli olarak izleyin ve logları kontrol edin
Teknik Detaylar
Token Caching
- Cache Duration: 50 dakika
- Cache Driver: Laravel cache (default)
- Otomatik Yenileme: Token süresi dolunca otomatik yenilenir
Timeout Settings
- JWT Token Request: 10 saniye
- Bill Sending Request: 30 saniye
Validation
Tüm gerekli alanlar kontrol edilir:
- bill_date
- bill_time
- payment_status
- amount
- total_tax
- total_amount
- currency_id
- customer (array)
- rows (array)
Troubleshooting
"Argist API anahtarları yapılandırılmadı"
Çözüm: .env dosyasında ARGIST_PUBLIC_KEY ve ARGIST_SECRET_KEY ayarlandığından emin olun.
"Token alma işlemi başarısız"
Çözüm:
- API anahtarlarının doğru olduğundan emin olun
- Ağ bağlantısını kontrol edin
- API'nin çalışır durumda olduğundan emin olun
"Gerekli alan eksik"
Çözüm: Tüm gerekli alanları request'e ekleyin. Kullanım bölümü referans alın.
Contributions
Katkılarınız hoşgeldiniz! Lütfen pull request gönderin.
License
MIT License. Detaylar için LICENSE.md dosyasına bakın.
Support
Sorular veya sorunlar için lütfen GitHub issues açın.
