e-invoice-api 0.6.0 → 0.8.0

data/lib/e_invoice_api/models.rb

@@ -39,14 +39,20 @@ module EInvoiceAPI
     mod.define_sorbet_constant!(const) { T.type_alias { mod.to_sorbet_type } }
   end
 
+  Allowance = EInvoiceAPI::Models::Allowance
+
   Certificate = EInvoiceAPI::Models::Certificate
 
+  Charge = EInvoiceAPI::Models::Charge
+
   CurrencyCode = EInvoiceAPI::Models::CurrencyCode
 
   DocumentAttachmentCreate = EInvoiceAPI::Models::DocumentAttachmentCreate
 
   DocumentCreate = EInvoiceAPI::Models::DocumentCreate
 
+  DocumentCreateFromPdfParams = EInvoiceAPI::Models::DocumentCreateFromPdfParams
+
   DocumentCreateParams = EInvoiceAPI::Models::DocumentCreateParams
 
   DocumentDeleteParams = EInvoiceAPI::Models::DocumentDeleteParams
@@ -65,6 +71,8 @@ module EInvoiceAPI
 
   DocumentType = EInvoiceAPI::Models::DocumentType
 
+  DocumentValidateParams = EInvoiceAPI::Models::DocumentValidateParams
+
   InboxListCreditNotesParams = EInvoiceAPI::Models::InboxListCreditNotesParams
 
   InboxListInvoicesParams = EInvoiceAPI::Models::InboxListInvoicesParams
@@ -75,6 +83,8 @@ module EInvoiceAPI
 
   LookupRetrieveParticipantsParams = EInvoiceAPI::Models::LookupRetrieveParticipantsParams
 
+  MeRetrieveParams = EInvoiceAPI::Models::MeRetrieveParams
+
   OutboxListDraftDocumentsParams = EInvoiceAPI::Models::OutboxListDraftDocumentsParams
 
   OutboxListReceivedDocumentsParams = EInvoiceAPI::Models::OutboxListReceivedDocumentsParams

data/lib/e_invoice_api/resources/documents/ubl.rb

@@ -4,6 +4,28 @@ module EInvoiceAPI
   module Resources
     class Documents
       class Ubl
+        # Create a new invoice or credit note from a UBL file
+        #
+        # @overload create_from_ubl(file:, request_options: {})
+        #
+        # @param file [Pathname, StringIO, IO, String, EInvoiceAPI::FilePart]
+        # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+        #
+        # @return [EInvoiceAPI::Models::DocumentResponse]
+        #
+        # @see EInvoiceAPI::Models::Documents::UblCreateFromUblParams
+        def create_from_ubl(params)
+          parsed, options = EInvoiceAPI::Documents::UblCreateFromUblParams.dump_request(params)
+          @client.request(
+            method: :post,
+            path: "api/documents/ubl",
+            headers: {"content-type" => "multipart/form-data"},
+            body: parsed,
+            model: EInvoiceAPI::DocumentResponse,
+            options: options
+          )
+        end
+
         # Get the UBL for an invoice or credit note
         #
         # @overload get(document_id, request_options: {})

data/lib/e_invoice_api/resources/documents.rb

@@ -14,9 +14,11 @@ module EInvoiceAPI
       #
       # Create a new invoice or credit note
       #
-      # @overload create(amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: 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_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: {})
       #
-      # @param amount_due [Float, String, nil]
+      # @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 attachments [Array<EInvoiceAPI::Models::DocumentAttachmentCreate>, nil]
       #
@@ -24,6 +26,8 @@ module EInvoiceAPI
       #
       # @param billing_address_recipient [String, nil]
       #
+      # @param charges [Array<EInvoiceAPI::Models::DocumentCreate::Charge>, nil]
+      #
       # @param currency [Symbol, EInvoiceAPI::Models::CurrencyCode] Currency of the invoice
       #
       # @param customer_address [String, nil]
@@ -48,9 +52,9 @@ module EInvoiceAPI
       #
       # @param invoice_id [String, nil]
       #
-      # @param invoice_total [Float, String, nil]
+      # @param invoice_total [Float, String, nil] The total amount of the invoice (so invoice_total = subtotal + total_tax + total
       #
-      # @param items [Array<EInvoiceAPI::Models::DocumentCreate::Item>, nil]
+      # @param items [Array<EInvoiceAPI::Models::DocumentCreate::Item>] At least one line item is required
       #
       # @param note [String, nil]
       #
@@ -58,7 +62,7 @@ module EInvoiceAPI
       #
       # @param payment_term [String, nil]
       #
-      # @param previous_unpaid_balance [Float, String, nil]
+      # @param previous_unpaid_balance [Float, String, nil] The previous unpaid balance of the invoice, if any. Must be positive and rounded
       #
       # @param purchase_order [String, nil]
       #
@@ -80,15 +84,15 @@ module EInvoiceAPI
       #
       # @param state [Symbol, EInvoiceAPI::Models::DocumentState]
       #
-      # @param subtotal [Float, String, nil]
+      # @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_details [Array<EInvoiceAPI::Models::DocumentCreate::TaxDetail>, nil]
       #
-      # @param total_discount [Float, String, nil]
+      # @param total_discount [Float, String, nil] The total financial discount of the invoice (so discounts not subject to VAT). M
       #
-      # @param total_tax [Float, String, nil]
+      # @param total_tax [Float, String, nil] The total tax of the invoice. Must be positive and rounded to maximum 2 decimals
       #
       # @param vatex [Symbol, EInvoiceAPI::Models::DocumentCreate::Vatex, nil] VATEX code list for VAT exemption reasons
       #
@@ -158,6 +162,39 @@ module EInvoiceAPI
         )
       end
 
+      # Create a new invoice or credit note from a PDF file. If the 'ubl_document' field
+      # is set in the response, it indicates that sufficient details were extracted from
+      # the PDF to automatically generate a valid UBL document ready for sending. If
+      # 'ubl_document' is not set, human intervention may be required to ensure
+      # compliance.
+      #
+      # @overload create_from_pdf(file:, customer_tax_id: nil, vendor_tax_id: nil, request_options: {})
+      #
+      # @param file [Pathname, StringIO, IO, String, EInvoiceAPI::FilePart] Body param:
+      #
+      # @param customer_tax_id [String, nil] Query param:
+      #
+      # @param vendor_tax_id [String, nil] Query param:
+      #
+      # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [EInvoiceAPI::Models::DocumentCreateFromPdfResponse]
+      #
+      # @see EInvoiceAPI::Models::DocumentCreateFromPdfParams
+      def create_from_pdf(params)
+        parsed, options = EInvoiceAPI::DocumentCreateFromPdfParams.dump_request(params)
+        query_params = [:customer_tax_id, :vendor_tax_id]
+        @client.request(
+          method: :post,
+          path: "api/documents/pdf",
+          query: parsed.slice(*query_params),
+          headers: {"content-type" => "multipart/form-data"},
+          body: parsed.except(*query_params),
+          model: EInvoiceAPI::Models::DocumentCreateFromPdfResponse,
+          options: options
+        )
+      end
+
       # Send an invoice or credit note via Peppol
       #
       # @overload send_(document_id, email: nil, receiver_peppol_id: nil, receiver_peppol_scheme: nil, sender_peppol_id: nil, sender_peppol_scheme: nil, request_options: {})
@@ -184,6 +221,25 @@ module EInvoiceAPI
         )
       end
 
+      # Validate a UBL document according to Peppol BIS Billing 3.0
+      #
+      # @overload validate(document_id, request_options: {})
+      #
+      # @param document_id [String]
+      # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [EInvoiceAPI::Models::UblDocumentValidation]
+      #
+      # @see EInvoiceAPI::Models::DocumentValidateParams
+      def validate(document_id, params = {})
+        @client.request(
+          method: :post,
+          path: ["api/documents/%1$s/validate", document_id],
+          model: EInvoiceAPI::UblDocumentValidation,
+          options: params[:request_options]
+        )
+      end
+
       # @api private
       #
       # @param client [EInvoiceAPI::Client]

data/lib/e_invoice_api/resources/me.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module EInvoiceAPI
+  module Resources
+    class Me
+      # Retrieve information about your account.
+      #
+      # @overload retrieve(request_options: {})
+      #
+      # @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [EInvoiceAPI::Models::MeRetrieveResponse]
+      #
+      # @see EInvoiceAPI::Models::MeRetrieveParams
+      def retrieve(params = {})
+        @client.request(
+          method: :get,
+          path: "api/me/",
+          model: EInvoiceAPI::Models::MeRetrieveResponse,
+          options: params[:request_options]
+        )
+      end
+
+      # @api private
+      #
+      # @param client [EInvoiceAPI::Client]
+      def initialize(client:)
+        @client = client
+      end
+    end
+  end
+end

data/lib/e_invoice_api/resources/validate.rb

@@ -8,9 +8,11 @@ module EInvoiceAPI
       #
       # Validate if the JSON document can be converted to a valid UBL document
       #
-      # @overload validate_json(amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: 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_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: {})
       #
-      # @param amount_due [Float, String, nil]
+      # @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 attachments [Array<EInvoiceAPI::Models::DocumentAttachmentCreate>, nil]
       #
@@ -18,6 +20,8 @@ module EInvoiceAPI
       #
       # @param billing_address_recipient [String, nil]
       #
+      # @param charges [Array<EInvoiceAPI::Models::DocumentCreate::Charge>, nil]
+      #
       # @param currency [Symbol, EInvoiceAPI::Models::CurrencyCode] Currency of the invoice
       #
       # @param customer_address [String, nil]
@@ -42,9 +46,9 @@ module EInvoiceAPI
       #
       # @param invoice_id [String, nil]
       #
-      # @param invoice_total [Float, String, nil]
+      # @param invoice_total [Float, String, nil] The total amount of the invoice (so invoice_total = subtotal + total_tax + total
       #
-      # @param items [Array<EInvoiceAPI::Models::DocumentCreate::Item>, nil]
+      # @param items [Array<EInvoiceAPI::Models::DocumentCreate::Item>] At least one line item is required
       #
       # @param note [String, nil]
       #
@@ -52,7 +56,7 @@ module EInvoiceAPI
       #
       # @param payment_term [String, nil]
       #
-      # @param previous_unpaid_balance [Float, String, nil]
+      # @param previous_unpaid_balance [Float, String, nil] The previous unpaid balance of the invoice, if any. Must be positive and rounded
       #
       # @param purchase_order [String, nil]
       #
@@ -74,15 +78,15 @@ module EInvoiceAPI
       #
       # @param state [Symbol, EInvoiceAPI::Models::DocumentState]
       #
-      # @param subtotal [Float, String, nil]
+      # @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_details [Array<EInvoiceAPI::Models::DocumentCreate::TaxDetail>, nil]
       #
-      # @param total_discount [Float, String, nil]
+      # @param total_discount [Float, String, nil] The total financial discount of the invoice (so discounts not subject to VAT). M
       #
-      # @param total_tax [Float, String, nil]
+      # @param total_tax [Float, String, nil] The total tax of the invoice. Must be positive and rounded to maximum 2 decimals
       #
       # @param vatex [Symbol, EInvoiceAPI::Models::DocumentCreate::Vatex, nil] VATEX code list for VAT exemption reasons
       #

data/lib/e_invoice_api/version.rb

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

data/lib/e_invoice_api.rb

@@ -52,9 +52,13 @@ require_relative "e_invoice_api/internal/transport/pooled_net_requester"
 require_relative "e_invoice_api/client"
 require_relative "e_invoice_api/internal/documents_number_page"
 require_relative "e_invoice_api/models/document_create"
+require_relative "e_invoice_api/models/allowance"
 require_relative "e_invoice_api/models/certificate"
+require_relative "e_invoice_api/models/charge"
 require_relative "e_invoice_api/models/currency_code"
 require_relative "e_invoice_api/models/document_attachment_create"
+require_relative "e_invoice_api/models/document_create_from_pdf_params"
+require_relative "e_invoice_api/models/document_create_from_pdf_response"
 require_relative "e_invoice_api/models/document_create_params"
 require_relative "e_invoice_api/models/document_delete_params"
 require_relative "e_invoice_api/models/document_delete_response"
@@ -68,11 +72,13 @@ require_relative "e_invoice_api/models/documents/attachment_list_params"
 require_relative "e_invoice_api/models/documents/attachment_list_response"
 require_relative "e_invoice_api/models/documents/attachment_retrieve_params"
 require_relative "e_invoice_api/models/documents/document_attachment"
+require_relative "e_invoice_api/models/documents/ubl_create_from_ubl_params"
 require_relative "e_invoice_api/models/documents/ubl_get_params"
 require_relative "e_invoice_api/models/documents/ubl_get_response"
 require_relative "e_invoice_api/models/document_send_params"
 require_relative "e_invoice_api/models/document_state"
 require_relative "e_invoice_api/models/document_type"
+require_relative "e_invoice_api/models/document_validate_params"
 require_relative "e_invoice_api/models/inbox_list_credit_notes_params"
 require_relative "e_invoice_api/models/inbox_list_invoices_params"
 require_relative "e_invoice_api/models/inbox_list_params"
@@ -80,6 +86,8 @@ require_relative "e_invoice_api/models/lookup_retrieve_params"
 require_relative "e_invoice_api/models/lookup_retrieve_participants_params"
 require_relative "e_invoice_api/models/lookup_retrieve_participants_response"
 require_relative "e_invoice_api/models/lookup_retrieve_response"
+require_relative "e_invoice_api/models/me_retrieve_params"
+require_relative "e_invoice_api/models/me_retrieve_response"
 require_relative "e_invoice_api/models/outbox_list_draft_documents_params"
 require_relative "e_invoice_api/models/outbox_list_received_documents_params"
 require_relative "e_invoice_api/models/paginated_document_response"
@@ -104,6 +112,7 @@ require_relative "e_invoice_api/resources/documents/attachments"
 require_relative "e_invoice_api/resources/documents/ubl"
 require_relative "e_invoice_api/resources/inbox"
 require_relative "e_invoice_api/resources/lookup"
+require_relative "e_invoice_api/resources/me"
 require_relative "e_invoice_api/resources/outbox"
 require_relative "e_invoice_api/resources/validate"
 require_relative "e_invoice_api/resources/webhooks"

data/rbi/e_invoice_api/client.rbi

@@ -28,6 +28,9 @@ module EInvoiceAPI
     sig { returns(EInvoiceAPI::Resources::Lookup) }
     attr_reader :lookup
 
+    sig { returns(EInvoiceAPI::Resources::Me) }
+    attr_reader :me
+
     sig { returns(EInvoiceAPI::Resources::Webhooks) }
     attr_reader :webhooks
 

data/rbi/e_invoice_api/models/allowance.rbi

@@ -0,0 +1,124 @@
+# typed: strong
+
+module EInvoiceAPI
+  module Models
+    class Allowance < EInvoiceAPI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(EInvoiceAPI::Allowance, EInvoiceAPI::Internal::AnyHash)
+        end
+
+      # The allowance amount, without VAT. Must be rounded to maximum 2 decimals
+      sig { returns(T.nilable(String)) }
+      attr_accessor :amount
+
+      # The base amount that may be used, in conjunction with the allowance percentage,
+      # to calculate the allowance amount. Must be rounded to maximum 2 decimals
+      sig { returns(T.nilable(String)) }
+      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
+      sig { returns(T.nilable(String)) }
+      attr_accessor :multiplier_factor
+
+      # The reason for the allowance
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reason
+
+      # The code for the allowance reason
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reason_code
+
+      # Duty or tax or fee category codes (Subset of UNCL5305)
+      #
+      # Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
+      sig { returns(T.nilable(EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)) }
+      attr_accessor :tax_code
+
+      # The VAT rate, represented as percentage that applies to the allowance
+      sig { returns(T.nilable(String)) }
+      attr_accessor :tax_rate
+
+      # An allowance is a discount for example for early payment, volume discount, etc.
+      sig do
+        params(
+          amount: T.nilable(String),
+          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),
+          tax_rate: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The allowance amount, without VAT. Must be rounded to maximum 2 decimals
+        amount: nil,
+        # The base amount that may be used, in conjunction with the allowance percentage,
+        # 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
+        multiplier_factor: nil,
+        # The reason for the allowance
+        reason: nil,
+        # The code for the allowance reason
+        reason_code: nil,
+        # Duty or tax or fee category codes (Subset of UNCL5305)
+        #
+        # Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
+        tax_code: nil,
+        # The VAT rate, represented as percentage that applies to the allowance
+        tax_rate: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            amount: T.nilable(String),
+            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),
+            tax_rate: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Duty or tax or fee category codes (Subset of UNCL5305)
+      #
+      # Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
+      module TaxCode
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, EInvoiceAPI::Allowance::TaxCode) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AE = T.let(:AE, EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)
+        E = T.let(:E, EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)
+        S = T.let(:S, EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)
+        Z = T.let(:Z, EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)
+        G = T.let(:G, EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)
+        O = T.let(:O, EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)
+        K = T.let(:K, EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)
+        L = T.let(:L, EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)
+        M = T.let(:M, EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)
+        B = T.let(:B, EInvoiceAPI::Allowance::TaxCode::TaggedSymbol)
+
+        sig do
+          override.returns(
+            T::Array[EInvoiceAPI::Allowance::TaxCode::TaggedSymbol]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end

data/rbi/e_invoice_api/models/charge.rbi

@@ -0,0 +1,122 @@
+# typed: strong
+
+module EInvoiceAPI
+  module Models
+    class Charge < EInvoiceAPI::Internal::Type::BaseModel
+      OrHash =
+        T.type_alias do
+          T.any(EInvoiceAPI::Charge, EInvoiceAPI::Internal::AnyHash)
+        end
+
+      # The charge amount, without VAT. Must be rounded to maximum 2 decimals
+      sig { returns(T.nilable(String)) }
+      attr_accessor :amount
+
+      # The base amount that may be used, in conjunction with the charge percentage, to
+      # calculate the charge amount. Must be rounded to maximum 2 decimals
+      sig { returns(T.nilable(String)) }
+      attr_accessor :base_amount
+
+      # The percentage that may be used, in conjunction with the charge base amount, to
+      # calculate the charge amount. To state 20%, use value 20
+      sig { returns(T.nilable(String)) }
+      attr_accessor :multiplier_factor
+
+      # The reason for the charge
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reason
+
+      # The code for the charge reason
+      sig { returns(T.nilable(String)) }
+      attr_accessor :reason_code
+
+      # Duty or tax or fee category codes (Subset of UNCL5305)
+      #
+      # Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
+      sig { returns(T.nilable(EInvoiceAPI::Charge::TaxCode::TaggedSymbol)) }
+      attr_accessor :tax_code
+
+      # The VAT rate, represented as percentage that applies to the charge
+      sig { returns(T.nilable(String)) }
+      attr_accessor :tax_rate
+
+      # A charge is an additional fee for example for late payment, late delivery, etc.
+      sig do
+        params(
+          amount: T.nilable(String),
+          base_amount: T.nilable(String),
+          multiplier_factor: T.nilable(String),
+          reason: T.nilable(String),
+          reason_code: T.nilable(String),
+          tax_code: T.nilable(EInvoiceAPI::Charge::TaxCode::OrSymbol),
+          tax_rate: T.nilable(String)
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # The charge amount, without VAT. Must be rounded to maximum 2 decimals
+        amount: nil,
+        # The base amount that may be used, in conjunction with the charge percentage, to
+        # calculate the charge amount. Must be rounded to maximum 2 decimals
+        base_amount: nil,
+        # The percentage that may be used, in conjunction with the charge base amount, to
+        # calculate the charge amount. To state 20%, use value 20
+        multiplier_factor: nil,
+        # The reason for the charge
+        reason: nil,
+        # The code for the charge reason
+        reason_code: nil,
+        # Duty or tax or fee category codes (Subset of UNCL5305)
+        #
+        # Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
+        tax_code: nil,
+        # The VAT rate, represented as percentage that applies to the charge
+        tax_rate: nil
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            amount: T.nilable(String),
+            base_amount: T.nilable(String),
+            multiplier_factor: T.nilable(String),
+            reason: T.nilable(String),
+            reason_code: T.nilable(String),
+            tax_code: T.nilable(EInvoiceAPI::Charge::TaxCode::TaggedSymbol),
+            tax_rate: T.nilable(String)
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Duty or tax or fee category codes (Subset of UNCL5305)
+      #
+      # Agency: UN/CEFACT Version: D.16B Subset: OpenPEPPOL
+      module TaxCode
+        extend EInvoiceAPI::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias { T.all(Symbol, EInvoiceAPI::Charge::TaxCode) }
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        AE = T.let(:AE, EInvoiceAPI::Charge::TaxCode::TaggedSymbol)
+        E = T.let(:E, EInvoiceAPI::Charge::TaxCode::TaggedSymbol)
+        S = T.let(:S, EInvoiceAPI::Charge::TaxCode::TaggedSymbol)
+        Z = T.let(:Z, EInvoiceAPI::Charge::TaxCode::TaggedSymbol)
+        G = T.let(:G, EInvoiceAPI::Charge::TaxCode::TaggedSymbol)
+        O = T.let(:O, EInvoiceAPI::Charge::TaxCode::TaggedSymbol)
+        K = T.let(:K, EInvoiceAPI::Charge::TaxCode::TaggedSymbol)
+        L = T.let(:L, EInvoiceAPI::Charge::TaxCode::TaggedSymbol)
+        M = T.let(:M, EInvoiceAPI::Charge::TaxCode::TaggedSymbol)
+        B = T.let(:B, EInvoiceAPI::Charge::TaxCode::TaggedSymbol)
+
+        sig do
+          override.returns(T::Array[EInvoiceAPI::Charge::TaxCode::TaggedSymbol])
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end