e-invoice-api 0.11.0 → 0.12.0

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
@@ -377,7 +428,8 @@ module EInvoiceAPI
 
         # @!attribute multiplier_factor
         #   The percentage that may be used, in conjunction with the allowance base amount,
-        #   to calculate the allowance amount. To state 20%, use value 20
+        #   to calculate the allowance amount. To state 20%, use value 20. Must be rounded
+        #   to maximum 2 decimals
         #
         #   @return [Float, String, nil]
         optional :multiplier_factor,
@@ -391,24 +443,23 @@ module EInvoiceAPI
         optional :reason, String, nil?: true
 
         # @!attribute reason_code
-        #   The code for the allowance reason
+        #   Allowance reason codes for invoice discounts and charges
         #
-        #   @return [String, nil]
-        optional :reason_code, String, nil?: true
+        #   @return [Symbol, EInvoiceAPI::Models::DocumentCreate::Allowance::ReasonCode, nil]
+        optional :reason_code, enum: -> { EInvoiceAPI::DocumentCreate::Allowance::ReasonCode }, nil?: true
 
         # @!attribute tax_code
-        #   Duty or tax or fee category codes (Subset of UNCL5305)
-        #
-        #   Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
+        #   The VAT category code that applies to the allowance
         #
         #   @return [Symbol, EInvoiceAPI::Models::DocumentCreate::Allowance::TaxCode, nil]
-        optional :tax_code, enum: -> { EInvoiceAPI::DocumentCreate::Allowance::TaxCode }, nil?: true
+        optional :tax_code, enum: -> { EInvoiceAPI::DocumentCreate::Allowance::TaxCode }
 
         # @!attribute tax_rate
-        #   The VAT rate, represented as percentage that applies to the allowance
+        #   The VAT rate, represented as percentage that applies to the allowance. Must be
+        #   rounded to maximum 2 decimals
         #
-        #   @return [String, nil]
-        optional :tax_rate, String, nil?: true
+        #   @return [Float, String, nil]
+        optional :tax_rate, union: -> { EInvoiceAPI::DocumentCreate::Allowance::TaxRate }, nil?: true
 
         # @!method initialize(amount: nil, base_amount: nil, multiplier_factor: nil, reason: nil, reason_code: nil, tax_code: nil, tax_rate: nil)
         #   Some parameter documentations has been truncated, see
@@ -424,11 +475,11 @@ module EInvoiceAPI
         #
         #   @param reason [String, nil] The reason for the allowance
         #
-        #   @param reason_code [String, nil] The code for the allowance reason
+        #   @param reason_code [Symbol, EInvoiceAPI::Models::DocumentCreate::Allowance::ReasonCode, nil] Allowance reason codes for invoice discounts and charges
         #
-        #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreate::Allowance::TaxCode, nil] Duty or tax or fee category codes (Subset of UNCL5305)
+        #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreate::Allowance::TaxCode] The VAT category code that applies to the allowance
         #
-        #   @param tax_rate [String, nil] The VAT rate, represented as percentage that applies to the allowance
+        #   @param tax_rate [Float, String, nil] The VAT rate, represented as percentage that applies to the allowance. Must be r
 
         # The allowance amount, without VAT. Must be rounded to maximum 2 decimals
         #
@@ -460,7 +511,8 @@ module EInvoiceAPI
         end
 
         # The percentage that may be used, in conjunction with the allowance base amount,
-        # to calculate the allowance amount. To state 20%, use value 20
+        # to calculate the allowance amount. To state 20%, use value 20. Must be rounded
+        # to maximum 2 decimals
         #
         # @see EInvoiceAPI::Models::DocumentCreate::Allowance#multiplier_factor
         module MultiplierFactor
@@ -474,9 +526,37 @@ module EInvoiceAPI
           #   @return [Array(Float, String)]
         end
 
-        # Duty or tax or fee category codes (Subset of UNCL5305)
+        # Allowance reason codes for invoice discounts and charges
         #
-        # Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
+        # @see EInvoiceAPI::Models::DocumentCreate::Allowance#reason_code
+        module ReasonCode
+          extend EInvoiceAPI::Internal::Type::Enum
+
+          REASON_CODE_41 = :"41"
+          REASON_CODE_42 = :"42"
+          REASON_CODE_60 = :"60"
+          REASON_CODE_62 = :"62"
+          REASON_CODE_63 = :"63"
+          REASON_CODE_64 = :"64"
+          REASON_CODE_65 = :"65"
+          REASON_CODE_66 = :"66"
+          REASON_CODE_67 = :"67"
+          REASON_CODE_68 = :"68"
+          REASON_CODE_70 = :"70"
+          REASON_CODE_71 = :"71"
+          REASON_CODE_88 = :"88"
+          REASON_CODE_95 = :"95"
+          REASON_CODE_100 = :"100"
+          REASON_CODE_102 = :"102"
+          REASON_CODE_103 = :"103"
+          REASON_CODE_104 = :"104"
+          REASON_CODE_105 = :"105"
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # The VAT category code that applies to the allowance
         #
         # @see EInvoiceAPI::Models::DocumentCreate::Allowance#tax_code
         module TaxCode
@@ -496,10 +576,24 @@ module EInvoiceAPI
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # The VAT rate, represented as percentage that applies to the allowance. Must be
+        # rounded to maximum 2 decimals
+        #
+        # @see EInvoiceAPI::Models::DocumentCreate::Allowance#tax_rate
+        module TaxRate
+          extend EInvoiceAPI::Internal::Type::Union
+
+          variant Float
+
+          variant String
+
+          # @!method self.variants
+          #   @return [Array(Float, String)]
+        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
@@ -543,10 +637,10 @@ module EInvoiceAPI
         optional :reason, String, nil?: true
 
         # @!attribute reason_code
-        #   The code for the charge reason
+        #   Charge reason codes for invoice charges and fees
         #
-        #   @return [String, nil]
-        optional :reason_code, String, nil?: true
+        #   @return [Symbol, EInvoiceAPI::Models::DocumentCreate::Charge::ReasonCode, nil]
+        optional :reason_code, enum: -> { EInvoiceAPI::DocumentCreate::Charge::ReasonCode }, nil?: true
 
         # @!attribute tax_code
         #   Duty or tax or fee category codes (Subset of UNCL5305)
@@ -559,8 +653,8 @@ module EInvoiceAPI
         # @!attribute tax_rate
         #   The VAT rate, represented as percentage that applies to the charge
         #
-        #   @return [String, nil]
-        optional :tax_rate, String, nil?: true
+        #   @return [Float, String, nil]
+        optional :tax_rate, union: -> { EInvoiceAPI::DocumentCreate::Charge::TaxRate }, nil?: true
 
         # @!method initialize(amount: nil, base_amount: nil, multiplier_factor: nil, reason: nil, reason_code: nil, tax_code: nil, tax_rate: nil)
         #   Some parameter documentations has been truncated, see
@@ -576,11 +670,11 @@ module EInvoiceAPI
         #
         #   @param reason [String, nil] The reason for the charge
         #
-        #   @param reason_code [String, nil] The code for the charge reason
+        #   @param reason_code [Symbol, EInvoiceAPI::Models::DocumentCreate::Charge::ReasonCode, nil] Charge reason codes for invoice charges and fees
         #
         #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreate::Charge::TaxCode, nil] Duty or tax or fee category codes (Subset of UNCL5305)
         #
-        #   @param tax_rate [String, nil] The VAT rate, represented as percentage that applies to the charge
+        #   @param tax_rate [Float, String, nil] The VAT rate, represented as percentage that applies to the charge
 
         # The charge amount, without VAT. Must be rounded to maximum 2 decimals
         #
@@ -626,6 +720,195 @@ module EInvoiceAPI
           #   @return [Array(Float, String)]
         end
 
+        # Charge reason codes for invoice charges and fees
+        #
+        # @see EInvoiceAPI::Models::DocumentCreate::Charge#reason_code
+        module ReasonCode
+          extend EInvoiceAPI::Internal::Type::Enum
+
+          AA = :AA
+          AAA = :AAA
+          AAC = :AAC
+          AAD = :AAD
+          AAE = :AAE
+          AAF = :AAF
+          AAH = :AAH
+          AAI = :AAI
+          AAS = :AAS
+          AAT = :AAT
+          AAV = :AAV
+          AAY = :AAY
+          AAZ = :AAZ
+          ABA = :ABA
+          ABB = :ABB
+          ABC = :ABC
+          ABD = :ABD
+          ABF = :ABF
+          ABK = :ABK
+          ABL = :ABL
+          ABN = :ABN
+          ABR = :ABR
+          ABS = :ABS
+          ABT = :ABT
+          ABU = :ABU
+          ACF = :ACF
+          ACG = :ACG
+          ACH = :ACH
+          ACI = :ACI
+          ACJ = :ACJ
+          ACK = :ACK
+          ACL = :ACL
+          ACM = :ACM
+          ACS = :ACS
+          ADC = :ADC
+          ADE = :ADE
+          ADJ = :ADJ
+          ADK = :ADK
+          ADL = :ADL
+          ADM = :ADM
+          ADN = :ADN
+          ADO = :ADO
+          ADP = :ADP
+          ADQ = :ADQ
+          ADR = :ADR
+          ADT = :ADT
+          ADW = :ADW
+          ADY = :ADY
+          ADZ = :ADZ
+          AEA = :AEA
+          AEB = :AEB
+          AEC = :AEC
+          AED = :AED
+          AEF = :AEF
+          AEH = :AEH
+          AEI = :AEI
+          AEJ = :AEJ
+          AEK = :AEK
+          AEL = :AEL
+          AEM = :AEM
+          AEN = :AEN
+          AEO = :AEO
+          AEP = :AEP
+          AES = :AES
+          AET = :AET
+          AEU = :AEU
+          AEV = :AEV
+          AEW = :AEW
+          AEX = :AEX
+          AEY = :AEY
+          AEZ = :AEZ
+          AJ = :AJ
+          AU = :AU
+          CA = :CA
+          CAB = :CAB
+          CAD = :CAD
+          CAE = :CAE
+          CAF = :CAF
+          CAI = :CAI
+          CAJ = :CAJ
+          CAK = :CAK
+          CAL = :CAL
+          CAM = :CAM
+          CAN = :CAN
+          CAO = :CAO
+          CAP = :CAP
+          CAQ = :CAQ
+          CAR = :CAR
+          CAS = :CAS
+          CAT = :CAT
+          CAU = :CAU
+          CAV = :CAV
+          CAW = :CAW
+          CAX = :CAX
+          CAY = :CAY
+          CAZ = :CAZ
+          CD = :CD
+          CG = :CG
+          CS = :CS
+          CT = :CT
+          DAB = :DAB
+          DAC = :DAC
+          DAD = :DAD
+          DAF = :DAF
+          DAG = :DAG
+          DAH = :DAH
+          DAI = :DAI
+          DAJ = :DAJ
+          DAK = :DAK
+          DAL = :DAL
+          DAM = :DAM
+          DAN = :DAN
+          DAO = :DAO
+          DAP = :DAP
+          DAQ = :DAQ
+          DL = :DL
+          EG = :EG
+          EP = :EP
+          ER = :ER
+          FAA = :FAA
+          FAB = :FAB
+          FAC = :FAC
+          FC = :FC
+          FH = :FH
+          FI = :FI
+          GAA = :GAA
+          HAA = :HAA
+          HD = :HD
+          HH = :HH
+          IAA = :IAA
+          IAB = :IAB
+          ID = :ID
+          IF = :IF
+          IR = :IR
+          IS = :IS
+          KO = :KO
+          L1 = :L1
+          LA = :LA
+          LAA = :LAA
+          LAB = :LAB
+          LF = :LF
+          MAE = :MAE
+          MI = :MI
+          ML = :ML
+          NAA = :NAA
+          OA = :OA
+          PA = :PA
+          PAA = :PAA
+          PC = :PC
+          PL = :PL
+          PRV = :PRV
+          RAB = :RAB
+          RAC = :RAC
+          RAD = :RAD
+          RAF = :RAF
+          RE = :RE
+          RF = :RF
+          RH = :RH
+          RV = :RV
+          SA = :SA
+          SAA = :SAA
+          SAD = :SAD
+          SAE = :SAE
+          SAI = :SAI
+          SG = :SG
+          SH = :SH
+          SM = :SM
+          SU = :SU
+          TAB = :TAB
+          TAC = :TAC
+          TT = :TT
+          TV = :TV
+          V1 = :V1
+          V2 = :V2
+          WH = :WH
+          XAA = :XAA
+          YY = :YY
+          ZZZ = :ZZZ
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
         # Duty or tax or fee category codes (Subset of UNCL5305)
         #
         # Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
@@ -648,10 +931,24 @@ module EInvoiceAPI
           # @!method self.values
           #   @return [Array<Symbol>]
         end
+
+        # The VAT rate, represented as percentage that applies to the charge
+        #
+        # @see EInvoiceAPI::Models::DocumentCreate::Charge#tax_rate
+        module TaxRate
+          extend EInvoiceAPI::Internal::Type::Union
+
+          variant Float
+
+          variant String
+
+          # @!method self.variants
+          #   @return [Array(Float, String)]
+        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
@@ -675,9 +972,9 @@ module EInvoiceAPI
                  nil?: true
 
         # @!attribute amount
-        #   The total amount of the line item, exclusive of VAT, after subtracting line
-        #   level allowances and adding line level charges. Must be rounded to maximum 2
-        #   decimals
+        #   The invoice line net amount (BT-131), exclusive of VAT, inclusive of line level
+        #   allowances and charges. Calculated as: ((unit_price / price_base_quantity) \*
+        #   quantity) - allowances + charges. Must be rounded to maximum 2 decimals
         #
         #   @return [Float, String, nil]
         optional :amount, union: -> { EInvoiceAPI::DocumentCreate::Item::Amount }, nil?: true
@@ -701,6 +998,15 @@ module EInvoiceAPI
         #   @return [String, nil]
         optional :description, String, nil?: true
 
+        # @!attribute price_base_quantity
+        #   The item price base quantity (BT-149). The number of item units to which the
+        #   price applies. Defaults to 1. Must be rounded to maximum 4 decimals
+        #
+        #   @return [Float, String, nil]
+        optional :price_base_quantity,
+                 union: -> { EInvoiceAPI::DocumentCreate::Item::PriceBaseQuantity },
+                 nil?: true
+
         # @!attribute product_code
         #   The product code of the line item.
         #
@@ -723,8 +1029,8 @@ module EInvoiceAPI
         # @!attribute tax_rate
         #   The VAT rate of the line item expressed as percentage with 2 decimals
         #
-        #   @return [String, nil]
-        optional :tax_rate, String, nil?: true
+        #   @return [Float, String, nil]
+        optional :tax_rate, union: -> { EInvoiceAPI::DocumentCreate::Item::TaxRate }, nil?: true
 
         # @!attribute unit
         #   Unit of Measure Codes from UNECERec20 used in Peppol BIS Billing 3.0.
@@ -733,18 +1039,19 @@ module EInvoiceAPI
         optional :unit, enum: -> { EInvoiceAPI::UnitOfMeasureCode }, nil?: true
 
         # @!attribute unit_price
-        #   The unit price of the line item. Must be rounded to maximum 2 decimals
+        #   The item net price (BT-146). The price of an item, exclusive of VAT, after
+        #   subtracting item price discount. Must be rounded to maximum 4 decimals
         #
         #   @return [Float, String, nil]
         optional :unit_price, union: -> { EInvoiceAPI::DocumentCreate::Item::UnitPrice }, nil?: true
 
-        # @!method initialize(allowances: nil, amount: nil, charges: nil, date: nil, description: nil, product_code: nil, quantity: nil, tax: nil, tax_rate: nil, unit: nil, unit_price: nil)
+        # @!method initialize(allowances: nil, amount: nil, charges: nil, date: nil, description: nil, price_base_quantity: nil, product_code: nil, quantity: nil, tax: nil, tax_rate: nil, unit: nil, unit_price: nil)
         #   Some parameter documentations has been truncated, see
         #   {EInvoiceAPI::Models::DocumentCreate::Item} for more details.
         #
         #   @param allowances [Array<EInvoiceAPI::Models::DocumentCreate::Item::Allowance>, nil] The allowances of the line item.
         #
-        #   @param amount [Float, String, nil] The total amount of the line item, exclusive of VAT, after subtracting line leve
+        #   @param amount [Float, String, nil] The invoice line net amount (BT-131), exclusive of VAT, inclusive of line level
         #
         #   @param charges [Array<EInvoiceAPI::Models::DocumentCreate::Item::Charge>, nil] The charges of the line item.
         #
@@ -752,17 +1059,19 @@ module EInvoiceAPI
         #
         #   @param description [String, nil] The description of the line item.
         #
+        #   @param price_base_quantity [Float, String, nil] The item price base quantity (BT-149). The number of item units to which the pri
+        #
         #   @param product_code [String, nil] The product code of the line item.
         #
         #   @param quantity [Float, String, nil] The quantity of items (goods or services) that is the subject of the line item.
         #
         #   @param tax [Float, String, nil] The total VAT amount for the line item. Must be rounded to maximum 2 decimals
         #
-        #   @param tax_rate [String, nil] The VAT rate of the line item expressed as percentage with 2 decimals
+        #   @param tax_rate [Float, String, nil] The VAT rate of the line item expressed as percentage with 2 decimals
         #
         #   @param unit [Symbol, EInvoiceAPI::Models::UnitOfMeasureCode, nil] Unit of Measure Codes from UNECERec20 used in Peppol BIS Billing 3.0.
         #
-        #   @param unit_price [Float, String, nil] The unit price of the line item. Must be rounded to maximum 2 decimals
+        #   @param unit_price [Float, String, nil] The item net price (BT-146). The price of an item, exclusive of VAT, after subtr
 
         class Allowance < EInvoiceAPI::Internal::Type::BaseModel
           # @!attribute amount
@@ -784,7 +1093,8 @@ module EInvoiceAPI
 
           # @!attribute multiplier_factor
           #   The percentage that may be used, in conjunction with the allowance base amount,
-          #   to calculate the allowance amount. To state 20%, use value 20
+          #   to calculate the allowance amount. To state 20%, use value 20. Must be rounded
+          #   to maximum 2 decimals
           #
           #   @return [Float, String, nil]
           optional :multiplier_factor,
@@ -798,24 +1108,27 @@ module EInvoiceAPI
           optional :reason, String, nil?: true
 
           # @!attribute reason_code
-          #   The code for the allowance reason
+          #   Allowance reason codes for invoice discounts and charges
           #
-          #   @return [String, nil]
-          optional :reason_code, String, nil?: true
+          #   @return [Symbol, EInvoiceAPI::Models::DocumentCreate::Item::Allowance::ReasonCode, nil]
+          optional :reason_code,
+                   enum: -> {
+                     EInvoiceAPI::DocumentCreate::Item::Allowance::ReasonCode
+                   },
+                   nil?: true
 
           # @!attribute tax_code
-          #   Duty or tax or fee category codes (Subset of UNCL5305)
-          #
-          #   Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
+          #   The VAT category code that applies to the allowance
           #
           #   @return [Symbol, EInvoiceAPI::Models::DocumentCreate::Item::Allowance::TaxCode, nil]
-          optional :tax_code, enum: -> { EInvoiceAPI::DocumentCreate::Item::Allowance::TaxCode }, nil?: true
+          optional :tax_code, enum: -> { EInvoiceAPI::DocumentCreate::Item::Allowance::TaxCode }
 
           # @!attribute tax_rate
-          #   The VAT rate, represented as percentage that applies to the allowance
+          #   The VAT rate, represented as percentage that applies to the allowance. Must be
+          #   rounded to maximum 2 decimals
           #
-          #   @return [String, nil]
-          optional :tax_rate, String, nil?: true
+          #   @return [Float, String, nil]
+          optional :tax_rate, union: -> { EInvoiceAPI::DocumentCreate::Item::Allowance::TaxRate }, nil?: true
 
           # @!method initialize(amount: nil, base_amount: nil, multiplier_factor: nil, reason: nil, reason_code: nil, tax_code: nil, tax_rate: nil)
           #   Some parameter documentations has been truncated, see
@@ -831,11 +1144,11 @@ module EInvoiceAPI
           #
           #   @param reason [String, nil] The reason for the allowance
           #
-          #   @param reason_code [String, nil] The code for the allowance reason
+          #   @param reason_code [Symbol, EInvoiceAPI::Models::DocumentCreate::Item::Allowance::ReasonCode, nil] Allowance reason codes for invoice discounts and charges
           #
-          #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreate::Item::Allowance::TaxCode, nil] Duty or tax or fee category codes (Subset of UNCL5305)
+          #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreate::Item::Allowance::TaxCode] The VAT category code that applies to the allowance
           #
-          #   @param tax_rate [String, nil] The VAT rate, represented as percentage that applies to the allowance
+          #   @param tax_rate [Float, String, nil] The VAT rate, represented as percentage that applies to the allowance. Must be r
 
           # The allowance amount, without VAT. Must be rounded to maximum 2 decimals
           #
@@ -867,7 +1180,8 @@ module EInvoiceAPI
           end
 
           # The percentage that may be used, in conjunction with the allowance base amount,
-          # to calculate the allowance amount. To state 20%, use value 20
+          # to calculate the allowance amount. To state 20%, use value 20. Must be rounded
+          # to maximum 2 decimals
           #
           # @see EInvoiceAPI::Models::DocumentCreate::Item::Allowance#multiplier_factor
           module MultiplierFactor
@@ -881,9 +1195,37 @@ module EInvoiceAPI
             #   @return [Array(Float, String)]
           end
 
-          # Duty or tax or fee category codes (Subset of UNCL5305)
+          # Allowance reason codes for invoice discounts and charges
           #
-          # Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
+          # @see EInvoiceAPI::Models::DocumentCreate::Item::Allowance#reason_code
+          module ReasonCode
+            extend EInvoiceAPI::Internal::Type::Enum
+
+            REASON_CODE_41 = :"41"
+            REASON_CODE_42 = :"42"
+            REASON_CODE_60 = :"60"
+            REASON_CODE_62 = :"62"
+            REASON_CODE_63 = :"63"
+            REASON_CODE_64 = :"64"
+            REASON_CODE_65 = :"65"
+            REASON_CODE_66 = :"66"
+            REASON_CODE_67 = :"67"
+            REASON_CODE_68 = :"68"
+            REASON_CODE_70 = :"70"
+            REASON_CODE_71 = :"71"
+            REASON_CODE_88 = :"88"
+            REASON_CODE_95 = :"95"
+            REASON_CODE_100 = :"100"
+            REASON_CODE_102 = :"102"
+            REASON_CODE_103 = :"103"
+            REASON_CODE_104 = :"104"
+            REASON_CODE_105 = :"105"
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
+          # The VAT category code that applies to the allowance
           #
           # @see EInvoiceAPI::Models::DocumentCreate::Item::Allowance#tax_code
           module TaxCode
@@ -903,11 +1245,26 @@ module EInvoiceAPI
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # The VAT rate, represented as percentage that applies to the allowance. Must be
+          # rounded to maximum 2 decimals
+          #
+          # @see EInvoiceAPI::Models::DocumentCreate::Item::Allowance#tax_rate
+          module TaxRate
+            extend EInvoiceAPI::Internal::Type::Union
+
+            variant Float
+
+            variant String
+
+            # @!method self.variants
+            #   @return [Array(Float, String)]
+          end
         end
 
-        # The total amount of the line item, exclusive of VAT, after subtracting line
-        # level allowances and adding line level charges. Must be rounded to maximum 2
-        # decimals
+        # The invoice line net amount (BT-131), exclusive of VAT, inclusive of line level
+        # allowances and charges. Calculated as: ((unit_price / price_base_quantity) \*
+        # quantity) - allowances + charges. Must be rounded to maximum 2 decimals
         #
         # @see EInvoiceAPI::Models::DocumentCreate::Item#amount
         module Amount
@@ -955,10 +1312,14 @@ module EInvoiceAPI
           optional :reason, String, nil?: true
 
           # @!attribute reason_code
-          #   The code for the charge reason
+          #   Charge reason codes for invoice charges and fees
           #
-          #   @return [String, nil]
-          optional :reason_code, String, nil?: true
+          #   @return [Symbol, EInvoiceAPI::Models::DocumentCreate::Item::Charge::ReasonCode, nil]
+          optional :reason_code,
+                   enum: -> {
+                     EInvoiceAPI::DocumentCreate::Item::Charge::ReasonCode
+                   },
+                   nil?: true
 
           # @!attribute tax_code
           #   Duty or tax or fee category codes (Subset of UNCL5305)
@@ -971,8 +1332,8 @@ module EInvoiceAPI
           # @!attribute tax_rate
           #   The VAT rate, represented as percentage that applies to the charge
           #
-          #   @return [String, nil]
-          optional :tax_rate, String, nil?: true
+          #   @return [Float, String, nil]
+          optional :tax_rate, union: -> { EInvoiceAPI::DocumentCreate::Item::Charge::TaxRate }, nil?: true
 
           # @!method initialize(amount: nil, base_amount: nil, multiplier_factor: nil, reason: nil, reason_code: nil, tax_code: nil, tax_rate: nil)
           #   Some parameter documentations has been truncated, see
@@ -988,11 +1349,11 @@ module EInvoiceAPI
           #
           #   @param reason [String, nil] The reason for the charge
           #
-          #   @param reason_code [String, nil] The code for the charge reason
+          #   @param reason_code [Symbol, EInvoiceAPI::Models::DocumentCreate::Item::Charge::ReasonCode, nil] Charge reason codes for invoice charges and fees
           #
           #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreate::Item::Charge::TaxCode, nil] Duty or tax or fee category codes (Subset of UNCL5305)
           #
-          #   @param tax_rate [String, nil] The VAT rate, represented as percentage that applies to the charge
+          #   @param tax_rate [Float, String, nil] The VAT rate, represented as percentage that applies to the charge
 
           # The charge amount, without VAT. Must be rounded to maximum 2 decimals
           #
@@ -1038,6 +1399,195 @@ module EInvoiceAPI
             #   @return [Array(Float, String)]
           end
 
+          # Charge reason codes for invoice charges and fees
+          #
+          # @see EInvoiceAPI::Models::DocumentCreate::Item::Charge#reason_code
+          module ReasonCode
+            extend EInvoiceAPI::Internal::Type::Enum
+
+            AA = :AA
+            AAA = :AAA
+            AAC = :AAC
+            AAD = :AAD
+            AAE = :AAE
+            AAF = :AAF
+            AAH = :AAH
+            AAI = :AAI
+            AAS = :AAS
+            AAT = :AAT
+            AAV = :AAV
+            AAY = :AAY
+            AAZ = :AAZ
+            ABA = :ABA
+            ABB = :ABB
+            ABC = :ABC
+            ABD = :ABD
+            ABF = :ABF
+            ABK = :ABK
+            ABL = :ABL
+            ABN = :ABN
+            ABR = :ABR
+            ABS = :ABS
+            ABT = :ABT
+            ABU = :ABU
+            ACF = :ACF
+            ACG = :ACG
+            ACH = :ACH
+            ACI = :ACI
+            ACJ = :ACJ
+            ACK = :ACK
+            ACL = :ACL
+            ACM = :ACM
+            ACS = :ACS
+            ADC = :ADC
+            ADE = :ADE
+            ADJ = :ADJ
+            ADK = :ADK
+            ADL = :ADL
+            ADM = :ADM
+            ADN = :ADN
+            ADO = :ADO
+            ADP = :ADP
+            ADQ = :ADQ
+            ADR = :ADR
+            ADT = :ADT
+            ADW = :ADW
+            ADY = :ADY
+            ADZ = :ADZ
+            AEA = :AEA
+            AEB = :AEB
+            AEC = :AEC
+            AED = :AED
+            AEF = :AEF
+            AEH = :AEH
+            AEI = :AEI
+            AEJ = :AEJ
+            AEK = :AEK
+            AEL = :AEL
+            AEM = :AEM
+            AEN = :AEN
+            AEO = :AEO
+            AEP = :AEP
+            AES = :AES
+            AET = :AET
+            AEU = :AEU
+            AEV = :AEV
+            AEW = :AEW
+            AEX = :AEX
+            AEY = :AEY
+            AEZ = :AEZ
+            AJ = :AJ
+            AU = :AU
+            CA = :CA
+            CAB = :CAB
+            CAD = :CAD
+            CAE = :CAE
+            CAF = :CAF
+            CAI = :CAI
+            CAJ = :CAJ
+            CAK = :CAK
+            CAL = :CAL
+            CAM = :CAM
+            CAN = :CAN
+            CAO = :CAO
+            CAP = :CAP
+            CAQ = :CAQ
+            CAR = :CAR
+            CAS = :CAS
+            CAT = :CAT
+            CAU = :CAU
+            CAV = :CAV
+            CAW = :CAW
+            CAX = :CAX
+            CAY = :CAY
+            CAZ = :CAZ
+            CD = :CD
+            CG = :CG
+            CS = :CS
+            CT = :CT
+            DAB = :DAB
+            DAC = :DAC
+            DAD = :DAD
+            DAF = :DAF
+            DAG = :DAG
+            DAH = :DAH
+            DAI = :DAI
+            DAJ = :DAJ
+            DAK = :DAK
+            DAL = :DAL
+            DAM = :DAM
+            DAN = :DAN
+            DAO = :DAO
+            DAP = :DAP
+            DAQ = :DAQ
+            DL = :DL
+            EG = :EG
+            EP = :EP
+            ER = :ER
+            FAA = :FAA
+            FAB = :FAB
+            FAC = :FAC
+            FC = :FC
+            FH = :FH
+            FI = :FI
+            GAA = :GAA
+            HAA = :HAA
+            HD = :HD
+            HH = :HH
+            IAA = :IAA
+            IAB = :IAB
+            ID = :ID
+            IF = :IF
+            IR = :IR
+            IS = :IS
+            KO = :KO
+            L1 = :L1
+            LA = :LA
+            LAA = :LAA
+            LAB = :LAB
+            LF = :LF
+            MAE = :MAE
+            MI = :MI
+            ML = :ML
+            NAA = :NAA
+            OA = :OA
+            PA = :PA
+            PAA = :PAA
+            PC = :PC
+            PL = :PL
+            PRV = :PRV
+            RAB = :RAB
+            RAC = :RAC
+            RAD = :RAD
+            RAF = :RAF
+            RE = :RE
+            RF = :RF
+            RH = :RH
+            RV = :RV
+            SA = :SA
+            SAA = :SAA
+            SAD = :SAD
+            SAE = :SAE
+            SAI = :SAI
+            SG = :SG
+            SH = :SH
+            SM = :SM
+            SU = :SU
+            TAB = :TAB
+            TAC = :TAC
+            TT = :TT
+            TV = :TV
+            V1 = :V1
+            V2 = :V2
+            WH = :WH
+            XAA = :XAA
+            YY = :YY
+            ZZZ = :ZZZ
+
+            # @!method self.values
+            #   @return [Array<Symbol>]
+          end
+
           # Duty or tax or fee category codes (Subset of UNCL5305)
           #
           # Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
@@ -1060,6 +1610,35 @@ module EInvoiceAPI
             # @!method self.values
             #   @return [Array<Symbol>]
           end
+
+          # The VAT rate, represented as percentage that applies to the charge
+          #
+          # @see EInvoiceAPI::Models::DocumentCreate::Item::Charge#tax_rate
+          module TaxRate
+            extend EInvoiceAPI::Internal::Type::Union
+
+            variant Float
+
+            variant String
+
+            # @!method self.variants
+            #   @return [Array(Float, String)]
+          end
+        end
+
+        # The item price base quantity (BT-149). The number of item units to which the
+        # price applies. Defaults to 1. Must be rounded to maximum 4 decimals
+        #
+        # @see EInvoiceAPI::Models::DocumentCreate::Item#price_base_quantity
+        module PriceBaseQuantity
+          extend EInvoiceAPI::Internal::Type::Union
+
+          variant Float
+
+          variant String
+
+          # @!method self.variants
+          #   @return [Array(Float, String)]
         end
 
         # The quantity of items (goods or services) that is the subject of the line item.
@@ -1091,7 +1670,22 @@ module EInvoiceAPI
           #   @return [Array(Float, String)]
         end
 
-        # The unit price of the line item. Must be rounded to maximum 2 decimals
+        # The VAT rate of the line item expressed as percentage with 2 decimals
+        #
+        # @see EInvoiceAPI::Models::DocumentCreate::Item#tax_rate
+        module TaxRate
+          extend EInvoiceAPI::Internal::Type::Union
+
+          variant Float
+
+          variant String
+
+          # @!method self.variants
+          #   @return [Array(Float, String)]
+        end
+
+        # The item net price (BT-146). The price of an item, exclusive of VAT, after
+        # subtracting item price discount. Must be rounded to maximum 4 decimals
         #
         # @see EInvoiceAPI::Models::DocumentCreate::Item#unit_price
         module UnitPrice
@@ -1106,8 +1700,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 +1731,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 +1755,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 +1802,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