invoicetronic_sdk 1.6 → 1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fe9df20ce60409f7994cc0669863afa5b3e493ed2e75e527d93cef8f3045af1f
-  data.tar.gz: 9709bfae90291f53906f8a56cfcfd96c254a0ce36dc40da061b572a9f7772646
+  metadata.gz: 3552bf7b33706df5138c817bc21092dd75df818bd9f3002a43d97a5b8d71d8cd
+  data.tar.gz: '03961b3e8d89f3727ce5fd28f8bee81419426dc77a417e0fb9734b133f4a646c'
 SHA512:
-  metadata.gz: 5359789c7d0e8e9b76187da7ddb3e83fef01706be50f0995e5439f66f911e11f8332bc4dfb0c3e465aa5ffabd10f2733402c08859feaf7f432d529074571cda3
-  data.tar.gz: c21a2d60dafe7cb1fb5d555a9c266a0371030c8c5160a1fb9434990c729459022bd4e471cd47e8bfc7691b29be85abb053d274dfcdff2b4a18f3fa6413831996
+  metadata.gz: 78407c0495ed036cb734529eabbdc352f9bb94750eaa23b5fa3cfdb76216d90900cd8732e55e005cf070fd4f7c832e08b7691b541e4ef4c9bb052483280158a8
+  data.tar.gz: 31be69a91c1ba4a70976ae2f477048c25f56e4fcf1a8d89fb6e2bb9a6c2ea1fd81b4a5fbbb092d2ed759b0b31cd4b3ce80a4098f0c2e3f29b8224e5ef7b94b8c

data/CHANGELOG.md

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

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    invoicetronic_sdk (1.6)
+    invoicetronic_sdk (1.8)
       typhoeus (~> 1.0, >= 1.0.1)
 
 GEM
@@ -31,7 +31,7 @@ GEM
     jaro_winkler (1.5.6)
     logger (1.7.0)
     method_source (1.1.0)
-    parallel (1.27.0)
+    parallel (1.28.0)
     parser (3.3.11.1)
       ast (~> 2.4.1)
       racc

data/README.md

@@ -9,8 +9,8 @@ For more information, see  [Invoicetronic website][2]
 
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
-- API version: 1.6.1
-- Package version: 1.6
+- API version: 1.12.0
+- Package version: 1.8
 - 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 +28,16 @@ gem build invoicetronic_sdk.gemspec
 Then either install the gem locally:
 
 ```shell
-gem install ./invoicetronic_sdk-1.6.gem
+gem install ./invoicetronic_sdk-1.8.gem
 ```
 
-(for development, run `gem install --dev ./invoicetronic_sdk-1.6.gem` to install the development dependencies)
+(for development, run `gem install --dev ./invoicetronic_sdk-1.8.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.6'
+    gem 'invoicetronic_sdk', '~> 1.8'
 
 ### Install from Git
 
@@ -61,6 +61,13 @@ Please follow the [installation](#installation) procedure and then run the follo
 # Load the gem
 require 'invoicetronic_sdk'
 
+# Setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR_USERNAME'
+  config.password = 'YOUR_PASSWORD'
+end
+
 api_instance = Invoicetronic_Sdk::CompanyApi.new
 opts = {
   page: 56, # Integer | Page number.

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/CompanyApi.md

@@ -25,6 +25,12 @@ Retrieve a paginated list of companies. Results can be filtered by free-text sea
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::CompanyApi.new
 opts = {
@@ -76,7 +82,7 @@ end
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 
@@ -97,6 +103,12 @@ Delete a company by its internal id.  **Companies** are the entities that send a
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::CompanyApi.new
 id = 56 # Integer | Item id
@@ -144,7 +156,7 @@ end
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 
@@ -165,6 +177,12 @@ Retrieve a company by its internal id.  **Companies** are the entities that send
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::CompanyApi.new
 id = 56 # Integer | Item id
@@ -208,7 +226,7 @@ end
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 
@@ -229,6 +247,12 @@ Add a new company.  **Companies** are the entities that send and receive invoice
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::CompanyApi.new
 company = Invoicetronic_Sdk::Company.new({vat: 'IT01234567891', fiscal_code: 'RSSMRA70A01F205V', name: 'Mario Rossi Srl'}) # Company | 
@@ -272,7 +296,7 @@ end
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 
@@ -293,6 +317,12 @@ Update an existing company.  **Companies** are the entities that send and receiv
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::CompanyApi.new
 company = Invoicetronic_Sdk::Company.new({vat: 'IT01234567891', fiscal_code: 'RSSMRA70A01F205V', name: 'Mario Rossi Srl'}) # Company | 
@@ -336,7 +366,7 @@ end
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 
@@ -357,6 +387,12 @@ Retrieve a company by its VAT number.  **Companies** are the entities that send
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::CompanyApi.new
 vat = 'vat_example' # String | 
@@ -400,7 +436,7 @@ end
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 

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/ExportApi.md

@@ -20,6 +20,12 @@ Export invoices as a ZIP archive of FatturaPA XML files, suitable for import int
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::ExportApi.new
 opts = {
@@ -76,7 +82,7 @@ nil (empty response body)
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 

data/docs/HealthApi.md

@@ -20,6 +20,12 @@ Returns the health status of the API and its dependencies. No authentication req
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::HealthApi.new
 
@@ -59,7 +65,7 @@ nil (empty response body)
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 

data/docs/LogApi.md

@@ -21,6 +21,12 @@ Retrieve a paginated list of log events. Results can be filtered by various crit
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::LogApi.new
 opts = {
@@ -94,7 +100,7 @@ end
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 
@@ -115,6 +121,12 @@ Retrieve a log event by its internal id.  **Logs** record every API request. The
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::LogApi.new
 id = 56 # Integer | Item id
@@ -158,7 +170,7 @@ end
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 

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,13 +16,19 @@ 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
 
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::ReceiveApi.new
 opts = {
@@ -102,7 +108,7 @@ end
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 
@@ -116,13 +122,19 @@ No authorization required
 
 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
 
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::ReceiveApi.new
 id = 56 # Integer | Item id
@@ -166,7 +178,7 @@ end
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 
@@ -180,13 +192,19 @@ No authorization required
 
 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
 
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::ReceiveApi.new
 id = 56 # Integer | Item id
@@ -234,7 +252,7 @@ end
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers
 
@@ -255,6 +273,12 @@ Retrieve only the payload of a receive invoice, without the full invoice metadat
 ```ruby
 require 'time'
 require 'invoicetronic_sdk'
+# setup authorization
+Invoicetronic_Sdk.configure do |config|
+  # Configure HTTP basic authorization: Basic
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'
+end
 
 api_instance = Invoicetronic_Sdk::ReceiveApi.new
 id = 56 # Integer | Item id
@@ -297,7 +321,7 @@ nil (empty response body)
 
 ### Authorization
 
-No authorization required
+[Basic](../README.md#Basic)
 
 ### HTTP request headers