facturx 1.0.0 → 1.2.0

data/rbi/facturx.rbi

@@ -1,17 +1,25 @@
 # typed: strict
 
 module Facturx
+  VERSION = T.let(T.unsafe(nil), String)
+
   class Error < StandardError
+    sig { params(message: T.nilable(String), details: T.untyped).void }
+    def initialize(message = nil, **details); end
+
     sig { returns(T::Hash[Symbol, T.untyped]) }
     attr_reader :details
   end
 
-  class InvalidXmlError < Error; end
+  class ValidationError < Error; end
+  class InvalidDocumentError < ValidationError; end
+  class InvalidXmlError < ValidationError; end
   class UnknownProfileError < InvalidXmlError; end
   class XsdValidationError < InvalidXmlError; end
+  class SchematronValidationError < InvalidXmlError; end
+  class SchemaLoadError < Error; end
+  class InvalidSourceError < Error; end
   class UnsupportedProfileError < Error; end
-  class FormattingError < Error; end
-  class ConformanceError < Error; end
   class InvalidPdfError < Error; end
   class ProtectedPdfError < InvalidPdfError; end
   class ComposerUnavailableError < Error; end
@@ -20,8 +28,8 @@ module Facturx
   class VerificationError < Error; end
 
   class << self
-    sig { params(xml: String).returns(TrueClass) }
-    def verify_xml(xml:); end
+    sig { params(xml: String).returns(Facturx::Validation::Report) }
+    def validate_xml(xml:); end
 
     sig { params(pdf: String, xml: String).returns(String) }
     def attach(pdf:, xml:); end
@@ -37,7 +45,7 @@ module Facturx
 
     sig do
       params(document: Facturx::Document, profile: T.any(Symbol, Facturx::Profile))
-        .returns(Facturx::Conformance::Report)
+        .returns(Facturx::Validation::Report)
     end
     def validate_document(document:, profile:); end
 
@@ -51,10 +59,27 @@ module Facturx
     def generate(pdf:, document:, profile:); end
   end
 
-  module Conformance
+  module Validation
     class Issue
+      sig do
+        params(
+          code: Symbol,
+          message: String,
+          layer: Symbol,
+          severity: Symbol,
+          term_id: T.nilable(String),
+          group_id: T.nilable(String),
+          path: T.nilable(String),
+          line: T.nilable(Integer),
+          column: T.nilable(Integer),
+          details: T::Hash[Symbol, T.untyped]
+        ).void
+      end
+      def initialize(code:, message:, layer:, severity: :error, term_id: nil, group_id: nil, path: nil,
+                     line: nil, column: nil, details: {}); end
+
       sig { returns(Symbol) }
-      attr_reader :code
+      attr_reader :code, :layer, :severity
 
       sig { returns(String) }
       attr_reader :message
@@ -62,15 +87,39 @@ module Facturx
       sig { returns(T.nilable(String)) }
       attr_reader :term_id, :group_id, :path
 
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :line, :column
+
       sig { returns(T::Hash[Symbol, T.untyped]) }
       attr_reader :details
+
+      sig do
+        params(
+          code: Symbol,
+          message: String,
+          layer: Symbol,
+          severity: Symbol,
+          term_id: T.nilable(String),
+          group_id: T.nilable(String),
+          path: T.nilable(String),
+          line: T.nilable(Integer),
+          column: T.nilable(Integer),
+          details: T::Hash[Symbol, T.untyped]
+        ).returns(Facturx::Validation::Issue)
+      end
+      def with(code: self.code, message: self.message, layer: self.layer, severity: self.severity,
+               term_id: self.term_id, group_id: self.group_id, path: self.path, line: self.line,
+               column: self.column, details: self.details); end
     end
 
     class Report
-      sig { returns(Facturx::Profile) }
+      sig { params(profile: T.nilable(Facturx::Profile), issues: T::Array[Facturx::Validation::Issue]).void }
+      def initialize(profile: nil, issues: []); end
+
+      sig { returns(T.nilable(Facturx::Profile)) }
       attr_reader :profile
 
-      sig { returns(T::Array[Facturx::Conformance::Issue]) }
+      sig { returns(T::Array[Facturx::Validation::Issue]) }
       attr_reader :issues
 
       sig { returns(T::Boolean) }
@@ -78,48 +127,58 @@ module Facturx
 
       sig { returns(T::Boolean) }
       def invalid?; end
-    end
-  end
 
-  class ProfileResolver
-    sig { params(profile: T.any(Symbol, Facturx::Profile)).returns(Facturx::Profile) }
-    def call(profile); end
-  end
-
-  class Writer
-    sig { params(document: Facturx::Document, profile: Facturx::Profile).returns(String) }
-    def call(document:, profile:); end
-
-    sig do
-      params(document: Facturx::Document, profile: Facturx::Profile)
-        .returns(Facturx::Conformance::Report)
-    end
-    def validate(document:, profile:); end
-  end
-
-  class Generate
-    sig do
-      params(pdf: String, document: Facturx::Document, profile: T.any(Symbol, Facturx::Profile))
-        .returns(String)
+      sig do
+        params(profile: T.nilable(Facturx::Profile), issues: T::Array[Facturx::Validation::Issue])
+          .returns(Facturx::Validation::Report)
+      end
+      def with(profile: self.profile, issues: self.issues); end
     end
-    def call(pdf:, document:, profile:); end
   end
 
   class Profile
+    sig { params(id: Symbol, guideline_urn: String, conformance_level: String).void }
+    def initialize(id:, guideline_urn:, conformance_level:); end
+
     sig { returns(Symbol) }
     def id; end
 
     sig { returns(String) }
     def guideline_urn; end
 
-    sig { returns(String) }
-    def xsd_path; end
-
     sig { returns(String) }
     def conformance_level; end
+
+    sig do
+      params(id: Symbol, guideline_urn: String, conformance_level: String)
+        .returns(Facturx::Profile)
+    end
+    def with(id: self.id, guideline_urn: self.guideline_urn, conformance_level: self.conformance_level); end
+  end
+
+  module Profiles
+    sig { returns(T::Array[Facturx::Profile]) }
+    def self.all; end
+
+    sig { params(id: T.any(String, Symbol)).returns(Facturx::Profile) }
+    def self.fetch(id); end
+
+    sig { params(guideline_urn: String).returns(T.nilable(Facturx::Profile)) }
+    def self.for_guideline_urn(guideline_urn); end
   end
 
   class Diagnostic
+    sig do
+      params(
+        code: Symbol,
+        message: String,
+        term_id: T.nilable(String),
+        path: T.nilable(String),
+        details: T::Hash[Symbol, T.untyped]
+      ).void
+    end
+    def initialize(code:, message:, term_id: nil, path: nil, details: {}); end
+
     sig { returns(Symbol) }
     def code; end
 
@@ -134,9 +193,32 @@ module Facturx
 
     sig { returns(T::Hash[T.untyped, T.untyped]) }
     def details; end
+
+    sig do
+      params(
+        code: Symbol,
+        message: String,
+        term_id: T.nilable(String),
+        path: T.nilable(String),
+        details: T::Hash[Symbol, T.untyped]
+      ).returns(Facturx::Diagnostic)
+    end
+    def with(code: self.code, message: self.message, term_id: self.term_id, path: self.path,
+             details: self.details); end
   end
 
   class Reading
+    sig do
+      params(
+        document: Facturx::Document,
+        profile: Facturx::Profile,
+        source: String,
+        diagnostics: T::Array[Facturx::Diagnostic],
+        source_type: Symbol
+      ).void
+    end
+    def initialize(document:, profile:, source:, diagnostics: [], source_type: :xml); end
+
     sig { returns(Facturx::Document) }
     def document; end
 
@@ -151,42 +233,137 @@ module Facturx
 
     sig { returns(Symbol) }
     def source_type; end
+
+    sig do
+      params(
+        document: Facturx::Document,
+        profile: Facturx::Profile,
+        source: String,
+        diagnostics: T::Array[Facturx::Diagnostic],
+        source_type: Symbol
+      ).returns(Facturx::Reading)
+    end
+    def with(document: self.document, profile: self.profile, source: self.source,
+             diagnostics: self.diagnostics, source_type: self.source_type); end
   end
 
   class Note
+    sig { params(content: T.nilable(String), subject_code: T.nilable(String)).void }
+    def initialize(content: nil, subject_code: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :content, :subject_code
+
+    sig { params(content: T.nilable(String), subject_code: T.nilable(String)).returns(Facturx::Note) }
+    def with(content: self.content, subject_code: self.subject_code); end
   end
 
   class Identifier
+    sig { params(value: T.nilable(String), scheme_id: T.nilable(String)).void }
+    def initialize(value: nil, scheme_id: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :value, :scheme_id
+
+    sig { params(value: T.nilable(String), scheme_id: T.nilable(String)).returns(Facturx::Identifier) }
+    def with(value: self.value, scheme_id: self.scheme_id); end
   end
 
   class Period
+    sig { params(start_date: T.nilable(::Date), end_date: T.nilable(::Date)).void }
+    def initialize(start_date: nil, end_date: nil); end
+
     sig { returns(T.nilable(::Date)) }
     attr_reader :start_date, :end_date
+
+    sig { params(start_date: T.nilable(::Date), end_date: T.nilable(::Date)).returns(Facturx::Period) }
+    def with(start_date: self.start_date, end_date: self.end_date); end
   end
 
   class Quantity
+    sig { params(value: T.nilable(T.any(::BigDecimal, Integer)), unit_code: T.nilable(String)).void }
+    def initialize(value: nil, unit_code: nil); end
+
     sig { returns(T.nilable(T.any(::BigDecimal, Integer))) }
     attr_reader :value
 
     sig { returns(T.nilable(String)) }
     attr_reader :unit_code
+
+    sig do
+      params(value: T.nilable(T.any(::BigDecimal, Integer)), unit_code: T.nilable(String))
+        .returns(Facturx::Quantity)
+    end
+    def with(value: self.value, unit_code: self.unit_code); end
   end
 
   class Contact
+    sig { params(name: T.nilable(String), telephone: T.nilable(String), email: T.nilable(String)).void }
+    def initialize(name: nil, telephone: nil, email: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :name, :telephone, :email
+
+    sig do
+      params(name: T.nilable(String), telephone: T.nilable(String), email: T.nilable(String))
+        .returns(Facturx::Contact)
+    end
+    def with(name: self.name, telephone: self.telephone, email: self.email); end
   end
 
   class Address
+    sig do
+      params(
+        postcode: T.nilable(String),
+        line_one: T.nilable(String),
+        line_two: T.nilable(String),
+        line_three: T.nilable(String),
+        city: T.nilable(String),
+        country_code: T.nilable(String),
+        country_subdivision: T.nilable(String)
+      ).void
+    end
+    def initialize(postcode: nil, line_one: nil, line_two: nil, line_three: nil, city: nil,
+                   country_code: nil, country_subdivision: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :postcode, :line_one, :line_two, :line_three, :city, :country_code, :country_subdivision
+
+    sig do
+      params(
+        postcode: T.nilable(String),
+        line_one: T.nilable(String),
+        line_two: T.nilable(String),
+        line_three: T.nilable(String),
+        city: T.nilable(String),
+        country_code: T.nilable(String),
+        country_subdivision: T.nilable(String)
+      ).returns(Facturx::Address)
+    end
+    def with(postcode: self.postcode, line_one: self.line_one, line_two: self.line_two,
+             line_three: self.line_three, city: self.city, country_code: self.country_code,
+             country_subdivision: self.country_subdivision); end
   end
 
   class Party
+    sig do
+      params(
+        identifiers: T::Array[Facturx::Identifier],
+        name: T.nilable(String),
+        description: T.nilable(String),
+        legal_registration: T.nilable(Facturx::Identifier),
+        trading_name: T.nilable(String),
+        address: T.nilable(Facturx::Address),
+        vat_identifier: T.nilable(Facturx::Identifier),
+        tax_identifier: T.nilable(Facturx::Identifier),
+        electronic_address: T.nilable(Facturx::Identifier),
+        contact: T.nilable(Facturx::Contact)
+      ).void
+    end
+    def initialize(identifiers: [], name: nil, description: nil, legal_registration: nil,
+                   trading_name: nil, address: nil, vat_identifier: nil, tax_identifier: nil,
+                   electronic_address: nil, contact: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :name, :description, :trading_name
 
@@ -210,9 +387,38 @@ module Facturx
 
     sig { returns(T.nilable(Facturx::Contact)) }
     def contact; end
+
+    sig do
+      params(
+        identifiers: T::Array[Facturx::Identifier],
+        name: T.nilable(String),
+        description: T.nilable(String),
+        legal_registration: T.nilable(Facturx::Identifier),
+        trading_name: T.nilable(String),
+        address: T.nilable(Facturx::Address),
+        vat_identifier: T.nilable(Facturx::Identifier),
+        tax_identifier: T.nilable(Facturx::Identifier),
+        electronic_address: T.nilable(Facturx::Identifier),
+        contact: T.nilable(Facturx::Contact)
+      ).returns(Facturx::Party)
+    end
+    def with(identifiers: self.identifiers, name: self.name, description: self.description,
+             legal_registration: self.legal_registration, trading_name: self.trading_name,
+             address: self.address, vat_identifier: self.vat_identifier,
+             tax_identifier: self.tax_identifier, electronic_address: self.electronic_address,
+             contact: self.contact); end
   end
 
   class CreditTransfer
+    sig do
+      params(
+        account_identifier: T.nilable(Facturx::Identifier),
+        account_name: T.nilable(String),
+        provider_identifier: T.nilable(Facturx::Identifier)
+      ).void
+    end
+    def initialize(account_identifier: nil, account_name: nil, provider_identifier: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :account_name
 
@@ -221,14 +427,42 @@ module Facturx
 
     sig { returns(T.nilable(Facturx::Identifier)) }
     def provider_identifier; end
+
+    sig do
+      params(
+        account_identifier: T.nilable(Facturx::Identifier),
+        account_name: T.nilable(String),
+        provider_identifier: T.nilable(Facturx::Identifier)
+      ).returns(Facturx::CreditTransfer)
+    end
+    def with(account_identifier: self.account_identifier, account_name: self.account_name,
+             provider_identifier: self.provider_identifier); end
   end
 
   class PaymentCard
+    sig { params(primary_account_number: T.nilable(String), holder_name: T.nilable(String)).void }
+    def initialize(primary_account_number: nil, holder_name: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :primary_account_number, :holder_name
+
+    sig do
+      params(primary_account_number: T.nilable(String), holder_name: T.nilable(String))
+        .returns(Facturx::PaymentCard)
+    end
+    def with(primary_account_number: self.primary_account_number, holder_name: self.holder_name); end
   end
 
   class DirectDebit
+    sig do
+      params(
+        mandate_identifier: T.nilable(Facturx::Identifier),
+        creditor_identifier: T.nilable(Facturx::Identifier),
+        debtor_account_identifier: T.nilable(Facturx::Identifier)
+      ).void
+    end
+    def initialize(mandate_identifier: nil, creditor_identifier: nil, debtor_account_identifier: nil); end
+
     sig { returns(T.nilable(Facturx::Identifier)) }
     def mandate_identifier; end
 
@@ -237,9 +471,32 @@ module Facturx
 
     sig { returns(T.nilable(Facturx::Identifier)) }
     def debtor_account_identifier; end
+
+    sig do
+      params(
+        mandate_identifier: T.nilable(Facturx::Identifier),
+        creditor_identifier: T.nilable(Facturx::Identifier),
+        debtor_account_identifier: T.nilable(Facturx::Identifier)
+      ).returns(Facturx::DirectDebit)
+    end
+    def with(mandate_identifier: self.mandate_identifier, creditor_identifier: self.creditor_identifier,
+             debtor_account_identifier: self.debtor_account_identifier); end
   end
 
   class PaymentInstructions
+    sig do
+      params(
+        means_code: T.nilable(String),
+        means_text: T.nilable(String),
+        remittance_information: T.nilable(String),
+        credit_transfers: T::Array[Facturx::CreditTransfer],
+        payment_card: T.nilable(Facturx::PaymentCard),
+        direct_debit: T.nilable(Facturx::DirectDebit)
+      ).void
+    end
+    def initialize(means_code: nil, means_text: nil, remittance_information: nil,
+                   credit_transfers: [], payment_card: nil, direct_debit: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :means_code, :means_text, :remittance_information
 
@@ -251,17 +508,61 @@ module Facturx
 
     sig { returns(T.nilable(Facturx::DirectDebit)) }
     def direct_debit; end
+
+    sig do
+      params(
+        means_code: T.nilable(String),
+        means_text: T.nilable(String),
+        remittance_information: T.nilable(String),
+        credit_transfers: T::Array[Facturx::CreditTransfer],
+        payment_card: T.nilable(Facturx::PaymentCard),
+        direct_debit: T.nilable(Facturx::DirectDebit)
+      ).returns(Facturx::PaymentInstructions)
+    end
+    def with(means_code: self.means_code, means_text: self.means_text,
+             remittance_information: self.remittance_information,
+             credit_transfers: self.credit_transfers, payment_card: self.payment_card,
+             direct_debit: self.direct_debit); end
   end
 
   class DocumentReference
+    sig do
+      params(
+        id: T.nilable(String),
+        line_id: T.nilable(String),
+        name: T.nilable(String),
+        issue_date: T.nilable(::Date)
+      ).void
+    end
+    def initialize(id: nil, line_id: nil, name: nil, issue_date: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :id, :line_id, :name
 
     sig { returns(T.nilable(::Date)) }
     attr_reader :issue_date
+
+    sig do
+      params(
+        id: T.nilable(String),
+        line_id: T.nilable(String),
+        name: T.nilable(String),
+        issue_date: T.nilable(::Date)
+      ).returns(Facturx::DocumentReference)
+    end
+    def with(id: self.id, line_id: self.line_id, name: self.name, issue_date: self.issue_date); end
   end
 
   class Delivery
+    sig do
+      params(
+        location_identifier: T.nilable(Facturx::Identifier),
+        party: T.nilable(Facturx::Party),
+        date: T.nilable(::Date)
+      ).void
+    end
+    def initialize(location_identifier: nil, party: nil, date: nil); end
+
     sig { returns(T.nilable(::Date)) }
     attr_reader :date
 
@@ -270,24 +571,92 @@ module Facturx
 
     sig { returns(T.nilable(Facturx::Party)) }
     def party; end
+
+    sig do
+      params(
+        location_identifier: T.nilable(Facturx::Identifier),
+        party: T.nilable(Facturx::Party),
+        date: T.nilable(::Date)
+      ).returns(Facturx::Delivery)
+    end
+    def with(location_identifier: self.location_identifier, party: self.party, date: self.date); end
   end
 
   class SupportingDocument
+    sig do
+      params(
+        reference: T.nilable(String),
+        description: T.nilable(String),
+        external_location: T.nilable(String),
+        content: T.nilable(String),
+        mime_code: T.nilable(String),
+        filename: T.nilable(String)
+      ).void
+    end
+    def initialize(reference: nil, description: nil, external_location: nil, content: nil,
+                   mime_code: nil, filename: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :reference, :description, :external_location, :content, :mime_code, :filename
+
+    sig do
+      params(
+        reference: T.nilable(String),
+        description: T.nilable(String),
+        external_location: T.nilable(String),
+        content: T.nilable(String),
+        mime_code: T.nilable(String),
+        filename: T.nilable(String)
+      ).returns(Facturx::SupportingDocument)
+    end
+    def with(reference: self.reference, description: self.description,
+             external_location: self.external_location, content: self.content,
+             mime_code: self.mime_code, filename: self.filename); end
   end
 
   class ProductAttribute
+    sig { params(name: T.nilable(String), value: T.nilable(String)).void }
+    def initialize(name: nil, value: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :name, :value
+
+    sig { params(name: T.nilable(String), value: T.nilable(String)).returns(Facturx::ProductAttribute) }
+    def with(name: self.name, value: self.value); end
   end
 
   class ProductClassification
+    sig do
+      params(code: T.nilable(String), list_id: T.nilable(String), list_version_id: T.nilable(String)).void
+    end
+    def initialize(code: nil, list_id: nil, list_version_id: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :code, :list_id, :list_version_id
+
+    sig do
+      params(code: T.nilable(String), list_id: T.nilable(String), list_version_id: T.nilable(String))
+        .returns(Facturx::ProductClassification)
+    end
+    def with(code: self.code, list_id: self.list_id, list_version_id: self.list_version_id); end
   end
 
   class Product
+    sig do
+      params(
+        name: T.nilable(String),
+        description: T.nilable(String),
+        seller_identifier: T.nilable(Facturx::Identifier),
+        buyer_identifier: T.nilable(Facturx::Identifier),
+        global_identifier: T.nilable(Facturx::Identifier),
+        attributes: T::Array[Facturx::ProductAttribute],
+        classifications: T::Array[Facturx::ProductClassification],
+        origin_country_code: T.nilable(String)
+      ).void
+    end
+    def initialize(name: nil, description: nil, seller_identifier: nil, buyer_identifier: nil,
+                   global_identifier: nil, attributes: [], classifications: [], origin_country_code: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :name, :description, :origin_country_code
 
@@ -305,25 +674,107 @@ module Facturx
 
     sig { returns(T::Array[Facturx::ProductClassification]) }
     def classifications; end
+
+    sig do
+      params(
+        name: T.nilable(String),
+        description: T.nilable(String),
+        seller_identifier: T.nilable(Facturx::Identifier),
+        buyer_identifier: T.nilable(Facturx::Identifier),
+        global_identifier: T.nilable(Facturx::Identifier),
+        attributes: T::Array[Facturx::ProductAttribute],
+        classifications: T::Array[Facturx::ProductClassification],
+        origin_country_code: T.nilable(String)
+      ).returns(Facturx::Product)
+    end
+    def with(name: self.name, description: self.description,
+             seller_identifier: self.seller_identifier, buyer_identifier: self.buyer_identifier,
+             global_identifier: self.global_identifier, attributes: self.attributes,
+             classifications: self.classifications, origin_country_code: self.origin_country_code); end
   end
 
   class Price
+    sig do
+      params(
+        amount: T.nilable(T.any(::BigDecimal, Integer)),
+        basis_quantity: T.nilable(Facturx::Quantity),
+        discount: T.nilable(T.any(::BigDecimal, Integer))
+      ).void
+    end
+    def initialize(amount: nil, basis_quantity: nil, discount: nil); end
+
     sig { returns(T.nilable(T.any(::BigDecimal, Integer))) }
     attr_reader :amount, :discount
 
     sig { returns(T.nilable(Facturx::Quantity)) }
     def basis_quantity; end
+
+    sig do
+      params(
+        amount: T.nilable(T.any(::BigDecimal, Integer)),
+        basis_quantity: T.nilable(Facturx::Quantity),
+        discount: T.nilable(T.any(::BigDecimal, Integer))
+      ).returns(Facturx::Price)
+    end
+    def with(amount: self.amount, basis_quantity: self.basis_quantity, discount: self.discount); end
   end
 
   class TaxBreakdown
+    sig do
+      params(
+        type_code: T.nilable(String),
+        category_code: T.nilable(String),
+        rate: T.nilable(T.any(::BigDecimal, Integer)),
+        basis_amount: T.nilable(T.any(::BigDecimal, Integer)),
+        tax_amount: T.nilable(T.any(::BigDecimal, Integer)),
+        exemption_reason: T.nilable(String),
+        exemption_reason_code: T.nilable(String),
+        due_date_type_code: T.nilable(String)
+      ).void
+    end
+    def initialize(type_code: nil, category_code: nil, rate: nil, basis_amount: nil, tax_amount: nil,
+                   exemption_reason: nil, exemption_reason_code: nil, due_date_type_code: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :type_code, :category_code, :exemption_reason, :exemption_reason_code, :due_date_type_code
 
     sig { returns(T.nilable(T.any(::BigDecimal, Integer))) }
     attr_reader :rate, :basis_amount, :tax_amount
+
+    sig do
+      params(
+        type_code: T.nilable(String),
+        category_code: T.nilable(String),
+        rate: T.nilable(T.any(::BigDecimal, Integer)),
+        basis_amount: T.nilable(T.any(::BigDecimal, Integer)),
+        tax_amount: T.nilable(T.any(::BigDecimal, Integer)),
+        exemption_reason: T.nilable(String),
+        exemption_reason_code: T.nilable(String),
+        due_date_type_code: T.nilable(String)
+      ).returns(Facturx::TaxBreakdown)
+    end
+    def with(type_code: self.type_code, category_code: self.category_code, rate: self.rate,
+             basis_amount: self.basis_amount, tax_amount: self.tax_amount,
+             exemption_reason: self.exemption_reason,
+             exemption_reason_code: self.exemption_reason_code,
+             due_date_type_code: self.due_date_type_code); end
   end
 
   class AllowanceCharge
+    sig do
+      params(
+        indicator: T.nilable(T::Boolean),
+        amount: T.nilable(T.any(::BigDecimal, Integer)),
+        base_amount: T.nilable(T.any(::BigDecimal, Integer)),
+        percentage: T.nilable(T.any(::BigDecimal, Integer)),
+        reason: T.nilable(String),
+        reason_code: T.nilable(String),
+        tax: T.nilable(Facturx::TaxBreakdown)
+      ).void
+    end
+    def initialize(indicator: nil, amount: nil, base_amount: nil, percentage: nil, reason: nil,
+                   reason_code: nil, tax: nil); end
+
     sig { returns(T.nilable(T::Boolean)) }
     attr_reader :indicator
 
@@ -335,15 +786,91 @@ module Facturx
 
     sig { returns(T.nilable(Facturx::TaxBreakdown)) }
     def tax; end
+
+    sig do
+      params(
+        indicator: T.nilable(T::Boolean),
+        amount: T.nilable(T.any(::BigDecimal, Integer)),
+        base_amount: T.nilable(T.any(::BigDecimal, Integer)),
+        percentage: T.nilable(T.any(::BigDecimal, Integer)),
+        reason: T.nilable(String),
+        reason_code: T.nilable(String),
+        tax: T.nilable(Facturx::TaxBreakdown)
+      ).returns(Facturx::AllowanceCharge)
+    end
+    def with(indicator: self.indicator, amount: self.amount, base_amount: self.base_amount,
+             percentage: self.percentage, reason: self.reason, reason_code: self.reason_code,
+             tax: self.tax); end
   end
 
   class Totals
+    sig do
+      params(
+        line_total: T.nilable(T.any(::BigDecimal, Integer)),
+        charge_total: T.nilable(T.any(::BigDecimal, Integer)),
+        allowance_total: T.nilable(T.any(::BigDecimal, Integer)),
+        tax_basis_total: T.nilable(T.any(::BigDecimal, Integer)),
+        tax_total: T.nilable(T.any(::BigDecimal, Integer)),
+        tax_total_in_tax_currency: T.nilable(T.any(::BigDecimal, Integer)),
+        grand_total: T.nilable(T.any(::BigDecimal, Integer)),
+        prepaid: T.nilable(T.any(::BigDecimal, Integer)),
+        rounding: T.nilable(T.any(::BigDecimal, Integer)),
+        due_payable: T.nilable(T.any(::BigDecimal, Integer))
+      ).void
+    end
+    def initialize(line_total: nil, charge_total: nil, allowance_total: nil, tax_basis_total: nil,
+                   tax_total: nil, tax_total_in_tax_currency: nil, grand_total: nil, prepaid: nil,
+                   rounding: nil, due_payable: nil); end
+
     sig { returns(T.nilable(T.any(::BigDecimal, Integer))) }
     attr_reader :line_total, :charge_total, :allowance_total, :tax_basis_total, :tax_total,
                 :tax_total_in_tax_currency, :grand_total, :prepaid, :rounding, :due_payable
+
+    sig do
+      params(
+        line_total: T.nilable(T.any(::BigDecimal, Integer)),
+        charge_total: T.nilable(T.any(::BigDecimal, Integer)),
+        allowance_total: T.nilable(T.any(::BigDecimal, Integer)),
+        tax_basis_total: T.nilable(T.any(::BigDecimal, Integer)),
+        tax_total: T.nilable(T.any(::BigDecimal, Integer)),
+        tax_total_in_tax_currency: T.nilable(T.any(::BigDecimal, Integer)),
+        grand_total: T.nilable(T.any(::BigDecimal, Integer)),
+        prepaid: T.nilable(T.any(::BigDecimal, Integer)),
+        rounding: T.nilable(T.any(::BigDecimal, Integer)),
+        due_payable: T.nilable(T.any(::BigDecimal, Integer))
+      ).returns(Facturx::Totals)
+    end
+    def with(line_total: self.line_total, charge_total: self.charge_total,
+             allowance_total: self.allowance_total, tax_basis_total: self.tax_basis_total,
+             tax_total: self.tax_total, tax_total_in_tax_currency: self.tax_total_in_tax_currency,
+             grand_total: self.grand_total, prepaid: self.prepaid, rounding: self.rounding,
+             due_payable: self.due_payable); end
   end
 
   class Line
+    sig do
+      params(
+        id: T.nilable(String),
+        note: T.nilable(String),
+        product: T.nilable(Facturx::Product),
+        quantity: T.nilable(Facturx::Quantity),
+        gross_price: T.nilable(Facturx::Price),
+        net_price: T.nilable(Facturx::Price),
+        tax: T.nilable(Facturx::TaxBreakdown),
+        period: T.nilable(Facturx::Period),
+        net_amount: T.nilable(T.any(::BigDecimal, Integer)),
+        allowances: T::Array[Facturx::AllowanceCharge],
+        charges: T::Array[Facturx::AllowanceCharge],
+        buyer_order_reference: T.nilable(Facturx::DocumentReference),
+        invoiced_object_identifier: T.nilable(Facturx::Identifier),
+        buyer_accounting_reference: T.nilable(String)
+      ).void
+    end
+    def initialize(id: nil, note: nil, product: nil, quantity: nil, gross_price: nil,
+                   net_price: nil, tax: nil, period: nil, net_amount: nil, allowances: [], charges: [],
+                   buyer_order_reference: nil, invoiced_object_identifier: nil,
+                   buyer_accounting_reference: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :id, :note, :buyer_accounting_reference
 
@@ -379,9 +906,86 @@ module Facturx
 
     sig { returns(T.nilable(Facturx::Identifier)) }
     def invoiced_object_identifier; end
+
+    sig do
+      params(
+        id: T.nilable(String),
+        note: T.nilable(String),
+        product: T.nilable(Facturx::Product),
+        quantity: T.nilable(Facturx::Quantity),
+        gross_price: T.nilable(Facturx::Price),
+        net_price: T.nilable(Facturx::Price),
+        tax: T.nilable(Facturx::TaxBreakdown),
+        period: T.nilable(Facturx::Period),
+        net_amount: T.nilable(T.any(::BigDecimal, Integer)),
+        allowances: T::Array[Facturx::AllowanceCharge],
+        charges: T::Array[Facturx::AllowanceCharge],
+        buyer_order_reference: T.nilable(Facturx::DocumentReference),
+        invoiced_object_identifier: T.nilable(Facturx::Identifier),
+        buyer_accounting_reference: T.nilable(String)
+      ).returns(Facturx::Line)
+    end
+    def with(id: self.id, note: self.note, product: self.product, quantity: self.quantity,
+             gross_price: self.gross_price, net_price: self.net_price, tax: self.tax,
+             period: self.period, net_amount: self.net_amount, allowances: self.allowances,
+             charges: self.charges, buyer_order_reference: self.buyer_order_reference,
+             invoiced_object_identifier: self.invoiced_object_identifier,
+             buyer_accounting_reference: self.buyer_accounting_reference); end
   end
 
   class Document
+    sig do
+      params(
+        guideline_urn: T.nilable(String),
+        business_process: T.nilable(String),
+        invoice_number: T.nilable(String),
+        type_code: T.nilable(String),
+        issue_date: T.nilable(::Date),
+        notes: T::Array[Facturx::Note],
+        currency: T.nilable(String),
+        tax_currency: T.nilable(String),
+        vat_point_date: T.nilable(::Date),
+        vat_point_date_code: T.nilable(String),
+        buyer_reference: T.nilable(String),
+        project_reference: T.nilable(Facturx::DocumentReference),
+        contract_reference: T.nilable(Facturx::DocumentReference),
+        purchase_order_reference: T.nilable(Facturx::DocumentReference),
+        sales_order_reference: T.nilable(Facturx::DocumentReference),
+        receiving_advice_reference: T.nilable(Facturx::DocumentReference),
+        despatch_advice_reference: T.nilable(Facturx::DocumentReference),
+        tender_or_lot_reference: T.nilable(Facturx::DocumentReference),
+        invoiced_object_identifier: T.nilable(Facturx::Identifier),
+        seller: T.nilable(Facturx::Party),
+        buyer: T.nilable(Facturx::Party),
+        payee: T.nilable(Facturx::Party),
+        tax_representative: T.nilable(Facturx::Party),
+        delivery: T.nilable(Facturx::Delivery),
+        billing_period: T.nilable(Facturx::Period),
+        payment: T.nilable(Facturx::PaymentInstructions),
+        payment_terms: T.nilable(String),
+        payment_due_date: T.nilable(::Date),
+        lines: T::Array[Facturx::Line],
+        tax_breakdowns: T::Array[Facturx::TaxBreakdown],
+        allowances: T::Array[Facturx::AllowanceCharge],
+        charges: T::Array[Facturx::AllowanceCharge],
+        totals: T.nilable(Facturx::Totals),
+        preceding_invoices: T::Array[Facturx::DocumentReference],
+        supporting_documents: T::Array[Facturx::SupportingDocument],
+        buyer_accounting_reference: T.nilable(String)
+      ).void
+    end
+    def initialize(guideline_urn: nil, business_process: nil, invoice_number: nil, type_code: nil,
+                   issue_date: nil, notes: [], currency: nil, tax_currency: nil,
+                   vat_point_date: nil, vat_point_date_code: nil, buyer_reference: nil,
+                   project_reference: nil, contract_reference: nil, purchase_order_reference: nil,
+                   sales_order_reference: nil, receiving_advice_reference: nil,
+                   despatch_advice_reference: nil, tender_or_lot_reference: nil,
+                   invoiced_object_identifier: nil, seller: nil, buyer: nil, payee: nil,
+                   tax_representative: nil, delivery: nil, billing_period: nil, payment: nil,
+                   payment_terms: nil, payment_due_date: nil, lines: [], tax_breakdowns: [],
+                   allowances: [], charges: [], totals: nil, preceding_invoices: [],
+                   supporting_documents: [], buyer_accounting_reference: nil); end
+
     sig { returns(T.nilable(String)) }
     attr_reader :guideline_urn, :business_process, :invoice_number, :type_code, :currency, :tax_currency,
                 :vat_point_date_code, :buyer_reference, :buyer_accounting_reference, :payment_terms
@@ -465,6 +1069,66 @@ module Facturx
 
     sig { returns(T::Array[Facturx::SupportingDocument]) }
     def supporting_documents; end
+
+    sig do
+      params(
+        guideline_urn: T.nilable(String),
+        business_process: T.nilable(String),
+        invoice_number: T.nilable(String),
+        type_code: T.nilable(String),
+        issue_date: T.nilable(::Date),
+        notes: T::Array[Facturx::Note],
+        currency: T.nilable(String),
+        tax_currency: T.nilable(String),
+        vat_point_date: T.nilable(::Date),
+        vat_point_date_code: T.nilable(String),
+        buyer_reference: T.nilable(String),
+        project_reference: T.nilable(Facturx::DocumentReference),
+        contract_reference: T.nilable(Facturx::DocumentReference),
+        purchase_order_reference: T.nilable(Facturx::DocumentReference),
+        sales_order_reference: T.nilable(Facturx::DocumentReference),
+        receiving_advice_reference: T.nilable(Facturx::DocumentReference),
+        despatch_advice_reference: T.nilable(Facturx::DocumentReference),
+        tender_or_lot_reference: T.nilable(Facturx::DocumentReference),
+        invoiced_object_identifier: T.nilable(Facturx::Identifier),
+        seller: T.nilable(Facturx::Party),
+        buyer: T.nilable(Facturx::Party),
+        payee: T.nilable(Facturx::Party),
+        tax_representative: T.nilable(Facturx::Party),
+        delivery: T.nilable(Facturx::Delivery),
+        billing_period: T.nilable(Facturx::Period),
+        payment: T.nilable(Facturx::PaymentInstructions),
+        payment_terms: T.nilable(String),
+        payment_due_date: T.nilable(::Date),
+        lines: T::Array[Facturx::Line],
+        tax_breakdowns: T::Array[Facturx::TaxBreakdown],
+        allowances: T::Array[Facturx::AllowanceCharge],
+        charges: T::Array[Facturx::AllowanceCharge],
+        totals: T.nilable(Facturx::Totals),
+        preceding_invoices: T::Array[Facturx::DocumentReference],
+        supporting_documents: T::Array[Facturx::SupportingDocument],
+        buyer_accounting_reference: T.nilable(String)
+      ).returns(Facturx::Document)
+    end
+    def with(guideline_urn: self.guideline_urn, business_process: self.business_process,
+             invoice_number: self.invoice_number, type_code: self.type_code, issue_date: self.issue_date,
+             notes: self.notes, currency: self.currency, tax_currency: self.tax_currency,
+             vat_point_date: self.vat_point_date, vat_point_date_code: self.vat_point_date_code,
+             buyer_reference: self.buyer_reference, project_reference: self.project_reference,
+             contract_reference: self.contract_reference,
+             purchase_order_reference: self.purchase_order_reference,
+             sales_order_reference: self.sales_order_reference,
+             receiving_advice_reference: self.receiving_advice_reference,
+             despatch_advice_reference: self.despatch_advice_reference,
+             tender_or_lot_reference: self.tender_or_lot_reference,
+             invoiced_object_identifier: self.invoiced_object_identifier, seller: self.seller,
+             buyer: self.buyer, payee: self.payee, tax_representative: self.tax_representative,
+             delivery: self.delivery, billing_period: self.billing_period, payment: self.payment,
+             payment_terms: self.payment_terms, payment_due_date: self.payment_due_date,
+             lines: self.lines, tax_breakdowns: self.tax_breakdowns, allowances: self.allowances,
+             charges: self.charges, totals: self.totals, preceding_invoices: self.preceding_invoices,
+             supporting_documents: self.supporting_documents,
+             buyer_accounting_reference: self.buyer_accounting_reference); end
   end
 
   module Builders
@@ -1087,4 +1751,6 @@ module Facturx
       def build; end
     end
   end
+
+  private_constant :Builders
 end