Fiscomm PURS E-Fiscalisation

Fiscomm PURS E-Fiscalisation connects your WooCommerce store to the Fiscomm E-Fiscalization API and automatically submits fiscal invoices to the Serbian Tax Authority (Poreska Uprava Republike Srbije — PURS) when orders are completed or refunded. Key features

• Automatic fiscalization on WooCommerce order completion and refund
• Support for standard, advance, and proforma invoices
• Support for B2B invoices (taxpayer identification number — PIB)
• Configurable buyer ID fields (individual / company)
• Per-product tax labels with support for variable products
• Product SKU prefix / suffix support
• Training mode for sandbox testing
• Detailed fiscalization log per order
• Serbian (sr_RS) and English (en_US) translations included
• WooCommerce HPOS (High Performance Order Storage) compatible

Third-party services This plugin connects to the Fiscomm E-Fiscalization API (https://fiscomm.rs/) to submit fiscal invoices to the Serbian Tax Authority. By using this plugin you agree to send order data (amounts, tax rates, buyer information) to that service on every fiscalized order.

• Fiscomm service: https://fiscomm.rs/
• Fiscomm terms of use: https://fiscomm.rs/uslovi-koriscenja/
• Fiscomm privacy policy: https://fiscomm.rs/politika-privatnosti/

An active Fiscomm API key is required. You can obtain one at https://fiscomm.rs/. Developer extensibility The plugin exposes documented WordPress action and filter hooks so that developers can customise fiscalization behaviour without modifying plugin files. See docs/HOOKS_REFERENCE.md in the plugin folder for the full reference. Bundled third-party libraries and their licenses are documented in THIRD_PARTY_LICENSES.md.

1.4.3

• Custom per-order Header/Footer text is now also included on refund (return) receipts, matching sale receipts.

1.4.2

• Fixed per-order receipt Header/Footer text not appearing on fiscal receipts: the header/footer are now sent nested under the receipt settings, matching the Fiscomm API, so custom header/footer text entered per order is printed as expected.

1.4.1

• Added an "Allow refunds without Buyer ID" setting (Refunds section). When enabled, refund documents are sent with skip Buyer ID validation so the Fiscomm API no longer requires a Buyer ID (PIB/tax identifier) on refunds. If a Buyer ID is present on the order it is still sent as usual.

1.4.0

• Added automatic daily exchange rate synchronization from the NBS (National Bank of Serbia): rates for enabled currencies are fetched once per day (around 08:00) and applied to invoices, removing the need to enter them manually.
• Added a per-currency "last updated" timestamp and source (auto/manual) shown in the exchange settings.
• Added an "Auto-update rates daily" toggle so stores can switch to fully manual rate management, plus a "Sync rates now" button to fetch the latest rates on demand.
• Manual rate edits are preserved for the day they are made; the next day's automatic sync refreshes them.
• Fixed misleading help text for the Receipt Header/Footer toggles: the actual header and footer text is entered per order (in the Fiscalization Information box on the order page), not in a separate dashboard.
• Fixed the PURS payment type help text to list all supported types (Cash, Credit Card, Voucher, Check, Bank Transfer, Instant Payment, Other Non-Cash) instead of only five.
• Duplicate "already being processed / already issued" fiscalization responses (which happen on accidental double-sends — e.g. a double click or a retry) are now logged and skipped silently with a neutral order note, instead of showing a confusing error. These are harmless system-level races and need no action.

1.3.5

• Fixed advance invoice dateTimeOfIssue being sent without timezone information; the full ISO 8601 datetime with offset (e.g. +02:00) is now forwarded to the API so the backend parses the correct local time instead of interpreting it as UTC.

1.3.4

• Fixed rounding mode incorrectly rounding line-item amounts to whole dinars instead of 2 decimal places; "Enable two decimal rounding" now correctly rounds to 2 decimals as labeled.
• Applied rounding mode consistently to refund invoices (previously only applied to normal invoices).

1.3.3

• Fixed items with zero total amount (including shipping) being incorrectly sent to the fiscalization API; they are now skipped before submission.
• Fixed items with an empty name being sent to the API; they are now skipped alongside zero-amount items.
• Fixed PIB auto-fill not working on order open: buyer ID code (type 10) and value are now correctly populated from the configured PIB meta key when the meta box renders.

1.3.2

• Fixed unnecessary /auth/verify-api-token HTTP call on every WordPress page load; API key validation is now triggered only on demand (admin verify action, fiscal requests), reducing server load for all connected sites.
• Fixed proforma-fiscalized order being incorrectly blocked from further fiscalization ("Order already fiscalized"): shared meta keys (_referent_document_number, _referent_document_dt) are no longer written for proforma invoices; invoiceExists() now uses per-type suffixed journal/URL as the primary signal.

1.3.1

• Fixed duplicate order error (ERR_00603) on second fiscalization attempt caused by WordPress meta cache race condition.
• Added explicit cache invalidation after order and refund meta save to ensure subsequent invoiceExists() checks always see updated markers.
• Cache clearing now works on both HPOS (High-Performance Order Storage) and classic post-based WooCommerce systems.
• Added info logging for meta persistence tracking to help diagnose fiscalization issues.
• Enhanced invoiceExists() documentation to clarify cache behavior.

1.3.0

• Fixed order list fiscalization column to show all actually created documents (proforma, all advance invoices, final invoice, and refund invoices).
• Refund invoices are now visually highlighted in red in the orders list for faster identification.
• Fixed false proforma display in orders list: proforma is now shown only when proforma URLs/PDF are present.
• Fixed advance finalization request payload: finalize now sends payment entries in finalize format (amount=0 + advanceAmount) to avoid double-payment interpretation while preserving backend finalize logic.
• Fixed finalize response parsing when backend returns wrapped payloads (finalReceipt), so created final receipts are correctly persisted to order meta.
• Advance invoice datetime is now auto-filled and sent only for advance sale flow; other invoice types no longer send dateTimeOfIssue.

1.2.3

• Added "Order number under receipt" setting (Receipt Header/Footer section): follow the shop setting from the Fiscomm platform (default), always show, or always hide the WooCommerce order number printed below fiscal receipts.

1.2.2

• Fixed fatal error ("syntax error, unexpected '|'") on PHP 7.4 that prevented the plugin from initializing — the plugin now runs on PHP 7.4 as declared.
• Translated all remaining hardcoded admin strings; complete Serbian (Cyrillic) and English translations with updated language files.
• Fixed plugin directory listing metadata (tags and contributors) not displaying on WordPress.org.

1.2.1

• Added API key info card in plugin settings showing account details fetched from Fiscomm.
• Added debug logging for API key verification request and response when debug logging is enabled.
• Fixed QR code rendering in fiscalization confirmation emails (restored default renderer).
• Fixed double-fiscalization of refunds when multiple refunds exist on the same order.
• Fixed advance invoice finalization so a failed meta save cannot trigger a duplicate API call on retry.
• Fixed buyer ID fields not being recognized when values contain leading/trailing whitespace.
• Meta box fields on fiscalized orders are now editable so buyer identification can be added before processing a refund.
• Added warning notice in the meta box when refund fiscalization is enabled but buyer ID is not set.
• Updated WordPress compatibility to 6.8.

1.2.0

• Removed third-party CDN loading for admin assets; now uses bundled local assets only.
• Aligned plugin version metadata across plugin header, core constant, and readme stable tag.

1.1.1

• Added public extensibility hooks for receipt lifecycle and metadata persistence.
• Added hook reference and WordPress hook audit documentation.
• Improved CI quality gates and strengthened initial test coverage.

1.1.0

• Added support for default values for all settings
• Refactored fiscalization settings and added logging functionality
• Removed unused AddSettingsTab trait and related settings tab.
• Introduced new system settings section for logging configuration.
• Added custom logging functionality to track fiscalization processes.
• Updated various methods to handle new logging and settings features.
• Enhanced order refund handling with automatic fiscalization on status change.
• Added new language files for English and Serbian translations.
• Cleaned up deprecated code and improved overall structure.

1.0.0

• Initial release

0.3.22

• Call to undefined method WC_Order_Item_Fee::get_product() fix

0.3.21

• When country is empty, defaults to Serbia
• Added more information about fiscalization under Shipping details in order

0.3.20

• Fixed exclude from fiscalization for variation products
• Added new way of using SKU with Product Name (SKU - Product Name)

0.3.19

• API Key change support with saved settings

0.3.18

• Advance invoices order warning fix

0.3.17

• Fix labels not showing per product

0.3.16

• Product SKU prefix & suffix support

0.3.15

• Reasons for not fiscalizable orders

0.3.14

• Option for hiding Tax Label section on Product page
• Disable fiscalization for orders outside of Serbia
• Synchronized Buyer IDS with documentation
• Refund show fix

0.3.13

• Adjusted timeout for API requests to 30 seconds

0.3.12

• WooCommerce HPOS compatibility
• Tax labels caching

0.3.11

• Added settings for using product SKU instead of product name in receipts

0.3.10

• Added number format for rounding on 2 decimals for Shipping

0.3.9

• Admin notice when Woocommerce is not installed
• Fixed buyerId sending without buyerId value

0.3.8

• Header and Footer text on receipts
• Buyer ID is now optional fields for Refunds
• Buyer ID is now shown even if only "Refunds" are enabled, and not "PIB"

0.3.7

• Fixed get_product returning bool instead of product object

0.3.6

• Switched GuzzleHttp to wp_remote_post & wp_remote_get for better compatibility

0.3.5

• Now supports disabling shipping item per payment method

0.3.4

• Added buyer cost center field in orders page

0.3.3

• Moved product specific tax labels to advanced tab
• Added support for specific tax label for variable products

0.3.2

• Patched error on finalizing advance invoices (createInvoice method error)

0.3.1

• Removed sessions from the plugin

0.3.0

• Added support for advance invoices

0.2.12

• Fixed bug with woocommerce not saving Sell to specific countries setting

0.2.11

• Now supports only fee orders if Woocommerce Specific Fees are included in the settings

0.2.10

• Supports enabling of two decimals rounding in Woocommerce Specific Settings

0.2.9

• Added support for overriding default/foreign tax labels for shipping invoice item

0.2.8

• Added support for adjusting exchange rate for foreign currencies

0.2.1

• Supports advance invoices
• Added support for B2B invoices by adding additional Taxpayer Identification Number field.
• Separated settings into sections for better readability

0.2.0

• Now supports multiple emails for training invoices
• Added exclusive training mode

0.1.4

• Feature for setting the name of the invoice item for shipping.

0.1.3

• Added excluding shipping costs

0.1.1

• Fix for dropdown

0.1.0

• Released: March 4, 2022