Uyumsoft e-Fatura kurulumu

Convord, Uyumsoft ile e-Fatura / e-Arşiv için BasicIntegrationApi ve (isteğe bağlı) e-İrsaliye için DespatchApi üzerinden JSON istekleri kullanır. Kimlik doğrulama, dokümandaki gibi her istekte userInfo içinde Username ve Password ile yapılır. OAuth veya ayrı bir “API key” kullanılmaz; alan adı “anahtar” gibi görünse de teknik olarak entegrasyon kullanıcısı ve şifresidir.

Panelde yapılandırma

1. Ayarlar → Entegrasyonlar üzerinden faturalama anahtarını açın.
2. Fatura oluşturma yöntemi olarak Uyumsoft seçin.
3. Bu sayfadaki firma vergi numarası (VKN/TCKN) ve vergi dairesi alanlarını doldurun; Uyumsoft tarafı firma tanımı ile eşleşmelidir.
4. Entegrasyon kullanıcı adı ve entegrasyon şifresini Uyumsoft’tan aldığınız değerlerle girin ve kaydedin.
5. e-Fatura göndereceğiniz müşteri kayıtlarında geçerli VKN (10 hane) veya TCKN (11 hane) bulundurun; aksi halde gönderim engellenir veya hata alırsınız.

“API key” mi, kullanıcı adı / şifre mi?

Uyumsoft REST örneklerinde görünen userInfo yapısı kullanılır. Paneldeki iki alan buna karşılık gelir; ek bir Bearer token veya ayrı secret key alanı yoktur.

İsterseniz sunucu .env içinde UYUMSOFT_USERNAME / UYUMSOFT_PASSWORD tanımlayıp tüm kiracılar için varsayılan sağlayabilirsiniz; firma panelindeki dolu alanlar önceliklidir.

Sunucu (.env) ayarları

Barındırma tarafında özellikle şunlar kontrol edilir:

• UYUMSOFT_BASE_URL: Örnek canlı https://efatura.uyumsoft.com.tr/api, test için https://efatura-test.uyumsoft.com.tr/api (path’ler yapılandırmayla birleşir).
• İsteğe bağlı tam URL: UYUMSOFT_INVOICE_API_URL, UYUMSOFT_DESPATCH_API_URL.
• Bağlantı testi: kurulum sonrası php artisan uyumsoft:test

Müşteri vergi numarası

Uyumsoft’a fatura gönderirken alıcı tarafında geçerli VKN/TCKN zorunludur. Siparişten fatura oluştururken veya gönderirken sistem uygun uyarıyı verir; müşteri kartını güncellemeniz yeterlidir.

E-İrsaliye (DespatchApi)

Yalnızca yerel PDF/XML sevk irsaliyesi için sunucu ayarı şart değildir. Gerçekten Uyumsoft üzerinden GİB e-İrsaliye göndermek için:

• EINVOICE_PROVIDER=uyumsoft
• UYUMSOFT_DISPATCH_ENABLED=true — bu modda alıcı müşteride de VKN/TCKN zorunludur.

Uyumsoft hesabı ve seri ayarları

API teknik olarak doğru çalışsa bile Uyumsoft panelinde firma için fatura <strong>seri / ön ek</strong> ve hesap ayarları tanımlı olmalıdır. Aksi halde “seri bulunamadı” gibi mesajlar dönebilir. Detaylar için Uyumsoft desteğinize danışın.

Test ortamı

Test URL’si ve örnek hesaplar için Uyumsoft dokümantasyonunu kullanın. Deneme için uyumsoft:test komutu BasicIntegrationApi erişimini smoke test eder.

Ek bilgi

Genel entegrasyon bağlamı için Entegrasyon Rehberi sayfasına bakın.