eRačun HR for OpenCart 2.3, 3.x and 4.x — HR-CIUS XML, KPD codes, OIB at checkout

eRačun HR turns an OpenCart order into a Croatian electronic invoice: XML under HR-CIUS, a PDF copy and a KPD code on every line. In Pro the document goes to the intermediary mer (formerly moj-eRačun).

We have not sent a single document to a real intermediary. Check the process, exemptions and reason texts with your accountant before the first invoice.

What the buyer sees

At checkout a company buyer enters an OIB. A wrong number stops the form with a message under the field, an empty one passes. A buyer without an OIB gets no automatic invoice: a B2C order stays as it is. In Pro the buyer gets a mail and can download the document from the account.

What the admin gets

The KPD tab shows categories with inheritance, a suggestion by code or word and bulk assignment. The order page gives the invoice, PDF, XML and an OIB correction. If a product has no code, no invoice goes out and the reason shows at once. In Pro the same page has sending, the status, the payment report and a credit note, and an intermediary’s refusal shows its text.

How it works, step by step

1. Fill in the seller data and bank details.
2. Create the OIB field with a button.
3. Assign KPD codes to categories or products.
4. On the order page issue the invoice and download the XML.
5. In Pro the document goes to the intermediary and the status shows on the order.

Under the hood

• Data and numbering live in the module’s own tables, and a normal removal keeps them.
• The intermediary password is stored encrypted.
• A retry after a timeout first looks for the document at the intermediary.
• The module does not do eIzvještavanje art. 51, refusals by the buyer, advance invoices or foreign buyers HR:K and HR:G.
• Fiskalizacija HR does not know about this module: do not run both paths on one order without your accountant.

How to install

1. Extensions → Installer: upload the archive for your version and keep the file name.
2. OpenCart 2.3: the Installer copies files only with FTP enabled. Without FTP copy the contents of upload/ to the shop root by hand.
3. OpenCart 2.3 and 3.x: Extensions → Modifications → Refresh.
4. Extensions → Modules → eRačun HR (Fiskalizacija 2.0) → install button → Edit.
5. Open the settings, fill in the seller and bank details.
6. Create the OIB field and assign KPD codes.
7. Issue a test invoice and check the XML on the intermediary’s public validator.
8. For Pro: paste the key or start the 7-day trial.