Przejdź do głównej zawartości

Konfiguracja klienta

Klient główny Client przechowuje konfigurację transportu HTTP i udostępnia publiczne, nieuwierzytelnione gałęzie. Uwierzytelnij się raz dla kontekstu KSeF, a potem przekaż uwierzytelnionego klienta do kodu przepływu.

Wybierz sync albo async

Dział zatytułowany „Wybierz sync albo async”
from ksef2 import Client, Environment


with Client(Environment.TEST) as client:
    auth = client.authentication.with_test_certificate(nip="5261040828")

Poza lokalnymi przepływami TEST używaj Environment.DEMO albo Environment.PRODUCTION.

Publiczne gałęzie klienta głównego

Dział zatytułowany „Publiczne gałęzie klienta głównego”

Klient główny przydaje się przed uwierzytelnieniem:

certificates = client.encryption.get_certificates()
providers = client.peppol.query()

Gałąź tylko dla TEST także jest na kliencie głównym:

client.testdata.create_subject(
    nip="5261040828",
    subject_type="vat_group",
    description="Sandbox company",
)

Gałęzie uwierzytelnione

Dział zatytułowany „Gałęzie uwierzytelnione”

Po uwierzytelnieniu użyj gałęzi pasującej do zadania:

invoices = auth.invoices
batch = auth.batch
tokens = auth.tokens
permissions = auth.permissions
certificates = auth.certificates
limits = auth.limits
sessions = auth.sessions
invoice_sessions = auth.invoice_sessions

Zalecany przepływ

Dział zatytułowany „Zalecany przepływ”

  1. Odczytaj środowisko i ustawienia transportu na granicy aplikacji.

  2. Utwórz jednego klienta głównego dla wybranego środowiska KSeF.

  3. Używaj gałęzi głównych tylko do publicznych odczytów albo przygotowania danych TEST.

  4. Uwierzytelnij się raz dla kontekstu, który wykonuje operację.

  5. Przekaż uwierzytelnionego klienta do przepływów faktur, tokenów, uprawnień, certyfikatów, limitów i sesji.

Referencja

Dział zatytułowany „Referencja”