KSeF API odbieranie uprawnień
POST /api/v2/permissions/common/grants/{permissionId}. Proces jest asynchroniczny i wymaga sprawdzania statusu operacji.Odbieranie uprawnień w KSeF API
Odbieranie uprawnień w KSeF API 2.0 odbywa się za pomocą endpointu POST /api/v2/permissions/common/grants/{permissionId}, gdzie permissionId to identyfikator uprawnienia do odebrania. Proces jest asynchroniczny i wymaga sprawdzania statusu operacji.
Aby odbierać uprawnienia, musisz mieć uprawnienie CredentialsManage. Po wywołaniu endpointu otrzymujesz referenceNumber operacji, który służy do sprawdzania statusu odbierania uprawnień.
Status operacji odbierania uprawnień można sprawdzić używając odpowiedniego endpointu. Proces może trwać pewien czas, więc regularnie sprawdzaj status, dopóki operacja nie zostanie zakończona.
Instrukcja krok po kroku
1. Sprawdź uprawnienia
Upewnij się, że masz uprawnienie CredentialsManage, które jest wymagane do odbierania uprawnień innym podmiotom. Sprawdź swoje uprawnienia używając odpowiedniego endpointu API.
2. Zidentyfikuj uprawnienie do odebrania
Zidentyfikuj permissionId uprawnienia, które chcesz odebrać. permissionId to identyfikator nadanego uprawnienia, który możesz uzyskać z listy nadanych uprawnień lub z odpowiedzi przy nadawaniu uprawnienia.
3. Wywołaj endpoint odbierania
Wywołaj endpoint POST /api/v2/permissions/common/grants/{permissionId}, gdzie permissionId to identyfikator uprawnienia do odebrania. W odpowiedzi otrzymasz referenceNumber operacji, który służy do sprawdzania statusu.
4. Sprawdź status operacji
Sprawdzaj status operacji odbierania uprawnień używając odpowiedniego endpointu z referenceNumber. Proces jest asynchroniczny, więc regularnie sprawdzaj status, dopóki operacja nie zostanie zakończona (sukces lub błąd).
Najczęstsze problemy i rozwiązania
Brak uprawnienia CredentialsManage
Aby odbierać uprawnienia, musisz mieć uprawnienie CredentialsManage. Sprawdź swoje uprawnienia używając odpowiedniego endpointu API. Jeśli nie masz tego uprawnienia, poproś administratora o jego nadanie lub użyj konta z odpowiednimi uprawnieniami.
Nie znam permissionId
permissionId to identyfikator nadanego uprawnienia. Możesz uzyskać go z listy nadanych uprawnień używając odpowiedniego endpointu API lub zapisać go przy nadawaniu uprawnienia. permissionId jest zwracany w odpowiedzi przy nadawaniu uprawnienia.
Status operacji nie zmienia się
Proces odbierania uprawnień jest asynchroniczny i może trwać pewien czas. Regularnie sprawdzaj status operacji używając referenceNumber. Jeśli status nie zmienia się przez długi czas, sprawdź dokumentację API lub skontaktuj się z supportem KSeF. W środowisku testowym proces może trwać dłużej.
Błąd przy odbieraniu uprawnień
Sprawdź szczegółowe komunikaty błędów zwrócone przez API. Typowe błędy: brak uprawnienia CredentialsManage, nieprawidłowy permissionId, uprawnienie już odebrane, brak dostępu do uprawnienia. Sprawdź dokumentację API dotyczącą błędów odbierania uprawnień.
Endpoint odbierania uprawnień
Endpoint POST /api/v2/permissions/common/grants/{permissionId} służy do odbierania uprawnień, gdzie permissionId to identyfikator nadanego uprawnienia do odebrania. Endpoint wymaga uprawnienia CredentialsManage. W odpowiedzi otrzymujesz referenceNumber operacji, który służy do sprawdzania statusu odbierania uprawnień. Proces jest asynchroniczny.
Wymagane uprawnienia
Aby odbierać uprawnienia, musisz mieć uprawnienie CredentialsManage. Uprawnienie to pozwala na zarządzanie uprawnieniami innych podmiotów (nadawanie i odbieranie). Sprawdź swoje uprawnienia używając odpowiedniego endpointu API. Jeśli nie masz tego uprawnienia, poproś administratora o jego nadanie.
Status operacji
Status operacji odbierania uprawnień można sprawdzić używając odpowiedniego endpointu z referenceNumber otrzymanym przy wywołaniu POST /api/v2/permissions/common/grants/{permissionId}. Proces jest asynchroniczny i może trwać pewien czas. Regularnie sprawdzaj status, dopóki operacja nie zostanie zakończona (sukces lub błąd). Status może być: w trakcie przetwarzania, zakończony pomyślnie, błąd.
Typowe problemy
Typowe problemy: brak uprawnienia CredentialsManage (wymagane do odbierania uprawnień), nieprawidłowy permissionId (sprawdź identyfikator uprawnienia), status operacji nie zmienia się (proces asynchroniczny, regularnie sprawdzaj status), błędy API (sprawdź szczegółowe komunikaty błędów). W środowisku testowym proces może trwać dłużej niż w produkcji.
FAQ
Jak odebrać uprawnienia w KSeF API?
Wywołaj endpoint POST /api/v2/permissions/common/grants/{permissionId}, gdzie permissionId to identyfikator nadanego uprawnienia do odebrania. Endpoint wymaga uprawnienia CredentialsManage. W odpowiedzi otrzymasz referenceNumber operacji, który służy do sprawdzania statusu. Proces jest asynchroniczny, więc regularnie sprawdzaj status.
Jakie uprawnienia są wymagane do odbierania uprawnień?
Aby odbierać uprawnienia, musisz mieć uprawnienie CredentialsManage. Uprawnienie to pozwala na zarządzanie uprawnieniami innych podmiotów (nadawanie i odbieranie). Sprawdź swoje uprawnienia używając odpowiedniego endpointu API. Jeśli nie masz tego uprawnienia, poproś administratora o jego nadanie.
Jak sprawdzić status operacji odbierania?
Status operacji odbierania uprawnień można sprawdzić używając odpowiedniego endpointu z referenceNumber otrzymanym przy wywołaniu POST /api/v2/permissions/common/grants/{permissionId}. Proces jest asynchroniczny i może trwać pewien czas. Regularnie sprawdzaj status, dopóki operacja nie zostanie zakończona.
Gdzie znajdę permissionId?
permissionId to identyfikator nadanego uprawnienia. Możesz uzyskać go z listy nadanych uprawnień używając odpowiedniego endpointu API lub zapisać go przy nadawaniu uprawnienia. permissionId jest zwracany w odpowiedzi przy nadawaniu uprawnienia i służy do identyfikacji uprawnienia przy odbieraniu.
Dlaczego nie mogę odebrać uprawnień?
Sprawdź, czy masz uprawnienie CredentialsManage, które jest wymagane do odbierania uprawnień. Sprawdź, czy permissionId jest poprawny i czy uprawnienie nie zostało już odebrane. Sprawdź szczegółowe komunikaty błędów zwrócone przez API. W środowisku testowym mogą występować dodatkowe ograniczenia.