Lexoffice'i n8n ile Otomatikleştirme: Fişler, Faturalar, Kişiler

Lexoffice, resmi bir n8n node'u bulunmamasına rağmen n8n ile otomatikleştirilebilir: çözüm, doğrudan Lexoffice'in genel API'siyle konuşan ve orada fiş alan, fatura oluşturan veya kişileri senkronize eden HTTP Request node'udur. Bunun için Lexoffice hesabından kişisel bir API anahtarına ihtiyaç vardır; n8n bu anahtarı Authorization başlığında bearer token olarak gönderir ve ayrıca HTTP Request node'unda kayıtlı bir Header Auth kimlik bilgisi gerekir. Üretim API'si Mayıs 2025'ten beri api.lexware.io alan adı altında çalışmaktadır ve saniyede en fazla iki istekle sınırlıdır. Güncelleme tarihi: Temmuz 2026.

Neden Lexoffice için yerel bir n8n node'u yok?

Lexoffice, n8n tarafından resmi olarak entegre edilen hizmetler arasında yer almadığından, workflow'ların hazır bir Lexoffice node'u yerine genel HTTP Request node'unu kullanması gerekir. n8n bu tür durumlar için HTTP Request node'unda Header Auth, Basic Auth, OAuth2 ve Query Auth dahil olmak üzere birkaç genel kimlik doğrulama yöntemini destekler (HTTP Request node'u hakkında n8n dokümantasyonu). Lexoffice için Header Auth doğru seçimdir, çünkü API, Authorization başlığı üzerinden bearer token kimlik doğrulaması gerektirir. Bu esnekliğin bedeli: uç noktalar, alanlar ve hata yönetimi elle yeniden oluşturulmalıdır ve Lexoffice tarafında API değişikliklerinde workflow, bir node güncellemesiyle otomatik olarak çalışmak yerine bağımsız olarak bakımının yapılması gerekir.

n8n, Lexoffice API'sine karşı nasıl kimlik doğrulanır?

Kimlik doğrulama, Lexoffice hesabında genel API ayarları altında oluşturduğunuz ve her isteğin Authorization başlığında bearer token olarak gönderdiğiniz kişisel bir API anahtarı üzerinden yapılır (Lexware API dokümantasyonu). n8n'de bunun için HTTP Request node'unda Authorization adında ve değeri Bearer'dan sonra anahtar olan bir Header Auth kimlik bilgisi oluşturursunuz. Workflow planlaması için iki teknik nokta önemlidir:

• Temel URL: 26 Mayıs 2025'ten beri üretim API'si https://api.lexware.io altında çalışmaktadır; eski lexoffice.io adresi bu tarihten beri değiştirilmiştir.
• Hız sınırı: API saniyede en fazla iki isteğe izin verir; bu aşıldığında HTTP 429 ile yanıt verir, bu nedenle daha büyük senkronizasyon çalışmaları için workflow içinde kısıtlı bir döngü veya bir Wait node'u gerekir.

n8n ile Lexoffice'ten yeni fişler nasıl alınır?

Yeni fişler, fiş türüne, duruma ve oluşturma veya değiştirme tarihine göre sorgu parametreleriyle filtrelenebilen GET uç noktası /v1/voucherlist üzerinden alınabilir. n8n'de HTTP Request node'unu GET yöntemi ve https://api.lexware.io/v1/voucherlist URL'siyle yapılandırır, örneğin yalnızca son 24 saatteki açık faturaları almak için voucherType, voucherStatus ve createdDateFrom gibi parametreler eklersiniz. Yanıt sayfalanmıştır; sayfa başına varsayılan 25 giriş boyutu ve totalPages ile totalElements gibi alanlarla birlikte gelir, bu nedenle tam bir eşitleme için bir sayfalama döngüsü gerekir. Tipik bir kalıp: bir cron tetikleyicisi workflow'u saatlik olarak başlatır, yeni veya değiştirilmiş fişleri alır ve bunları bir tabloya veya dahili bir panoya yazar.

n8n ile Lexoffice'te yeni faturalar nasıl oluşturulur?

Yeni faturalar, JSON gövdesinin müşteriyi, fatura kalemlerini ve vergi oranlarını içerdiği /v1/invoices adresine yapılan bir POST isteği üzerinden oluşturulur. HTTP Request node'unda POST yöntemini seçer, Content-Type'ı application/json olarak ayarlar ve fatura gövdesini ya önceki workflow verilerinden ya da alanları Lexoffice şemasına uygun şekilde bir araya getiren bir Set node'undan aktarırsınız. Pratik bir örnek: bir online mağazada sipariş tamamlama, webhook üzerinden bir n8n workflow'unu tetikler; bu workflow müşteri verilerini ve kalemleri otomatik olarak Lexoffice'in beklediği biçime aktarır ve faturayı oluşturur. API şemayı sıkı bir şekilde doğrular, bu nedenle böyle bir workflow üretime alınmadan önce gerçek test verileriyle test çalışmaları yapmak faydalıdır.

n8n ile Lexoffice arasında kişiler nasıl senkronize edilir?

Kişiler, e-posta veya ad gibi filtrelerle GET /v1/contacts üzerinden sorgulanabilir ve POST /v1/contacts üzerinden yeni oluşturulabilir; bu da Lexoffice ile bir CRM veya tablo arasında eşitleme yapılmasını sağlar. Yaygın bir kalıp, GET ile belirli bir e-posta adresine sahip bir kişinin zaten var olup olmadığını kontrol eder ve yinelenenleri önlemek için yalnızca gerektiğinde POST ile yeni bir kişi oluşturur. Lexoffice'i ayrı bir CRM'nin yanında muhasebe için kullanan şirketler için bu, kişi verilerinin çift elle bakımını ortadan kaldırır. Hata yönetimi, hız sınırı kontrolü ve izleme ile bu tür çok adımlı workflow'ları sürekli olarak işletmek isteyenler, NordFlux'ta n8n workflow'larının kurulumu konusunda destek bulur; buna hangi süreçlerin teknik ve ekonomik olarak gerçekten değerli olduğunun değerlendirilmesi de dahildir.

Lexoffice ve n8n hakkında sık sorulan sorular

n8n için resmi bir Lexoffice node'u var mı?

Hayır, n8n Lexoffice için resmi, yerel bir node sunmuyor, bu nedenle bağlantı genel HTTP Request node'u üzerinden Lexoffice'in genel API'sine karşı çalışır. Bu, hazır bir node'a göre daha fazla yapılandırma çabası anlamına gelir, ancak teknik olarak fişler, faturalar ve kişiler gibi tüm temel işlevlere API üzerinden erişilebilir. Bir kez kurulan bir Header Auth kimlik bilgisiyle, istediğiniz kadar workflow adımı aynı erişime dayanabilir.

Lexoffice API'sinin hız sınırı ne kadardır?

Lexoffice API'si istekleri saniyede en fazla iki istekle sınırlar; bu aşıldığında HTTP durum kodu 429 ile yanıt verir. Bu nedenle çok sayıda kaydı olan n8n workflow'larında limiti aşmamak için bir Wait node'u veya kısıtlı bir döngü eklemelisiniz. Örneğin birkaç yüz kişi gibi daha büyük senkronizasyonlarda bu durum çalışma süresinde fark edilir ve workflow planlamasında hesaba katılmalıdır.

Lexoffice API'si şu anda hangi temel URL'yi kullanıyor?

26 Mayıs 2025'ten beri üretim Lexoffice API'si api.lexware.io alan adı altında çalışmaktadır; lexoffice.io altındaki eski adres bu tarihten beri değiştirilmiştir. Hâlâ eski URL'yi kullanan n8n workflow'ları, hataları önlemek için yeni temel URL'ye geçirilmelidir. API anahtarının kendisi bundan etkilenmez ve Lexoffice hesabında yönetilmeye devam eder.

Lexoffice API'yi değiştirirse ne olur?

Bağlantı, bakımı yapılan bir n8n node'u yerine kendi oluşturduğunuz HTTP isteklerine dayandığından, şema veya uç nokta değişikliklerinde workflow'un elle uyarlanması gerekir. Bu, bireysel bir kalıbın esnekliğinin bedelidir: resmi olarak bakımı yapılan bir node'da olacağı gibi otomatik bir güncelleme mekanizması yoktur. Bu bakım çabasını kendisi üstlenmek istemeyenler, bunu planlama aşamasında kesin olarak hesaba katmalıdır.