Entegrasyon · 2026-11-17
Markdown dışa aktarCSV veya JSON dosyasından XRechnung faturaları oluşturma
Bu pilot, PDF yerine fatura verilerinden XRechnung faturaları oluşturur. Toplu işlemde bir CSV veya JSON dosyası yükleyin, sütunları eşleyin, faturaları bir önizlemede kontrol edin ve işlemi başlatın. Hizmet dosyayı yapay zeka olmadan okur; bu nedenle her bilgi dosyada bulunmalıdır.
PDF yerine fatura verisi
500 adede kadar fatura içeren bir dosya, XRechnung dosyalarından oluşan bir toplu işleme dönüşür.
XRechnung için bir toplu işlemde PDF yerine bir CSV veya JSON dosyası yükleyebilirsiniz. Hizmet dosyayı yapay zeka olmadan okur. Her bilgi dosyadan gelir: hiçbir şey türetilmez, tamamlanmaz veya yuvarlanmaz. Ülke, para birimi, KDV, tarihler ve tüm toplamlar dosyada bulunmalıdır.
Bir işlem ya PDF’ler ya da aktarılan faturalar içerir, ikisini birden içermez. Pilot yalnızca XRechnung (UBL) oluşturur. Toplu işlem etkin bir Enterprise aboneliği gerektirir.
Pilot
Aktarım bir pilottur. Excel dosyaları doğrudan okunmaz: çalışma sayfasını önce UTF-8 CSV olarak dışa aktarın.
Bir dosya aktarma
- Profil’i, ardından Toplu işlem’i açın ve CSV veya JSON içe aktar’ı seçin.
- Dosyayı seçin. Dosyanın kullandığı ondalık ayırıcıyı ve tarih biçimini ayarlayın.
- Sütunları eşleyin. Adı bir fatura alanına, onun BT numarasına veya etiketine uyan bir sütun bir öneri alır. Değer içeren her sütun eşlenmeli veya yok sayılmalıdır.
- Faturaları önizlemede kontrol edin. Bulgusu olan bir fatura aktarılamaz: dosyayı düzeltin, düzeltilmiş dosyayı seçin ve önizlemeyi güncelleyin.
- Kontrolü onaylayın ve Faturaları toplu işe ekle’yi seçin.
- Maliyet kontrolünü okuyun ve işlemi PDF’lerde olduğu gibi başlatın.
Dosya türleri
| Dosya | Yapı |
|---|---|
| CSV | Başlık satırı olan UTF-8. Ayırıcı , ; sekme veya |, tırnaklar RFC 4180’e göre. Bayt sırası işaretine izin verilir. |
| Düz JSON kayıtları | Değerleri metin veya sayı olan nesnelerden oluşan bir dizi. Her nesne bir satırdır ve anahtarları sütunlardır. |
| Kanonik JSON | Yapılandırılmış fatura nesnelerinden oluşan bir dizi veya {"invoices": [...]}. Sütun eşlemesi gerekmez. |
Satırlar nasıl faturaya dönüşür
- Bir CSV satırı veya düz bir JSON kaydı bir fatura kalemidir.
- Aynı fatura numarasına (BT-1) sahip satırlar bir fatura oluşturur. Fatura bilgilerinde, örneğin alıcı adında, uyuşmaları gerekir.
- CSV veya düz JSON’dan bir fatura tek bir KDV dökümü içerir. Birden fazla KDV kategorisi veya oranı olan faturaları kanonik JSON olarak gönderin.
Sayılar ve tarihler
| Değer | Kural |
|---|---|
| Ondalık ayırıcı | . veya ,. , ile . binlikleri gruplar. JSON sayıları her zaman . kullanır. |
| Tarih biçimi | 2026-11-13 (ISO) veya 13.11.2026 |
| CSV’deki tutarlar | En fazla iki ondalık basamak |
| Miktarlar ve fiyatlar | En fazla on ondalık basamak |
| Her sayı | Ondalık ayırıcıdan önce en fazla 15 basamak |
| Posta kodu gibi tanımlayıcılar | Baştaki sıfırlar korunur |
Bir fatura ne zaman bekler
Bir faturanın bulgusu olur ve aktarım şu durumlarda bekler:
- satırları bir fatura bilgisinde ayrışıyorsa, örneğin iki farklı alıcı adı;
- zorunlu bir alan boşsa veya bir değer okunamıyorsa;
- toplamları tutmuyorsa (EN 16931 kuralları BR-CO-10, BR-CO-13, BR-CO-14, BR-CO-15 ve BR-CO-16);
- kalem indirimi veya ek ücreti olmayan bir kalemde kalem tutarı (BT-131), miktar × birim fiyat ÷ fiyat taban miktarından bir sentten fazla farklıysa;
Odışındaki bir KDV kategorisinin oranı yoksa (BT-119, BT-152);- veriler kanonik fatura şemasına uymuyorsa.
Hizmetin reddettiği dosyalar
Hizmet, birden fazla şekilde okuyabileceği bir dosyayı reddeder:
- boş veya tekrarlanan sütun adları;
- başlıktan daha fazla veya daha az hücre içeren satırlar;
- tekrarlanan JSON anahtarları;
NaN,Infinityve üslü sayılar;- düz kayıtlarda iç içe değerler ve kanonik JSON’da bilinmeyen alanlar.
Sınırlar
| Sınır | Değer |
|---|---|
| Dosya boyutu | 2 MB |
| Dosya başına fatura | 500 |
| Satır | 10.000 |
| Sütun | 100 |
| JSON derinliği | 32 |
Faturalandırma
Aktarılan her fatura, toplu işlemdeki bir PDF fatura gibi dönüştürülür, doğrulanır, ücretlendirilir ve teslim edilir: verilen her fatura için bir dönüştürme, önce dahil olan dönüştürmelerinizden, sonra API kredilerinden. Maliyeti başlatmadan önce görürsünüz.
Aktarımdan önce hiçbir şey kaydedilmez. Değişmemiş bir aktarımı tekrarlarsanız aynı faturalar yeniden kullanılır.
Örnek dosya
Sentetik örnek, uydurma verilerle üç fatura içerir. Noktalı virgül, ondalık virgül ve 13.11.2026 gibi tarihler kullanır. SYNTH-0002 faturasının iki kalemi vardır.
Sonraki adımlar
Toplu işlem etkin bir Enterprise aboneliği gerektirir.