W systemie obowiązują limity znaków dla poszczególnych pól faktury. Ich celem jest zapewnienie poprawnej struktury danych oraz zgodności z wymaganiami technicznymi, w tym w szczególności z wymogami KSeF.
W przypadku przekroczenia dopuszczalnej długości danych system może nie pozwolić na ich zapis lub zaakceptować dokument, jednak błąd zostanie wykryty na dalszym etapie przetwarzania, np. podczas wysyłki do KSeF lub weryfikacji struktury dokumentu.
Limity znaków w polach faktury
Pola na poziomie faktury
- Nazwa sprzedawcy / nabywcy (seller_name, buyer_name) - maksymalnie 256 znaków
- Adres (seller_street, buyer_street) - maksymalnie 255 znaków
- Email (buyer_email, seller_email) - maksymalnie 255 znaków
- Telefon (buyer_phone, seller_phone) - maksymalnie 16 znaków
- Powód korekty (correction_reason) - maksymalnie 256 znaków
-
Rozliczenia na fakturze
→ Pole kind (rodzaj) jest wymagane - dozwolone wartości to “charge” (obciążenie) lub “deduction” (odliczenie).
→ Pole amount (kwota rozliczenia) jest wymagane - wartość musi być większa od 0, maksymalnie 9 999 999.99, z dokładnością do 2 miejsc po przecinku.
→ Pole reason (powód) jest wymagane - maksymalna długość 256 znaków.
→ Maksymalna liczba pozycji: 100 per rodzaj (100 obciążeń + 100 odliczeń).
Pola na poziomie pozycji
- Nazwa pozycji (positions[].name) - maksymalnie 255 znaków
- Kod produktu (code, pole additional_info) - maksymalnie 255 znaków
- PKWiU / PKOB / CN (pole additional_info, gdy additional_info_desc ≠ GTIN) - maksymalnie 50 znaków
- GTIN (pole additional_info, gdy additional_info_desc=GTIN) - maksymalnie 20 znaków
- Opis na pozycji faktury - maksymalnie 256 znaków
Uwagi na fakturze (descriptions)
- Rodzaj uwagi (descriptions[].kind) - maksymalnie 256 znaków
- Treść uwagi (descriptions[].content) konto bez KSeF: maksymalnie 65 535 znaków, dla kont z aktywną integracją KSeF: maksymalnie 256 znaków (wymóg schematu KSeF - element DodatkowyOpis.Wartość)
→ Pola kind i content nie mogą zawierać emoji - wysłanie emoji spowoduje błąd walidacji.
→ Białe znaki na początku i końcu pól kind oraz content są automatycznie usuwane (strip).
→ Maksymalna liczba uwag na jednej fakturze: 10 000. - Dodatkowe uwagi (na drugiej stronie) - maksymalnie 3500 znaków
- Dodatkowe uwagi (na dole strony) - maksymalnie 3500