e-invoice-api 0.10.1 → 0.12.0

data/lib/e_invoice_api/models/me_retrieve_response.rb

@@ -28,7 +28,7 @@ module EInvoiceAPI
       optional :bcc_recipient_email, String, nil?: true
 
       # @!attribute company_address
-      #   Address of the company
+      #   Address of the company. Must be in the form of `Street Name Street Number`
       #
       #   @return [String, nil]
       optional :company_address, String, nil?: true
@@ -52,17 +52,26 @@ module EInvoiceAPI
       optional :company_email, String, nil?: true
 
       # @!attribute company_name
-      #   Name of the company
+      #   Name of the company. Must include the company type. For example: `BV`, `NV`,
+      #   `CVBA`, `VOF`
       #
       #   @return [String, nil]
       optional :company_name, String, nil?: true
 
       # @!attribute company_number
-      #   Company number
+      #   Company number. For Belgium this is the CBE number or their EUID (European
+      #   Unique Identifier) number
       #
       #   @return [String, nil]
       optional :company_number, String, nil?: true
 
+      # @!attribute company_tax_id
+      #   Company tax ID. For Belgium this is the VAT number. Must include the country
+      #   prefix
+      #
+      #   @return [String, nil]
+      optional :company_tax_id, String, nil?: true
+
       # @!attribute company_zip
       #   Zip code of the company
       #
@@ -98,7 +107,10 @@ module EInvoiceAPI
       #   @return [Time, nil]
       optional :smp_registration_date, Time, nil?: true
 
-      # @!method initialize(credit_balance:, name:, plan:, bcc_recipient_email: nil, company_address: nil, company_city: nil, company_country: nil, company_email: nil, company_name: nil, company_number: nil, company_zip: nil, description: nil, ibans: nil, peppol_ids: nil, smp_registration: nil, smp_registration_date: nil)
+      # @!method initialize(credit_balance:, name:, plan:, bcc_recipient_email: nil, company_address: nil, company_city: nil, company_country: nil, company_email: nil, company_name: nil, company_number: nil, company_tax_id: nil, company_zip: nil, description: nil, ibans: nil, peppol_ids: nil, smp_registration: nil, smp_registration_date: nil)
+      #   Some parameter documentations has been truncated, see
+      #   {EInvoiceAPI::Models::MeRetrieveResponse} for more details.
+      #
       #   @param credit_balance [Integer] Credit balance of the tenant
       #
       #   @param name [String]
@@ -107,7 +119,7 @@ module EInvoiceAPI
       #
       #   @param bcc_recipient_email [String, nil] BCC recipient email to deliver documents
       #
-      #   @param company_address [String, nil] Address of the company
+      #   @param company_address [String, nil] Address of the company. Must be in the form of `Street Name Street Number`
       #
       #   @param company_city [String, nil] City of the company
       #
@@ -115,9 +127,11 @@ module EInvoiceAPI
       #
       #   @param company_email [String, nil] Email of the company
       #
-      #   @param company_name [String, nil] Name of the company
+      #   @param company_name [String, nil] Name of the company. Must include the company type. For example: `BV`, `NV`, `CV
+      #
+      #   @param company_number [String, nil] Company number. For Belgium this is the CBE number or their EUID (European Uniqu
       #
-      #   @param company_number [String, nil] Company number
+      #   @param company_tax_id [String, nil] Company tax ID. For Belgium this is the VAT number. Must include the country pre
       #
       #   @param company_zip [String, nil] Zip code of the company
       #

data/lib/e_invoice_api/models/payment_detail_create.rb

@@ -4,30 +4,41 @@ module EInvoiceAPI
   module Models
     class PaymentDetailCreate < EInvoiceAPI::Internal::Type::BaseModel
       # @!attribute bank_account_number
+      #   Bank account number (for non-IBAN accounts)
       #
       #   @return [String, nil]
       optional :bank_account_number, String, nil?: true
 
       # @!attribute iban
+      #   International Bank Account Number for payment transfers
       #
       #   @return [String, nil]
       optional :iban, String, nil?: true
 
       # @!attribute payment_reference
+      #   Structured payment reference or communication (e.g., structured communication
+      #   for Belgian bank transfers)
       #
       #   @return [String, nil]
       optional :payment_reference, String, nil?: true
 
       # @!attribute swift
+      #   SWIFT/BIC code of the bank
       #
       #   @return [String, nil]
       optional :swift, String, nil?: true
 
       # @!method initialize(bank_account_number: nil, iban: nil, payment_reference: nil, swift: nil)
-      #   @param bank_account_number [String, nil]
-      #   @param iban [String, nil]
-      #   @param payment_reference [String, nil]
-      #   @param swift [String, nil]
+      #   Some parameter documentations has been truncated, see
+      #   {EInvoiceAPI::Models::PaymentDetailCreate} for more details.
+      #
+      #   @param bank_account_number [String, nil] Bank account number (for non-IBAN accounts)
+      #
+      #   @param iban [String, nil] International Bank Account Number for payment transfers
+      #
+      #   @param payment_reference [String, nil] Structured payment reference or communication (e.g., structured communication fo
+      #
+      #   @param swift [String, nil] SWIFT/BIC code of the bank
     end
   end
 end

data/lib/e_invoice_api/resources/documents.rb

@@ -14,99 +14,103 @@ module EInvoiceAPI
       #
       # Create a new invoice or credit note
       #
-      # @overload create(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, request_options: {})
+      # @overload create(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, request_options: {})
       #
       # @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]
+      # @param customer_address [String, nil] The address of the customer/buyer
       #
-      # @param customer_address_recipient [String, nil]
+      # @param customer_address_recipient [String, nil] The recipient name at the customer address
       #
-      # @param customer_email [String, nil]
+      # @param customer_company_id [String, nil] Customer company ID. For Belgium this is the CBE number or their EUID (European
       #
-      # @param customer_id [String, nil]
+      # @param customer_email [String, nil] The email address of the customer
       #
-      # @param customer_name [String, nil]
+      # @param customer_id [String, nil] The unique identifier for the customer in your system
       #
-      # @param customer_tax_id [String, nil]
+      # @param customer_name [String, nil] The company name of the customer/buyer
       #
-      # @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection]
+      # @param customer_tax_id [String, nil] Customer tax ID. For Belgium this is the VAT number. Must include the country pr
       #
-      # @param document_type [Symbol, EInvoiceAPI::Models::DocumentType]
+      # @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection] The direction of the document: INBOUND (purchases) or OUTBOUND (sales)
       #
-      # @param due_date [Date, nil]
+      # @param document_type [Symbol, EInvoiceAPI::Models::DocumentType] The type of document: INVOICE, CREDIT_NOTE, or DEBIT_NOTE
       #
-      # @param invoice_date [Date, nil]
+      # @param due_date [Date, nil] The date when payment is due
       #
-      # @param invoice_id [String, nil]
+      # @param invoice_date [Date, nil] The date when the invoice was issued
       #
-      # @param invoice_total [Float, String, nil] The total amount of the invoice (so invoice_total = subtotal + total_tax + total
+      # @param invoice_id [String, nil] The unique invoice identifier/number
+      #
+      # @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 total financial discount of the invoice (so discounts not subject to VAT). M
+      # @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] The address of the vendor/seller
       #
-      # @param vendor_address [String, nil]
+      # @param vendor_address_recipient [String, nil] The recipient name at the vendor address
       #
-      # @param vendor_address_recipient [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_email [String, nil]
+      # @param vendor_email [String, nil] The email address of the vendor
       #
-      # @param vendor_name [String, nil]
+      # @param vendor_name [String, nil] The name of the vendor/seller/supplier
       #
-      # @param vendor_tax_id [String, nil]
+      # @param vendor_tax_id [String, nil] Vendor tax ID. For Belgium this is the VAT number. Must include the country pref
       #
       # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/e_invoice_api/resources/validate.rb

@@ -8,99 +8,103 @@ module EInvoiceAPI
       #
       # Validate if the JSON document can be converted to a valid UBL document
       #
-      # @overload validate_json(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, request_options: {})
+      # @overload validate_json(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, request_options: {})
       #
       # @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]
+      # @param customer_address [String, nil] The address of the customer/buyer
       #
-      # @param customer_address_recipient [String, nil]
+      # @param customer_address_recipient [String, nil] The recipient name at the customer address
       #
-      # @param customer_email [String, nil]
+      # @param customer_company_id [String, nil] Customer company ID. For Belgium this is the CBE number or their EUID (European
       #
-      # @param customer_id [String, nil]
+      # @param customer_email [String, nil] The email address of the customer
       #
-      # @param customer_name [String, nil]
+      # @param customer_id [String, nil] The unique identifier for the customer in your system
       #
-      # @param customer_tax_id [String, nil]
+      # @param customer_name [String, nil] The company name of the customer/buyer
       #
-      # @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection]
+      # @param customer_tax_id [String, nil] Customer tax ID. For Belgium this is the VAT number. Must include the country pr
       #
-      # @param document_type [Symbol, EInvoiceAPI::Models::DocumentType]
+      # @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection] The direction of the document: INBOUND (purchases) or OUTBOUND (sales)
       #
-      # @param due_date [Date, nil]
+      # @param document_type [Symbol, EInvoiceAPI::Models::DocumentType] The type of document: INVOICE, CREDIT_NOTE, or DEBIT_NOTE
       #
-      # @param invoice_date [Date, nil]
+      # @param due_date [Date, nil] The date when payment is due
       #
-      # @param invoice_id [String, nil]
+      # @param invoice_date [Date, nil] The date when the invoice was issued
       #
-      # @param invoice_total [Float, String, nil] The total amount of the invoice (so invoice_total = subtotal + total_tax + total
+      # @param invoice_id [String, nil] The unique invoice identifier/number
+      #
+      # @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 total financial discount of the invoice (so discounts not subject to VAT). M
+      # @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] The address of the vendor/seller
       #
-      # @param vendor_address [String, nil]
+      # @param vendor_address_recipient [String, nil] The recipient name at the vendor address
       #
-      # @param vendor_address_recipient [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_email [String, nil]
+      # @param vendor_email [String, nil] The email address of the vendor
       #
-      # @param vendor_name [String, nil]
+      # @param vendor_name [String, nil] The name of the vendor/seller/supplier
       #
-      # @param vendor_tax_id [String, nil]
+      # @param vendor_tax_id [String, nil] Vendor tax ID. For Belgium this is the VAT number. Must include the country pref
       #
       # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
       #

data/lib/e_invoice_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EInvoiceAPI
-  VERSION = "0.10.1"
+  VERSION = "0.12.0"
 end

data/rbi/e_invoice_api/models/allowance.rbi

@@ -18,7 +18,8 @@ module EInvoiceAPI
       attr_accessor :base_amount
 
       # 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
       sig { returns(T.nilable(String)) }
       attr_accessor :multiplier_factor
 
@@ -26,17 +27,21 @@ module EInvoiceAPI
       sig { returns(T.nilable(String)) }
       attr_accessor :reason
 
-      # The code for the allowance reason
-      sig { returns(T.nilable(String)) }
+      # Allowance reason codes for invoice discounts and charges
+      sig do
+        returns(T.nilable(EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol))
+      end
       attr_accessor :reason_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
       sig { returns(T.nilable(EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)) }
-      attr_accessor :tax_code
+      attr_reader :tax_code
 
-      # The VAT rate, represented as percentage that applies to the allowance
+      sig { params(tax_code: EInvoiceAPI::Allowance::TaxCode::OrSymbol).void }
+      attr_writer :tax_code
+
+      # The VAT rate, represented as percentage that applies to the allowance. Must be
+      # rounded to maximum 2 decimals
       sig { returns(T.nilable(String)) }
       attr_accessor :tax_rate
 
@@ -47,8 +52,8 @@ module EInvoiceAPI
           base_amount: T.nilable(String),
           multiplier_factor: T.nilable(String),
           reason: T.nilable(String),
-          reason_code: T.nilable(String),
-          tax_code: T.nilable(EInvoiceAPI::Allowance::TaxCode::OrSymbol),
+          reason_code: T.nilable(EInvoiceAPI::Allowance::ReasonCode::OrSymbol),
+          tax_code: EInvoiceAPI::Allowance::TaxCode::OrSymbol,
           tax_rate: T.nilable(String)
         ).returns(T.attached_class)
       end
@@ -59,17 +64,17 @@ module EInvoiceAPI
         # to calculate the allowance amount. Must be rounded to maximum 2 decimals
         base_amount: nil,
         # 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
         multiplier_factor: nil,
         # The reason for the allowance
         reason: nil,
-        # The code for the allowance reason
+        # Allowance reason codes for invoice discounts and charges
         reason_code: nil,
-        # 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
         tax_code: nil,
-        # 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
         tax_rate: nil
       )
       end
@@ -81,8 +86,9 @@ module EInvoiceAPI
             base_amount: T.nilable(String),
             multiplier_factor: T.nilable(String),
             reason: T.nilable(String),
-            reason_code: T.nilable(String),
-            tax_code: T.nilable(EInvoiceAPI::Allowance::TaxCode::TaggedSymbol),
+            reason_code:
+              T.nilable(EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol),
+            tax_code: EInvoiceAPI::Allowance::TaxCode::TaggedSymbol,
             tax_rate: T.nilable(String)
           }
         )
@@ -90,9 +96,63 @@ module EInvoiceAPI
       def to_hash
       end
 
-      # Duty or tax or fee category codes (Subset of UNCL5305)
-      #
-      # Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
+      # Allowance reason codes for invoice discounts and charges
+      module ReasonCode
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, EInvoiceAPI::Allowance::ReasonCode) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        REASON_CODE_41 =
+          T.let(:"41", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_42 =
+          T.let(:"42", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_60 =
+          T.let(:"60", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_62 =
+          T.let(:"62", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_63 =
+          T.let(:"63", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_64 =
+          T.let(:"64", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_65 =
+          T.let(:"65", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_66 =
+          T.let(:"66", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_67 =
+          T.let(:"67", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_68 =
+          T.let(:"68", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_70 =
+          T.let(:"70", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_71 =
+          T.let(:"71", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_88 =
+          T.let(:"88", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_95 =
+          T.let(:"95", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_100 =
+          T.let(:"100", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_102 =
+          T.let(:"102", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_103 =
+          T.let(:"103", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_104 =
+          T.let(:"104", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+        REASON_CODE_105 =
+          T.let(:"105", EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[EInvoiceAPI::Allowance::ReasonCode::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+
+      # The VAT category code that applies to the allowance
       module TaxCode
         extend EInvoiceAPI::Internal::Type::Enum