Skip to content

SDK Changelog

This page documents all SDK releases. SDKs are available for 8 languages: C#, Python, PHP, Java, JavaScript, Ruby, Go, TypeScript.

Each SDK release includes API changes that impact clients (new fields, endpoints, parameters, breaking changes). For full details on server-side fixes, see the API changelog.

v1.10 - September 9, 2026

Aligned to API version v1.15.0.

New

  • Error responses now carry a stable code to branch on, instead of just a message: usage_limit_exceeded and signature_limit_exceeded on 403 responses from an exhausted limit, company_already_registered on the 400 for an already registered company. The code does not change across languages, while the message follows Accept-Language.
  • Endpoints subject to the operation limit now declare the 403 in the specification, so the response shows up among the documented ones in the SDKs.

Fixes

  • 403 responses reporting an exceeded limit now carry the reason in the response body; previously an empty response came back.
  • The error message for an already registered company now explains the cause: VAT numbers and fiscal codes are unique across the whole platform, so a company can be already registered even when it is not among your own.

v1.9 - July 7, 2026

Aligned to API version v1.14.0.

New

  • The send endpoints now support the optional Idempotency-Key header: retrying the same request after a network timeout returns the original response instead of creating a duplicate invoice on SDI. See the Idempotency guide.

Fixes

  • Several client-side error conditions (for example an invalid JSON payload, or updating a resource that violates a uniqueness constraint) now return 400 Bad Request with a descriptive message instead of a 500.
  • The rate limiting headers now reflect the limits actually enforced.

v1.8 - April 21, 2026

Aligned to API version v1.12.0.

New Features

  • The send invoice service responses now include the latest SDI status directly, removing the need for a separate call to retrieve it.
  • Multiple sent invoices can be retrieved in a single call via a multi-id filter (up to 100 values per request).
  • The account status exposes additional information about the active Desk seat and the API key type in use.
  • The webhook history now includes error details when delivery to your endpoint fails.
  • Introduced a dedicated rate limiting policy for repetitive reads (polling), advertised via response headers.

Fixes

  • Fixed an issue where some server-signed invoices uploaded as XML with a particular encoding were processed incorrectly.
  • Fixed an issue where the last-update timestamp on sent invoices did not reflect all state transitions after the initial submission.

v1.7 - April 2, 2026

Aligned to API version v1.6.4.

Fixes

  • Restored Basic authentication in all SDKs.

v1.6 - March 30, 2026

Aligned to API version v1.6.1.

New Features

  • Log events now include the user_agent field, filterable via query parameter.

v1.5 - March 12, 2026

Aligned to API version v1.3.3.

New Features

  • Added nome_committente field to sent invoices and nome_prestatore field to received invoices. The business name is automatically extracted from the XML and is searchable via the q filter.
  • Added sorting support for document_date (and -document_date) on /send/ and /receive/ endpoints.
  • Added q parameter for full-text search on /company/, /send/, and /receive/.

v1.4 - February 25, 2026

Aligned to API version v1.2.1.

New Features

  • Added GET /company/{vat} endpoint to retrieve a company by its VAT number.
  • Added GET /send/{id}/payload and GET /receive/{id}/payload endpoints to retrieve the XML payload without invoice metadata.

v1.3 - February 13, 2026

Aligned to API version v1.1.0.

New Features

  • Added GET /export/ endpoint to export sent and received invoices as a ZIP archive of FatturaPA XML files. Supports filters by company, period (month/quarter), and document date range.

Fixes

  • Received invoices (Receive) are now counted as operations only when unread.

v1.2 - February 10, 2026

Aligned to API version v1.0.27.

New Features

  • Added force parameter to DELETE /company/{id} — requires ?force=true when linked invoices exist, otherwise returns 409 Conflict with details.

v1.1 - December 4, 2025

Aligned to API version v1.0.12.

New Features

  • Added resource_id field to webhook notifications to directly identify the created or modified resource.

v1.0 - July 14, 2025

Aligned to API version v1.0.0.

New Features

First official release of Invoicetronic SDKs with support for 8 languages: C#, Python, PHP, Java, JavaScript, Ruby, Go, TypeScript.