invoicetronic_sdk 1.7 → 1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 50f6b71fbd341a92f66690d771c773b4f046e57bdffe270daf4f6e58f21beade
-  data.tar.gz: 7950a17f414a66064935dcb3159086fa900534122286939ff714b907ff29aa99
+  metadata.gz: 26528c2b72851b8fb80fa975a54ec6ce01f0fcaa22ec0e857f35ae63d9c57a4a
+  data.tar.gz: 1917ebcb258bf9d1c47283766f831962d56eb16d53dd6402fe055f8bbddab890
 SHA512:
-  metadata.gz: 7876619080be87e4be2e60a06e58582ac9ac8139ab7064ae851cca47f103920c5deee3bfb4a5d376b5c70f6e27076470960d529e9a693db80979f1dcd149913b
-  data.tar.gz: 43e3594858513d494829eeb8fca837a808437ca62764dfdb5099f3415fb724245064fcbebddb8f4e608b676927a1a6b65c9410b5c472b93906ead0d9882712e0
+  metadata.gz: 546eb1877c9bc3ad20524bb3dabe8937aa80be36c2bdb61801e31271ba0b0b67a1b8fc1b1f3e5a33796894d8d7c3adeda23528226af256df235c9c0d44266d69
+  data.tar.gz: af27a9504e4d19069967b21071e6f7913b20c52b9b74f6425d1763a774b9bc1bb3430a189b6d65805294c3192a5d729b06143c0d3b329cbf16afd906b54ec53a

data/CHANGELOG.md

@@ -1 +1 @@
-# Changelog\n\n## [1.7.0] - 2026-04-02\nSee main repository changelog for details.
+# Changelog\n\n## [1.9.0] - 2026-07-07\nSee main repository changelog for details.

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    invoicetronic_sdk (1.7)
+    invoicetronic_sdk (1.9)
       typhoeus (~> 1.0, >= 1.0.1)
 
 GEM
@@ -42,7 +42,7 @@ GEM
     pry-byebug (3.12.0)
       byebug (~> 13.0)
       pry (>= 0.13, < 0.17)
-    psych (5.3.1)
+    psych (5.4.0)
       date
       stringio
     racc (1.8.1)

data/README.md

@@ -4,13 +4,27 @@ The [Invoicetronic API][2] is a RESTful service that allows you to send and rece
 
 For more information, see  [Invoicetronic website][2]
 
+## Before you start
+
+For the full integration guide, tutorials, SDKs and quickstarts, see the **[Documentation](https://invoicetronic.com/en/docs/)**. A few cross-cutting topics worth knowing before integrating:
+
+- **[Prerequisites](https://invoicetronic.com/en/docs/prerequisites/)** — what you need to start in Sandbox and what's required to move to production.
+- **[API Keys](https://invoicetronic.com/en/docs/apikeys/)** — how `ik_live_` and `ik_test_` keys select the environment.
+- **[Sandbox](https://invoicetronic.com/en/docs/sandbox/)** — free test environment that mirrors the live workflow, with no credits consumed.
+- **[Rate Limiting](https://invoicetronic.com/en/docs/ratelimiting/)** — per-second, per-minute and per-day limits; how to handle `429 Too Many Requests`.
+- **[Pagination](https://invoicetronic.com/en/docs/pagination/)** — `page` and `page_size` parameters and the `Invoicetronic-Total-Count` response header.
+- **[CORS](https://invoicetronic.com/en/docs/cors/)** — calling the API from the browser; allowed origins are configured per key.
+- **[Webhooks](https://invoicetronic.com/en/docs/webhooks/)** — real-time event notifications with HMAC-SHA256 signature validation.
+- **[Localization](https://invoicetronic.com/en/docs/accept-language/)** — use the `Accept-Language` header to receive error messages in Italian, English or German.
+
 [1]: https://www.fatturapa.gov.it/it/sistemainterscambio/cose-il-sdi/
 [2]: https://invoicetronic.com/
 
+
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
-- API version: 1.6.4
-- Package version: 1.7
+- API version: 1.14.0
+- Package version: 1.9
 - Generator version: 7.20.0
 - Build package: org.openapitools.codegen.languages.RubyClientCodegen
 For more information, please visit [https://invoicetronic.com/en/contact/](https://invoicetronic.com/en/contact/)
@@ -28,16 +42,16 @@ gem build invoicetronic_sdk.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./invoicetronic_sdk-1.7.gem
+gem install ./invoicetronic_sdk-1.9.gem
 ```
 
-(for development, run `gem install --dev ./invoicetronic_sdk-1.7.gem` to install the development dependencies)
+(for development, run `gem install --dev ./invoicetronic_sdk-1.9.gem` to install the development dependencies)
 
 or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
 
 Finally add this to the Gemfile:
 
-    gem 'invoicetronic_sdk', '~> 1.7'
+    gem 'invoicetronic_sdk', '~> 1.9'
 
 ### Install from Git
 

data/docs/Company.md

@@ -4,10 +4,10 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **id** | **Integer** | Unique identifier. Leave it at 0 for new records as it will be set automatically. | [optional] |
-| **created** | **Time** | Creation date. It is set automatically. | [optional] |
-| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional] |
-| **user_id** | **Integer** | User id. | [optional] |
+| **id** | **Integer** | Unique identifier. For POST requests, leave it at `0` — the server will assign one automatically. For PUT requests, set it to the id of the record you want to update. | [optional] |
+| **created** | **Time** | Creation date. It is set automatically. | [optional][readonly] |
+| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional][readonly] |
+| **user_id** | **Integer** | User id. It is set automatically based on the authenticated user. | [optional][readonly] |
 | **vat** | **String** | Vat number. Must include the country code. |  |
 | **fiscal_code** | **String** | Fiscal code. In most cases it's the same as the vat number. |  |
 | **name** | **String** | Name |  |
@@ -18,7 +18,7 @@
 require 'invoicetronic_sdk'
 
 instance = Invoicetronic_Sdk::Company.new(
-  id: null,
+  id: 0,
   created: null,
   version: null,
   user_id: null,

data/docs/Event.md

@@ -4,9 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **id** | **Integer** | Unique identifier. Leave it at 0 for new records as it will be set automatically. | [optional] |
-| **created** | **Time** | Creation date. It is set automatically. | [optional] |
-| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional] |
+| **id** | **Integer** | Unique identifier. For POST requests, leave it at `0` — the server will assign one automatically. For PUT requests, set it to the id of the record you want to update. | [optional] |
+| **created** | **Time** | Creation date. It is set automatically. | [optional][readonly] |
+| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional][readonly] |
 | **user_id** | **Integer** | User id. | [optional] |
 | **api_key_id** | **Integer** | Api key id. | [optional] |
 | **company_id** | **Integer** | Company id. | [optional] |
@@ -28,7 +28,7 @@
 require 'invoicetronic_sdk'
 
 instance = Invoicetronic_Sdk::Event.new(
-  id: null,
+  id: 0,
   created: null,
   version: null,
   user_id: null,

data/docs/ModelSend.md

@@ -4,23 +4,24 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **id** | **Integer** | Unique identifier. Leave it at 0 for new records as it will be set automatically. | [optional] |
-| **created** | **Time** | Creation date. It is set automatically. | [optional] |
-| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional] |
-| **user_id** | **Integer** | User id. | [optional] |
-| **company_id** | **Integer** | Company id. On send, this is the sender and must be set in advance. On receive, it will be automatically set based on the recipient's VAT number. If a matching company is not found, the invoice will be rejected until the company is created. | [optional] |
-| **committente** | **String** | VAT number of the Cessionario/Committente (customer). This is automatically set based on the recipient's VAT number. | [optional] |
-| **prestatore** | **String** | VAT number of the Cedente/Prestatore (vendor). This is automatically set based on the sender's VAT number. | [optional] |
-| **identifier** | **String** | SDI identifier. This is set by the SDI and is guaranteed to be unique within the SDI system. | [optional] |
-| **file_name** | **String** | Xml file name. | [optional] |
+| **id** | **Integer** | Unique identifier. For POST requests, leave it at `0` — the server will assign one automatically. For PUT requests, set it to the id of the record you want to update. | [optional] |
+| **created** | **Time** | Creation date. It is set automatically. | [optional][readonly] |
+| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional][readonly] |
+| **user_id** | **Integer** | User id. It is set automatically based on the authenticated user. | [optional][readonly] |
+| **company_id** | **Integer** | Company id. It is set automatically based on the VAT number extracted from the invoice payload (the sender for `send`, the recipient for `receive`). | [optional][readonly] |
+| **committente** | **String** | VAT number of the Cessionario/Committente (customer). This is automatically set based on the recipient's VAT number. | [optional][readonly] |
+| **prestatore** | **String** | VAT number of the Cedente/Prestatore (vendor). This is automatically set based on the sender's VAT number. | [optional][readonly] |
+| **identifier** | **String** | SDI identifier. This is set by the SDI and is guaranteed to be unique within the SDI system. | [optional][readonly] |
+| **file_name** | **String** | Xml file name. If not provided on send, it will be auto-generated. | [optional] |
 | **format** | **String** | SDI format (FPA12, FPR12, FSM10, ...) | [optional] |
 | **payload** | **String** | Xml payload. This is the actual xml content, as string. On send, it can be base64 encoded. If it's not, it will be encoded before sending. It is guaranteed to be encrypted at rest. |  |
-| **last_update** | **Time** | Last update from SDI. | [optional] |
-| **date_sent** | **Time** | When the invoice was sent to SDI. | [optional] |
-| **documents** | [**Array<DocumentData>**](DocumentData.md) | The invoices included in the payload. This is set by the system, based on the xml content. | [optional] |
+| **last_update** | **Time** | Last update from SDI. | [optional][readonly] |
+| **date_sent** | **Time** | When the invoice was sent to SDI. | [optional][readonly] |
+| **documents** | [**Array<DocumentData>**](DocumentData.md) | The invoices included in the payload. This is set by the system, based on the xml content. | [optional][readonly] |
 | **encoding** | **String** | Whether the payload is Base64 encoded or a plain XML (text). | [optional] |
-| **nome_committente** | **String** | Business name of the committente (client/buyer) extracted from the invoice XML. | [optional] |
+| **nome_committente** | **String** | Business name of the committente (client/buyer) extracted from the invoice XML. | [optional][readonly] |
 | **meta_data** | **Hash<String, String>** | Optional metadata, as json. | [optional] |
+| **latest_state** | **String** | Current SDI state of the invoice. Reflects the most recent update received from SDI. Null when no update has been received yet. | [optional][readonly] |
 | **company** | [**Company**](Company.md) |  | [optional] |
 
 ## Example
@@ -29,7 +30,7 @@
 require 'invoicetronic_sdk'
 
 instance = Invoicetronic_Sdk::ModelSend.new(
-  id: null,
+  id: 0,
   created: null,
   version: null,
   user_id: null,
@@ -37,15 +38,16 @@ instance = Invoicetronic_Sdk::ModelSend.new(
   committente: null,
   prestatore: null,
   identifier: null,
-  file_name: null,
-  format: null,
-  payload: null,
+  file_name: IT01180680397ITRON_00001.xml,
+  format: FPR12,
+  payload: PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48cDpGYXR0dXJhRWxldHRyb25pY2EgLi4uPjwvcDpGYXR0dXJhRWxldHRyb25pY2E+,
   last_update: null,
   date_sent: null,
   documents: null,
   encoding: null,
   nome_committente: null,
-  meta_data: null,
+  meta_data: {"order_id":"ORD-123"},
+  latest_state: null,
   company: null
 )
 ```

data/docs/Receive.md

@@ -4,20 +4,20 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **id** | **Integer** | Unique identifier. Leave it at 0 for new records as it will be set automatically. | [optional] |
-| **created** | **Time** | Creation date. It is set automatically. | [optional] |
-| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional] |
-| **user_id** | **Integer** | User id. | [optional] |
-| **company_id** | **Integer** | Company id. On send, this is the sender and must be set in advance. On receive, it will be automatically set based on the recipient's VAT number. If a matching company is not found, the invoice will be rejected until the company is created. | [optional] |
-| **committente** | **String** | VAT number of the Cessionario/Committente (customer). This is automatically set based on the recipient's VAT number. | [optional] |
-| **prestatore** | **String** | VAT number of the Cedente/Prestatore (vendor). This is automatically set based on the sender's VAT number. | [optional] |
-| **identifier** | **String** | SDI identifier. This is set by the SDI and is guaranteed to be unique within the SDI system. | [optional] |
-| **file_name** | **String** | Xml file name. | [optional] |
+| **id** | **Integer** | Unique identifier. For POST requests, leave it at `0` — the server will assign one automatically. For PUT requests, set it to the id of the record you want to update. | [optional] |
+| **created** | **Time** | Creation date. It is set automatically. | [optional][readonly] |
+| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional][readonly] |
+| **user_id** | **Integer** | User id. It is set automatically based on the authenticated user. | [optional][readonly] |
+| **company_id** | **Integer** | Company id. It is set automatically based on the VAT number extracted from the invoice payload (the sender for `send`, the recipient for `receive`). | [optional][readonly] |
+| **committente** | **String** | VAT number of the Cessionario/Committente (customer). This is automatically set based on the recipient's VAT number. | [optional][readonly] |
+| **prestatore** | **String** | VAT number of the Cedente/Prestatore (vendor). This is automatically set based on the sender's VAT number. | [optional][readonly] |
+| **identifier** | **String** | SDI identifier. This is set by the SDI and is guaranteed to be unique within the SDI system. | [optional][readonly] |
+| **file_name** | **String** | Xml file name. If not provided on send, it will be auto-generated. | [optional] |
 | **format** | **String** | SDI format (FPA12, FPR12, FSM10, ...) | [optional] |
 | **payload** | **String** | Xml payload. This is the actual xml content, as string. On send, it can be base64 encoded. If it's not, it will be encoded before sending. It is guaranteed to be encrypted at rest. |  |
-| **last_update** | **Time** | Last update from SDI. | [optional] |
-| **date_sent** | **Time** | When the invoice was sent to SDI. | [optional] |
-| **documents** | [**Array<DocumentData>**](DocumentData.md) | The invoices included in the payload. This is set by the system, based on the xml content. | [optional] |
+| **last_update** | **Time** | Last update from SDI. | [optional][readonly] |
+| **date_sent** | **Time** | When the invoice was sent to SDI. | [optional][readonly] |
+| **documents** | [**Array<DocumentData>**](DocumentData.md) | The invoices included in the payload. This is set by the system, based on the xml content. | [optional][readonly] |
 | **encoding** | **String** | Whether the payload is Base64 encoded or a plain XML (text). | [optional] |
 | **nome_prestatore** | **String** | Business name of the prestatore (supplier/seller) extracted from the invoice XML. | [optional] |
 | **is_read** | **Boolean** | Whether the invoice has been read at least once. Set to true only when the invoice is requested with include_payload=true. | [optional] |
@@ -29,7 +29,7 @@
 require 'invoicetronic_sdk'
 
 instance = Invoicetronic_Sdk::Receive.new(
-  id: null,
+  id: 0,
   created: null,
   version: null,
   user_id: null,
@@ -37,9 +37,9 @@ instance = Invoicetronic_Sdk::Receive.new(
   committente: null,
   prestatore: null,
   identifier: null,
-  file_name: null,
-  format: null,
-  payload: null,
+  file_name: IT01180680397ITRON_00001.xml,
+  format: FPR12,
+  payload: PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48cDpGYXR0dXJhRWxldHRyb25pY2EgLi4uPjwvcDpGYXR0dXJhRWxldHRyb25pY2E+,
   last_update: null,
   date_sent: null,
   documents: null,

data/docs/ReceiveApi.md

@@ -16,7 +16,7 @@ All URIs are relative to *http://localhost*
 
 List incoming invoices
 
-Retrieve a paginated list of receive invoices. Results can be filtered by various criteria such as company, date ranges, sender, document number, and free-text search (`q`). Returns invoice metadata; set `include_payload` to true to include the full invoice content. Invoices are marked as read (`is_read` = true) only when `include_payload` is true.  **Receive** invoices are inbound purchase invoices received from suppliers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 24 hours in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).
+Retrieve a paginated list of receive invoices. Results can be filtered by various criteria such as company, date ranges, sender, document number, and free-text search (`q`). Returns invoice metadata; set `include_payload` to true to include the full invoice content. Invoices are marked as read (`is_read` = true) only when `include_payload` is true.  **Receive** invoices are inbound purchase invoices received from suppliers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 24 hours in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).  Inbound invoices are routed to your account via the recipient VAT number, so the recipient company must exist in Invoicetronic for the invoice to be matched. If an invoice arrives before its company has been registered, it is held by our SDI infrastructure and automatically re-processed once the company is created—no invoice is lost. See [Prerequisites](https://invoicetronic.com/en/docs/prerequisites/) for the recommended setup order.
 
 ### Examples
 
@@ -122,7 +122,7 @@ end
 
 Delete an incoming invoice by id
 
-Permanently delete a receive invoice by its internal id. This action cannot be undone.  **Receive** invoices are inbound purchase invoices received from suppliers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 24 hours in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).
+Permanently delete a receive invoice by its internal id. This action cannot be undone.  **Receive** invoices are inbound purchase invoices received from suppliers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 24 hours in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).  Inbound invoices are routed to your account via the recipient VAT number, so the recipient company must exist in Invoicetronic for the invoice to be matched. If an invoice arrives before its company has been registered, it is held by our SDI infrastructure and automatically re-processed once the company is created—no invoice is lost. See [Prerequisites](https://invoicetronic.com/en/docs/prerequisites/) for the recommended setup order.
 
 ### Examples
 
@@ -192,7 +192,7 @@ end
 
 Get an incoming invoice by id
 
-Retrieve an incoming invoice by its internal id. The `id` is unique and assigned by the system when the invoice is received. Returns invoice metadata; set `include_payload` to true to include the full invoice content. The invoice is marked as read (`is_read` = true) only when `include_payload` is true.  **Receive** invoices are inbound purchase invoices received from suppliers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 24 hours in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).
+Retrieve an incoming invoice by its internal id. The `id` is unique and assigned by the system when the invoice is received. Returns invoice metadata; set `include_payload` to true to include the full invoice content. The invoice is marked as read (`is_read` = true) only when `include_payload` is true.  **Receive** invoices are inbound purchase invoices received from suppliers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 24 hours in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).  Inbound invoices are routed to your account via the recipient VAT number, so the recipient company must exist in Invoicetronic for the invoice to be matched. If an invoice arrives before its company has been registered, it is held by our SDI infrastructure and automatically re-processed once the company is created—no invoice is lost. See [Prerequisites](https://invoicetronic.com/en/docs/prerequisites/) for the recommended setup order.
 
 ### Examples
 

data/docs/SendApi.md

@@ -24,7 +24,7 @@ All URIs are relative to *http://localhost*
 
 Add an invoice by file
 
-Add a new invoice by uploading a file. Supported formats are XML (FatturaPA) and P7M (signed). The invoice will be signed (if requested), validated (if requested), and queued for delivery to SDI. Status updates from SDI will be available in the `update` endpoint.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).  You can also upload invoices via the [Dashboard](https://dashboard.invoicetronic.com).
+Add a new invoice by uploading a file. Supported formats are XML (FatturaPA) and P7M (signed). The invoice will be signed (if requested), validated (if requested), and queued for delivery to SDI. Status updates from SDI will be available in the `update` endpoint.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).  You can also upload invoices via the [Dashboard](https://dashboard.invoicetronic.com).  ### Idempotency  To protect against duplicate submissions caused by network retries, you can send an optional `Idempotency-Key` header with any unique, client-generated value (up to 255 characters).  - The first request with a given key is processed normally, and its response (status, body and `Location`) is stored for 24 hours. - Any subsequent request that reuses the same key within that window replays the original response instead of sending a second invoice to SDI. - If a request with the same key is still being processed, the retry receives `409 Conflict`. - If the same key is reused with a **different** invoice payload, the request is rejected with `422 Unprocessable Entity`: a given key must always map to the same request.  Keys are scoped per account, so different accounts can use the same key value without interfering. If the idempotency store is temporarily unavailable, the request is processed normally without idempotency protection.
 
 ### Examples
 
@@ -42,7 +42,8 @@ api_instance = Invoicetronic_Sdk::SendApi.new
 file = File.new('/path/to/some/file') # File | 
 opts = {
   validate: true, # Boolean | Validate the document first, and reject it on failure.
-  signature: 'None' # String | Whether to digitally sign the document.
+  signature: 'None', # String | Whether to digitally sign the document.
+  idempotency_key: 'idempotency_key_example' # String | Optional client-generated key that makes the submission idempotent. Retrying the same request with the same key within 24 hours returns the original response instead of creating a duplicate invoice.
 }
 
 begin
@@ -79,6 +80,7 @@ end
 | **file** | **File** |  |  |
 | **validate** | **Boolean** | Validate the document first, and reject it on failure. | [optional][default to false] |
 | **signature** | **String** | Whether to digitally sign the document. | [optional][default to 'Auto'] |
+| **idempotency_key** | **String** | Optional client-generated key that makes the submission idempotent. Retrying the same request with the same key within 24 hours returns the original response instead of creating a duplicate invoice. | [optional] |
 
 ### Return type
 
@@ -100,7 +102,7 @@ end
 
 List invoices
 
-Retrieve a paginated list of send invoices. Results can be filtered by various criteria such as company, date ranges, document number, and free-text search (`q`). Returns invoice metadata; set `include_payload` to true to include the full invoice content.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).
+Retrieve a paginated list of send invoices. Results can be filtered by various criteria such as company, date ranges, document number, current SDI state (`latest_state`), and free-text search (`q`). Use `ids` to fetch specific Send records in a single call (comma-separated, up to 100). Returns invoice metadata; set `include_payload` to true to include the full invoice content.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).
 
 ### Examples
 
@@ -128,7 +130,9 @@ opts = {
   document_date_from: Time.parse('2013-10-20T19:20:30+01:00'), # Time | UTC ISO 8601 (2024-11-29T12:34:56Z)
   document_date_to: Time.parse('2013-10-20T19:20:30+01:00'), # Time | UTC ISO 8601 (2024-11-29T12:34:56Z)
   document_number: 'document_number_example', # String | Document number.
+  latest_state: 'Inviato', # String | Filter by the most recent SDI state for the invoice. Matches the `latest_state` field exposed inline on each Send.
   include_payload: true, # Boolean | Include payload in the response. Defaults to false.
+  ids: 'ids_example', # String | Comma-separated list of Send ids (max 100). Filters the collection to the matching rows; unknown or unauthorized ids are silently skipped.
   page: 56, # Integer | Page number.
   page_size: 56, # Integer | Items per page. Cannot be greater than 200.
   sort: 'sort_example', # String | Sort by field. Prefix with '-' for descending order.
@@ -178,7 +182,9 @@ end
 | **document_date_from** | **Time** | UTC ISO 8601 (2024-11-29T12:34:56Z) | [optional] |
 | **document_date_to** | **Time** | UTC ISO 8601 (2024-11-29T12:34:56Z) | [optional] |
 | **document_number** | **String** | Document number. | [optional] |
+| **latest_state** | **String** | Filter by the most recent SDI state for the invoice. Matches the `latest_state` field exposed inline on each Send. | [optional] |
 | **include_payload** | **Boolean** | Include payload in the response. Defaults to false. | [optional] |
+| **ids** | **String** | Comma-separated list of Send ids (max 100). Filters the collection to the matching rows; unknown or unauthorized ids are silently skipped. | [optional] |
 | **page** | **Integer** | Page number. | [optional][default to 1] |
 | **page_size** | **Integer** | Items per page. Cannot be greater than 200. | [optional][default to 100] |
 | **sort** | **String** | Sort by field. Prefix with '-' for descending order. | [optional] |
@@ -421,7 +427,7 @@ end
 
 Add an invoice by json
 
-Add a new invoice using a FatturaPA JSON representation. The invoice will be signed (if requested), validated (if requested), and queued for delivery to SDI. Status updates from SDI will be available in the `update` endpoint.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).  You can also upload invoices via the [Dashboard](https://dashboard.invoicetronic.com).
+Add a new invoice using a FatturaPA JSON representation. Property names mirror the FatturaPA XML schema (PascalCase, e.g. `FatturaElettronicaHeader`). The invoice will be signed (if requested), validated (if requested), and queued for delivery to SDI. Status updates from SDI will be available in the `update` endpoint.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).  You can also upload invoices via the [Dashboard](https://dashboard.invoicetronic.com).  ### Idempotency  To protect against duplicate submissions caused by network retries, you can send an optional `Idempotency-Key` header with any unique, client-generated value (up to 255 characters).  - The first request with a given key is processed normally, and its response (status, body and `Location`) is stored for 24 hours. - Any subsequent request that reuses the same key within that window replays the original response instead of sending a second invoice to SDI. - If a request with the same key is still being processed, the retry receives `409 Conflict`. - If the same key is reused with a **different** invoice payload, the request is rejected with `422 Unprocessable Entity`: a given key must always map to the same request.  Keys are scoped per account, so different accounts can use the same key value without interfering. If the idempotency store is temporarily unavailable, the request is processed normally without idempotency protection.
 
 ### Examples
 
@@ -439,7 +445,8 @@ api_instance = Invoicetronic_Sdk::SendApi.new
 body = { ... } # Object | 
 opts = {
   validate: true, # Boolean | Validate the document first, and reject it on failure.
-  signature: 'None' # String | Whether to digitally sign the document.
+  signature: 'None', # String | Whether to digitally sign the document.
+  idempotency_key: 'idempotency_key_example' # String | Optional client-generated key that makes the submission idempotent. Retrying the same request with the same key within 24 hours returns the original response instead of creating a duplicate invoice.
 }
 
 begin
@@ -476,6 +483,7 @@ end
 | **body** | **Object** |  |  |
 | **validate** | **Boolean** | Validate the document first, and reject it on failure. | [optional][default to false] |
 | **signature** | **String** | Whether to digitally sign the document. | [optional][default to 'Auto'] |
+| **idempotency_key** | **String** | Optional client-generated key that makes the submission idempotent. Retrying the same request with the same key within 24 hours returns the original response instead of creating a duplicate invoice. | [optional] |
 
 ### Return type
 
@@ -497,7 +505,7 @@ end
 
 Add an invoice
 
-Add a new invoice using a structured Send object. The invoice will be signed (if requested), validated (if requested), and queued for delivery to SDI. Status updates from SDI will be available in the `update` endpoint.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).  You can also upload invoices via the [Dashboard](https://dashboard.invoicetronic.com).
+Add a new invoice using a structured Send object. The invoice will be signed (if requested), validated (if requested), and queued for delivery to SDI. Status updates from SDI will be available in the `update` endpoint.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).  You can also upload invoices via the [Dashboard](https://dashboard.invoicetronic.com).  ### Idempotency  To protect against duplicate submissions caused by network retries, you can send an optional `Idempotency-Key` header with any unique, client-generated value (up to 255 characters).  - The first request with a given key is processed normally, and its response (status, body and `Location`) is stored for 24 hours. - Any subsequent request that reuses the same key within that window replays the original response instead of sending a second invoice to SDI. - If a request with the same key is still being processed, the retry receives `409 Conflict`. - If the same key is reused with a **different** invoice payload, the request is rejected with `422 Unprocessable Entity`: a given key must always map to the same request.  Keys are scoped per account, so different accounts can use the same key value without interfering. If the idempotency store is temporarily unavailable, the request is processed normally without idempotency protection.
 
 ### Examples
 
@@ -512,10 +520,11 @@ Invoicetronic_Sdk.configure do |config|
 end
 
 api_instance = Invoicetronic_Sdk::SendApi.new
-model_send = Invoicetronic_Sdk::ModelSend.new({payload: 'payload_example'}) # ModelSend | 
+model_send = Invoicetronic_Sdk::ModelSend.new({payload: 'PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48cDpGYXR0dXJhRWxldHRyb25pY2EgLi4uPjwvcDpGYXR0dXJhRWxldHRyb25pY2E+'}) # ModelSend | 
 opts = {
   validate: true, # Boolean | Validate the document first, and reject it on failure.
-  signature: 'None' # String | Whether to digitally sign the document.
+  signature: 'None', # String | Whether to digitally sign the document.
+  idempotency_key: 'idempotency_key_example' # String | Optional client-generated key that makes the submission idempotent. Retrying the same request with the same key within 24 hours returns the original response instead of creating a duplicate invoice.
 }
 
 begin
@@ -552,6 +561,7 @@ end
 | **model_send** | [**ModelSend**](ModelSend.md) |  |  |
 | **validate** | **Boolean** | Validate the document first, and reject it on failure. | [optional][default to false] |
 | **signature** | **String** | Whether to digitally sign the document. | [optional][default to 'Auto'] |
+| **idempotency_key** | **String** | Optional client-generated key that makes the submission idempotent. Retrying the same request with the same key within 24 hours returns the original response instead of creating a duplicate invoice. | [optional] |
 
 ### Return type
 
@@ -642,7 +652,7 @@ nil (empty response body)
 
 Validate an invoice by json
 
-Validate a JSON invoice without sending it to SDI. Use this to check for errors before actual submission. Returns validation results with any errors found.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).
+Validate a FatturaPA JSON invoice without sending it to SDI. Property names mirror the FatturaPA XML schema (PascalCase, e.g. `FatturaElettronicaHeader`). Use this to check for errors before actual submission. Returns validation results with any errors found.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).
 
 ### Examples
 
@@ -726,7 +736,7 @@ Invoicetronic_Sdk.configure do |config|
 end
 
 api_instance = Invoicetronic_Sdk::SendApi.new
-model_send = Invoicetronic_Sdk::ModelSend.new({payload: 'payload_example'}) # ModelSend | 
+model_send = Invoicetronic_Sdk::ModelSend.new({payload: 'PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz48cDpGYXR0dXJhRWxldHRyb25pY2EgLi4uPjwvcDpGYXR0dXJhRWxldHRyb25pY2E+'}) # ModelSend | 
 
 begin
   # Validate an invoice
@@ -849,7 +859,7 @@ nil (empty response body)
 
 Add an invoice by xml
 
-Add a new invoice using a raw XML document in FatturaPA format. The invoice will be signed (if requested), validated (if requested), and queued for delivery to SDI. Status updates from SDI will be available in the `update` endpoint.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).  You can also upload invoices via the [Dashboard](https://dashboard.invoicetronic.com).
+Add a new invoice using a raw XML document in FatturaPA format. The invoice will be signed (if requested), validated (if requested), and queued for delivery to SDI. Status updates from SDI will be available in the `update` endpoint.  **Send** invoices are outbound sales invoices transmitted to customers through Italy's SDI (Sistema di Interscambio). Preserved for two years in the live environment and 15 days in the [Sandbox](https://invoicetronic.com/en/docs/sandbox/).  You can also upload invoices via the [Dashboard](https://dashboard.invoicetronic.com).  ### Idempotency  To protect against duplicate submissions caused by network retries, you can send an optional `Idempotency-Key` header with any unique, client-generated value (up to 255 characters).  - The first request with a given key is processed normally, and its response (status, body and `Location`) is stored for 24 hours. - Any subsequent request that reuses the same key within that window replays the original response instead of sending a second invoice to SDI. - If a request with the same key is still being processed, the retry receives `409 Conflict`. - If the same key is reused with a **different** invoice payload, the request is rejected with `422 Unprocessable Entity`: a given key must always map to the same request.  Keys are scoped per account, so different accounts can use the same key value without interfering. If the idempotency store is temporarily unavailable, the request is processed normally without idempotency protection.
 
 ### Examples
 
@@ -867,7 +877,8 @@ api_instance = Invoicetronic_Sdk::SendApi.new
 body = { ... } # Object | 
 opts = {
   validate: true, # Boolean | Validate the document first, and reject it on failure.
-  signature: 'None' # String | Whether to digitally sign the document.
+  signature: 'None', # String | Whether to digitally sign the document.
+  idempotency_key: 'idempotency_key_example' # String | Optional client-generated key that makes the submission idempotent. Retrying the same request with the same key within 24 hours returns the original response instead of creating a duplicate invoice.
 }
 
 begin
@@ -904,6 +915,7 @@ end
 | **body** | **Object** |  |  |
 | **validate** | **Boolean** | Validate the document first, and reject it on failure. | [optional][default to false] |
 | **signature** | **String** | Whether to digitally sign the document. | [optional][default to 'Auto'] |
+| **idempotency_key** | **String** | Optional client-generated key that makes the submission idempotent. Retrying the same request with the same key within 24 hours returns the original response instead of creating a duplicate invoice. | [optional] |
 
 ### Return type
 

data/docs/SendReduced.md

@@ -9,6 +9,7 @@
 | **meta_data** | **Hash<String, String>** | Optional metadata, as json. | [optional] |
 | **documents** | [**Array<DocumentData>**](DocumentData.md) | The invoices included in the payload. | [optional] |
 | **date_sent** | **Time** | When the invoice was sent to SDI. | [optional] |
+| **latest_state** | **String** | Current SDI state of the invoice. Reflects the most recent update received from SDI. | [optional] |
 
 ## Example
 
@@ -20,7 +21,8 @@ instance = Invoicetronic_Sdk::SendReduced.new(
   prestatore: null,
   meta_data: null,
   documents: null,
-  date_sent: null
+  date_sent: null,
+  latest_state: null
 )
 ```
 

data/docs/Status.md

@@ -6,6 +6,8 @@
 | ---- | ---- | ----------- | ----- |
 | **operation_left** | **Integer** | Operations (invoices and validations) left. | [optional] |
 | **signature_left** | **Integer** | Signatures left. | [optional] |
+| **has_active_seat** | **Boolean** | Whether the current API key has an active Desk seat. | [optional] |
+| **is_sub_key** | **Boolean** | Whether the current API key is a sub-key (restricted key). | [optional] |
 
 ## Example
 
@@ -14,7 +16,9 @@ require 'invoicetronic_sdk'
 
 instance = Invoicetronic_Sdk::Status.new(
   operation_left: null,
-  signature_left: null
+  signature_left: null,
+  has_active_seat: null,
+  is_sub_key: null
 )
 ```
 

data/docs/Update.md

@@ -4,9 +4,9 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **id** | **Integer** | Unique identifier. Leave it at 0 for new records as it will be set automatically. | [optional] |
-| **created** | **Time** | Creation date. It is set automatically. | [optional] |
-| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional] |
+| **id** | **Integer** | Unique identifier. For POST requests, leave it at `0` — the server will assign one automatically. For PUT requests, set it to the id of the record you want to update. | [optional] |
+| **created** | **Time** | Creation date. It is set automatically. | [optional][readonly] |
+| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional][readonly] |
 | **user_id** | **Integer** | User id. | [optional] |
 | **company_id** | **Integer** | Company id. | [optional] |
 | **send_id** | **Integer** | Send id. This is the id of the sent invoice to which this update refers to. | [optional] |
@@ -24,7 +24,7 @@
 require 'invoicetronic_sdk'
 
 instance = Invoicetronic_Sdk::Update.new(
-  id: null,
+  id: 0,
   created: null,
   version: null,
   user_id: null,

data/docs/WebHook.md

@@ -4,16 +4,17 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **id** | **Integer** | Unique identifier. Leave it at 0 for new records as it will be set automatically. | [optional] |
-| **created** | **Time** | Creation date. It is set automatically. | [optional] |
-| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional] |
-| **user_id** | **Integer** | User id. | [optional] |
-| **company_id** | **Integer** | Company id. | [optional] |
+| **id** | **Integer** | Unique identifier. For POST requests, leave it at `0` — the server will assign one automatically. For PUT requests, set it to the id of the record you want to update. | [optional] |
+| **created** | **Time** | Creation date. It is set automatically. | [optional][readonly] |
+| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional][readonly] |
+| **user_id** | **Integer** | User id. It is set automatically based on the authenticated user. | [optional][readonly] |
+| **company_id** | **Integer** | Optional company id. If set, the webhook is restricted to events for that company; if omitted, it fires for all companies on the account. | [optional] |
 | **url** | **String** | The url of your application's endpoint that will receive a POST request when the webhook is fired. |  |
 | **enabled** | **Boolean** | Whether the webhook is enabled. On creation, this is set to `true`. | [optional] |
 | **secret** | **String** | The secret used to generate webhook signatures, only returned on creation. You should store this value securely and validate it on every call, to ensure that the caller is InvoicetronicApi. | [optional] |
 | **description** | **String** | An optional description. | [optional] |
 | **events** | **Array<String>** | List of events that trigger the webhook. See Invoicetronic.SupportedEvents.Available for a list of valid event names. | [optional] |
+| **failure_notified_at** | **Time** | Timestamp of the last failure notification email sent for this webhook. Set by the notifier service; reset to null on successful delivery. | [optional][readonly] |
 
 ## Example
 
@@ -21,16 +22,17 @@
 require 'invoicetronic_sdk'
 
 instance = Invoicetronic_Sdk::WebHook.new(
-  id: null,
+  id: 0,
   created: null,
   version: null,
   user_id: null,
-  company_id: null,
-  url: null,
+  company_id: 1,
+  url: https://example.com/webhooks/invoicetronic,
   enabled: null,
-  secret: null,
-  description: null,
-  events: null
+  secret: wh_sec_1a2b3c4d5e6f7g8h9i0j,
+  description: Production webhook,
+  events: ["send.add","receive.add"],
+  failure_notified_at: null
 )
 ```
 

data/docs/WebHookHistory.md

@@ -4,13 +4,14 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **id** | **Integer** | Unique identifier. Leave it at 0 for new records as it will be set automatically. | [optional] |
-| **created** | **Time** | Creation date. It is set automatically. | [optional] |
-| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional] |
+| **id** | **Integer** | Unique identifier. For POST requests, leave it at `0` — the server will assign one automatically. For PUT requests, set it to the id of the record you want to update. | [optional] |
+| **created** | **Time** | Creation date. It is set automatically. | [optional][readonly] |
+| **version** | **Integer** | Row version, for optimistic concurrency. It is set automatically. | [optional][readonly] |
 | **web_hook_id** | **Integer** | Webhook id. | [optional] |
 | **user_id** | **Integer** | User id. | [optional] |
 | **event** | **String** | Event name. | [optional] |
-| **status_code** | **Integer** | Status code. | [optional] |
+| **status_code** | **Integer** | HTTP status code returned by the webhook endpoint. A value of 0 means the request could not be completed due to a network error (e.g., DNS resolution failure, connection refused, or timeout). This typically indicates that the endpoint URL is misconfigured or no longer exists. | [optional] |
+| **error** | **String** | Error description, if any. Null when the delivery is successful (2xx). Contains the exception message for network errors (status code 0) or the response body for non-2xx HTTP responses. | [optional] |
 | **date_time** | **Time** | Date and time of the request. | [optional] |
 | **success** | **Boolean** | Whether the request was successful. | [optional][readonly] |
 
@@ -20,13 +21,14 @@
 require 'invoicetronic_sdk'
 
 instance = Invoicetronic_Sdk::WebHookHistory.new(
-  id: null,
+  id: 0,
   created: null,
   version: null,
   web_hook_id: null,
   user_id: null,
   event: null,
   status_code: null,
+  error: null,
   date_time: null,
   success: null
 )