Ana içeriğe atla

Entegrasyon · 2026-11-17

Markdown dışa aktar

CSV 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

  1. Profil’i, ardından Toplu işlem’i açın ve CSV veya JSON içe aktar’ı seçin.
  2. Dosyayı seçin. Dosyanın kullandığı ondalık ayırıcıyı ve tarih biçimini ayarlayın.
  3. 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.
  4. Faturaları önizlemede kontrol edin. Bulgusu olan bir fatura aktarılamaz: dosyayı düzeltin, düzeltilmiş dosyayı seçin ve önizlemeyi güncelleyin.
  5. Kontrolü onaylayın ve Faturaları toplu işe ekle’yi seçin.
  6. Maliyet kontrolünü okuyun ve işlemi PDF’lerde olduğu gibi başlatın.

Dosya türleri

DosyaYapı
CSVBaş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 JSONYapı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ğerKural
Ondalık ayırıcı. veya ,. , ile . binlikleri gruplar. JSON sayıları her zaman . kullanır.
Tarih biçimi2026-11-13 (ISO) veya 13.11.2026
CSV’deki tutarlarEn fazla iki ondalık basamak
Miktarlar ve fiyatlarEn fazla on ondalık basamak
Her sayıOndalık ayırıcıdan önce en fazla 15 basamak
Posta kodu gibi tanımlayıcılarBaş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;
  • O dışı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, Infinity ve üslü sayılar;
  • düz kayıtlarda iç içe değerler ve kanonik JSON’da bilinmeyen alanlar.

Sınırlar

SınırDeğer
Dosya boyutu2 MB
Dosya başına fatura500
Satır10.000
Sütun100
JSON derinliği32

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.