Fakturownia iPhone widget to track revenue and unpaid invoices on your home screen
Know what's still outstanding and what's gone overdue before you start chasing, no logging in.
Revenue without opening Fakturownia
The Revenue module fetches your booked invoices for a period you choose -- this month, last 30 days, this year, or the last 12 months -- and surfaces three numbers: total revenue, invoice count, and average invoice value. Proformas and estimates are excluded; only issued invoices count as booked revenue. Choose net or gross basis depending on how you read your numbers. The widget updates on demand, so you always see the current period's total without loading a browser tab.
Outstanding and overdue at a glance
The Receivables module tracks money owed to you. Outstanding covers every open invoice not yet fully paid. Overdue narrows it to invoices past their payment date. Both figures appear in your chosen display currency alongside an overdue count. That count is the signal most founders check first: any value above zero means there are payments to chase, zero means you are clear.
Multi-currency conversion at the accounting date
Fakturownia accounts regularly invoice in EUR, GBP, and USD at the same time, with no single account currency. PulseKit converts every invoice into one display currency you pick, using the NBP exchange rate that Fakturownia recorded on each invoice's accounting date -- the same booked rate already in your records, not today's spot price. If you pick PLN, no external rate lookups are needed at all and widget totals match your ledger exactly. Any other NBP-supported currency uses the same date-matched historical rate, so the consolidated figure reflects what was actually invoiced.
How to connect Fakturownia with Apple
Fakturownia needs two values:
- Account domain. The part before .fakturownia.pl in your address bar. For acme.fakturownia.pl the domain is "acme". A full URL like https://acme.fakturownia.pl also works.
- API token. In Fakturownia, open Ustawienia → Ustawienia konta → Integracja → Kod autoryzacyjny API and copy the code.
PulseKit only reads your invoices to compute revenue and outstanding totals. It never creates, edits, sends, or deletes anything.
Security
How we protect your credentials
Your Fakturownia credentials (each field you typed) are joined on this device and sealed with AES-256-GCM before they ever leave your iPhone. Only your device holds the unwrap secret, stored in the iOS Keychain. The PulseKit backend wraps that already-encrypted payload again with its STORAGE_SECRET and writes the double-envelope blob to Postgres, so the server never sees any field in plaintext at rest. Each fetch request includes a one-time unwrap secret that decrypts the inner envelope only long enough to call Fakturownia. Credentials are scoped to this device, can be revoked from PulseKit at any time, and are never written to logs.
What you can track
Pick the metrics you care about and pin them as widgets. Numbers below are illustrative — your widgets show your live data.
Revenue
Booked sales over a period, consolidated into one currency
- 78Revenue
- 98Invoice count
- 56Avg invoice value
Receivables
Outstanding and overdue invoices, consolidated into one currency
- 98Outstanding
- 78Overdue
- 89Overdue count
Who uses this
- Sole traders
Running a JDG billed in EUR or GBP, you want monthly revenue without switching tabs. Set the Revenue widget to this month with PLN or EUR as the display currency and see a running total from every issued invoice. The average invoice value metric shows whether deal size is drifting without digging into individual records.
- Freelance consultants
When you bill multiple clients across currencies, knowing who still owes you is harder than it should be. The Receivables widget consolidates every open invoice into one outstanding total and shows how many are overdue, so you can decide each morning whether to send a payment reminder without logging into Fakturownia.
- Small agency founders
An agency issuing 10 to 30 invoices a month in mixed currencies needs a quick read on whether billing is on track. The Revenue widget shows invoice count alongside the revenue total, so you can see at a glance whether volume is keeping pace with previous periods before the month closes.
- Micro-business owners
If you issue invoices infrequently but need to know exactly what is outstanding before committing to new expenses, the Receivables widget gives you that number on your home screen. Overdue amount and overdue count tell you immediately whether cash collection needs attention, without a login.
FAQs
What Fakturownia data does PulseKit show?
PulseKit shows two groups of metrics from your Fakturownia account. The Revenue module shows total booked revenue, invoice count, and average invoice value for a selected period. The Receivables module shows the total outstanding across all open invoices, the overdue amount, and the count of overdue invoices. All money figures appear in a single display currency you choose when configuring the widget.
How does the currency conversion work?
Each invoice is converted to your chosen display currency using the NBP exchange rate that Fakturownia recorded on that invoice's accounting date -- not today's rate. This matches the booked rate already in your accounting records. If you select PLN as the display currency, conversion relies entirely on Fakturownia's own stored rates with no external lookups required, and the totals reproduce your ledger values exactly.
Does PulseKit count proforma invoices as revenue?
No. Only booked sales invoices are counted. Proformas and estimates are excluded because they represent quotes, not confirmed revenue. Correction invoices are included and can reduce the period total if they carry a negative value, keeping the figure consistent with what Fakturownia treats as issued sales.
Where do I find my Fakturownia API token?
In Fakturownia, open Ustawienia, then Ustawienia konta, then Integracja. The field labeled Kod autoryzacyjny API contains your token. Copy it into the PulseKit connection form along with your account domain -- the part before .fakturownia.pl in your address bar. For example, if your address is acme.fakturownia.pl, your domain is acme.
Can I track net revenue instead of gross?
Yes, for the Revenue module. A basis setting lets you switch between net (excluding VAT) and gross (including VAT). Receivables always uses gross figures because outstanding and overdue balances are naturally gross -- the unpaid amount on an invoice is the full invoice total owed, not the pre-tax portion.
Does PulseKit write anything to my Fakturownia account?
No. PulseKit only reads your invoices to compute revenue and outstanding totals. It never creates, edits, sends, or deletes invoices or any other record. The API token stored on your device is used exclusively for GET requests. This is also stated in the connection screen before you connect.
How is my API token protected?
Your account domain and API token are encrypted on your device with AES-256-GCM before they leave your iPhone. Only your device holds the key, stored in the iOS Keychain. The PulseKit server wraps that encrypted payload a second time for storage and never sees your credentials in plaintext. Credentials are scoped to your device and can be revoked from PulseKit at any time.
Add Fakturownia widgets to your iPhone
Install PulseKit, paste your credentials, pick a widget.