Faktuj
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.
Quick Start
git clone https://github.com/softvoyagers/fakturka-api.git
cd fakturka-api
npm install
npm run dev
# Open http://localhost:8080
API Reference
Base URL
https://faktuj.pl/api/v1
Endpoints
| 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 |
Example Request
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.pdf
Response
Returns a PDF file (application/pdf) with the generated Polish VAT invoice.
Development
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 check
Docker
docker compose up --build
# Or:
docker build -t faktuj-api .
docker run -p 8080:8080 faktuj-api
Tech Stack
| 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) |
Portfolio
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
License
MIT