e-invoice-api 0.13.0 → 0.15.0

data/lib/e_invoice_api/models/document_create.rb

@@ -428,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,
@@ -442,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
@@ -475,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
         #
@@ -511,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
@@ -525,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
@@ -547,6 +576,21 @@ 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 for payment. Must be positive and rounded to maximum 2 decimals
@@ -593,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)
@@ -609,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
@@ -626,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
         #
@@ -676,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
@@ -698,6 +931,20 @@ 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 including tax (invoice_total = subtotal +
@@ -725,9 +972,10 @@ 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. Can be
+        #   negative for credit notes or corrections.
         #
         #   @return [Float, String, nil]
         optional :amount, union: -> { EInvoiceAPI::DocumentCreate::Item::Amount }, nil?: true
@@ -759,13 +1007,15 @@ module EInvoiceAPI
 
         # @!attribute quantity
         #   The quantity of items (goods or services) that is the subject of the line item.
-        #   Must be rounded to maximum 4 decimals
+        #   Must be rounded to maximum 4 decimals. Can be negative for credit notes or
+        #   corrections.
         #
         #   @return [Float, String, nil]
         optional :quantity, union: -> { EInvoiceAPI::DocumentCreate::Item::Quantity }, nil?: true
 
         # @!attribute tax
-        #   The total VAT amount for the line item. Must be rounded to maximum 2 decimals
+        #   The total VAT amount for the line item. Must be rounded to maximum 2 decimals.
+        #   Can be negative for credit notes or corrections.
         #
         #   @return [Float, String, nil]
         optional :tax, union: -> { EInvoiceAPI::DocumentCreate::Item::Tax }, nil?: true
@@ -773,8 +1023,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.
@@ -783,7 +1033,8 @@ 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
@@ -794,7 +1045,7 @@ module EInvoiceAPI
         #
         #   @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.
         #
@@ -806,13 +1057,13 @@ module EInvoiceAPI
         #
         #   @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 [Float, String, nil] The total VAT amount for the line item. Must be rounded to maximum 2 decimals. C
         #
-        #   @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
@@ -834,7 +1085,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,
@@ -848,24 +1100,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
@@ -881,11 +1136,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
           #
@@ -917,7 +1172,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
@@ -931,9 +1187,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
@@ -953,11 +1237,27 @@ 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. Can be
+        # negative for credit notes or corrections.
         #
         # @see EInvoiceAPI::Models::DocumentCreate::Item#amount
         module Amount
@@ -1005,10 +1305,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)
@@ -1021,8 +1325,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
@@ -1038,11 +1342,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
           #
@@ -1088,6 +1392,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
@@ -1110,10 +1603,25 @@ 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 quantity of items (goods or services) that is the subject of the line item.
-        # Must be rounded to maximum 4 decimals
+        # Must be rounded to maximum 4 decimals. Can be negative for credit notes or
+        # corrections.
         #
         # @see EInvoiceAPI::Models::DocumentCreate::Item#quantity
         module Quantity
@@ -1127,7 +1635,8 @@ module EInvoiceAPI
           #   @return [Array(Float, String)]
         end
 
-        # The total VAT amount for the line item. Must be rounded to maximum 2 decimals
+        # The total VAT amount for the line item. Must be rounded to maximum 2 decimals.
+        # Can be negative for credit notes or corrections.
         #
         # @see EInvoiceAPI::Models::DocumentCreate::Item#tax
         module Tax
@@ -1141,7 +1650,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