e-invoice-api 0.13.0 → 0.15.0

data/lib/e_invoice_api/models/document_create_from_pdf_response.rb

@@ -152,13 +152,6 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :payment_term, String, nil?: true
 
-      # @!attribute previous_unpaid_balance
-      #   The previous unpaid balance from prior invoices, if any. Must be positive and
-      #   rounded to maximum 2 decimals
-      #
-      #   @return [String, nil]
-      optional :previous_unpaid_balance, String, nil?: true
-
       # @!attribute purchase_order
       #   The purchase order reference number
       #
@@ -320,7 +313,7 @@ module EInvoiceAPI
       #   @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_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, success: nil, tax_code: nil, tax_details: nil, total_discount: nil, total_tax: nil, ubl_document: 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)
+      # @!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, 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, success: nil, tax_code: nil, tax_details: nil, total_discount: nil, total_tax: nil, ubl_document: 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::DocumentCreateFromPdfResponse} for more details.
       #
@@ -372,8 +365,6 @@ module EInvoiceAPI
       #
       #   @param payment_term [String, nil] The payment terms (e.g., 'Net 30', 'Due on receipt', '2/10 Net 30')
       #
-      #   @param previous_unpaid_balance [String, nil] The previous unpaid balance from prior invoices, if any. Must be positive and ro
-      #
       #   @param purchase_order [String, nil] The purchase order reference number
       #
       #   @param remittance_address [String, nil] The address where payment should be sent or remitted to
@@ -432,9 +423,10 @@ module EInvoiceAPI
         optional :allowances, -> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::Allowance] }, 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 [String, nil]
         optional :amount, String, nil?: true
@@ -464,13 +456,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 [String, nil]
         optional :quantity, String, 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 [String, nil]
         optional :tax, String, nil?: true
@@ -488,7 +482,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 [String, nil]
         optional :unit_price, String, nil?: true
@@ -499,7 +494,7 @@ module EInvoiceAPI
         #
         #   @param allowances [Array<EInvoiceAPI::Models::Allowance>, nil] The allowances of the line item.
         #
-        #   @param amount [String, nil] The total amount of the line item, exclusive of VAT, after subtracting line leve
+        #   @param amount [String, nil] The invoice line net amount (BT-131), exclusive of VAT, inclusive of line level
         #
         #   @param charges [Array<EInvoiceAPI::Models::Charge>, nil] The charges of the line item.
         #
@@ -511,13 +506,13 @@ module EInvoiceAPI
         #
         #   @param quantity [String, nil] The quantity of items (goods or services) that is the subject of the line item.
         #
-        #   @param tax [String, nil] The total VAT amount for the line item. Must be rounded to maximum 2 decimals
+        #   @param tax [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 unit [Symbol, EInvoiceAPI::Models::UnitOfMeasureCode, nil] Unit of Measure Codes from UNECERec20 used in Peppol BIS Billing 3.0.
         #
-        #   @param unit_price [String, nil] The unit price of the line item. Must be rounded to maximum 2 decimals
+        #   @param unit_price [String, nil] The item net price (BT-146). The price of an item, exclusive of VAT, after subtr
       end
 
       # Tax category code of the invoice (e.g., S for standard rate, Z for zero rate, E

data/lib/e_invoice_api/models/document_response.rb

@@ -161,13 +161,6 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :payment_term, String, nil?: true
 
-      # @!attribute previous_unpaid_balance
-      #   The previous unpaid balance from prior invoices, if any. Must be positive and
-      #   rounded to maximum 2 decimals
-      #
-      #   @return [String, nil]
-      optional :previous_unpaid_balance, String, nil?: true
-
       # @!attribute purchase_order
       #   The purchase order reference number
       #
@@ -317,7 +310,7 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :vendor_tax_id, String, nil?: true
 
-      # @!method initialize(id:, 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)
+      # @!method initialize(id:, 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, 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::DocumentResponse} for more details.
       #
@@ -371,8 +364,6 @@ module EInvoiceAPI
       #
       #   @param payment_term [String, nil] The payment terms (e.g., 'Net 30', 'Due on receipt', '2/10 Net 30')
       #
-      #   @param previous_unpaid_balance [String, nil] The previous unpaid balance from prior invoices, if any. Must be positive and ro
-      #
       #   @param purchase_order [String, nil] The purchase order reference number
       #
       #   @param remittance_address [String, nil] The address where payment should be sent or remitted to
@@ -435,7 +426,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 [String, nil]
         optional :multiplier_factor, String, nil?: true
@@ -447,21 +439,20 @@ 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::DocumentResponse::Allowance::ReasonCode, nil]
+        optional :reason_code, enum: -> { EInvoiceAPI::DocumentResponse::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::DocumentResponse::Allowance::TaxCode, nil]
-        optional :tax_code, enum: -> { EInvoiceAPI::DocumentResponse::Allowance::TaxCode }, nil?: true
+        optional :tax_code, enum: -> { EInvoiceAPI::DocumentResponse::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
@@ -478,15 +469,43 @@ 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::DocumentResponse::Allowance::ReasonCode, nil] Allowance reason codes for invoice discounts and charges
         #
-        #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentResponse::Allowance::TaxCode, nil] Duty or tax or fee category codes (Subset of UNCL5305)
+        #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentResponse::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 [String, nil] The VAT rate, represented as percentage that applies to the allowance. Must be r
 
-        # 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::DocumentResponse::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::DocumentResponse::Allowance#tax_code
         module TaxCode
@@ -536,10 +555,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::DocumentResponse::Charge::ReasonCode, nil]
+        optional :reason_code, enum: -> { EInvoiceAPI::DocumentResponse::Charge::ReasonCode }, nil?: true
 
         # @!attribute tax_code
         #   Duty or tax or fee category codes (Subset of UNCL5305)
@@ -567,12 +586,201 @@ 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::DocumentResponse::Charge::ReasonCode, nil] Charge reason codes for invoice charges and fees
         #
         #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentResponse::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
 
+        # Charge reason codes for invoice charges and fees
+        #
+        # @see EInvoiceAPI::Models::DocumentResponse::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
@@ -605,9 +813,10 @@ module EInvoiceAPI
         optional :allowances, -> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::Allowance] }, 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 [String, nil]
         optional :amount, String, nil?: true
@@ -637,13 +846,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 [String, nil]
         optional :quantity, String, 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 [String, nil]
         optional :tax, String, nil?: true
@@ -661,7 +872,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 [String, nil]
         optional :unit_price, String, nil?: true
@@ -672,7 +884,7 @@ module EInvoiceAPI
         #
         #   @param allowances [Array<EInvoiceAPI::Models::Allowance>, nil] The allowances of the line item.
         #
-        #   @param amount [String, nil] The total amount of the line item, exclusive of VAT, after subtracting line leve
+        #   @param amount [String, nil] The invoice line net amount (BT-131), exclusive of VAT, inclusive of line level
         #
         #   @param charges [Array<EInvoiceAPI::Models::Charge>, nil] The charges of the line item.
         #
@@ -684,13 +896,13 @@ module EInvoiceAPI
         #
         #   @param quantity [String, nil] The quantity of items (goods or services) that is the subject of the line item.
         #
-        #   @param tax [String, nil] The total VAT amount for the line item. Must be rounded to maximum 2 decimals
+        #   @param tax [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 unit [Symbol, EInvoiceAPI::Models::UnitOfMeasureCode, nil] Unit of Measure Codes from UNECERec20 used in Peppol BIS Billing 3.0.
         #
-        #   @param unit_price [String, nil] The unit price of the line item. Must be rounded to maximum 2 decimals
+        #   @param unit_price [String, nil] The item net price (BT-146). The price of an item, exclusive of VAT, after subtr
       end
 
       class PaymentDetail < EInvoiceAPI::Internal::Type::BaseModel

data/lib/e_invoice_api/models/unit_of_measure_code.rb

@@ -474,7 +474,6 @@ module EInvoiceAPI
       MIN = :MIN
       MON = :MON
       ONZ = :ONZ
-      PCE = :PCE
       LBR = :LBR
       QT = :QT
       SEC = :SEC
@@ -1037,6 +1036,7 @@ module EInvoiceAPI
       NAR = :NAR
       C62 = :C62
       LTR = :LTR
+      H87 = :H87
 
       # @!method self.values
       #   @return [Array<Symbol>]

data/lib/e_invoice_api/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module EInvoiceAPI
-  VERSION = "0.13.0"
+  VERSION = "0.15.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