Fiskalizator for WooCommerce

Description

Croatian law requires invoices to be reported to the Tax Administration (Porezna uprava) in real time – “fiskalizacija”. Fiskalizator for WooCommerce connects your store to the Fiskalizator service, which creates the invoice for each paid order, signs it with your fiscalization certificate, reports it to the Tax Administration and returns the JIR and ZKI codes.

Hrvatski: dodatak povezuje WooCommerce trgovinu s Fiskalizatorom, koji za svaku plaćenu narudžbu izradi račun, potpiše ga vašim certifikatom, fiskalizira kod Porezne uprave i vrati JIR i ZKI. Sučelje je na hrvatskom kad je WordPress na hrvatskom.

What it does

• Fiscalizes orders automatically when they reach “Processing” or “Completed” (Fiskalizacija 1.0, B2C receipts with JIR/ZKI).
• Issues a structured B2B e-invoice (eRačun, Fiskalizacija 2.0) when the buyer enters a company tax number (OIB) at checkout, sent through your own information intermediary.
• Writes the result back to the order: an order note, the invoice number and JIR, and a “Fiscalization” column in the orders list (classic and HPOS screens).
• Guided setup inside the WordPress admin: company details, certificate upload, business premises, e-invoice access point, EU OSS sales and reverse charge.
• Invoice book with late fiscalization, proformas and invoices from orders, and offers.
• Optional “Withdraw from the contract” button (EU Directive 2023/2673), as a footer button you switch on or the [fiskalizator_raskid] shortcode.
• An OIB / EU VAT number field at checkout – both the block checkout and the classic one – with a check-digit validation.

The plugin is an interface to the Fiskalizator service. The fiscalization itself – certificate handling, XML signing and the connection to the Tax Administration – runs in the service, not on your site.

Requirements

• A WooCommerce store selling under a Croatian tax number (OIB).
• A Fiskalizator account. The plugin can open one for you when you connect the store. The service is paid, with a free trial; see https://fiskalizator.klikoteka.hr.
• A fiscalization certificate (.p12) from FINA or Certilia.
• For e-invoices: your own contract with a Croatian information intermediary (for example ePoslovanje or Moj-eRačun).

External services

This plugin relies on the Fiskalizator service, operated by Klikoteka d.o.o. (https://fiskalizator.klikoteka.hr). It cannot fiscalize anything without it. Nothing is sent until you connect the store on the plugin’s “Connection” screen.

What is sent, and when:

• When you connect the store: the site URL, the site name and the admin e-mail address, so the service can open or find your account. The service calls your site back once (/wp-json/fiskalizator/v1/verify) to confirm that you control the domain: it sends a random challenge and your site answers with a keyed hash of it. That address answers only for a few minutes after an administrator presses a connect button, and never returns the key itself.
• When an order reaches “Processing” or “Completed”: the order data needed to issue the invoice – line items, amounts, tax, payment method, and the buyer’s name, address, e-mail and tax number if one was entered. The request is signed with a secret key shared between your store and the service.
• When you refund an order (in full or in part): the order number, the refund’s number, amount and reason, and how the refunded amount falls across VAT rates, so the service can issue the storno or credit note that refers to the invoice.
• When a buyer types a company tax number (OIB) at checkout or in the cart: that number, to look up the company’s public registry name and address.
• When you issue a proforma or an invoice for an order by hand (Orders screen): the same order data as above.
• When you press “Import customers from the store” (Settings screen): for WooCommerce customers that have a company name – that name, the billing address, the e-mail address and a VAT number if one is stored.
• When you use the plugin’s admin screens: the plugin’s own version number (so the service can tell you when a newer one is out; the plugin never downloads or installs anything itself), and what you enter there (company details, premises, settings, offers) and, if you upload it, your fiscalization certificate and its password, which go directly to the service over HTTPS and are not stored on your site.
• When you press “Choose a plan” (Overview screen): nothing is sent by your site. The button is a link to the service’s plan page on https://klikoteka.hr, and the link carries an identifier of your account so the plan is attached to it.
• When you turn on the withdrawal button: nothing is sent by your site; the button is a link to a form hosted by the service, which the buyer fills in there.

What comes back: after fiscalization the service calls your site (/wp-json/fiskalizator/v1/order-fiscalized, signed with the same key) to write the invoice number, JIR and status onto the order.

Service terms of use: https://fiskalizator.klikoteka.hr/terms
Service privacy policy: https://fiskalizator.klikoteka.hr/privacy

The service in turn reports invoices to the Croatian Tax Administration, as the law requires, and sends e-invoices through the information intermediary you connect.