SSD Nodes Learn Hosting plans →
Przewodniki Matt ConnorAutor: Matt Connor

Samodzielne oprogramowanie do faktur: porównanie systemów

Porównanie Invoice Ninja, InvoiceShelf, InvoicePlane, Kimai oraz ERPNext. Analiza funkcji rozliczeniowych, obsługi bramek płatności oraz ryzyk związanych z własną infrastrukturą VPS.

Jakie oprogramowanie do fakturowania wybrać do hostowania we własnym zakresie?

Oprogramowanie do fakturowania hostowane samodzielnie sprowadza się do pięciu realistycznych wyborów na jednym VPS, a nie są to bliskie zamienniki. Invoice Ninja to najbardziej dopracowany produkt: faktury cykliczne, portal klienta, bramki płatności i formaty e-faktur działają od dnia instalacji. InvoiceShelf to lżejsza opcja w pełni otwartoźródłowa. InvoicePlane to prosta aplikacja PHP niewymagająca orkiestracji. Kimai rozlicza śledzone godziny zamiast pozycji na fakturze. ERPNext to pełny system księgowy, który również generuje faktury.

Dwa problemy niweczą samodzielnie hostowaną konfigurację fakturowania znacznie częściej niż brakująca funkcja. Pierwszym jest poczta elektroniczna. Faktura znajdująca się w folderze spamu to faktura nieopłacona, a nic nie informuje o tym fakcie. Drugim są kopie zapasowe. Jest to jedyna samodzielnie hostowana baza danych, której utrata staje się problemem podatkowym, a nie tylko niedogodnością.

Przed zapoznaniem się z listą funkcji należy przeczytać licencję. Trzy z tych pięciu programów są objęte licencją copyleft, jeden ma licencję permisywną, a jeden jest dostępny w modelu source-available z realnymi ograniczeniami dotyczącymi zakresu użytkowania.

Pięć opcji i ich przeznaczenie

Invoice Ninja

Aplikacja oparta na frameworku Laravel, obecnie w linii v5. Samodzielny hosting jest darmowy i nie posiada ograniczeń: obsługuje faktury cykliczne, wyceny, projekty, śledzenie czasu pracy, wydatki, portal klienta oraz bramki płatności, w tym Stripe i PayPal. Projekt określa się jako „aplikację typu source-available do fakturowania, wycen, zarządzania projektami i śledzenia czasu pracy, zbudowaną w Laravel”. Użytkownicy hostujący aplikację samodzielnie płacą za dwie rzeczy. Pierwszą jest branding. Zgodnie z opisem projektu: „Oferujemy licencję white-label w cenie 40 USD rocznie, aby usunąć branding Invoice Ninja z elementów aplikacji widocznych dla klienta”. Cena ta jest aktualna na październik 2026. Drugą jest wysyłanie i odbieranie e-faktur w sieci Peppol, co odbywa się za pośrednictwem platformy Invoice Ninja i zostało omówione poniżej w sekcji dotyczącej wymagań księgowych.

Wybierz to rozwiązanie, jeśli oczekujesz najbardziej kompletnego produktu i akceptujesz utrzymywanie rozbudowanego stosu technologicznego.

InvoiceShelf

Fork aplikacji Crater, udostępniony na licencji GNU Affero General Public License version 3 (AGPL-3.0). Obsługuje faktury, kosztorysy, cykliczne rozliczenia, wydatki, podatki, wielowalutowość, portal klienta oraz obsługę wielu firm. Płatności i funkcje white-label znajdują się w oddzielnych oficjalnych repozytoriach modułów, oba na licencji AGPL-3.0 i oba darmowe. Płatności kartą realizowane są przez Stripe checkout. Do zastosowań produkcyjnych należy używać wspieranego wydania 2.x: domyślna gałąź 3.x to wersja alfa, a istniejący moduł płatności z nią nie współpracuje.

Wybierz to rozwiązanie, jeśli potrzebujesz niewielkiej, w pełni otwartoźródłowej aplikacji i nie wymagasz obsługi trzydziestu różnych bramek płatności.

InvoicePlane

Aplikacja PHP oparta na CodeIgniter, wydana na licencji MIT, którą instaluje się poprzez rozpakowanie plików w głównym katalogu serwera WWW. Archiwum wydania nie wymaga budowania kroków w Docker ani Node. Pliki PDF generowane są przez mPDF, więc szablony oparte są na HTML i CSS. Klienci otrzymują link gościa do przeglądania i opłacenia faktury.

Płatności stanowiły wcześniej problem. Wersja InvoicePlane 1.6.0 zawierała Stripe jako jedyną aktywną bramkę, a pozostali dostawcy byli wyłączeni. PayPal powrócił w linii 1.6: wydanie 1.6.4 z 19 stycznia 2026 dodało obsługę PayPal Advanced Credit Cards oraz Venmo, a wydania 1.6.5, 1.7.1 i 1.7.2 zawierają aktywne Stripe i PayPal, podczas gdy pozostałe sterowniki pozostają wyłączone. Instrukcja instalacji dołączona do wydania 1.7.2, aktualnej wersji z 28 sierpnia 2026, wymaga PHP 8.2 lub nowszego (wspierane są również 8.3 i 8.4) oraz MariaDB, podczas gdy strona wymagań w wiki projektu nadal wskazuje starszy zakres PHP 8.0 do 8.1. Należy zapoznać się z notatkami do konkretnego pobieranego wydania.

Wybierz to rozwiązanie, jeśli korzystasz ze współdzielonego hostingu lub VPS z 512 MB pamięci RAM.

Kimai

Narzędzie do śledzenia czasu pracy na licencji AGPL-3.0, które generuje faktury na podstawie kart czasu pracy. Jest to właściwy wybór dla każdego, kto rozlicza się godzinowo. Szablony faktur przesyła się jako pliki DOCX, ODS lub XLSX, które – jak potwierdza dokumentacja – są jedynymi akceptowanymi formatami, a następnie renderuje do PDF lub HTML. Układ faktury projektuje się w edytorze tekstu zamiast pisać kod CSS, co dla większości użytkowników jest łatwiejsze.

Kimai nie posiada wbudowanej bramki płatności, a w jego sklepie nie ma dostępnych wtyczek płatniczych, więc faktury PDF wysyła się e-mailem. Darmowa wtyczka zewnętrzna o nazwie Customer Portal udostępnia statystyki klientów i projektów oraz karty czasu pracy za pośrednictwem tajnego adresu URL (opcjonalnie chronionego hasłem), jednak wyświetla ona karty czasu pracy, a nie faktury. Ustrukturyzowane e-fakturowanie jest płatną wtyczką sklepową o nazwie E-Invoice Plus, wycenioną na 99 EUR netto rocznie według stanu na październik 2026. Obsługuje ona profile EN16931, Extended oraz XRechnung 3.0 w formatach CII lub UBL, Peppol UBL w wersji beta, a także hybrydowe pliki PDF ZUGFeRD i Factur-X.

Wybierz to rozwiązanie, jeśli faktura jest wynikiem rozliczenia śledzonego czasu pracy.

ERPNext

Oprogramowanie na licencji GPL-3.0, należące do innej kategorii. Faktura sprzedaży jest jednym z typów dokumentów w pełnym systemie księgowym, obejmującym plan kont, zapisy w dzienniku, stany magazynowe i płace. Jest to właściwy wybór, gdy fakturowanie przestaje być jedynym zadaniem. Dla jednego freelancera z ośmioma klientami jest to oprogramowanie zbyt rozbudowane. Uruchomienie systemu stanowi osobny projekt, opisany w uruchamianiu ERPNext na VPS.

Fakturowanie cykliczne zależy od niewidocznego harmonogramu

Invoice Ninja, InvoiceShelf, InvoicePlane oraz ERPNext generują faktury cykliczne. Kimai nie posiada wbudowanej funkcji faktur cyklicznych, ponieważ faktura jest tam tworzona na podstawie wpisów w karcie czasu pracy za dany okres.

Tryb awarii jest identyczny w każdej aplikacji opartej na Laravel i przebiega w sposób cichy. Faktury cykliczne tworzy harmonogram Laravel, który musi być wyzwalany co minutę, albo przez cron wywołujący php artisan schedule:run, albo przez długo działający proces php artisan schedule:work. Jeśli nic go nie wyzwala, lista faktur cyklicznych nadal wyświetla datę następnej wysyłki, która po prostu mija. Faktura nie powstaje. Żaden błąd nie jest rejestrowany, ponieważ kod nie został wykonany.

Dlatego po utworzeniu pierwszej faktury cyklicznej należy ustawić datę następnej wysyłki na kilka minut do przodu i poczekać. Jeśli faktura nie dotrze, harmonogram nie działa. W instalacji Docker zazwyczaj oznacza to, że usługa lub proces harmonogramu nie uruchomiły się lub zostały zakończone. W obecnych obrazach Invoice Ninja i InvoiceShelf harmonogram działa wewnątrz kontenera aplikacji, a nie jako osobna usługa, więc należy czytać logi tego właśnie kontenera.

docker compose ps
docker compose logs --tail 50

Każda usługa w pliku powinna zgłaszać stan running. Usługa znajdująca się w stanie exited to ta, której logi należy sprawdzić.

Wielowalutowość i podatki: co sprawdzić przed wdrożeniem

Listy funkcji często zawierają hasło „wielowalutowość”, jednak znaczenie tego terminu bywa różne. Należy przeprowadzić poniższe cztery testy na instancji demonstracyjnej, używając rzeczywistych danych z własnej działalności. Błędy w tym obszarze zostaną wykryte przez księgowość, a nie przez administratora.

  1. Czy faktura przechowuje kurs wymiany walut obowiązujący w dniu jej wystawienia? Jest to wymóg konieczny. Jeśli aplikacja przelicza sumy według bieżącego kursu, raporty z poprzedniego kwartału będą zmieniać się przy każdym otwarciu, a księgi przestaną być zgodne z już złożonymi deklaracjami.
  2. Czy podatek jest naliczany dla każdej pozycji z osobna, dla całej faktury, czy w obu wariantach? Jedna stawka dla całej faktury jest wystarczająca do momentu, w którym jedna z pozycji otrzymuje stawkę 0%.
  3. Czy istnieje możliwość wprowadzania cen brutto oraz netto? Przeliczanie po fakcie wprowadza różnice zaokrągleń rzędu jednego centa na pozycji, a takie kwoty sumują się w skali roku.
  4. Co dokument pokazuje w przypadku klienta z innego kraju, który jest zwolniony z VAT? Na fakturze musi znaleźć się adnotacja o zwolnieniu, a nie tylko zero w kolumnie podatku.

Invoice Ninja oraz ERPNext obsługują wszystkie cztery punkty. InvoiceShelf wymienia podatki i wielowalutowość wśród swoich funkcji. InvoicePlane oraz Kimai są prostszymi rozwiązaniami, dlatego należy przetestować je na najbardziej złożonej fakturze, a nie na najprostszym przypadku.

Portal klienta i bramki płatności

Portal klienta to strona, na której klient przegląda faktury, pobiera pliki PDF i dokonuje płatności. Jest to istotniejsze, niż mogłoby się wydawać, ponieważ upominanie się o płatność drogą mailową pochłania więcej czasu niż wystawienie samej faktury.

Invoice Ninja oferuje w tym zakresie najwięcej, udostępniając pełny portal, obsługę wielu bramek płatności, zapisywanie metod płatności oraz automatyczne fakturowanie dla faktur cyklicznych. InvoiceShelf posiada portal klienta i dodaje obsługę Stripe checkout poprzez moduł płatności. InvoicePlane udostępnia dla każdej faktury link gościnny i wspiera Stripe oraz PayPal (obsługa PayPal powróciła w wersji 1.6.4). Kimai nie posiada bramki płatności, a darmowa wtyczka Customer Portal służy do udostępniania kart czasu pracy i statystyk, a nie faktur, dlatego plik PDF jest wysyłany jako załącznik.

Jedna kwestia jest często mylnie interpretowana. Samodzielne hostowanie aplikacji do fakturowania nie oznacza przechowywania numerów kart płatniczych. W przypadku Stripe checkout klient jest przekierowywany do serwisu Stripe, tam wprowadza dane karty, a Twój VPS nigdy nie uzyskuje dostępu do tego numeru. Zakres zgodności PCI (payment card industry) pozostaje ograniczony właśnie dlatego, że formularz płatności nie został zbudowany przez Ciebie. Jeśli w przyszłości zaistnieje potrzeba korzystania z więcej niż jednego procesora płatności lub kierowania płatności w zależności od kraju, należy to zrealizować w osobnej warstwie, takiej jak self-hosted payment orchestration with Hyperswitch.

Jakość PDF i szablon, który zostanie poddany edycji

Szablon wymaga edycji. Domyślne ustawienia umieszczają adres w miejscu nieodpowiednim dla danego kraju.

Invoice Ninja renderuje szablony HTML i CSS do formatu PDF przy użyciu bezgłowego (headless) silnika Chrome dołączonego do obrazu (Chromium na architekturze arm64), co powoduje duży rozmiar kontenera. Należy zapewnić odpowiednią ilość pamięci: przeglądarka w trybie bezgłowym jest najbardziej zasobożernym procesem w stosie, dlatego serwer VPS o pojemności 1 GB może być niewystarczający. InvoicePlane korzysta z mPDF, który jest rozwiązaniem opartym w całości na PHP i lekkim, jednak kosztem ignorowania niektórych nowoczesnych właściwości CSS. Kimai przyjmuje odmienne podejście, wymagając przesłania pliku DOCX lub ODS, dzięki czemu układ dokumentu jest przygotowywany w LibreOffice lub Word przez osobę, która nie musi znać arkuszy stylów.

Jeśli priorytetem jest wygląd faktury, a nie znajomość CSS, podejście Kimai jest korzystniejsze. Jeśli szablon ma podlegać kontroli wersji i być czytelny w porównaniach (diff), lepszym wyborem jest HTML.

Czy licencja pozwala na komercyjne wykorzystanie oprogramowania?

Wszystkie pięć rozwiązań pozwala na wystawianie faktur własnym klientom. Różnice pojawiają się w przypadku działań wykraczających poza ten zakres.

Invoice Ninja podlega licencji Elastic License 2.0. Istotne są dwa zapisy.

Nie wolno udostępniać oprogramowania podmiotom trzecim jako usługi hostowanej lub zarządzanej, jeśli usługa zapewnia użytkownikom dostęp do znacznego zestawu funkcji lub funkcjonalności oprogramowania.
Nie wolno usuwać, zmieniać, wyłączać ani obchodzić funkcjonalności klucza licencyjnego w oprogramowaniu.

Zatem korzystanie z niego na potrzeby własnej działalności jest dozwolone, natomiast uruchamianie instancji dla klientów jako produktu – nie. Drugi zapis wyjaśnia, dlaczego usunięcie brandingu wymaga zakupu licencji za 40 USD, a nie modyfikacji kodu źródłowego.

InvoiceShelf, Kimai oraz Crater korzystają z licencji AGPL-3.0. Komercyjne wykorzystanie jest bezpłatne w przypadku wszystkich trzech. Sklep Kimai oferuje płatne wtyczki dla funkcji niedostępnych w darmowej instalacji, takich jak E-Invoice Plus, pola własne czy zarządzanie wydatkami, w cenie 99 EUR za każdą rocznie. Subskrypcje wtyczek obejmują wieczystą licencję awaryjną: zakupione wersje działają po anulowaniu subskrypcji, jednak aktualizacje wymagają aktywnego abonamentu. Zobowiązanie licencyjne wynika z sekcji 13: w przypadku modyfikacji kodu i udostępnienia zmodyfikowanej wersji innym osobom przez sieć, należy udostępnić im kod źródłowy wprowadzonych zmian. Niezmodyfikowana instancja jest już objęta publicznym kodem źródłowym dostawcy, więc większość użytkowników hostujących oprogramowanie samodzielnie nie musi podejmować żadnych działań.

InvoicePlane korzysta z licencji MIT, która nakłada najmniejsze zobowiązania w tej grupie, choć plik README zaznacza, że nazwa i logo pozostają własnością projektu.

ERPNext korzysta z licencji GPL-3.0. Modyfikacje, które są dystrybuowane, muszą zostać udostępnione, natomiast prywatne korzystanie z oprogramowania nie wiąże się z żadnymi zobowiązaniami.

Powyższy opis dotyczy treści licencji i nie stanowi porady prawnej.

Czy projekt jest nadal utrzymywany? Sprawdź dziennik commitów

Crater był przez kilka lat popularną aplikacją open source do fakturowania i wiele poradników nadal go poleca. Według stanu na 10 października 2026, w jego domyślnej gałęzi nie odnotowano żadnego commita od 1329 dni, licząc od 19 lutego 2023.

WykresGap since the last commit on the default branch, in days, checked 10 October 2026
Dane, na których opiera się ten wykres
[
  {
    "label": "ERPNext",
    "commit_gap": 0
  },
  {
    "label": "InvoicePlane",
    "commit_gap": 0
  },
  {
    "label": "Kimai",
    "commit_gap": 4
  },
  {
    "label": "InvoiceShelf",
    "commit_gap": 11
  },
  {
    "label": "Invoice Ninja",
    "commit_gap": 22
  },
  {
    "label": "Crater",
    "commit_gap": 1329
  }
]

Spośród 6 projektów w tym bloku, pięć posiadało commit w ciągu czterech tygodni przed tą weryfikacją, a trzy w ciągu tygodnia przed nią. InvoiceShelf to fork, który kontynuuje prace nad Craterem, na tej samej licencji AGPL-3.0 i z tym samym modelem danych, więc przejście na niego jest migracją danych, a nie przepisywaniem systemu. Zainstaluj InvoiceShelf, nie Crater.

Instalacja poszczególnych usług na VPS

Wszystkie wymienione aplikacje, z wyjątkiem InvoicePlane, najłatwiej uruchomić za pomocą Docker Compose. Jeśli to rozwiązanie jest nowe, należy zacząć od pierwszego stosu Docker Compose na VPS i wrócić do tego miejsca.

Invoice Ninja udostępnia własne repozytorium compose. Aktualne instrukcje korzystają z gałęzi debian, a plik compose znajduje się w podkatalogu o tej samej nazwie.

git clone https://github.com/invoiceninja/dockerfiles.git -b debian
cd dockerfiles/debian
docker run --rm -it invoiceninja/invoiceninja-debian php artisan key:generate --show

Skopiuj całą zawartość wyjściową do APP_KEY w pliku .env w tym katalogu, wraz z rzeczywistymi danymi APP_URL. Ustaw również IN_USER_EMAIL oraz IN_PASSWORD dla pierwszego konta, ponieważ pozostawienie ich pustych spowoduje, że domyślnym loginem będzie admin@example.com z hasłem changeme!. Następnie uruchom usługę.

docker compose up -d

Dołączona usługa nginx publikuje port 80 na hoście, dlatego należy umieścić przed nią proxy TLS lub zmienić to mapowanie. W kreatorze konfiguracji jako hosta bazy danych należy podać mysql, ponieważ jest to nazwa usługi w sieci compose. Wartość localhost wskazuje w tym kontekście na sam kontener aplikacji.

InvoiceShelf udostępnia gotowe pliki compose, po jednym dla każdego silnika bazy danych.

curl -fLO https://raw.githubusercontent.com/InvoiceShelf/docker/master/docker-compose.mysql.yml
mv docker-compose.mysql.yml docker-compose.yml

Otwórz ten plik przed uruchomieniem. Każde hasło wewnątrz jest jedynie symbolem zastępczym, o czym informują komentarze w pliku. Wartości APP_URL, SESSION_DOMAIN oraz SANCTUM_STATEFUL_DOMAINS są domyślnie ustawione na localhost i wszystkie trzy wymagają podania rzeczywistej nazwy hosta przed pierwszym logowaniem. Następnie uruchom usługę.

docker compose up -d

Usługa publikuje port 8090 na hoście i obsługuje port 8080 wewnątrz kontenera. Przed skierowaniem do niej jakiegokolwiek ruchu klienckiego należy umieścić przed nią reverse proxy z obsługą TLS (transport layer security).

Plik produkcyjny compose dla Kimai, na podstawie dokumentacji projektu
services:

  sqldb:
    image: mysql:8.3
    volumes:
      - mysql:/var/lib/mysql
    environment:
      - MYSQL_DATABASE=kimai
      - MYSQL_USER=kimaiuser
      - MYSQL_PASSWORD=kimaipassword
      - MYSQL_ROOT_PASSWORD=changemeplease
    command: --default-storage-engine innodb
    restart: unless-stopped
    healthcheck:
      test: mysqladmin -uroot -p$$MYSQL_ROOT_PASSWORD ping -h 127.0.0.1 --silent
      interval: 10s
      timeout: 5s
      retries: 12
      start_period: 30s

  kimai:
    image: kimai/kimai2:stable
    depends_on:
      sqldb:
        condition: service_healthy
        restart: true
    volumes:
      - data:/opt/kimai/var/data
      - plugins:/opt/kimai/var/plugins
    ports:
      - 8001:8001
    environment:
      - APP_SECRET=your-fantastic-long-random-and-ultra-secure-secret
      - TRUSTED_HOSTS=kimai.example.com
      - ADMINMAIL=admin@example.com
      - ADMINPASS=changemeplease
      - DATABASE_URL=mysql://kimaiuser:kimaipassword@sqldb/kimai?charset=utf8mb4&serverVersion=8.3.0
    restart: unless-stopped

volumes:
  data:
  mysql:
  plugins:

Ustaw APP_SECRET na długi, losowy ciąg znaków, a TRUSTED_HOSTS na domenę, która będzie faktycznie używana. Wartości ADMINMAIL oraz ADMINPASS tworzą pierwszego administratora przy pierwszym uruchomieniu, dlatego po zalogowaniu należy zmienić hasło w interfejsie i usunąć je z pliku.

InvoicePlane zawiera konfiguracje Docker przeznaczone do prac rozwojowych i testów. W przypadku instalacji archiwalnej należy najpierw utworzyć pustą bazę danych.

sudo mysql -e "CREATE DATABASE invoiceplane CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"

Pobierz archiwum ze strony wydań projektu, rozpakuj je w głównym katalogu serwera WWW, skopiuj ipconfig.php.example do ipconfig.php i ustaw adres URL wewnątrz pliku, postępując zgodnie z zawartymi w nim komentarzami. Następnie otwórz https://your-domain.example/index.php/setup i przeprowadź proces instalacji.

Dlaczego faktura trafia do folderu spam

To błąd, który kosztuje pieniądze, a aplikacja raportuje fakturę jako wysłaną.

Nie wysyłaj poczty z fakturami z adresu IP serwera VPS. Nowy adres IP VPS nie ma historii wysyłki, a duzi odbiorcy domyślnie traktują pierwszą wiadomość z nieznanego adresu w zakresie hostingowym jako podejrzaną. Wysyłaj pocztę przez przekaźnik SMTP (simple mail transfer protocol) w domenie, którą uwierzytelniłeś. Kompleksowe wykonanie tego zadania to osobne zagadnienie, a niezawodne wysyłanie poczty z aplikacji hostowanej samodzielnie opisuje przekaźnik, rekordy DNS oraz testowanie.

Adres From to element, w którym większość konfiguracji fakturowania zawodzi. Musi on pochodzić z domeny, która autoryzuje Twój przekaźnik, a najprostszym sposobem na zagwarantowanie tego jest użycie domeny, którą kontrolujesz i którą Twój przekaźnik podpisuje za pomocą DKIM (domainkeys identified mail). Umieszczanie adresu klienta w polu From wydaje się uprzejme, ale zazwyczaj uniemożliwia dostarczenie wiadomości. Wytyczne Google dla nadawców mówią, że wiadomość przechodzi DMARC tylko wtedy, gdy SPF lub DKIM są poprawne, a domena uwierzytelniająca jest zgodna z domeną w nagłówku From. Twój przekaźnik uwierzytelnia Twoją domenę, a nie domenę klienta. Można to naprawić tylko po stronie klienta: musiałby on dodać Twój przekaźnik do swojego rekordu SPF lub skonfigurować dla niego podpisywanie DKIM dla swojej domeny, czego Google wymaga od każdego korzystającego z dostawcy poczty: „Jeśli korzystasz z dostawcy usług e-mail, zweryfikuj, czy uwierzytelnia on pocztę Twojej domeny za pomocą SPF i DKIM”. Jeśli klient tego nie zrobił, wiadomość nie przechodzi weryfikacji DMARC, a Gmail informuje, że nieuwierzytelnione wiadomości „mogą zostać oznaczone jako spam lub odrzucone z błędem 5.7.26”. Odrzucenie tego typu wygląda następująco:

550 5.7.26 Unauthenticated email from example.com is not accepted due to domain's DMARC policy

Utrzymuj własny adres w polu From, a klienta umieszczaj w Reply-To. Sprawdź opublikowane rekordy przed wysłaniem czegokolwiek rzeczywistego.

dig +short TXT example.com
dig +short TXT _dmarc.example.com
dig +short TXT selector1._domainkey.example.com

Pierwsze polecenie powinno zwrócić rekord SPF (sender policy framework) wskazujący na Twój przekaźnik. Drugie powinno zwrócić politykę DMARC (domain-based message authentication, reporting and conformance). Trzecie zależy od selektora dostarczonego przez przekaźnik, a pusta odpowiedź oznacza, że rekord DKIM nie istnieje lub został opublikowany pod błędną nazwą, przez co każda wysłana wiadomość nie przejdzie weryfikacji podpisu.

Następnie wyślij rzeczywistą fakturę na konto, które posiadasz u dużego dostawcy, i odczytaj surowe nagłówki. dkim=pass oraz spf=pass w nagłówku Authentication-Results to jedyny dowód, który ma znaczenie. Własna flaga „wysłano” w aplikacji oznacza jedynie, że przekazała ona wiadomość do przekaźnika.

Kopie zapasowe: baza danych, której nie można utracić

Utrata serwera multimediów oznacza konieczność ponownego pobrania plików. Nawet samodzielnie hostowany serwer zdjęć, taki jak PhotoPrism lub Immich, zazwyczaj przechowuje drugą kopię oryginałów, które nadal znajdują się w telefonie, którym zostały wykonane. Utrata bazy danych faktur oznacza brak możliwości wykazania, co zostało zafakturowane, za co otrzymano płatność oraz co nadal pozostaje do zapłaty. Należy traktować to odpowiednio poważnie.

Należy tworzyć kopie zapasowe czterech elementów. Bazy danych. Wolumenu pamięci masowej, który przechowuje logotypy, wygenerowane pliki PDF oraz rachunki za wydatki. Pliku środowiskowego aplikacji. Oraz wygenerowanych plików PDF przechowywanych jako zwykłe pliki, ponieważ plik PDF otworzy się za dziesięć lat nawet bez aplikacji, która go utworzyła.

Plik środowiskowy ma większe znaczenie, niż się powszechnie uważa. Laravel szyfruje wrażliwe przechowywane wartości, w tym dane uwierzytelniające bramki płatności, używając APP_KEY z tego pliku. Przywrócenie bazy danych obok świeżo wygenerowanego klucza sprawi, że wartości te nie zostaną odszyfrowane. Faktury będą obecne, ale ustawienia bramki staną się nieczytelne.

Zrzut ze stosu InvoiceShelf wygląda następująco. Jego usługa bazy danych uruchamia mariadb:10, więc narzędziem wewnątrz kontenera jest mariadb-dump.

docker compose exec -T database mariadb-dump \
  --user=root --password=YOUR_ROOT_PASSWORD \
  --single-transaction --databases invoiceshelf > invoiceshelf.sql

--single-transaction wykonuje spójną migawkę tabel InnoDB bez ich blokowania, dzięki czemu aplikacja może nadal obsługiwać żądania podczas trwania zrzutu. -T zapobiega przydzielaniu terminala przez Docker, co w przeciwnym razie uszkodziłoby przekierowane wyjście i doprowadziło do powstania pliku zrzutu, którego nie da się zaimportować.

Należy wysyłać kopie poza serwer zgodnie z harmonogramem, korzystając z szyfrowanych kopii zapasowych restic do pamięci zewnętrznej, oraz ustawić retencję na okres wystarczająco długi, aby pokryć czas wymagany przez księgowość.

Następnie należy przetestować przywracanie. Należy wczytać zrzut w tymczasowym kontenerze, zalogować się i otworzyć fakturę z zeszłego miesiąca. Dopóki nie zostanie to wykonane przynajmniej raz, nie można mieć pewności, czy kopia zapasowa działa poprawnie.

O co zapyta księgowy

Nie należy traktować tego poradnika jako porady podatkowej. Poniżej przedstawiono zestawienie danych, które może wygenerować oprogramowanie, aby można było je przekazać doradcy.

Dane do eksportu. Użytkownik powinien mieć możliwość eksportu faktur i płatności do formatu CSV bezpośrednio z interfejsu, bez użycia klienta bazy danych i bez zgłaszania ticketów do wsparcia. Zrzut SQL to kopia zapasowa, a nie eksport, ponieważ księgowy nie będzie w stanie go otworzyć.

Niezmienność numeracji. Numery faktur powinny być nadawane sekwencyjnie, bez luk i nigdy nie mogą być użyte ponownie. Usunięcie faktury tworzy lukę, którą trzeba wyjaśnić. Zamiast tego należy stosować anulowanie lub korekty, co wspiera każda z omawianych aplikacji. To, czy wymagana jest ciągłość numeracji, zależy od miejsca rejestracji działalności; warto zapytać o to odpowiednio wcześnie.

Przechowywanie danych. Zrzuty baz danych oraz wygenerowane pliki PDF należy przechowywać tak długo, jak wymagają tego przepisy. Plik PDF to dokument, który faktycznie został wysłany i stanowi dowód w przypadku sporu dotyczącego faktury.

Historia zmian. Możliwość sprawdzenia, kto i kiedy edytował fakturę, jest przydatna i różni się w zależności od aplikacji. Invoice Ninja prowadzi dziennik aktywności dla każdego rekordu.

Ustrukturyzowane e-fakturowanie stało się w części krajów UE realnym wymogiem, a nie tylko dodatkową funkcjonalnością. Invoice Ninja generuje popularne formaty, w tym ZUGFeRD, XRechnung, Facturae, FatturaPA oraz standardowe EN16931, choć dokumentacja wskazuje, że FatturaPA nie jest gotowe do użytku produkcyjnego, ponieważ połączenie z włoskim systemem SDI nie jest aktywne. Dostarczanie faktur przez sieć Peppol z instancji self-hosted odbywa się za pośrednictwem platformy chmurowej Invoice Ninja. Zgodnie z dokumentacją dostawcy, należy zarejestrować podmiot w Invoice Ninja, co generuje identyfikator podmiotu prawnego, a instancja przekazuje e-faktury przez usługę dostawcy. E-faktury przychodzące są pobierane przez zadanie cron, które odpytuje serwery co 4 godziny. Strona dotycząca e-fakturowania w Invoice Ninja oferuje dostęp do Peppol w ramach planu Enterprise, którego koszt zaczyna się od 18 USD miesięcznie i obejmuje 250 kredytów Peppol (jeden kredyt na jedną wysłaną e-fakturę). Dodatkowe pakiety kosztują 50 USD za 500 kredytów lub 100 USD za 1000 kredytów i są ważne przez rok. W instalacjach self-hosted nie ma darmowych kredytów; należy zakupić te same pakiety (stan na 15 listopada 2026). Płatna wtyczka E-Invoice Plus dla Kimai obsługuje EN16931, XRechnung, ZUGFeRD, Factur-X oraz Peppol w wersji beta, ale nie obsługuje Facturae ani FatturaPA. InvoicePlane posiada mechanizm obsługi e-faktur, ale nie dostarcza żadnego formatu w wersji podstawowej: należy dodać szablony z repozytorium projektu InvoicePlane-e-invoices, które zawiera przykłady dla ZUGFeRD, Factur-X oraz UBL. ERPNext obsługuje XRechnung, ZUGFeRD i Factur-X (tylko w formacie CII, bez UBL i Peppol) za pomocą darmowej aplikacji eu_einvoice na licencji GPL-3.0 autorstwa ALYF. InvoiceShelf oferuje teraz hybrydowe pliki PDF EN16931 ZUGFeRD / Factur-X poprzez darmowy, oficjalny moduł E-Invoicing dla wersji 3.x alpha preview; projekt nadal zaleca użytkownikom produkcyjnym korzystanie z wersji 2.x. Invoice Ninja jest jedynym rozwiązaniem z wbudowaną pełną obsługą tych standardów, co stanowi najsilniejszy argument za jego wyborem w przypadku wystawiania faktur na terenie UE.

FAQ

Czy powinienem zainstalować Crater czy InvoiceShelf?

InvoiceShelf. Domyślna gałąź projektu Crater nie otrzymała żadnego commita od 1329 dni, licząc na dzień 10 października 2026, a oficjalny przewodnik migracji InvoiceShelf określa go jako "porzucony projekt Crater". InvoiceShelf korzysta z tej samej licencji AGPL-3.0 oraz tego samego modelu danych, więc przejście między nimi sprowadza się do migracji bazy danych, a nie przepisywania systemu. Każdy poradnik zalecający Crater został napisany przed wygaszeniem aktywności w tym projekcie.

Czy mogę używać Invoice Ninja we własnej firmie bez opłat?

Tak. Samodzielnie hostowana wersja Invoice Ninja jest w pełni funkcjonalna i darmowa na licencji Elastic License 2.0, wliczając w to faktury cykliczne, portal klienta oraz bramki płatności. Dwie funkcje są płatne. Usunięcie brandingu Invoice Ninja ze stron widocznych dla klienta wymaga licencji white-label, kosztującej "40 USD rocznie" według informacji projektu na październik 2026. Wysyłanie i odbieranie e-faktur w sieci Peppol odbywa się przez platformę hostowaną Invoice Ninja. Na dzień 15 listopada 2026, instalacje self-hosted muszą dokupić kredyty Peppol, ponieważ nie są one dołączone do oprogramowania: 50 USD za 500 lub 100 USD za 1000 kredytów, ważnych przez rok. Każda wysłana e-faktura zużywa jeden kredyt. Licencja zabrania jedynie oferowania oprogramowania jako usługi hostowanej dla osób trzecich.

Dlaczego moje e-maile z fakturami trafiają do folderu spam?

Prawie zawsze przyczyną jest brak uwierzytelnienia wiadomości dla domeny w adresie From. Należy wysyłać pocztę przez przekaźnik SMTP, zamiast bezpośrednio z serwera VPS, a następnie opublikować rekordy SPF i DMARC dla swojej domeny oraz dodać rekord DKIM zgodnie z selektorem dostarczonym przez przekaźnik. W polu From należy zachować własny adres, a adres klienta umieścić w Reply-To. Ustawienie adresu klienta jako nadawcy powoduje odrzucenie wiadomości przez DMARC, chyba że klient dodał Twój przekaźnik do swojego rekordu SPF lub skonfigurował podpisywanie DKIM dla swojej domeny przez ten przekaźnik. W przeciwnym razie Gmail może oznaczyć wiadomość jako spam lub odrzucić ją z błędem typu 550 5.7.26 Unauthenticated email from example.com is not accepted due to domain's DMARC policy. Poprawność konfiguracji można potwierdzić, odnajdując dkim=pass oraz spf=pass w nagłówku Authentication-Results wiadomości testowej.

Co wybrać, jeśli rozliczam się godzinowo?

Kimai. Jest to przede wszystkim narzędzie do śledzenia czasu pracy, więc faktura generowana jest na podstawie zatwierdzonych wpisów w karcie czasu pracy, a pozycje na fakturze odpowiadają zarejestrowanym zadaniom. Szablony to pliki DOCX, ODS lub XLSX, które projektuje się w edytorze tekstu, co jest łatwiejsze niż edycja CSS. Ceną za to jest brak obsługi płatności online w Kimai. Darmowa wtyczka Customer Portal pozwala udostępniać karty czasu pracy i statystyki projektów przez tajny link, ale nie faktury, więc PDF-y wysyła się e-mailem i oczekuje przelewu. Invoice Ninja również śledzi czas i posiada pełny portal faktur z płatnościami kartą, więc wybierz to rozwiązanie, jeśli płatności online są ważniejsze niż szczegółowość kart czasu pracy.

Co dokładnie muszę archiwizować?

Bazę danych, wolumen przechowywania zawierający logotypy i wygenerowane pliki PDF, plik środowiskowy oraz wyrenderowane pliki PDF przechowywane jako zwykłe pliki. Plik środowiskowy jest tym, o czym najczęściej zapominają użytkownicy: aplikacje Laravel, takie jak Invoice Ninja i InvoiceShelf, szyfrują zapisane dane uwierzytelniające za pomocą APP_KEY, więc baza danych przywrócona z nowo wygenerowanym kluczem sprawi, że ustawienia bramki płatności staną się nieczytelne. Należy jednorazowo przywrócić całość na instancję testową i otworzyć starą fakturę, ponieważ jest to jedyny sposób, aby upewnić się, że kopia zapasowa działa poprawnie.

Czy ten artykuł był przydatny?