Przejdź do głównej zawartości

Przegląd przepływów

Ta sekcja jest dla sytuacji, w których znasz już podstawowy kształt SDK i chcesz wykonać konkretne zadanie w KSeF. Quickstart pokazuje jedną ścieżkę od początku do końca; tutaj rozbijamy typowe decyzje produkcyjne.

Skonfiguruj klientów Wybierz sync albo async, publiczne gałęzie klienta głównego i uwierzytelnione gałęzie przepływów.
Uwierzytelnij się Wybierz certyfikat TEST, token KSeF, certyfikat XAdES, zmienne środowiskowe albo profile kompatybilne z CLI.
Zbuduj faktury Wygeneruj XML FA(3) typowanymi builderami Pythona przed otwarciem sesji KSeF.
Wyślij faktury Wyślij XML FA(3) przez sesję online albo sesję wsadową i sprawdź wynik przetwarzania.
Wyszukaj faktury Zbuduj filtry metadanych, przejdź po stronach wyników i czekaj na widoczność nowych faktur.
Pobierz faktury Pobierz jedną fakturę po numerze KSeF albo zaplanuj szyfrowany eksport paczek.
Sprawdź status i UPO Odpytuj status online albo batch, listuj faktury sesji i pobieraj dokumenty UPO.
Zarządzaj tokenami Generuj, listuj, sprawdzaj i cofaj tokeny KSeF dla automatyzacji.
Zarządzaj uprawnieniami Nadawaj, wyszukuj, odbieraj i monitoruj uprawnienia KSeF.
Zarządzaj certyfikatami Sprawdzaj limity, rejestruj certyfikaty, pobieraj wydane materiały i cofaj certyfikaty.
Sprawdź limity Odczytuj i nadpisuj limity kontekstu, podmiotu oraz API rate limity.
Certyfikaty szyfrowania Sprawdzaj publiczne certyfikaty KSeF używane w szyfrowanych przepływach faktur i eksportów.
Dostawcy PEPPOL Wyszukuj publiczne dane dostawców PEPPOL z klienta głównego.
Dane TEST Twórz sandboxowe podmioty, uprawnienia, flagi załączników i fixture'y z temporal cleanup.
Pomocniki XAdES Ładuj materiał certyfikatu, generuj certyfikaty TEST i podpisuj XML.

Typowa kolejność

Dział zatytułowany „Typowa kolejność”

  1. Skonfiguruj środowisko i dane uwierzytelniające.

    Sekrety trzymaj w zmiennych środowiskowych, a niesekretne ustawienia w lokalnej konfiguracji.

  2. Uwierzytelnij się dla wybranego kontekstu.

    Uwierzytelniony klient udostępnia online_session, batch, invoices, tokens, permissions, certificates i inne gałęzie przepływów.

  3. Uruchom gałąź przepływu, która odpowiada za zadanie.

    Użyj publicznych gałęzi klienta głównego do certyfikatów szyfrowania, lookupu PEPPOL i danych TEST. Użyj gałęzi uwierzytelnionych do faktur, sesji, tokenów, uprawnień, certyfikatów i limitów.

  4. Poczekaj na przetwarzanie w KSeF albo status operacji.

    Pomocniki wysokiego poziomu potrafią odpytywać status faktury, zakończenie batcha, operacje uprawnień, rejestrację certyfikatu, widoczność w metadanych i gotowość paczki eksportu.

  5. Zapisz wynik biznesowy.

    Zapisuj numery KSeF, referencje sesji, referencje operacji, uchwyty eksportu, pobrany XML, referencje tokenów, numery seryjne certyfikatów i UPO zgodnie z polityką retencji aplikacji.

Powiązane strony

Dział zatytułowany „Powiązane strony”