2.2.0

Author: CIRF-DEV9

.github/RELEASE_NOTES.md

@@ -1,12 +1,23 @@
+## Rejestr zmian: Wersja 2.2.0
+### Nowe
+- Dodano możliwość przełączenia PascalCase/camelCase w nazwach właściwości zwracanych z API.
+- Dodano obsługę endpointa `POST /permissions/query/entities/grants` umożliwiającego pobranie listy uprawnień do obsługi faktur w bieżącym kontekście logowania.
+- Rozszerzono odpowiedź endpointu POST `/auth/challenge` o pole `clientIp` zwracające adres IP klienta zarejestrowany przez KSeF.
+- Ustandaryzowano odpowiedzi `401 Unauthorized` oraz `403 Forbidden` do formatu Problem Details `(application/problem+json)`.
+- Dodano schematy `UnauthorizedProblemDetails` oraz `ForbiddenProblemDetails`.
+- Rozszerzono `ForbiddenProblemDetails` o wymagane pole `reasonCode` oraz o opcjonalny obiekt `security` (dodatkowe dane zależne od `reasonCode`).
+
 ## Rejestr zmian: Wersja 2.1.2
 ### Nowe
+
 - Dodano nowy kod systemowy `FA_RR(1)` w `SystemCode` (wraz z mapowaniem w `SystemCodeHelper`).
 - Dodano nowy test E2E dla faktury VAT RR: `AuthorizationPermissionsRRInvoicingE2ETests.RRInvoicingPermission_AllowsSendingFaRrInvoice`.
 
 ## Rejestr zmian: Wersja 2.1.1
 ### Nowe
 - Dodano parametr `enforceXadesCompliance` w metodzie `SubmitXadesAuthRequestAsync`, umożliwiający wcześniejsze włączenie nowych wymagań walidacji XAdES na środowiskach DEMO i PROD poprzez nagłówek `X-KSeF-Feature: enforce-xades-compliance`.
-- Dodano wsparcie dla .NET Standard 2.0 dla Windows oraz .NET Framework 4.8, dzięki zaangażowaniu Kontrybutora [@marcinborecki](https://github.com/CIRFMF/ksef-client-csharp/commits?author=marcinborecki)
+- Dodano wsparcie dla .NET Standard 2.0 dla Windows oraz .NET Framework 4.8, dzięki zaangażowaniu Kontrybutora [@marcinborecki](https://github.com/CIRFMF/ksef-client-csharp/pull/197)
+
 
 
 ## Rejestr zmian: Wersja 2.1.0
@@ -19,7 +30,7 @@
 
 ### Zmodyfikowane
 - `AuthStatus`, `AuthenticationListItem`: Pole `AuthenticationMethod` oznaczono jako **Obsolete** (planowane wycofanie: 2026-11-16).
-- Metody `AddBatchFilePart` oraz `AddBatchFileParts` z parametrem `fileName` oznaczono jako przestarzałe (Obsolete) i zostaną usunięte w niedalekiej przyszłości. Zaleca się używanie przyciążeń bez parametru `fileName`
+- Metody `AddBatchFilePart` oraz `AddBatchFileParts` z parametrem `fileName` oznaczono jako przestarzałe (Obsolete) i zostaną usunięte w niedalekiej przyszłości. Zaleca się używanie przeciążeń bez parametru `fileName`
 - `KsefNumberValidator` zwraca teraz komunikat informujący o błędzie w przypadku nieprawidłowej sumy kontrolnej
 - `DateRange`: Zmieniono typ pól `From` i `To` z DateTime na DateTimeOffset w celu poprawnej obsługi stref czasowych i offsetów zgodnie ze specyfikacją API KSeF (format ISO 8601 z offsetem/UTC/lokalny Europe/Warsaw)
 	- Zmiana typu DateRange.From i DateRange.To z DateTime na DateTimeOffset może wpłynąć na Twoje rozwiązania. Jeśli korzystasz z DateRange do filtrowania faktur, sprawdź czy Twój kod poprawnie tworzy DateTimeOffset

KSeF.Client.ClientFactory/KSeFFactoryExtensions.cs

@@ -1,4 +1,5 @@
 using Microsoft.Extensions.DependencyInjection;
+using KSeF.Client.Http;
 using System.Net.Http.Headers;
 
 namespace KSeF.Client.ClientFactory.DI
@@ -13,8 +14,13 @@ public static class KSeFFactoryExtensions
         /// </summary>
         /// <param name="services">Rozszerzany interfejs</param>
         /// <exception cref="ArgumentException"></exception>
-        public static IServiceCollection RegisterKSeFClientFactory(this IServiceCollection services)
+        public static IServiceCollection RegisterKSeFClientFactory(this IServiceCollection services, bool useCamelCase = false)
         {
+            if (useCamelCase)
+            {
+                JsonUtil.ResetConfigurationForCasePropertyName(useCamelCase);
+            }
+
             services.AddHttpClient(Environment.Demo.ToString(), http =>
             {
                 http.BaseAddress = new Uri(KsefEnvironmentConfig.BaseUrls[Environment.Demo]);

KSeF.Client.Core/Exceptions/ApiExceptionDetail.cs

@@ -21,5 +21,14 @@ public class ApiExceptionDetail
         /// Opcjonalna lista dodatkowych komunikatów kontekstowych.
         /// </summary>
         public List<string> Details { get; set; }
+
+        public ApiExceptionDetail() { }
+
+        public ApiExceptionDetail(int code, string description, List<string> details = null)
+        {
+            ExceptionCode = code;
+            ExceptionDescription = description;
+            Details = details;
+        }
     }
 }

KSeF.Client.Core/Exceptions/ForbiddenProblemDetails.cs

@@ -0,0 +1,15 @@
+using System.Collections.Generic;
+
+namespace KSeF.Client.Core.Exceptions
+{
+    public class ForbiddenProblemDetails
+    {
+        public string Title { get; set; }
+        public int Status { get; set; }
+        public string Detail { get; set; }
+        public string Instance { get; set; }
+        public string ReasonCode { get; set; }
+        public Dictionary<string, object> Security { get; set; }
+        public string TraceId { get; set; }
+    }
+}

KSeF.Client.Core/Exceptions/UnauthorizedProblemDetails.cs

@@ -0,0 +1,11 @@
+namespace KSeF.Client.Core.Exceptions
+{
+    public class UnauthorizedProblemDetails
+    {
+        public string Title { get; set; }
+        public int Status { get; set; }
+        public string Detail { get; set; }
+        public string Instance { get; set; }
+        public string TraceId { get; set; }
+    }
+}

KSeF.Client.Core/Infrastructure/Rest/Routes.cs

@@ -374,6 +374,11 @@ public static class Query
                 /// Wyszukiwanie uprawnień nadanych podmiotom unijnym (EU entities) w bieżącym kontekście.
                 /// </summary>
                 public const string EuEntitiesGrants = Prefix + "/query/eu-entities/grants";
+
+                /// <summary>
+                /// Wyszukiwanie uprawnień do obsługi faktur w bieżącym kontekście.
+                /// </summary>
+                public const string Entities = Prefix + "/query/entities/grants";
             }
 
             /// <summary>

KSeF.Client.Core/Interfaces/Clients/ISearchPermissionClient.cs

@@ -103,5 +103,21 @@ public interface ISearchPermissionClient
         /// <exception cref="KsefApiException">Nieprawidłowe żądanie. (400 Bad request)</exception>
         /// <exception cref="KsefApiException">Brak autoryzacji. (401 Unauthorized)</exception>
         Task<PagedPermissionsResponse<EuEntityPermission>> SearchGrantedEuEntityPermissionsAsync(EuEntityPermissionsQueryRequest requestPayload, string accessToken, int? pageOffset = null, int? pageSize = null, CancellationToken cancellationToken = default);
+
+        /// <summary>
+        /// Pobranie listy uprawnień do obsługi faktur w bieżącym kontekście.
+        /// </summary>
+        /// <param name="requestPayload">Zapytanie z ContextIdentifier</param>
+        /// <param name="accessToken">Access token</param>
+        /// <param name="pageOffset">Index strony wyników (domyślnie 0)</param>
+        /// <param name="pageSize">Ilość elementów na stronie (domyślnie 10)</param>
+        /// <param name="cancellationToken"></param>
+        /// <returns><see cref="EntityPermissionGrantResponse"/></returns>
+        Task<EntityPermissionGrantResponse> QueryEntitiesGrantsAsync(
+            EntityPermissionGrantQueryRequest requestPayload,
+            string accessToken,
+            int? pageOffset = null,
+            int? pageSize = null,
+            CancellationToken cancellationToken = default);
     }
 }

KSeF.Client.Core/Models/ApiResponses/OnlineSessionCodeResponse.cs

@@ -45,10 +45,10 @@ public static class OnlineSessionCodeResponse
         /// </summary>
         public const int SessionCancelledNoInvoices = 440;
 
-        /// <summary>
-        /// Kod 445 — Błąd weryfikacji, brak poprawnych faktur.
-        /// </summary>
-        public const int NoValidInvoices = 445;
+		/// <summary>
+		/// Kod 445 — Błąd weryfikacji, brak poprawnych faktur.
+		/// </summary>
+		public const int NoValidInvoices = 445;
 
         /// <summary>
         /// Kod 500 — Nieznany błąd.

KSeF.Client.Core/Models/Authorization/AuthenticationChallengeResponse.cs

@@ -19,5 +19,9 @@ public class AuthenticationChallengeResponse
         /// </summary>
         public long TimestampMs { get; set; }
 
+        /// <summary>
+        /// Adres IP klienta
+        /// </summary>
+        public string ClientIp { get; set; }
     }
 }

KSeF.Client.Core/Models/Permissions/Entity/EntityPermissionGrantQueryRequest.cs

@@ -0,0 +1,25 @@
+using System.Runtime.Serialization;
+using System.Xml.Serialization;
+
+namespace KSeF.Client.Core.Models.Permissions.Entity
+{
+    public class EntityPermissionGrantQueryRequest
+    {
+        public EntityPermissionGrantQueryContextIdentifier ContextIdentifier { get; set; }
+    }
+
+    public class EntityPermissionGrantQueryContextIdentifier
+    {
+        public EntityPermissionGrantQueryContextIdentifierType Type { get; set; }
+        public string Value { get; set; }
+
+    }
+
+    public enum EntityPermissionGrantQueryContextIdentifierType
+    {
+        [EnumMember(Value = "Nip")]
+        Nip,
+        [EnumMember(Value = "InternalId")]
+        InternalId
+    }
+}