Troubleshooting
“Test connection” fails
Section titled ““Test connection” fails”- Check the mode: the test account only works in test mode and the live account only in live mode.
- Check the subdomain (only your own account’s name or
name.fakturownia.pl) and that the token is the API authorization code of that account, without spaces. - A
Brak autoryzacji(not authorized) answer means Fakturownia does not accept the token for that subdomain. - The Log tab shows the API’s answer (masked). Validation errors come as
422with the field name and the reason, for examplebuyer_name: can't be blank. - Your server must be able to reach
https://<account>.fakturownia.pl(outgoing port 443) and have a current CA bundle.
Nothing happens after an order changes status
Section titled “Nothing happens after an order changes status”- Check Settings > General > Enable and the order status settings.
- Check the license status bar on the add-on pages.
- Open Jobs: queued jobs wait for cron. If the counts never change, the cron job is not running; run the command from the settings page by hand once.
- Orders before the “do not sync before” date are skipped.
A job is “Waiting to retry” or “Gave up”
Section titled “A job is “Waiting to retry” or “Gave up””The last error is shown in the list. Fix the cause (token, data, outage) and press Retry. Jobs are retried automatically after 5 minutes, 15 minutes, 1 hour, 3 hours and 12 hours before they give up.
“oid: has already been taken”
Section titled ““oid: has already been taken””Fakturownia already has a document with this order number. This is the protection against double documents: if a network error hid a successful answer, the first document exists. Find it in Fakturownia by the order number (for example WEB-1042); the add-on will not create a second one.
The document is a receipt but the buyer gave a NIP (or the reverse)
Section titled “The document is a receipt but the buyer gave a NIP (or the reverse)”The number must pass the NIP checksum and sit in the profile field chosen under Profile field with the NIP. Check the field in the order details: the order stores the value at checkout.
Positions do not add up to the order total
Section titled “Positions do not add up to the order total”The log shows a warning with both amounts. Usually a CS-Cart tax has no Fakturownia value in the Mapping tab, or shipping is taxed differently from the default tax. Fix the mapping; documents already issued are not rewritten, correct them in Fakturownia.
A correction is refused
Section titled “A correction is refused”Fakturownia refuses a correction in some cases, for example for a receipt. The Jobs tab shows its message; issue the correction in Fakturownia by hand and discard the job.
The cron address answers “Forbidden”
Section titled “The cron address answers “Forbidden””The key in the address is wrong. Copy the address again from the settings page.
Still stuck
Section titled “Still stuck”Contact us through https://cs-cart.kaviolabs.com with the add-on version, the CS-Cart version and the relevant log lines (the token is masked automatically).