Fakturownia integration
for Medusa
VAT invoices, proformas, receipts and corrections in Fakturownia for Medusa orders, issued exactly once. Payment, KSeF number and PDF come back to the admin, and customers download their documents in the store.
What exactly
this integration does
-
A document at the right moment
The invoice is issued when the payment is captured or when the order is placed. You can also issue a proforma first and the VAT invoice after shipping.
-
Receipts for consumers
A buyer without a tax ID gets a receipt instead of an invoice, a company gets an invoice with the tax ID from the order.
-
Corrections with approval
A return, refund, edit or cancellation after issue becomes a correction plan with the positions before and after. A person approves it, and the correction is issued once.
-
KSeF in detail
KSeF number, status, errors, UPO and XML on every document, with a history and a resend.
-
E-mails and reminders
The document with its PDF to the buyer, reminders about unpaid invoices and a monthly summary.
-
Documents in the customer account
A logged-in customer downloads the invoices of their orders right in the store.
How it guards
your data
-
Zero duplicates
One row per order and document kind, unique in the database. Before every issue the document is looked up in Fakturownia by the order number.
-
One shot, never blind
The request that creates an invoice is never repeated. A lost answer means a lookup in Fakturownia, not a second invoice.
-
Nothing about the buyer in Medusa
The plugin keeps the document kind, number, amounts and statuses. Buyer data is built from the order when it is sent, and addresses in the e-mail history are masked.
Setup
in three steps
The full list of options, events and API routes is in the package README on GitHub.
Paste it into Claude Code, Cursor or another AI assistant in your Medusa project: it installs and configures the integration, with writes off.
- 1 Install the package from npm.
npm install @koda-plus/medusa-plugin-fakturownia - 2 Add the plugin to medusa-config.ts.
plugins: [ { resolve: "@koda-plus/medusa-plugin-fakturownia", options: { apiToken: process.env.FAKTUROWNIA_API_TOKEN, account: process.env.FAKTUROWNIA_ACCOUNT, // "mojafirma" issuePlace: "Warszawa", // documentFlow: "proforma_then_vat", // corrections: "plan", }, }, ] - 3 Run the migrations and open the integration in the Medusa admin.
npx medusa db:migrate
Running for our clients
See our portfolio
biolcheck
Other
integrations
- Allegro Offers, orders, stock and parcels
- BaseLinker Cards, stock, prices and orders both ways
- Subiekt nexo Orders as ZK, WZ and invoices with KSeF
- InPost Parcel lockers, courier and COD on ShipX
- OLX Adverts that match the store's stock
- Stripe Volume, fees, disputes and account health
- Negotiations Target price, counter offer, acceptance
- Trade credit Limits, terms and customer balances
- Loyalty Points, a reward ladder and a ledger
- Packaging Piece, box, pallet, minimum and step
- EU compliance GPSR, RODO and Omnibus in one panel
- VAT whitelist NIP, VIES and REGON in one panel
- E-mails Ready templates in Polish and English
- Tasks Tasks on orders, products and customers
Tell us about your project,
we'll tailor the rest to you
A 15-minute call is enough for us to know whether we are a fit for your project.
We start from what you need, not from an off-the-shelf solution.