Release Notes - October 2026

Breaking changes

Reduced set of VAT rates

POST /v1/mf1/receipts (including its return and void variants), POST /v1/mf1/pems/{serial_number}/emergency-reports and the GET endpoints that return commercial document details now only accept and return the following VAT rates:

• 4.00
• 5.00
• 10.00
• 22.00

The previously supported rates (2.00, 6.40, 7.00, 7.30, 7.50, 7.65, 7.95, 8.30, 8.50, 8.80, 9.50, 12.30) are no longer valid.

payment_type value credit renamed

On POST /v1/mf1/receipts, the credit value of payment_type has been renamed to uncollected_goods.

Telemetry endpoint removed

GET /v1/mf1/pems/telemetry has been removed.

PEM status and diagnostics data is now available as a diagnostics back-office report.

ATECO code format changed

ateco_code on POST /v1/mf1/pems/{serial_number}/emergency-reports must now be exactly 6 uppercase alphanumeric characters. Previously it was 5 to 6 digits.

New restriction on PEM data download

GET /v1/mf1/pems/{serial_number}/download-data now returns 409 Conflict if the PEM's journal is currently open.

New endpoints

Back-office reports (MF1)

See Back-office Reports for an overview.

Method	Path	Description
GET	/v1/mf1/pems/{serial_number}/backoffice-reports	Lists a PEM's back-office reports
GET	/v1/mf1/pems/{serial_number}/backoffice-reports/requests	Lists a PEM's back-office report requests, with their status (queued, processed, failed) and the generation progress of the related reports
POST	/v1/mf1/pems/{serial_number}/backoffice-reports/journal-reading	Queues a journal-reading report for the PEM's currently open journal. Returns 409 if no journal is open
POST	/v1/mf1/pems/{serial_number}/backoffice-reports/diagnostics	Queues a diagnostics report for the PEM. Returns 409 if no journal is open
POST	/v1/mf1/pems/{serial_number}/backoffice-reports/receipts	Queues a report on one or more commercial documents. Set type to details for the full content of each document (filter by document number, document number range or date range), or to summary for totals grouped by VAT treatment (filter by document number range or date range)
GET	/v1/mf1/pems/{serial_number}/backoffice-reports/{report_uuid}/pdf	Downloads the PDF of a back-office report

A journal-closure report is queued automatically when POST /v1/mf1/pems/{serial_number}/close is called.

Cash register (MF1)

Method	Path	Description
GET	/v1/mf1/cash-registers/me	Returns the cash register associated with the mTLS certificate used for the call (PEM serial number, cash register name and ATECO codes)

ATECO codes (MF2)

Method	Path	Description
GET	/v1/mf2/merchants/{uuid}/ateco-codes	Retrieves a merchant's ATECO codes
PUT	/v1/mf2/merchants/{uuid}/ateco-codes	Replaces a merchant's ATECO codes

Non-breaking changes

• New optional field ateco_code on commercial document items.
• New optional field display_cash_register_name in the PEM configuration.
• GET /v1/mf1/pems/{serial_number}/download-data no longer documents the 400 and 500 responses.
• In MF2 error responses, the status field is now typed as an integer instead of a number.
• In MF2 paginated responses, the pagination links (view.first, view.last, etc.) can now be null.
• The descriptions of GET /v1/mf2/pems/{serial_number}, GET /v1/mf2/merchants/{merchant_uuid}/pems and POST /v1/mf2/pems/{serial_number}/discard have been updated. The last one now correctly states that it sets the PEM status to discarded.