e-invoice-api 0.11.0 → 0.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 13ddd70823e2f224864388289a3822542e2a37fab629216e6c686a68945e63ef
-  data.tar.gz: bb989d57ded23fd2c7bad4f673787589f4bce1bfbbca9699eac8469ab51c68b4
+  metadata.gz: 9f1aa76dde526bb3a6037077c94486fce371fbfc3163f35870d8e2e030105fe8
+  data.tar.gz: 14a5e513da3ce3c5821cb1331aeffd5da50d8bc728fae006d9bef2ceaa87e71e
 SHA512:
-  metadata.gz: 3d6c59349252c242c40dcabde2c33f5f794f1b2f4bd4e0db16f5dfd61da4ec81fcfd8c6fae7b9f3b0658325b68dfe276352fac9823a00f868031b5379db0b008
-  data.tar.gz: b6f9ebe8ab96d759102014be1bed0a1922a0cbab0a6a7626eee608831dc3b666e74576ab57db262f4d85db78fb890ec68dee026bb2e8328b46f3c81b5bcb2b03
+  metadata.gz: c994a981f4a6be764b24708a6c994f4f78a2b138e1643c4cb17a593cb7bb0f942eabf5ea9b5bb2c8a0b053200c3cdba6fc3ab7c5c2c14ab3c2fc0e0e8c5da5f8
+  data.tar.gz: 6afca35923c60ee4183a94712ab4f1c3145794d6718f8c04ffa273a81d4fca02d284334f01b6ec78bb35f008baf1510194076cc2a230ee8ac98d24cdd86f1eee

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.13.0 (2025-11-14)
+
+Full Changelog: [v0.12.0...v0.13.0](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.12.0...v0.13.0)
+
+### Features
+
+* **api:** api update ([6e82f54](https://github.com/e-invoice-be/e-invoice-rb/commit/6e82f5492fbc467157a7a0cf03eaa256b32caa92))
+
+## 0.12.0 (2025-11-14)
+
+Full Changelog: [v0.11.0...v0.12.0](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.11.0...v0.12.0)
+
+### Features
+
+* **api:** api update ([9fdde80](https://github.com/e-invoice-be/e-invoice-rb/commit/9fdde803109f66b3dd5601430345ab5334565650))
+* **api:** api update ([b81b8e8](https://github.com/e-invoice-be/e-invoice-rb/commit/b81b8e8361d82229d444102e37eff951a8989e29))
+
 ## 0.11.0 (2025-11-06)
 
 Full Changelog: [v0.10.1...v0.11.0](https://github.com/e-invoice-be/e-invoice-rb/compare/v0.10.1...v0.11.0)

data/README.md

@@ -17,7 +17,7 @@ To use this gem, install via Bundler by adding the following to your application
 <!-- x-release-please-start-version -->
 
 ```ruby
-gem "e-invoice-api", "~> 0.11.0"
+gem "e-invoice-api", "~> 0.13.0"
 ```
 
 <!-- x-release-please-end -->
@@ -83,7 +83,7 @@ file =
   EInvoiceAPI::FilePart.new(File.read("/path/to/file"), filename: "/path/to/file", content_type: "…")
 response = e_invoice.documents.create_from_pdf(file: file)
 
-puts(response.customer_id)
+puts(response.customer_company_id)
 ```
 
 Note that you can also pass a raw `IO` descriptor, but this disables retries, as the library can't be sure if the descriptor is a file or pipe (which cannot be rewound).

data/lib/e_invoice_api/models/document_create.rb

@@ -11,8 +11,7 @@ module EInvoiceAPI
                nil?: true
 
       # @!attribute amount_due
-      #   The amount due of the invoice. Must be positive and rounded to maximum 2
-      #   decimals
+      #   The amount due for payment. Must be positive and rounded to maximum 2 decimals
       #
       #   @return [Float, String, nil]
       optional :amount_due, union: -> { EInvoiceAPI::DocumentCreate::AmountDue }, nil?: true
@@ -25,11 +24,13 @@ module EInvoiceAPI
                nil?: true
 
       # @!attribute billing_address
+      #   The billing address (if different from customer address)
       #
       #   @return [String, nil]
       optional :billing_address, String, nil?: true
 
       # @!attribute billing_address_recipient
+      #   The recipient name at the billing address
       #
       #   @return [String, nil]
       optional :billing_address_recipient, String, nil?: true
@@ -42,69 +43,88 @@ module EInvoiceAPI
                nil?: true
 
       # @!attribute currency
-      #   Currency of the invoice
+      #   Currency of the invoice (ISO 4217 currency code)
       #
       #   @return [Symbol, EInvoiceAPI::Models::CurrencyCode, nil]
       optional :currency, enum: -> { EInvoiceAPI::CurrencyCode }
 
       # @!attribute customer_address
+      #   The address of the customer/buyer
       #
       #   @return [String, nil]
       optional :customer_address, String, nil?: true
 
       # @!attribute customer_address_recipient
+      #   The recipient name at the customer address
       #
       #   @return [String, nil]
       optional :customer_address_recipient, String, nil?: true
 
+      # @!attribute customer_company_id
+      #   Customer company ID. For Belgium this is the CBE number or their EUID (European
+      #   Unique Identifier) number. In the Netherlands this is the KVK number.
+      #
+      #   @return [String, nil]
+      optional :customer_company_id, String, nil?: true
+
       # @!attribute customer_email
+      #   The email address of the customer
       #
       #   @return [String, nil]
       optional :customer_email, String, nil?: true
 
       # @!attribute customer_id
+      #   The unique identifier for the customer in your system
       #
       #   @return [String, nil]
       optional :customer_id, String, nil?: true
 
       # @!attribute customer_name
+      #   The company name of the customer/buyer
       #
       #   @return [String, nil]
       optional :customer_name, String, nil?: true
 
       # @!attribute customer_tax_id
+      #   Customer tax ID. For Belgium this is the VAT number. Must include the country
+      #   prefix
       #
       #   @return [String, nil]
       optional :customer_tax_id, String, nil?: true
 
       # @!attribute direction
+      #   The direction of the document: INBOUND (purchases) or OUTBOUND (sales)
       #
       #   @return [Symbol, EInvoiceAPI::Models::DocumentDirection, nil]
       optional :direction, enum: -> { EInvoiceAPI::DocumentDirection }
 
       # @!attribute document_type
+      #   The type of document: INVOICE, CREDIT_NOTE, or DEBIT_NOTE
       #
       #   @return [Symbol, EInvoiceAPI::Models::DocumentType, nil]
       optional :document_type, enum: -> { EInvoiceAPI::DocumentType }
 
       # @!attribute due_date
+      #   The date when payment is due
       #
       #   @return [Date, nil]
       optional :due_date, Date, nil?: true
 
       # @!attribute invoice_date
+      #   The date when the invoice was issued
       #
       #   @return [Date, nil]
       optional :invoice_date, Date, nil?: true
 
       # @!attribute invoice_id
+      #   The unique invoice identifier/number
       #
       #   @return [String, nil]
       optional :invoice_id, String, nil?: true
 
       # @!attribute invoice_total
-      #   The total amount of the invoice (so invoice_total = subtotal + total_tax +
-      #   total_discount). Must be positive and rounded to maximum 2 decimals
+      #   The total amount of the invoice including tax (invoice_total = subtotal +
+      #   total_tax + total_discount). Must be positive and rounded to maximum 2 decimals
       #
       #   @return [Float, String, nil]
       optional :invoice_total, union: -> { EInvoiceAPI::DocumentCreate::InvoiceTotal }, nil?: true
@@ -116,6 +136,7 @@ module EInvoiceAPI
       optional :items, -> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::DocumentCreate::Item] }
 
       # @!attribute note
+      #   Additional notes or comments for the invoice
       #
       #   @return [String, nil]
       optional :note, String, nil?: true
@@ -128,13 +149,14 @@ module EInvoiceAPI
                nil?: true
 
       # @!attribute payment_term
+      #   The payment terms (e.g., 'Net 30', 'Due on receipt', '2/10 Net 30')
       #
       #   @return [String, nil]
       optional :payment_term, String, nil?: true
 
       # @!attribute previous_unpaid_balance
-      #   The previous unpaid balance of the invoice, if any. Must be positive and rounded
-      #   to maximum 2 decimals
+      #   The previous unpaid balance from prior invoices, if any. Must be positive and
+      #   rounded to maximum 2 decimals
       #
       #   @return [Float, String, nil]
       optional :previous_unpaid_balance,
@@ -142,51 +164,61 @@ module EInvoiceAPI
                nil?: true
 
       # @!attribute purchase_order
+      #   The purchase order reference number
       #
       #   @return [String, nil]
       optional :purchase_order, String, nil?: true
 
       # @!attribute remittance_address
+      #   The address where payment should be sent or remitted to
       #
       #   @return [String, nil]
       optional :remittance_address, String, nil?: true
 
       # @!attribute remittance_address_recipient
+      #   The recipient name at the remittance address
       #
       #   @return [String, nil]
       optional :remittance_address_recipient, String, nil?: true
 
       # @!attribute service_address
+      #   The address where services were performed or goods were delivered
       #
       #   @return [String, nil]
       optional :service_address, String, nil?: true
 
       # @!attribute service_address_recipient
+      #   The recipient name at the service address
       #
       #   @return [String, nil]
       optional :service_address_recipient, String, nil?: true
 
       # @!attribute service_end_date
+      #   The end date of the service period or delivery period
       #
       #   @return [Date, nil]
       optional :service_end_date, Date, nil?: true
 
       # @!attribute service_start_date
+      #   The start date of the service period or delivery period
       #
       #   @return [Date, nil]
       optional :service_start_date, Date, nil?: true
 
       # @!attribute shipping_address
+      #   The shipping/delivery address
       #
       #   @return [String, nil]
       optional :shipping_address, String, nil?: true
 
       # @!attribute shipping_address_recipient
+      #   The recipient name at the shipping address
       #
       #   @return [String, nil]
       optional :shipping_address_recipient, String, nil?: true
 
       # @!attribute state
+      #   The current state of the document: DRAFT, TRANSIT, FAILED, SENT, or RECEIVED
       #
       #   @return [Symbol, EInvoiceAPI::Models::DocumentState, nil]
       optional :state, enum: -> { EInvoiceAPI::DocumentState }
@@ -200,7 +232,8 @@ module EInvoiceAPI
       optional :subtotal, union: -> { EInvoiceAPI::DocumentCreate::Subtotal }, nil?: true
 
       # @!attribute tax_code
-      #   Tax category code of the invoice
+      #   Tax category code of the invoice (e.g., S for standard rate, Z for zero rate, E
+      #   for exempt)
       #
       #   @return [Symbol, EInvoiceAPI::Models::DocumentCreate::TaxCode, nil]
       optional :tax_code, enum: -> { EInvoiceAPI::DocumentCreate::TaxCode }
@@ -221,7 +254,8 @@ module EInvoiceAPI
       optional :total_discount, union: -> { EInvoiceAPI::DocumentCreate::TotalDiscount }, nil?: true
 
       # @!attribute total_tax
-      #   The total tax of the invoice. Must be positive and rounded to maximum 2 decimals
+      #   The total tax amount of the invoice. Must be positive and rounded to maximum 2
+      #   decimals
       #
       #   @return [Float, String, nil]
       optional :total_tax, union: -> { EInvoiceAPI::DocumentCreate::TotalTax }, nil?: true
@@ -235,131 +269,148 @@ module EInvoiceAPI
       optional :vatex, enum: -> { EInvoiceAPI::DocumentCreate::Vatex }, nil?: true
 
       # @!attribute vatex_note
-      #   VAT exemption note of the invoice
+      #   Textual explanation for VAT exemption
       #
       #   @return [String, nil]
       optional :vatex_note, String, nil?: true
 
       # @!attribute vendor_address
+      #   The address of the vendor/seller
       #
       #   @return [String, nil]
       optional :vendor_address, String, nil?: true
 
       # @!attribute vendor_address_recipient
+      #   The recipient name at the vendor address
       #
       #   @return [String, nil]
       optional :vendor_address_recipient, String, nil?: true
 
+      # @!attribute vendor_company_id
+      #   Vendor company ID. For Belgium this is the CBE number or their EUID (European
+      #   Unique Identifier) number. In the Netherlands this is the KVK number.
+      #
+      #   @return [String, nil]
+      optional :vendor_company_id, String, nil?: true
+
       # @!attribute vendor_email
+      #   The email address of the vendor
       #
       #   @return [String, nil]
       optional :vendor_email, String, nil?: true
 
       # @!attribute vendor_name
+      #   The name of the vendor/seller/supplier
       #
       #   @return [String, nil]
       optional :vendor_name, String, nil?: true
 
       # @!attribute vendor_tax_id
+      #   Vendor tax ID. For Belgium this is the VAT number. Must include the country
+      #   prefix
       #
       #   @return [String, nil]
       optional :vendor_tax_id, String, nil?: true
 
-      # @!method initialize(allowances: nil, amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: nil, charges: nil, currency: nil, customer_address: nil, customer_address_recipient: nil, customer_email: nil, customer_id: nil, customer_name: nil, customer_tax_id: nil, direction: nil, document_type: nil, due_date: nil, invoice_date: nil, invoice_id: nil, invoice_total: nil, items: nil, note: nil, payment_details: nil, payment_term: nil, previous_unpaid_balance: nil, purchase_order: nil, remittance_address: nil, remittance_address_recipient: nil, service_address: nil, service_address_recipient: nil, service_end_date: nil, service_start_date: nil, shipping_address: nil, shipping_address_recipient: nil, state: nil, subtotal: nil, tax_code: nil, tax_details: nil, total_discount: nil, total_tax: nil, vatex: nil, vatex_note: nil, vendor_address: nil, vendor_address_recipient: nil, vendor_email: nil, vendor_name: nil, vendor_tax_id: nil)
+      # @!method initialize(allowances: nil, amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: nil, charges: nil, currency: nil, customer_address: nil, customer_address_recipient: nil, customer_company_id: nil, customer_email: nil, customer_id: nil, customer_name: nil, customer_tax_id: nil, direction: nil, document_type: nil, due_date: nil, invoice_date: nil, invoice_id: nil, invoice_total: nil, items: nil, note: nil, payment_details: nil, payment_term: nil, previous_unpaid_balance: nil, purchase_order: nil, remittance_address: nil, remittance_address_recipient: nil, service_address: nil, service_address_recipient: nil, service_end_date: nil, service_start_date: nil, shipping_address: nil, shipping_address_recipient: nil, state: nil, subtotal: nil, tax_code: nil, tax_details: nil, total_discount: nil, total_tax: nil, vatex: nil, vatex_note: nil, vendor_address: nil, vendor_address_recipient: nil, vendor_company_id: nil, vendor_email: nil, vendor_name: nil, vendor_tax_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {EInvoiceAPI::Models::DocumentCreate} for more details.
       #
       #   @param allowances [Array<EInvoiceAPI::Models::DocumentCreate::Allowance>, nil]
       #
-      #   @param amount_due [Float, String, nil] The amount due of the invoice. Must be positive and rounded to maximum 2 decimal
+      #   @param amount_due [Float, String, nil] The amount due for payment. Must be positive and rounded to maximum 2 decimals
       #
       #   @param attachments [Array<EInvoiceAPI::Models::DocumentAttachmentCreate>, nil]
       #
-      #   @param billing_address [String, nil]
+      #   @param billing_address [String, nil] The billing address (if different from customer address)
       #
-      #   @param billing_address_recipient [String, nil]
+      #   @param billing_address_recipient [String, nil] The recipient name at the billing address
       #
       #   @param charges [Array<EInvoiceAPI::Models::DocumentCreate::Charge>, nil]
       #
-      #   @param currency [Symbol, EInvoiceAPI::Models::CurrencyCode] Currency of the invoice
+      #   @param currency [Symbol, EInvoiceAPI::Models::CurrencyCode] Currency of the invoice (ISO 4217 currency code)
+      #
+      #   @param customer_address [String, nil] The address of the customer/buyer
       #
-      #   @param customer_address [String, nil]
+      #   @param customer_address_recipient [String, nil] The recipient name at the customer address
       #
-      #   @param customer_address_recipient [String, nil]
+      #   @param customer_company_id [String, nil] Customer company ID. For Belgium this is the CBE number or their EUID (European
       #
-      #   @param customer_email [String, nil]
+      #   @param customer_email [String, nil] The email address of the customer
       #
-      #   @param customer_id [String, nil]
+      #   @param customer_id [String, nil] The unique identifier for the customer in your system
       #
-      #   @param customer_name [String, nil]
+      #   @param customer_name [String, nil] The company name of the customer/buyer
       #
-      #   @param customer_tax_id [String, nil]
+      #   @param customer_tax_id [String, nil] Customer tax ID. For Belgium this is the VAT number. Must include the country pr
       #
-      #   @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection]
+      #   @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection] The direction of the document: INBOUND (purchases) or OUTBOUND (sales)
       #
-      #   @param document_type [Symbol, EInvoiceAPI::Models::DocumentType]
+      #   @param document_type [Symbol, EInvoiceAPI::Models::DocumentType] The type of document: INVOICE, CREDIT_NOTE, or DEBIT_NOTE
       #
-      #   @param due_date [Date, nil]
+      #   @param due_date [Date, nil] The date when payment is due
       #
-      #   @param invoice_date [Date, nil]
+      #   @param invoice_date [Date, nil] The date when the invoice was issued
       #
-      #   @param invoice_id [String, nil]
+      #   @param invoice_id [String, nil] The unique invoice identifier/number
       #
-      #   @param invoice_total [Float, String, nil] The total amount of the invoice (so invoice_total = subtotal + total_tax + total
+      #   @param invoice_total [Float, String, nil] The total amount of the invoice including tax (invoice*total = subtotal + total*
       #
       #   @param items [Array<EInvoiceAPI::Models::DocumentCreate::Item>] At least one line item is required
       #
-      #   @param note [String, nil]
+      #   @param note [String, nil] Additional notes or comments for the invoice
       #
       #   @param payment_details [Array<EInvoiceAPI::Models::PaymentDetailCreate>, nil]
       #
-      #   @param payment_term [String, nil]
+      #   @param payment_term [String, nil] The payment terms (e.g., 'Net 30', 'Due on receipt', '2/10 Net 30')
       #
-      #   @param previous_unpaid_balance [Float, String, nil] The previous unpaid balance of the invoice, if any. Must be positive and rounded
+      #   @param previous_unpaid_balance [Float, String, nil] The previous unpaid balance from prior invoices, if any. Must be positive and ro
       #
-      #   @param purchase_order [String, nil]
+      #   @param purchase_order [String, nil] The purchase order reference number
       #
-      #   @param remittance_address [String, nil]
+      #   @param remittance_address [String, nil] The address where payment should be sent or remitted to
       #
-      #   @param remittance_address_recipient [String, nil]
+      #   @param remittance_address_recipient [String, nil] The recipient name at the remittance address
       #
-      #   @param service_address [String, nil]
+      #   @param service_address [String, nil] The address where services were performed or goods were delivered
       #
-      #   @param service_address_recipient [String, nil]
+      #   @param service_address_recipient [String, nil] The recipient name at the service address
       #
-      #   @param service_end_date [Date, nil]
+      #   @param service_end_date [Date, nil] The end date of the service period or delivery period
       #
-      #   @param service_start_date [Date, nil]
+      #   @param service_start_date [Date, nil] The start date of the service period or delivery period
       #
-      #   @param shipping_address [String, nil]
+      #   @param shipping_address [String, nil] The shipping/delivery address
       #
-      #   @param shipping_address_recipient [String, nil]
+      #   @param shipping_address_recipient [String, nil] The recipient name at the shipping address
       #
-      #   @param state [Symbol, EInvoiceAPI::Models::DocumentState]
+      #   @param state [Symbol, EInvoiceAPI::Models::DocumentState] The current state of the document: DRAFT, TRANSIT, FAILED, SENT, or RECEIVED
       #
       #   @param subtotal [Float, String, nil] The taxable base of the invoice. Should be the sum of all line items - allowance
       #
-      #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreate::TaxCode] Tax category code of the invoice
+      #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreate::TaxCode] Tax category code of the invoice (e.g., S for standard rate, Z for zero rate, E
       #
       #   @param tax_details [Array<EInvoiceAPI::Models::DocumentCreate::TaxDetail>, nil]
       #
       #   @param total_discount [Float, String, nil] The net financial discount/charge of the invoice (non-VAT charges minus non-VAT
       #
-      #   @param total_tax [Float, String, nil] The total tax of the invoice. Must be positive and rounded to maximum 2 decimals
+      #   @param total_tax [Float, String, nil] The total tax amount of the invoice. Must be positive and rounded to maximum 2 d
       #
       #   @param vatex [Symbol, EInvoiceAPI::Models::DocumentCreate::Vatex, nil] VATEX code list for VAT exemption reasons
       #
-      #   @param vatex_note [String, nil] VAT exemption note of the invoice
+      #   @param vatex_note [String, nil] Textual explanation for VAT exemption
       #
-      #   @param vendor_address [String, nil]
+      #   @param vendor_address [String, nil] The address of the vendor/seller
       #
-      #   @param vendor_address_recipient [String, nil]
+      #   @param vendor_address_recipient [String, nil] The recipient name at the vendor address
       #
-      #   @param vendor_email [String, nil]
+      #   @param vendor_company_id [String, nil] Vendor company ID. For Belgium this is the CBE number or their EUID (European Un
       #
-      #   @param vendor_name [String, nil]
+      #   @param vendor_email [String, nil] The email address of the vendor
       #
-      #   @param vendor_tax_id [String, nil]
+      #   @param vendor_name [String, nil] The name of the vendor/seller/supplier
+      #
+      #   @param vendor_tax_id [String, nil] Vendor tax ID. For Belgium this is the VAT number. Must include the country pref
 
       class Allowance < EInvoiceAPI::Internal::Type::BaseModel
         # @!attribute amount
@@ -498,8 +549,7 @@ module EInvoiceAPI
         end
       end
 
-      # The amount due of the invoice. Must be positive and rounded to maximum 2
-      # decimals
+      # The amount due for payment. Must be positive and rounded to maximum 2 decimals
       #
       # @see EInvoiceAPI::Models::DocumentCreate#amount_due
       module AmountDue
@@ -650,8 +700,8 @@ module EInvoiceAPI
         end
       end
 
-      # The total amount of the invoice (so invoice_total = subtotal + total_tax +
-      # total_discount). Must be positive and rounded to maximum 2 decimals
+      # The total amount of the invoice including tax (invoice_total = subtotal +
+      # total_tax + total_discount). Must be positive and rounded to maximum 2 decimals
       #
       # @see EInvoiceAPI::Models::DocumentCreate#invoice_total
       module InvoiceTotal
@@ -1106,8 +1156,8 @@ module EInvoiceAPI
         end
       end
 
-      # The previous unpaid balance of the invoice, if any. Must be positive and rounded
-      # to maximum 2 decimals
+      # The previous unpaid balance from prior invoices, if any. Must be positive and
+      # rounded to maximum 2 decimals
       #
       # @see EInvoiceAPI::Models::DocumentCreate#previous_unpaid_balance
       module PreviousUnpaidBalance
@@ -1137,7 +1187,8 @@ module EInvoiceAPI
         #   @return [Array(Float, String)]
       end
 
-      # Tax category code of the invoice
+      # Tax category code of the invoice (e.g., S for standard rate, Z for zero rate, E
+      # for exempt)
       #
       # @see EInvoiceAPI::Models::DocumentCreate#tax_code
       module TaxCode
@@ -1160,19 +1211,24 @@ module EInvoiceAPI
 
       class TaxDetail < EInvoiceAPI::Internal::Type::BaseModel
         # @!attribute amount
+        #   The tax amount for this tax category. Must be rounded to maximum 2 decimals
         #
         #   @return [Float, String, nil]
         optional :amount, union: -> { EInvoiceAPI::DocumentCreate::TaxDetail::Amount }, nil?: true
 
         # @!attribute rate
+        #   The tax rate as a percentage (e.g., '21.00', '6.00', '0.00')
         #
         #   @return [String, nil]
         optional :rate, String, nil?: true
 
         # @!method initialize(amount: nil, rate: nil)
-        #   @param amount [Float, String, nil]
-        #   @param rate [String, nil]
+        #   @param amount [Float, String, nil] The tax amount for this tax category. Must be rounded to maximum 2 decimals
+        #
+        #   @param rate [String, nil] The tax rate as a percentage (e.g., '21.00', '6.00', '0.00')
 
+        # The tax amount for this tax category. Must be rounded to maximum 2 decimals
+        #
         # @see EInvoiceAPI::Models::DocumentCreate::TaxDetail#amount
         module Amount
           extend EInvoiceAPI::Internal::Type::Union
@@ -1202,7 +1258,8 @@ module EInvoiceAPI
         #   @return [Array(Float, String)]
       end
 
-      # The total tax of the invoice. Must be positive and rounded to maximum 2 decimals
+      # The total tax amount of the invoice. Must be positive and rounded to maximum 2
+      # decimals
       #
       # @see EInvoiceAPI::Models::DocumentCreate#total_tax
       module TotalTax