Portfolio BigCommerce → Fakturownia
An invoice for every paid order — no manager needed
An integration of a Polish online store on BigCommerce with the Fakturownia invoicing service. The moment an order is paid, the system issues the invoice, emails the PDF to the buyer and writes the result into the order itself.
Project
BigCommerce → Fakturownia
- Client
- An online store in Poland running on BigCommerce Every sale in Poland needs an invoice, while the store and the accounting lived in different services.
- System
- A service between the store and Fakturownia It takes orders from BigCommerce, issues invoices in Fakturownia and sends them to buyers. The panel is view-only: orders belong to the store.
- Our role
- Analysis of both APIs, field mapping, the back end Plus job queues, a log of every data exchange, the viewing panel, deployment and support.
- Technologies
-
- PHP
- Laravel
- Filament
- Livewire
- MariaDB
- Redis
- Control
- A log of every exchange with BigCommerce and Fakturownia You can see what came from the store, what went to Fakturownia and exactly where an error happened.
Task
The store sells, invoices are done by hand
Orders arrived in BigCommerce, and a manager issued invoices separately in Fakturownia: copying the buyer, items, prices and tax, then sending the PDF. As sales grew, this became a bottleneck and a source of mistakes.
Invoice only after payment
An order can wait for payment for a long time. The invoice must be issued exactly when the money arrives — not earlier, not later.
No duplicates
The store sends several notifications about one order: creation, status changes, retries. There must be one invoice per order.
Exact buyer and tax data
Company or private person, address, currency, payment method and the tax rate of every item must reach the invoice without retyping.
The store knows what happened
The manager works in BigCommerce and should not have to check another service to see whether the invoice was issued and reached the buyer.
Solution
The order makes its own way to an invoice
A notification checked by signature
BigCommerce reports a new or changed order. The system verifies the notification’s digital signature and takes the order data straight from the store’s API — not from the notification text.
The invoice at the moment of payment
When an order becomes paid or completed, the system creates the invoice in Fakturownia: buyer, items, prices, currency, payment method and tax. The system remembers which orders already have an invoice, so repeated notifications about one order do not create a second one.
PDF to the buyer, summary to the store
The finished PDF is stored in the system and emailed to the buyer, and the invoice number, time and whether the email went out are written into the order’s staff notes in BigCommerce.
Capabilities
From order to invoice
01 · 4
Orders
- BigCommerce notifications with signature check
- Orders and items straight from the store’s API
- Order updated on every status change
- Filters by status and dates
02 · 4
Invoices
- Invoice after the order is paid or completed
- Company or private person as the buyer
- Currency, payment method and tax rate from the order
- Repeated notifications create no second invoice
03 · 3
Documents
- Invoice PDF stored next to the order
- Email to the buyer with the PDF attached
- Invoice number in BigCommerce staff notes
04 · 4
Control
- Log of incoming and outgoing requests with responses
- Retries in a background queue
- User roles and an activity log
- View-only panel
Result
Paid — the invoice is already in the inbox
The manager no longer copies orders into Fakturownia: the invoice appears by itself as soon as the order is paid, and the buyer gets the PDF right away.
BigCommerce shows that the invoice was issued, and if an exchange stopped somewhere, the log shows at which step and why.