API - KSeF – Centrum pomocy SaldeoSMART

Dane dostępne przez API

Przy pracy z fakturami w systemie KSeF przez API dostępne są następujące informacje:

Numer KSeF
Data nadania numeru KSeF
Informacja o użytkowniku wysyłającym faktury do KSeF
Link do wygenerowanego PDF (dostępny w operacji invoice.listbyid, w pliku XML w polu source)

Ważne: Zarówno podgląd wydruku, jak i numer KSeF nie są zwracane natychmiast po wystawieniu faktury przez API.

Funkcjonalności przy wystawianiu faktury przez API

W SaldeoSMART udostępniono następujące możliwości:

Wysłanie faktury do KSeF po jej zaimportowaniu
Rozszerzone opcje wystawienia dla innego podmiotu:
- Określenie roli
- Wskazanie ID_WEW (możliwość podania 5 ostatnich cyfr identyfikatora)
Możliwość automatycznego zainicjowania wysyłki faktury emailem do nabywcy po zaimportowaniu
Rozbudowa metody invoice.add o nowe stawki VAT
- 0 EX
- 0 WDT
- NP UE

Zmiany w API

Nowe wersje metod i podgląd faktury z KSeF

Nowy węzeł w odpowiedzi XML: preview_source

W odpowiedziach przesyłanych w formacie XML został dodany nowy węzeł preview_source. Zawiera on link do pliku HTML z podglądem faktury pobranej z KSeF. Podgląd należy wygenerować na podstawie naszej transformacji w Saldeo.

Nowe węzły XML umożliwiające przekazanie danych zamówienia i umowy przy wystawianiu faktury

Co zostało dodane

W strukturze XML żądania do API pojawiły się nowe węzły:

numer zamówienia
data zamówienia
numer umowy
data umowy

Węzły te muszą być przekazywane parami: numer zawsze razem z datą. Nie można podać samego numeru bez daty ani samej daty bez numeru - w takim przypadku API zwróci błąd.

Zamówienie i umowa są od siebie niezależne

Nie trzeba podawać obu. Możliwe kombinacje:

tylko zamówienie (numer + data),
tylko umowa (numer + data),
zamówienie i umowa jednocześnie.

⚠️ Ograniczenia walidacyjne: Wprowadzono limity znakowe dla przesyłanych wartości – zarówno numer zamówienia, jak i numer umowy mogą składać się z maksymalnie 240 znaków. Z kolei format daty podlega standardowym ograniczeniom dla tego typu danych.

Szczegóły techniczne

Pełna dokumentacja żądań i parametrów dostępna jest w oficjalnej specyfikacji API SaldeoSMART.