Skip to content

Commit 25ad64c

Browse files
author
k-wysocki-bl
committed
update code snippets
1 parent 53d9d4f commit 25ad64c

File tree

12 files changed

+267
-114
lines changed

12 files changed

+267
-114
lines changed

auth/sesje.md

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,15 +8,20 @@ Zwraca listę aktywnych sesji uwierzytelnienia.
88
GET [/auth/sessions](https://ksef-test.mf.gov.pl/docs/v2/index.html#tag/Aktywne-sesje/paths/~1api~1v2~1auth~1sessions/get)
99

1010
Przykład w języku ```C#```:
11+
[KSeF.Client.Tests.Core/E2E/Authorization/Sessions/SessionE2ETests.cs](https://github.com/CIRFMF/ksef-client-csharp/blob/main/KSeF.Client.Tests.Core/E2E/Authorization/Sessions/SessionE2ETests.cs)
1112
```csharp
1213
const int pageSize = 20;
13-
string? continuationToken = null;
14-
var activeSessions = new List<Item>();
14+
string continuationToken = string.Empty;
15+
List<AuthenticationListItem> authenticationListItems = [];
16+
1517
do
1618
{
17-
var response = await ksefClient.GetActiveSessions(accessToken, pageSize, continuationToken, cancellationToken);
18-
continuationToken = response.ContinuationToken;
19-
activeSessions.AddRange(response.Items);
19+
AuthenticationListResponse page = await ActiveSessionsClient.GetActiveSessions(accessToken, pageSize, continuationToken, CancellationToken.None);
20+
continuationToken = page.ContinuationToken;
21+
if (page.Items != null)
22+
{
23+
authenticationListItems.AddRange(page.Items);
24+
}
2025
}
2126
while (!string.IsNullOrWhiteSpace(continuationToken));
2227
```
@@ -41,6 +46,7 @@ Unieważnia sesję związaną z tokenem użytym do wywołania tego endpointu. Po
4146
- aktywne ```accessTokeny``` pozostają ważne do upływu ich terminu ważności.
4247

4348
Przykład w języku ```C#```:
49+
[KSeF.Client.Tests.Core/E2E/Authorization/Sessions/SessionE2ETests.cs](https://github.com/CIRFMF/ksef-client-csharp/blob/main/KSeF.Client.Tests.Core/E2E/Authorization/Sessions/SessionE2ETests.cs)
4450
```csharp
4551
await ksefClient.RevokeCurrentSessionAsync(token, cancellationToken);
4652
```
@@ -61,6 +67,7 @@ Unieważnia sesję o wskazanym numerze referencyjnym. Po operacji:
6167
- aktywne ```accessTokeny``` pozostają ważne do upływu ich terminu ważności.
6268

6369
Przykład w języku ```C#```:
70+
[KSeF.Client.Tests.Core/E2E/Authorization/Sessions/SessionE2ETests.cs](https://github.com/CIRFMF/ksef-client-csharp/blob/main/KSeF.Client.Tests.Core/E2E/Authorization/Sessions/SessionE2ETests.cs)
6471
```csharp
6572
await ksefClient.RevokeSessionAsync(referenceNumber, accessToken, cancellationToken);
6673
```

certyfikaty-KSeF.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -69,7 +69,7 @@ Przykład w języku C#:
6969
[KSeF.Client.Tests.Core\E2E\Certificates\CertificatesE2ETests.cs](https://github.com/CIRFMF/ksef-client-csharp/blob/main/KSeF.Client.Tests.Core/E2E/Certificates/CertificatesE2ETests.cs)
7070
```csharp
7171
CertificateEnrollmentsInfoResponse certificateEnrollmentsInfoResponse =
72-
await KsefClient.GetCertificateEnrollmentDataAsync(accessToken, CancellationToken);
72+
await KsefClient.GetCertificateEnrollmentDataAsync(accessToken, CancellationToken).ConfigureAwait(false);
7373
```
7474

7575
Przykład w języku Java:
@@ -259,7 +259,8 @@ Parametry filtrowania (opcjonalne):
259259
* `pageOffset` - numer strony wyników (domyślnie 0)
260260

261261
Przykład w języku C#:
262-
[KSeF.Client.Tests.Core\E2E\Certificates\CertificatesE2ETests.cs](https://github.com/CIRFMF/ksef-client-csharp/blob/main/KSeF.Client.Tests.Core/E2E/Certificates/CertificatesE2ETests.cs)
262+
[KSeF.Client.Tests.Core\E2E\Certificates\CertificateMetadataListE2ETests.cs](https://github.com/CIRFMF/ksef-client-csharp/blob/main/KSeF.Client.Tests.Core\E2E\Certificates/CertificateMetadataListE2ETests.cs)
263+
263264
```csharp
264265
var request = GetCertificateMetadataListRequestBuilder
265266
.Create()

faktury/sesja-sprawdzenie-stanu-i-pobranie-upo.md

Lines changed: 24 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -11,30 +11,34 @@ GET [sessions](https://ksef-test.mf.gov.pl/docs/v2/index.html#tag/Status-wysylki
1111
Zwraca bieżący status sesji wraz z zagregowanymi danymi o liczbie przesłanych, poprawnie i niepoprawnie przetworzonych faktur; po zamknięciu sesji udostępnia dodatkowo listę referencji do zbiorczego UPO.
1212

1313
Przykład w języku C#:
14+
[KSeF.Client.Tests.Core/E2E/Sessions/SessionStatusE2ETests.cs](https://github.com/CIRFMF/ksef-client-csharp/blob/main/KSeF.Client.Tests.Core/E2E/Sessions/SessionStatusE2ETests.cs)
1415
```csharp
1516
// Pobieranie sesji wsadowych
16-
var sessions = new List<Session>();
17+
List<Session> sessions = new List<Session>();
1718
const int pageSize = 20;
1819
string? continuationToken = null;
1920
do
2021
{
21-
var response = await ksefClient.GetSessionsAsync(SessionType.Batch, accessToken, pageSize, continuationToken, sessionsFilter, cancellationToken);
22+
SessionsListResponse response = await ksefClient.GetSessionsAsync(SessionType.Batch, accessToken, pageSize, continuationToken, sessionsFilter, cancellationToken).ConfigureAwait(false);
2223
continuationToken = response.ContinuationToken;
2324
sessions.AddRange(response.Sessions);
2425
} while (!string.IsNullOrEmpty(continuationToken));
2526

2627
// Pobieranie sesji interaktywnych
27-
var sessions = new List<Session>();
28+
List<Session> sessions = new List<Session>();
2829
const int pageSize = 20;
2930
string? continuationToken = null;
3031
do
3132
{
32-
var response = await ksefClient.GetSessionsAsync(SessionType.Online, accessToken, pageSize, continuationToken, sessionsFilter, cancellationToken);
33+
SessionsListResponse response = await ksefClient.GetSessionsAsync(SessionType.Online, accessToken, pageSize, continuationToken, sessionsFilter, cancellationToken).ConfigureAwait(false);
3334
continuationToken = response.ContinuationToken;
3435
sessions.AddRange(response.Sessions);
3536
} while (!string.IsNullOrEmpty(continuationToken));
3637
```
3738

39+
`sessionsFilter` to obiekt filtrów znajdujący się tutaj: [KSeF.Client.Core/Models/Sessions/SessionsFilter.cs](https://github.com/CIRFMF/ksef-client-csharp/blob/main/KSeF.Client.Core/Models/Sessions/SessionsFilter.cs)
40+
41+
3842
Przykład w języku Java:
3943
[SessionIntegrationTest.java](https://github.com/CIRFMF/ksef-client-java/blob/main/demo-web-app/src/integrationTest/java/pl/akmf/ksef/sdk/SessionIntegrationTest.java)
4044

@@ -58,18 +62,20 @@ GET [sessions/\{referenceNumber\}](https://ksef-test.mf.gov.pl/docs/v2/index.htm
5862
Zwraca bieżący status sesji wraz z zagregowanymi danymi o liczbie przesłanych, poprawnie i niepoprawnie przetworzonych faktur; po zamknięciu sesji udostępnia dodatkowo listę referencji do zbiorczego UPO.
5963

6064
Przykład w języku C#:
65+
[KSeF.Client.Tests.Core/E2E/OnlineSession/OnlineSessionE2ETests.cs](https://github.com/CIRFMF/ksef-client-csharp/blob/main/KSeF.Client.Tests.Core/E2E/OnlineSession/OnlineSessionE2ETests.cs)
6166
```csharp
62-
var openSessionResult = await kSeFClient.GetSessionStatusAsync(referenceNumber, accessToken, cancellationToken);
63-
var documentCount = openSessionResult.InvoiceCount;
64-
var successfulInvoiceCount = openSessionResult.SuccessfulInvoiceCount;
65-
var failedInvoiceCount = openSessionResult.FailedInvoiceCount;
67+
SessionStatusResponse openSessionResult = await kSeFClient.GetSessionStatusAsync(referenceNumber, accessToken, cancellationToken).ConfigureAwait(false);
68+
69+
int documentCount = openSessionResult.InvoiceCount;
70+
int successfulInvoiceCount = openSessionResult.SuccessfulInvoiceCount;
71+
int failedInvoiceCount = openSessionResult.FailedInvoiceCount;
6672
```
6773

6874
Przykład w języku Java:
6975
[OnlineSessionIntegrationTest.java](https://github.com/CIRFMF/ksef-client-java/blob/main/demo-web-app/src/integrationTest/java/pl/akmf/ksef/sdk/OnlineSessionIntegrationTest.java)
7076

7177
```java
72-
SessionStatusResponse statusResponse = ksefClient.getSessionStatus(sessionReferenceNumber, accessToken);
78+
SessionStatusResponse statusResponse = ksefClient.getSessionStatus(referenceNumber, accessToken);
7379
```
7480

7581

@@ -86,17 +92,18 @@ string continuationtoken = null;
8692

8793
do
8894
{
89-
var sessionInvoices = await ksefClient
95+
SessionInvoicesResponse sessionInvoices = await ksefClient
9096
.GetSessionInvoicesAsync(
9197
referenceNumber,
9298
accessToken,
9399
pageOffset,
94100
pageSize,
95-
cancellationToken);
101+
cancellationToken)
102+
ConfigureAwait(false);
96103

97-
foreach (var doc in getInvoicesResult.Invoices)
104+
foreach (SessionInvoice sessionInvoice in sessionInvoices.Invoices)
98105
{
99-
Console.WriteLine($"#{doc.InvoiceNumber}. Status: {doc.Status.Code}");
106+
Console.WriteLine($"#{sessionInvoice.InvoiceNumber}. Status: {sessionInvoice.Status.Code}");
100107
}
101108

102109
continuationtoken = sessionInvoices.ContinuationToken;
@@ -125,7 +132,7 @@ GET [sessions/\{referenceNumber\}/invoices/\{invoiceReferenceNumber\}](https://k
125132

126133
Przykład w języku C#:
127134
```csharp
128-
var invoice = await ksefClient
135+
SessionInvoice invoice = await ksefClient
129136
.GetSessionInvoiceAsync(
130137
referenceNumber,
131138
invoiceReferenceNumber,
@@ -151,7 +158,7 @@ GET [sessions/\{referenceNumber\}/invoices/\{invoiceReferenceNumber\}/upo](https
151158

152159
Przykład w języku C#:
153160
```csharp
154-
var upo = await ksefClient
161+
string upo = await ksefClient
155162
.GetSessionInvoiceUpoByReferenceNumberAsync(
156163
referenceNumber,
157164
invoiceReferenceNumber,
@@ -204,7 +211,7 @@ string continuationToken = "";
204211

205212
do
206213
{
207-
var sessionInvoices = await ksefClient
214+
List<SessionInvoicesResponse> sessionInvoices = await ksefClient
208215
.GetSessionFailedInvoicesAsync(
209216
referenceNumber,
210217
accessToken,
@@ -263,7 +270,7 @@ Otrzymany dokument XML jest zgodny ze schematem [XSD](/faktury/upo/schemy/upo-v4
263270
Przykład w języku C#:
264271

265272
```csharp
266-
var upo = await ksefClient.GetSessionUpoAsync(
273+
string upo = await ksefClient.GetSessionUpoAsync(
267274
sessionReferenceNumber,
268275
upoReferenceNumber,
269276
accessToken,

kody-qr.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Kody QR wprowadzono z myślą o sytuacjach, gdy faktura trafia do odbiorcy innym
88
- pobrać jej wersję ustrukturyzowaną (plik XML) bez potrzeby kontaktu z wystawcą,
99
- potwierdzić autentyczność wystawcy (w przypadku faktur offline).
1010

11-
Generowanie kodów (zarówno dla faktur online, jak i offline) odbywa się lokalnie w aplikacji klienta na podstawie danych zawartych w wystawionej fakturze. Kod QR musi być zgodny z normą ISO/IEC 18004:2024. Jeśli nie ma możliwości umieszczenia kodu bezpośrednio na fakturze (np. format danych tego nie pozwala), należy dostarczyć go odbiorcy jako oddzielny plik graficzny lub link.
11+
Generowanie kodów (zarówno dla faktur online, jak i offline) odbywa się lokalnie w aplikacji klienta na podstawie danych zawartych w wystawionej fakturze. Kod QR musi być zgodny z normą ISO/IEC 18004:2024. Jeśli nie ma możliwości umieszczenia kodu bezpośrednio na fakturze (np. format danych tego nie pozwala), należy dostarczyć go odbiorcy jako oddzielny plik graficzny lub link.
1212

1313
### Środowiska
1414

@@ -234,7 +234,6 @@ Przykład w języku ```C#```:
234234
byte[] qrOfflineCode = QrCodeService.GenerateQrCode(
235235
linkService.BuildCertificateVerificationUrl(
236236
nip,
237-
QRCodeContextIdentifierType.Nip,
238237
nip,
239238
certificate.CertificateSerialNumber,
240239
invoiceHash,

0 commit comments

Comments
 (0)