Tag: api

KSeF PHP Client - biblioteka do obsługi API Krajowego Systemu e-Faktur

Opublikowano: 1 dzień 10 godzin temu Autor: admin

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

Biblioteka dostępna jest za darmo do pobrania z mojego repozytorium. Instalacja za pomocą Composer:

composer require n1ebieski/ksef-php-client

Jak korzystać z API?

Opublikowano: 3 lata 6 miesięcy temu Autor: admin

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: