Tag: api

Udostępniam KSeF PHP Client - bibliotekę Open Source mojego autorstwa, która upraszcza integrację aplikacji PHP z API Krajowego Systemu e-Faktur (KSeF).

Czym jest KSeF?

KSeF (Krajowy System e-Faktur) to system centralnego fakturowania, służący do wystawiania, udostępniania i odbierania faktur ustrukturyzowanych. W uproszczeniu: zamiast tradycyjnego generowania dokumentów faktur w formacie PDF lub XML, faktury będą wysyłane i przechowywane w centralnym systemie państwowym, dostępne dla podatników i organów skarbowych.

Oficjalne informacje o nowej wersji systemu (KSeF 2.0) są dostępne na stronie Ministerstwa Finansów.

Co oferuje KSeF PHP Client?

Poniżej najważniejsze funkcjonalności, które obecnie wspiera biblioteka:

• Obsługa wszystkich trybów autoryzacji:
  • przez token KSeF
  • przez certyfikat kwalifikowany
  • przez certyfikat KSeF
  • manualnie przez profil zaufany ePUAP
• Mapa logiczna struktury faktury w postaci DTO - ułatwia budowanie, walidację i edycję dokumentów
• Automatyczne odświeżanie Access Tokena
• Generowanie kodów QR dla faktur oraz certyfikatu
• Obsługa komunikacji z API KSeF: wysyłanie, pobieranie, sprawdzanie statusu
• Przykłady użycia i dokumentacja w repozytorium

composer require n1ebieski/ksef-php-client

Od wersji 8.0 iDir oferuje ujednolicone API za pomocą którego można stworzyć automatyczne dodawarki, sprawdzarki albo panele moderacji centralnej. Niniejszy post jest krótkim wprowadzeniem do korzystania z API. Do testowania poszczególnych requestów polecam zaopatrzyć się w darmowy program Postman.

# Import dostępnych enpointów

Mając zainstalowany program Postman, w górnym menu należy wybrać Import, zaznaczyć zakładkę Link i wstawić link z oficjalnej dokumentacji API iDir https://demo.idir.intelekt.net.pl/docs/collection.json.

# Dodawanie nowych wpisów

Domyślnie w iDir dodawanie nowych wpisów dostępne jest zarówno dla zalogowanych użytkowników serwisu jak i gości. W przypadku dodawania wpisów jako gość, wymagane jest dodatkowo podanie unikalnego adresu email. Z racji tego API nie wymaga w tym przypadku autentykacji za pomocą tokena API.

Aby dodać wpis do katalogu należy znać ID grupy. Grupy można wyciągnąć za pomocą endpointu:

pokaż więcej »