KSeF API limity przy delegowanych uprawnieniach – IP:NIP i kontekst
Limity API przy delegowanych uprawnieniach
KSeF API 2.0 stosuje precyzyjny mechanizm limitów oparty na parze IP:NIP, gdzie NIP to kontekst (numer podmiotu), w którym jesteś zalogowany. Limity są naliczane oddzielnie dla każdej pary IP:NIP, niezależnie od tego, czy działasz w kontekście własnego NIP czy delegowanego.
Przy delegowanych uprawnieniach klient nadaje Ci uprawnienia do działania w jego imieniu (jego NIP jako kontekst). W takim przypadku limity są naliczane dla pary IP:NIP_klienta, a nie dla Twojego własnego NIP. Oznacza to, że każdy klient ma własny pulpit limitów, nawet jeśli używasz tego samego certyfikatu i adresu IP.
Dokumentacja limitów API jest dostępna w repozytorium GitHub CIRFMF/ksef-docs w pliku limity/limity-api.md. Limity różnią się w zależności od środowiska (test, demo, produkcja) oraz typu operacji (tryb interaktywny, wsadowy).
Zrozumienie mechanizmu limitów przy delegowanych uprawnieniach jest kluczowe dla prawidłowego planowania przepustowości integracji i uniknięcia przekroczeń limitów.
Instrukcja krok po kroku
1. Zrozum mechanizm limitów IP:NIP
Limity są naliczane oddzielnie dla każdej pary IP:NIP (kontekstu), w którym jesteś zalogowany. IP to adres IP serwera, z którego wysyłasz żądania. NIP to kontekst (numer podmiotu), w którym działasz - może to być Twój własny NIP lub NIP klienta (przy delegowanych uprawnieniach).
2. Sprawdź limity dla delegowanych uprawnień
Przy delegowanych uprawnieniach, gdy logujesz się w kontekście NIP klienta, limity są naliczane dla pary IP:NIP_klienta. Oznacza to, że każdy klient ma własny pulpit limitów, niezależnie od tego, że używasz tego samego certyfikatu i adresu IP. Limity dla różnych klientów nie sumują się.
3. Monitoruj limity dla każdego kontekstu
Monitoruj wykorzystanie limitów osobno dla każdego kontekstu (NIP klienta). Każdy kontekst ma własne limity, więc przekroczenie limitów dla jednego klienta nie wpływa na limity dla innych klientów. Implementuj monitorowanie limitów per kontekst w swojej aplikacji.
4. Zapoznaj się z dokumentacją limitów
Przeczytaj dokumentację limitów w pliku limity/limity-api.md w repozytorium GitHub CIRFMF/ksef-docs. Dokumentacja zawiera szczegółowe informacje o limitach dla różnych środowisk i typów operacji, w tym limity dla trybu interaktywnego (180 dokumentów/godzinę dla pary IP:NIP) i wsadowego.
5. Planuj przepustowość dla wielu klientów
Przy obsłudze wielu klientów z delegowanymi uprawnieniami, każdy klient ma własne limity. Planuj przepustowość osobno dla każdego klienta. Jeśli potrzebujesz większych limitów, możesz wnioskować o zwiększenie limitów dla konkretnego kontekstu (NIP) przez formularz kontaktowy MF.
Najczęstsze problemy i rozwiązania
Czy limity są sumowane dla wszystkich klientów?
Nie, limity są naliczane oddzielnie dla każdej pary IP:NIP (kontekstu). Każdy klient ma własny pulpit limitów, nawet jeśli używasz tego samego certyfikatu i adresu IP. Limity dla różnych klientów nie sumują się.
Jak działają limity przy delegowanych uprawnieniach?
Przy delegowanych uprawnieniach, gdy logujesz się w kontekście NIP klienta, limity są naliczane dla pary IP:NIP_klienta, a nie dla Twojego własnego NIP. Oznacza to, że każdy klient ma własne limity, niezależnie od tego, że używasz tego samego certyfikatu.
Czy mogę zwiększyć limity dla delegowanych uprawnień?
Tak, możesz wnioskować o zwiększenie limitów dla konkretnego kontekstu (NIP) przez formularz kontaktowy Ministerstwa Finansów. Wniosek powinien zawierać szczegółowy opis zastosowania oraz uzasadnienie potrzeby zwiększenia limitów.
Gdzie znajdę dokumentację limitów?
Dokumentacja limitów API jest dostępna w repozytorium GitHub CIRFMF/ksef-docs w pliku limity/limity-api.md. Dokumentacja zawiera szczegółowe informacje o limitach dla różnych środowisk i typów operacji.
Mechanizm limitów IP:NIP
Limity API KSeF są naliczane oddzielnie dla każdej pary IP:NIP (kontekstu), w którym jesteś zalogowany. IP to adres IP serwera, z którego wysyłasz żądania. NIP to kontekst (numer podmiotu), w którym działasz - może to być Twój własny NIP lub NIP klienta (przy delegowanych uprawnieniach). Każda para IP:NIP ma własny pulpit limitów, niezależnie od innych par.
Limity przy delegowanych uprawnieniach
Przy delegowanych uprawnieniach klient nadaje Ci uprawnienia do działania w jego imieniu (jego NIP jako kontekst). W takim przypadku limity są naliczane dla pary IP:NIP_klienta, a nie dla Twojego własnego NIP. Oznacza to, że każdy klient ma własny pulpit limitów, nawet jeśli używasz tego samego certyfikatu i adresu IP. Limity dla różnych klientów nie sumują się - przekroczenie limitów dla jednego klienta nie wpływa na limity dla innych klientów.
Dokumentacja limitów
Dokumentacja limitów API jest dostępna w repozytorium GitHub CIRFMF/ksef-docs w pliku limity/limity-api.md. Dokumentacja zawiera szczegółowe informacje o: limitach dla różnych środowisk (test, demo, produkcja), limitach dla różnych typów operacji (tryb interaktywny, wsadowy), mechanizmie naliczania limitów dla pary IP:NIP, możliwości zwiększenia limitów. Przykładowo, w trybie interaktywnym obowiązuje limit 180 dokumentów na godzinę dla pojedynczego NIP oraz adresu IP.
Planowanie przepustowości
Przy obsłudze wielu klientów z delegowanymi uprawnieniami, każdy klient ma własne limity. Planuj przepustowość osobno dla każdego klienta. Monitoruj wykorzystanie limitów per kontekst w swojej aplikacji. Jeśli potrzebujesz większych limitów, możesz wnioskować o zwiększenie limitów dla konkretnego kontekstu (NIP) przez formularz kontaktowy Ministerstwa Finansów. Wniosek powinien zawierać szczegółowy opis zastosowania oraz uzasadnienie potrzeby zwiększenia limitów.
FAQ
Jak działają limity przy delegowanych uprawnieniach?
Przy delegowanych uprawnieniach, gdy logujesz się w kontekście NIP klienta, limity są naliczane dla pary IP:NIP_klienta, a nie dla Twojego własnego NIP. Oznacza to, że każdy klient ma własny pulpit limitów, nawet jeśli używasz tego samego certyfikatu i adresu IP. Limity dla różnych klientów nie sumują się.
Czy limity są sumowane dla wszystkich klientów?
Nie, limity są naliczane oddzielnie dla każdej pary IP:NIP (kontekstu). Każdy klient ma własny pulpit limitów, niezależnie od tego, że używasz tego samego certyfikatu i adresu IP. Limity dla różnych klientów nie sumują się - przekroczenie limitów dla jednego klienta nie wpływa na limity dla innych klientów.
Gdzie znajdę dokumentację limitów API?
Dokumentacja limitów API jest dostępna w repozytorium GitHub CIRFMF/ksef-docs w pliku limity/limity-api.md. Dokumentacja zawiera szczegółowe informacje o limitach dla różnych środowisk i typów operacji, w tym limity dla trybu interaktywnego (180 dokumentów/godzinę dla pary IP:NIP) i wsadowego.
Czy mogę zwiększyć limity dla delegowanych uprawnień?
Tak, możesz wnioskować o zwiększenie limitów dla konkretnego kontekstu (NIP) przez formularz kontaktowy Ministerstwa Finansów. Wniosek powinien zawierać szczegółowy opis zastosowania oraz uzasadnienie potrzeby zwiększenia limitów.
Jak monitorować limity dla wielu klientów?
Monitoruj wykorzystanie limitów osobno dla każdego kontekstu (NIP klienta). Każdy kontekst ma własne limity, więc przekroczenie limitów dla jednego klienta nie wpływa na limity dla innych klientów. Implementuj monitorowanie limitów per kontekst w swojej aplikacji, sprawdzając nagłówki odpowiedzi API (X-RateLimit-Remaining) dla każdego kontekstu osobno.