Wyszukaj dostawców PEPPOL

Użyj client.peppol, gdy potrzebujesz publicznej listy dostawców usług PEPPOL zarejestrowanych w KSeF. To gałąź klienta głównego i nie wymaga uwierzytelniania.

Wyszukaj dostawców

list() zwraca Pager: iteruj po nim, by dostać każdego dostawcę, wywołaj .pages() dla list wielkości strony albo .first_page(), by wykonać jedno żądanie.

Wszyscy dostawcy

for provider in client.peppol.list():
    print(provider.id, provider.name, provider.date_created)

# PeppolProvider
# {
#   "id": "PPL123456",
#   "name": "Example PEPPOL Provider",
#   "date_created": "2026-06-25T10:00:00Z"
# }

Jedna strona

first = client.peppol.list().first_page()

Cache'uj wybory dostawców

Rekordy dostawców są danymi referencyjnymi. Odpytaj je z KSeF, a potem cache'uj id i nazwę wyświetlaną do wyboru użytkownika albo walidacji w produkcie.

providers_by_id = {
    provider.id: provider.name
    for provider in client.peppol.list()
}

Zalecany przepływ

1. Wyszukaj dostawców z klienta głównego.

2. Zapisz id i nazwy dostawców w cache'u danych referencyjnych aplikacji.

3. Używaj id dostawców przy walidacji wyborów użytkownika albo danych związanych z PEPPOL.

4. Odświeżaj cache zgodnie z wymaganiami świeżości danych w produkcie.

Następne przepływy

• Konfiguracja klienta: Utwórz klienta głównego używanego do publicznych zapytań o dostawców PEPPOL.
• PEPPOL: Zrozum, gdzie dane dostawców PEPPOL pasują do powierzchni SDK.