Darmowy generator faktur VAT online dla polskich firm. Bez rejestracji, bez oplat.
Free Polish invoice generator API. No API keys. No authentication. No signup. Part of the SoftVoyagers ecosystem.
git clone https://github.com/softvoyagers/fakturka-api.git
cd fakturka-api
npm install
npm run dev
# Open http://localhost:8080https://faktuj.pl/api/v1
| Method | Path | Description |
|---|---|---|
POST |
/api/v1/invoice/generate |
Generate PDF invoice (faktura VAT) |
POST |
/api/v1/invoice/preview |
Preview invoice totals (JSON) |
GET |
/health |
Health check |
curl -X POST "https://faktuj.pl/api/v1/invoice/generate" \
-H "Content-Type: application/json" \
-d '{
"numer": "FV/2026/02/001",
"dataWystawienia": "2026-02-15",
"dataSprzedazy": "2026-02-15",
"terminPlatnosci": "2026-03-01",
"metodaPlatnosci": "przelew",
"miejsceWystawienia": "Warszawa",
"sprzedawca": {
"nazwa": "Kowalski Consulting Sp. z o.o.",
"nip": "5213456789",
"adres": "ul. Marszalkowska 1",
"kodPocztowy": "00-001",
"miasto": "Warszawa",
"numerKonta": "PL 61 1090 1014 0000 0712 1981 2874"
},
"nabywca": {
"nazwa": "Nowak Software S.A.",
"nip": "7891234560",
"adres": "ul. Krakowska 50",
"kodPocztowy": "31-066",
"miasto": "Krakow"
},
"pozycje": [
{
"nazwa": "Usluga programistyczna",
"ilosc": 160,
"jednostka": "godz.",
"cenaNetto": 150,
"stawkaVat": 23
}
]
}' --output faktura.pdfReturns a PDF file (application/pdf) with the generated Polish VAT invoice.
npm install # Install dependencies
npm run dev # Start dev server (nodemon + ts-node)
npm run build # Compile TypeScript
npm run start # Run compiled output
npm test # Run tests with coverage
npm run lint # TypeScript type checkdocker compose up --build
# Or:
docker build -t faktuj-api .
docker run -p 8080:8080 faktuj-api| Layer | Technology |
|---|---|
| Runtime | Node.js 20 (LTS) |
| Language | TypeScript (strict mode) |
| Framework | Express 5 |
| PDF Engine | pdfmake |
| Testing | Jest + Supertest |
| Container | Multi-stage Dockerfile (node:20-alpine) |
| CI/CD | GitHub Actions |
| Hosting | Azure Web App for Containers |
| Frontend | Vanilla HTML/CSS/JS (cyberpunk + light theme, Polish) |
Part of the SoftVoyagers ecosystem:
- LinkMeta - URL metadata extraction API
- PageShot - Screenshot & webpage capture API
- MyAddress - Address autocomplete & geocoding
- PDFSpark - HTML/URL to PDF conversion API
- OGForge - Open Graph image generator API
- LinkShrink - Privacy-first URL shortener API
- Faktuj - Darmowy generator faktur VAT online
MIT
