Interfejs API do komunikacji z innymi serwisami

[mnowak2026]

Propozycja dodania jest interfejsu API, żeby można było utworzyć dokument sprzedaży, faktura lub paragon, a następnie pobranie obrazu faktury w PDF.

[lkosson]

Ciekawy pomysł. Dorzucam do listy.

Z dostępnych na rynku produktów chyba tylko Subiekt i eNova wystawiają sensownej jakości API.

[lkosson]

Dostosowałem program tak, by można było się do niego podpinać z poziomu innych aplikacji i skryptów.

Na ten moment integracja odbywa się przez dodanie referencji do ProFak.dll z poziomu zewnętrznej aplikacji (siłą rzeczy musi być to aplikacja .NETowa). W zależności od tego jakie będzie zainteresowanie i odzew użytkowników, będę decydował w jakim kierunku dalej to pociągnąć.

W ten sposób masz niskopoziomowy dostęp do wszystkich obiektów biznesowych w bazie (faktury, kontrahenci, towary itp) oraz wysokopoziomowy dostęp do operacji biznesowych (np. Faktura.WystawPodobna()). Poniżej kilka przykładowych scenariuszy (wszystkie jako ConsoleApplication z dodaną referencją do ProFaka i pakietem Microsoft.EntityFrameworkCore.Sqlite).

Wystawienie faktury według danych słownikowych

using var api = new ProFak.API(@"e:\Firma\profak.sqlite3");
using var tx = api.Transakcja();
var nabywca = api.Baza.Kontrahenci.First(kh => kh.Nazwa == "ProTech");
var towar = api.Baza.Towary.First(towar => towar.Nazwa == "Zestaw promocyjny");
var usluga = api.Baza.Towary.First(towar => towar.Nazwa == "Usługa kurierska");
var faktura = api.PrzygotujFakture(ProFak.DB.RodzajFaktury.Sprzedaż, nabywca, [(towar, 5), (usluga, 1)]);
tx.Zatwierdz();

Wystawienie faktury opłaconej z góry, razem z rabatem i dodatkowym opisem

using var api = new ProFak.API(@"e:\Firma\profak.sqlite3");
using var tx = api.Transakcja();
var nabywca = api.Baza.Kontrahenci.First(kh => kh.Nazwa == "ProTech");
var towar = api.Baza.Towary.First(towar => towar.Nazwa == "Zestaw promocyjny");
var usluga = api.Baza.Towary.First(towar => towar.Nazwa == "Usługa kurierska");
var faktura = api.PrzygotujFakture(ProFak.DB.RodzajFaktury.Sprzedaż, nabywca, [(towar, 5), (usluga, 1)]);
var pozycjaTowaru = api.Baza.PozycjeFaktur.First(pozycja => pozycja.FakturaId == faktura.Id && pozycja.TowarId == towar.Id);
pozycjaTowaru.RabatProcent = 5;
pozycjaTowaru.PrzeliczCeny(api.Baza);
api.Baza.Zapisz(pozycjaTowaru);
faktura.UwagiPubliczne = "Dziękujemy za zakupy!";
faktura.PrzeliczRazem(api.Baza);
var wplata = new ProFak.DB.Wplata { Data = DateTime.Now, FakturaRef = faktura, Kwota = faktura.PozostaloDoZaplaty, Uwagi = "PayU" };
api.Baza.Zapisz(wplata);
api.Baza.Zapisz(faktura);
tx.Zatwierdz();

Wygenerowanie PDFów dla wszystkich dzisiejszych faktur

using var api = new ProFak.API(@"e:\Firma\profak.sqlite3");
var fvs = api.Baza.Faktury.Where(fv => fv.DataWystawienia >= DateTime.Now.Date).ToList();
var wydruk = new ProFak.Wydruki.Faktura(api.Baza, fvs);
var pdf = wydruk.ZapiszJako("PDF");