P88.KSeF.Interop 2.0.0.5

Instalacja

1. Dodaj źródło GitHub Packages CIRFMF
2. Dodaj paczkę KSeF.Client.Core
3. Dodaj paczkę P88.KSeF.Interop
4. Zainstaluj KSeF.Interop.Server
   • Metoda 1
     1. Edytuj app.manifest (Dodaj > Nowy element > Plik manifestu aplikacji)

        <?xml version="1.0" encoding="utf-8"?>
        <assembly manifestVersion="1.0" xmlns="urn:schemas-microsoft-com:asm.v1">
          <assemblyIdentity version="1.0.0.0" name="MyApplication.app"/>
        
          <dependency>
            <dependentAssembly>
              <assemblyIdentity type="win32" name="KSeF.Interop.Server.X" version="2.0.0.3"/>
            </dependentAssembly>
          </dependency>
        
        </assembly>
        

     2. Ustaw Platform target na x64
     3. Wypakuj KSeF.Interop.Server.2.0.0.3.zip do KSeF.Interop.Server.X w katalogu aplikacji (np. bin\Debug\KSeF.Interop.Server.X).
   • Metoda 2 (Wymaga uprawnień administratora)
     1. Wypakuj KSeF.Interop.Server.2.0.0.3.zip.
     2. Uruchom register.ps1 jako administrator.
   • Metoda 3 (Wymaga uprawnień administratora)
     1. Wypakuj KSeF.Interop.Server.2.0.0.3.zip.
     2. Uruchom cmd jako administrator.
     3. W cmd uruchom:

        regsvr32 /s "ścieżka_do_folderu\KSeF.Interop.Server.comhost.dll"
        

Użycie

Inicjalizacja

KsefClient ksef = new KsefClient(connectionString: "Data Source=1.2.3.4;Initial Catalog=db;User ID=user;Password=password;TrustServerCertificate=True;");
await ksef.InitializeAsync(login: "login", nip: "1234567890");
await ksef.AuthenticateAsync();

Wysyłka pojedynczej faktury (sesja interaktywna)

// Wyślij fakturę
SendOnlineInvoiceResponse sendInvoiceResponse = await ksef.SendInvoiceAsync(invoiceId: 12345);

// Poczekaj na przetworzenie
SessionStatusResponse sessionStatusResponse = await ksef.PollSessionAsync(sendInvoiceResponse.SessionReferenceNumber);

// Pobierz przetworzoną fakturę
SessionInvoice sessionInvoice = await ksef.GetSessionInvoiceAsync(sendInvoiceResponse.SessionReferenceNumber, sendInvoiceResponse.ReferenceNumber);

// Wyślij fakturę
SendOnlineInvoiceResponse sendInvoiceResponse = await ksef.SendInvoiceAsync(invoiceId: 12345);

// Poczekaj na przetworzenie
SessionInvoice sessionInvoice;
do
{
    sessionInvoice = await ksef.GetSessionInvoiceAsync(sendInvoiceResponse.SessionReferenceNumber, sendInvoiceResponse.ReferenceNumber);
    await Task.Delay(1000);
} while (sessionInvoice.Status.Code < 200);

Wysyłka wielu faktur (sesja wsadowa)

// Wyślij faktury
SendBatchInvoiceResponse  sendInvoicesResponse = await ksef.SendInvoiceAsync(invoiceIds: [624, 625, 626]);

// Poczekaj na przetworzenie
SessionStatusResponse sessionStatusResponse = await ksef.PollSessionAsync(sendInvoicesResponse.SessionReferenceNumber);

// Pobierz przetworzone faktury
List<SessionInvoice> sessionInvoices = await ksef.GetSessionInvoicesAsync(sendInvoiceResponse.SessionReferenceNumber);

// Wyślij faktury
SendBatchInvoiceResponse sendInvoicesResponse = await ksef.SendInvoicesAsync(invoiceIds: [624, 625, 626]);

// Poczekaj na przetworzenie
List<SessionInvoice> sessionInvoices;
int processing, success, error;
do
{
    sessionInvoices = await ksef.GetSessionInvoicesAsync(sendInvoiceResponse.SessionReferenceNumber);
    processing = sessionInvoices.Count(x => x.Status.Code < 200);
    success = sessionInvoices.Count(x => x.Status.Code == 200);
    error = sessionInvoices.Count(x => x.Status.Code > 200);
    await Task.Delay(1000);
} while (sessionInvoices.Count < <InvoiceIds>.Length || processing > 0);

Pobieranie listy faktur

// Przykładowy filtr: faktury sprzedażowe z ostatnich 30 dni
InvoiceQueryFilters filters = new InvoiceQueryFilters()
{
    SubjectType = InvoiceSubjectType.Subject1,
    DateRange = new DateRange()
    {
        DateType = DateType.Invoicing,
        From = DateTime.UtcNow.AddDays(-30),
    },
};

// Pobierz listę faktur
List<InvoiceSummary> invoices = [];
PagedInvoiceResponse queryResponse;
do
{
    const int maxPageSize = 250;
    queryResponse = await ksef.QueryInvoices(filters, pageOffset: invoices.Count / maxPageSize, pageSize: maxPageSize);
    invoices.AddRange(queryResponse.Invoices);
} while (queryResponse is { HasMore: true, IsTruncated: false });

Eksport faktur

// Przykładowy filtr: faktury zakupowe z ostatnich 7 dni
InvoiceExportFilters filters = new InvoiceExportFilters()
{
    SubjectType = InvoiceSubjectType.Subject2,
    DateRange = new DateRange()
    {
        DateType = DateType.Invoicing,
        From = DateTime.UtcNow.AddDays(-7),
    },
};

// Eksport faktur
PackageProcessingResult packageResult = await ksef.ExportInvoicesAsync(filters);
foreach (var metadata in packageResult.MetadataSummaries)
{
    string xmlContent = packageResult.InvoiceXmlFiles[$"{metadata.KsefNumber}.xml"];
}

Generowanie linków weryfikacyjnych

var ksef = new KsefClient(connectionString);
await ksef.InitializeAsync(userId, nip);
// AuthenticateAsync() nie jest wymagane do generowania linków weryfikacyjnych

string invoiceVerificationUrl = await ksef.BuildInvoiceVerificationUrl(invoiceId: 12345);
string certificateVerificationUrl = await ksef.BuildCertificateVerificationUrl(invoiceId: 12345);