AltOne.WebAPI.Core 2510.1.1-0.7.5.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
This is a prerelease version of AltOne.WebAPI.Core. 
dotnet add package AltOne.WebAPI.Core --version 2510.1.1-0.7.5.0
                    


                    

                
NuGet\Install-Package AltOne.WebAPI.Core -Version 2510.1.1-0.7.5.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="AltOne.WebAPI.Core" Version="2510.1.1-0.7.5.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="AltOne.WebAPI.Core" Version="2510.1.1-0.7.5.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="AltOne.WebAPI.Core" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add AltOne.WebAPI.Core --version 2510.1.1-0.7.5.0
                    


                    

                
#r "nuget: AltOne.WebAPI.Core, 2510.1.1-0.7.5.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package AltOne.WebAPI.Core@2510.1.1-0.7.5.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=AltOne.WebAPI.Core&version=2510.1.1-0.7.5.0&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=AltOne.WebAPI.Core&version=2510.1.1-0.7.5.0&prerelease
                    


                            Install as a Cake Tool

AltOne.WebAPI.Core

AltOne.WebAPI.Core to licencjonowana biblioteka dla platformy enova365, zapewniająca szybkie i bezpieczne integracje poprzez REST API (JSON). Pakiet udostępnia gotowe kontrakty i operacje WebAPI w kluczowych obszarach:

  • Metody słownikowe i operacyjne: pracownicy, kontrahenci, słowniki płatności i form rozliczeń, powiązania kontrahentów, rachunki bankowe, cechy (w tym historyczne i algorytmiczne), załączniki (odczyt/zapis wraz z cechami), adresy i kontakty.
  • Metody agregujące do pobierania danych „w paczkach” (packable) oraz skróconych kontraktów dla szybkich integracji.

Biblioteka zapewnia ujednolicone walidacje, spójne komunikaty zwrotne, co skraca czas wdrożenia i minimalizuje ryzyko błędów. Dostępny jest także tryb TestMode (dry‑run), umożliwiający bezpieczne testowanie żądań – bez trwałych zmian w bazie danych – z pełną walidacją i zwracaniem ostrzeżeń oraz wyników jak w operacjach produkcyjnych.

Generowana jest dokumentacja dla różnych grup odbiorców:

  • Konsultanci i biznes: opis usług i kontraktów, przykłady użycia.
  • Programiści: definicje JSON/schema i materiały zgodne z narzędziami typu Postman/CI, ułatwiające integrację i testy automatyczne.

Wymagania i zależności

  • Wymagana biblioteka: Newtonsoft.Json.Schema w wersji 3.0.15.
    Biblioteka ta jest używana do generowania definicji JSON Schema.

Produkty korzystające z biblioteki

Biblioteka jest wykorzystywana jako wspólna warstwa integracyjna w innych pakietach AltOne.WebAPI.* Aktualną listę znajdziesz na karcie „Used By” pakietu NuGet:
https://www.nuget.org/packages/AltOne.WebAPI.Core/2510.0.0-0.7.3.0#usedby-body-tab

Dla wszystkich tych pakietów biblioteka odpowiada za generowanie spójnej dokumentacji WebAPI (HTML + JSON Schema + kolekcje Postman). Przykład publicznie dostępnej dokumentacji:
https://altone-public.github.io/enova-products-docs/AltOne.Integracje/docs/DokumentacjaDynamicWebAPI.html

Dokumentacja nadaje się do:

  • analizy zakresu i możliwości integracji,
  • pracy warsztatowej z biznesem/konsultantami,
  • pracy programistów (kontrakty, schematy, testy w Postman),
  • automatyzacji testów integracyjnych (CI).

Dokumentacja pakietu

Użycie

Po zainstalowaniu biblioteki w środowisku multi enova365 oraz przypisaniu kontrolerów do użytkownika będą dostępne nowe metody do integracji poprzez WebAPI. Szczegóły dostępnych wszystkich metod do szybkiej integracji: Dokumentacja usługi w repozytorium GitHub

Konfiguracja i szczegółowe informacje dostępne są w dokumentacji produktowej:
AltOne.WebAPI.Core enova365

Testy integracyjne

Aktualne wyniki testów dla najnowszych wersji enova365:
latest.md w repozytorium GitHub

Ważne informacje

Wyniki testów integracyjnych mają charakter pomocniczy i nie zwalniają klienta z obowiązku przetestowania biblioteki w środowisku testowym przed wdrożeniem na produkcję.

Automatyczne testy obejmują jedynie podstawowe scenariusze i mogą nie odzwierciedlać specyfiki konkretnego wdrożenia.

Security

Biblioteka jest skanowana w ramach Azure DevOps Advanced Security.

Advanced Security

Aktualnie: brak otwartych alertów dependency. ✅

Historia zmian

Zmiany wersji są publikowane w sekcji Release Notes na NuGet.org.

License

Biblioteka jest licencjonowana. Szczegóły warunków licencji dostępne są w umowie z AltOne.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (6)

Showing the top 5 NuGet packages that depend on AltOne.WebAPI.Core:

Package Downloads
AltOne.WebAPI.ObslugaCzasuPracy

Licencjonowana biblioteka rozszerzająca enova365 o obsługę czasu pracy poprzez WebAPI
AltOne.WebApi.ObslugaFakturKosztowych

Licencjonowana biblioteka rozszerzająca umożliwiająca zapis dokumentów kosztowych, PK oraz matryc do bazy enova365 poprzez WebAPI
AltOne.WebAPI.ObslugaFakturHandlowych

Biblioteka rozszerzająca umożliwiająca zapis dokumentów handlowych do bazy enova365
AltOne.WebApi.DataExchangeTable

Biblioteka rozszerzająca obsługę tabeli wymiany DataExchangeTable poprzez WebAPI. Wymagana biblioteka AltOne.DataExchangeTable oraz AltOne.WebAPI.Core
AltOne.WebAPI.ObslugaKadrowa

Licencjonowana biblioteka rozszerzająca enova365 o obsługę wybranego obszaru kadr poprzez WebAPI

GitHub repositories

This package is not used by any popular GitHub repositories.

## Version 0.7.5.0 z dn. 17.12.2025
     - Rozszerzenie kontraktu kontrahenta o WarunkiHandlowe oraz OdsetkiKarne
     ## Version 2510.1.1-0.7.4.0 z dn. 27.11.2025
     - Dodanie trybu TestMode dla zapytań WebAPI (bez trwałych zmian w danych, tzw. dry‑run).
     - Rozszerzenie `RowDTO` o obsługę TestMode oraz spójne walidacje i komunikaty zwrotne.
     - Ujednolicenie logowania wyników i ostrzeżeń w trybie testowym.
     ## Version 0.7.3.0 z dn. 27.10.2025
     - Kompilacja z wersją 2510.0.0 ze względu na zmianę obsługi załączników przez enova365
     - Dodanie obsługi odczytu/zapisu cech do załączników
     ## Version 0.7.2.1 z dn. 14.10.2025
     - Generowanie dokumentacji w j. angielskim
     - Oprogramowanie obsługi atrybutu [Obsolate] dla metod WebAPI w generowanej dokumentacji
     - Oprogramowanie stylu dark dla dokumentacji, linku "Back do libraries" na górnej belce
     ## Version 0.7.1.8 z dn. 11.09.2025
     - Poprawki zgłaszane przez Advenced Security w usłudze Azure Devops
     - Nowa forma pliku readme.md dla nuget.org
     ## Version 0.7.1.7 z dn. 12.08.2025
     - Update do wersji enova365 2504.1.1 (Advenced Security -> Recommendation: Upgrade Azure.Identity from 1.10 to 1.11)
     - Modyfikacja obsługi liczników wywołań metotod WebAPI
     ## Version 0.7.1.6 z dn. 18.06.2025
     - Umożliwenie przesłania cech bez konieczności uzupełniania właściwości obiektu Zatrudnienie
     ## Version 0.7.1.5 z dn. 28.05.2025
     - Umożliwienie zapisu aktualizacji bez podawania jednostki organizacyjnej w obiekcie Zatrudnienie
     ## Version 0.7.1.4 z dn. 06.05.2025
     - Umożliwienie zapisu aktualizacji bez podawania całego okresu w obiekcie Zatrudnienie
     ## Version 0.7.1.3 z dn. 11.04.2025
     - Uporządkowanie metod SimpleRight, 1 metoda - 1 prawo wg nazwy metody.
     - Weryfikacja kodu i bezpieczeństwa przez mechanizm Azure Devops - Advenced Security (security-and-quality)
     ## Version 0.7.1.2 z dn. 18.04.2025
     - Dodanie obsługi identyfikatora podatkowego pracownika (nip, pesel)
     - Dodanie obsługi identyfikacji rachunków bankowych po ID, można także po nr rachunku
     ## Version 0.7.1.1 z dn. 17.04.2025
     - Poprawiono odczyt cech i obsługę wartości null; cechy tekstowe konwertowane bezpiecznie do string.
     ## Version 0.7.1.0 z dn. 20.02.2025
     - Dodanie metody zwracajacej mapowania serwisow na dynamiczne kontrolery
     ## Version 0.7.0.8 z dn. 12.02.2025
     - Przywrocenie metody GetPackableContractors
     ## Version 0.7.0.7
     - Nowa wersja dokumentacji oraz jej aktualizacja
     - Dodanie obsługi dynamicznych domen WebAPI.
     - Przetłumaczenie nazw opisu metod na j. angielski
     - Rekompilacja z wersją 2410.0.0 net8
     ## Version 0.6.9.0-n2.0-Beta
     - Dodanie obsługi tłumaczeń kontraktów na j. angielski
     ## Version 0.6.8.3-n2.0
     - Dodanie metody do zastępowania kontrahenta (blokowania jednego kontrahenta i przepisanie płatności na głównego)
     - Dodanie metody do tworzenia powiązań pomiędzy kontrahentami
     - Dodanie obsługi odczytu powiązań kontrahentów - parametr Powiazania
     ## Version 0.6.7.3-n2.0-Beta
     - Poprawa obsługi ustawienia priorytetu rachunku bankowego do wynagrodzenia
     ## Version 0.6.7.2-n2.0-Beta
     - Obsługa odczytu cech algorytmicznych z parametrem GetArgs
     ## Version 0.6.6.3-n2.0-Beta
     - Obsługa NazwyFirmy dla adresu korespondencyjnego na pracowniku
     ## Version 0.6.6.1-n2.0-Beta
     - Dodanie możliwości odczytu i zapisu AdresuDoKorespondencji na pracowniku.
     - Dodanie pola Aktualizuj na kontrakcie PracownikDTO. Aktualizacja historii nastąpi tylko po świadomym ustawieniu pola na true.
     ## Version 0.6.5.0-n2.0
     - Dodanie metody do pobierania skróconego kontraktu pracownika GetPackableBasicEmployees
     - Poprawa weryfikacji daty licencji modułów dodatkowych
     ## Version 0.6.4.2-n2.0-Beta
     - Obsługa generowania dokumentacji w formacie Postman dla typów byte[]
     ## Version 0.6.4.1-n2.0-Beta
     - Dodanie obsługi adresów URL do dla dokumentacji typu Postman
     - Dodanie obsługi kodu kraju przy odczycie/zapisie obywatelstwa na kontrakcie PracownikDTO
     ## Version 0.6.3.8-n2.0-Beta
     - Dodanie obsługi odczytu załączników w klasie RowDTO
     ## Version 0.6.3.7-n2.0-Beta
     - Poprawa przypisania kodu pocztowego dla zagranicznych kontrahentów
     ## Version 0.6.3.6-n2.0-Beta
     - Udostępnienie w klasie Result kolekcji ostrzeżeń. Ostrzeżenia będą oprogramowywane sukcesywnie dla poszczególnych metod.
     ## Version 0.6.3.5-n2.0-Beta
     - Udostępnienie wirtualnej metody ModifySave dla obiektu PracownikDTO dającej możliwość rozszerzenia kontraktu
     ## Version 0.6.2.0-n2.0-Beta
     - Zapis oraz rozbudowa kontraktu Zatrudnienie o pola Wymiar i Zwolniony
     - Umożliwienie zapisu i odczytu cech historycznych
     ## Version 0.6.0.3-n2.0
     - Zdjęcie wymagalności pola Base64 na obiekcie AttachmentDTO. Obsłużony null lub pusty string w kodzie.
     - Rozszerzenie obiektu KontrahentDTO o odczyt obiektu KontaktDTO z polami (EMAIL, WWW, Skype, SkrytkaPocztowa, TelefonKomorkowy)
     ## Version 0.6.0.2-n2.0
     - Poprawa obsługi odczytu cech dla obiektu pracownika przy pobieraniu danych w paczkach
     - Przygotowanie do netstandard2.0
     - Zmiana nazwy pakietu AltOne.WebApi.Core (wcześniejsza AltOne.WCF.Core). Nazwa biblioteki pozostaje bez zmian.
     - Dodano nową metodę do zapisu załączników dla danego obiektu