Kod przetestowany w sandboxie zadziała na produkcji po zmianie adresu i klucza API. Poniższa lista obejmuje pozostałe elementy do sprawdzenia przed wystawieniem pierwszej prawdziwej faktury.
Wymagania
- Konto produkcyjne inFakt w planie obejmującym dostęp do API.
- Integracja przetestowana w sandboxie.
Kroki
Zmiana adresu API
Adres
https://api.sandbox-infakt.pl/v3zastępuje się adresemhttps://api.infakt.pl/v3. Adres należy przechowywać w konfiguracji, a nie w kodzie.Wygenerowanie klucza produkcyjnego
Na koncie produkcyjnym, w Ustawienia → Inne opcje → API, generuje się nowy klucz wyłącznie z zakresami, z których korzysta integracja (Uprawnienia). Klucz przechowuje się w menedżerze sekretów.
Konfiguracja integracji z KSeF
Integracja wysyłająca faktury do KSeF wymaga połączenia konta produkcyjnego z KSeF za pomocą certyfikatu w aplikacji inFakt. Odpowiedź
GET /ksef2/integration.jsonpowinna zawierać"active": true.Przeniesienie webhooków
Webhooki dodaje się i weryfikuje ponownie na koncie produkcyjnym. Każdy z nich ma nowy sekret, więc wartość
INFAKT_WEBHOOK_SECRETtrzeba zaktualizować.Sprawdzenie obsługi błędów
Integracja powinna:
- ponawia żądania po kodzie
429z coraz dłuższą przerwą (Limity zapytań); - przekazuje użytkownikowi komunikaty z pola
errorsodpowiedzi422; - obsługuje kody
402i403z polemlimit(limity planu); - rozpoznaje powtórzone zdarzenia webhooków po
event.uuid.
- ponawia żądania po kodzie
Weryfikacja
Pierwszą fakturę na produkcji należy sprawdzić w aplikacji inFakt. Faktura wysłana do KSeF powinna otrzymać status success i numer ksef_number. Błędny szkic faktury usuwa się przed wysyłką do KSeF, a po wysyłce wystawia się fakturę korygującą.
Następne kroki
- Kody błędów
- Historia zmian API: zmiany w API można śledzić również przez RSS.