zipdatev 0.1.0

data/lib/zipdatev/generators/ledger_xml.rb

@@ -0,0 +1,144 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+module ZipDatev
+  module Generators
+    # Generates DATEV ledger XML files for accountsPayableLedger entries.
+    #
+    # Each invoice generates one ledger XML file containing the accounting
+    # data. Single-line invoices produce one accountsPayableLedger entry,
+    # while multi-line invoices produce multiple entries (one per line item).
+    #
+    # @example Generate ledger XML for a simple invoice
+    #   generator = ZipDatev::Generators::LedgerXml.new(
+    #     invoice: invoice,
+    #     generator_info: "MyCompany",
+    #     generating_system: "MyApp"
+    #   )
+    #   xml_doc = generator.generate
+    #
+    # @example Get the suggested filename
+    #   generator.filename  # => "Rechnungsdaten_RE_R2023x101.xml"
+    class LedgerXml < Base
+      # @return [Invoice] The invoice to generate XML for
+      attr_reader :invoice
+
+      # @return [String] Generator information (company name)
+      attr_reader :generator_info
+
+      # @return [String] Generating system identifier
+      attr_reader :generating_system
+
+      # Initialize a new ledger XML generator.
+      #
+      # @param invoice [Invoice] The invoice to generate XML for
+      # @param generator_info [String] Generator information (company name)
+      # @param generating_system [String] Generating system identifier
+      def initialize(invoice:, generator_info:, generating_system:)
+        super()
+        @invoice = invoice
+        @generator_info = generator_info
+        @generating_system = generating_system
+      end
+
+      # Generate the ledger XML document.
+      #
+      # @return [Nokogiri::XML::Document] The generated XML document
+      def generate
+        Nokogiri::XML::Builder.new(encoding: "UTF-8") do |xml|
+          xml.LedgerImport(ledger_import_attributes) do
+            xml.consolidate(consolidate_attributes) do
+              generate_entries(xml)
+            end
+          end
+        end.doc
+      end
+
+      # Get the suggested filename for this ledger XML.
+      #
+      # @return [String] The filename (e.g., "Rechnungsdaten_RE_R2023x101.xml")
+      def filename
+        ledger_filename(invoice.consolidated_invoice_id || invoice.invoice_id)
+      end
+
+      private
+
+      # Attributes for the LedgerImport root element
+      def ledger_import_attributes
+        {
+          "xmlns" => LEDGER_XMLNS,
+          "xmlns:xsi" => XSI_XMLNS,
+          "xsi:schemaLocation" => LEDGER_XSI_SCHEMA_LOCATION,
+          "version" => Base::VERSION,
+          "generator_info" => generator_info,
+          "generating_system" => generating_system,
+          "xml_data" => XML_DATA
+        }
+      end
+
+      # Attributes for the consolidate element
+      def consolidate_attributes
+        attrs = {
+          "consolidatedAmount" => format_decimal(invoice.consolidated_amount),
+          "consolidatedDate" => format_date(invoice.consolidated_date),
+          "consolidatedInvoiceId" => invoice.consolidated_invoice_id,
+          "consolidatedCurrencyCode" => invoice.consolidated_currency_code
+        }
+
+        # Add optional consolidated attributes
+        delivery_date = invoice.consolidated_delivery_date
+        attrs["consolidatedDeliveryDate"] = format_date(delivery_date) if delivery_date
+
+        order_id = invoice.consolidated_order_id
+        attrs["consolidatedOrderId"] = order_id if order_id
+
+        attrs.compact
+      end
+
+      # Generate accountsPayableLedger entries
+      def generate_entries(xml)
+        if invoice.multi_line?
+          invoice.line_items.each do |line_item|
+            generate_entry(xml, line_item)
+          end
+        else
+          generate_entry(xml, invoice)
+        end
+      end
+
+      # Generate a single accountsPayableLedger entry
+      #
+      # @param xml [Nokogiri::XML::Builder] The XML builder
+      # @param source [Invoice, LineItem] The source of attribute values
+      def generate_entry(xml, source)
+        xml.accountsPayableLedger do
+          ACCOUNTS_PAYABLE_LEDGER_ELEMENTS.each do |field|
+            value = get_field_value(source, field)
+            next if value.nil?
+
+            formatted = format_field_value(field, value)
+            next if formatted.nil? || formatted.empty?
+
+            xml.send(to_xml_name(field), formatted)
+          end
+        end
+      end
+
+      # Get a field value from the source, with inheritance from invoice
+      # for line items with nil values.
+      #
+      # @param source [Invoice, LineItem] The primary source
+      # @param field [Symbol] The field name
+      # @return [Object, nil] The field value
+      def get_field_value(source, field)
+        value = source.public_send(field)
+
+        # If source is a line item and value is nil, try invoice
+        value = invoice.public_send(field) if value.nil? && source.is_a?(LineItem)
+
+        value
+      end
+    end
+  end
+end

data/lib/zipdatev/invoice.rb

@@ -0,0 +1,339 @@
+# frozen_string_literal: true
+
+require "active_model"
+require "date"
+
+module ZipDatev
+  # Represents invoice data for a DATEV accountsPayableLedger entry.
+  #
+  # An invoice can either have a single set of values (simple invoice)
+  # or multiple line items (for invoices with multiple tax rates).
+  #
+  # When an invoice has line items, consolidation values are automatically
+  # computed from the line items. When there are no line items, the invoice's
+  # own values are used for consolidation.
+  #
+  # @example Simple invoice with single tax rate
+  #   invoice = ZipDatev::Invoice.new(
+  #     date: Date.new(2023, 1, 12),
+  #     amount: 1190.00,
+  #     currency_code: "EUR",
+  #     invoice_id: "R2023x101",
+  #     tax: 19.00
+  #   )
+  #
+  # @example Invoice with multiple line items
+  #   invoice = ZipDatev::Invoice.new(
+  #     date: Date.new(2023, 2, 5),
+  #     invoice_id: "R-2023-204",
+  #     currency_code: "EUR"
+  #   )
+  #   invoice.add_line_item(amount: 119.00, tax: 19.00, booking_text: "Product A")
+  #   invoice.add_line_item(amount: 107.00, tax: 7.00, booking_text: "Product B")
+  #
+  # @example Invoice with discount terms
+  #   invoice = ZipDatev::Invoice.new(
+  #     date: Date.new(2023, 1, 12),
+  #     amount: 1190.00,
+  #     currency_code: "EUR",
+  #     invoice_id: "R2023x101",
+  #     discount_amount: 35.70,
+  #     discount_percentage: 3.00,
+  #     discount_payment_date: Date.new(2023, 1, 17),
+  #     discount_amount_2: 11.90,
+  #     discount_percentage_2: 1.00,
+  #     discount_payment_date_2: Date.new(2023, 1, 22),
+  #     due_date: Date.new(2023, 1, 26)
+  #   )
+  class Invoice
+    include ActiveModel::Model
+    include ActiveModel::Attributes
+
+    # Required field validations
+    validates :date, presence: true
+    validates :amount, presence: true
+    validates :currency_code, presence: true
+    validates :invoice_id, presence: true
+
+    # Amount validations
+    validates :amount, numericality: {
+      other_than: 0,
+      greater_than_or_equal_to: Constants::MIN_AMOUNT,
+      less_than_or_equal_to: Constants::MAX_AMOUNT
+    }, allow_nil: true
+    validates :amount, decimal_precision: { places: 2 }, allow_nil: true
+
+    # Discount amount validations
+    validates :discount_amount, numericality: {
+      greater_than_or_equal_to: Constants::MIN_DISCOUNT_AMOUNT,
+      less_than_or_equal_to: Constants::MAX_DISCOUNT_AMOUNT
+    }, allow_nil: true
+    validates :discount_amount, decimal_precision: { places: 2 }, allow_nil: true
+
+    validates :discount_amount_2, numericality: {
+      greater_than_or_equal_to: Constants::MIN_DISCOUNT_AMOUNT,
+      less_than_or_equal_to: Constants::MAX_DISCOUNT_AMOUNT
+    }, allow_nil: true
+    validates :discount_amount_2, decimal_precision: { places: 2 }, allow_nil: true
+
+    # Tax validations
+    validates :tax, numericality: {
+      greater_than_or_equal_to: Constants::MIN_TAX,
+      less_than_or_equal_to: Constants::MAX_TAX
+    }, allow_nil: true
+    validates :tax, decimal_precision: { places: 2 }, allow_nil: true
+
+    # Discount percentage validations
+    validates :discount_percentage, numericality: {
+      greater_than_or_equal_to: Constants::MIN_TAX,
+      less_than_or_equal_to: Constants::MAX_TAX
+    }, allow_nil: true
+    validates :discount_percentage, decimal_precision: { places: 2 }, allow_nil: true
+
+    validates :discount_percentage_2, numericality: {
+      greater_than_or_equal_to: Constants::MIN_TAX,
+      less_than_or_equal_to: Constants::MAX_TAX
+    }, allow_nil: true
+    validates :discount_percentage_2, decimal_precision: { places: 2 }, allow_nil: true
+
+    # Exchange rate validations
+    validates :exchange_rate, numericality: {
+      greater_than_or_equal_to: Constants::MIN_EXCHANGE_RATE,
+      less_than_or_equal_to: Constants::MAX_EXCHANGE_RATE
+    }, allow_nil: true
+    validates :exchange_rate, decimal_precision: { places: 6 }, allow_nil: true
+
+    # Cost amount validations
+    validates :cost_amount, decimal_precision: { places: 4 }, allow_nil: true
+
+    # Account number validations
+    validates :account_no, numericality: {
+      only_integer: true,
+      greater_than_or_equal_to: Constants::MIN_ACCOUNT_NO,
+      less_than_or_equal_to: Constants::MAX_ACCOUNT_NO
+    }, allow_nil: true
+
+    validates :bp_account_no, numericality: {
+      only_integer: true,
+      greater_than_or_equal_to: Constants::MIN_BP_ACCOUNT_NO,
+      less_than_or_equal_to: Constants::MAX_BP_ACCOUNT_NO
+    }, allow_nil: true
+
+    validates :bu_code, numericality: {
+      only_integer: true,
+      greater_than_or_equal_to: Constants::MIN_BU_CODE,
+      less_than_or_equal_to: Constants::MAX_BU_CODE
+    }, allow_nil: true
+
+    validates :payment_conditions_id, numericality: {
+      only_integer: true,
+      greater_than_or_equal_to: Constants::MIN_PAYMENT_CONDITIONS_ID,
+      less_than_or_equal_to: Constants::MAX_PAYMENT_CONDITIONS_ID
+    }, allow_nil: true
+
+    # String length validations
+    validates :invoice_id, length: { maximum: Constants::INVOICE_ID_MAX_LENGTH }
+    validates :internal_invoice_id, length: { maximum: Constants::INTERNAL_INVOICE_ID_MAX_LENGTH }, allow_nil: true
+    validates :order_id, length: { maximum: Constants::ORDER_ID_MAX_LENGTH }, allow_nil: true
+    validates :booking_text, length: { maximum: Constants::BOOKING_TEXT_MAX_LENGTH }, allow_nil: true
+    validates :information, length: { maximum: Constants::INFORMATION_MAX_LENGTH }, allow_nil: true
+    validates :supplier_name, length: { maximum: Constants::SUPPLIER_NAME_MAX_LENGTH }, allow_nil: true
+    validates :supplier_city, length: { maximum: Constants::SUPPLIER_CITY_MAX_LENGTH }, allow_nil: true
+    validates :account_name, length: { maximum: Constants::ACCOUNT_NAME_MAX_LENGTH }, allow_nil: true
+    validates :party_id, length: { maximum: Constants::PARTY_ID_MAX_LENGTH }, allow_nil: true
+    validates :vat_id, length: { maximum: Constants::VAT_ID_MAX_LENGTH }, allow_nil: true
+    validates :iban, length: { maximum: Constants::IBAN_MAX_LENGTH }, allow_nil: true
+    validates :swift_code, length: { maximum: Constants::SWIFT_MAX_LENGTH }, allow_nil: true
+    validates :bank_code, length: { maximum: Constants::BANK_CODE_MAX_LENGTH }, allow_nil: true
+    validates :bank_account, length: { maximum: Constants::BANK_ACCOUNT_MAX_LENGTH }, allow_nil: true
+    validates :cost_category_id, length: { maximum: Constants::COST_CATEGORY_ID_MAX_LENGTH }, allow_nil: true
+    validates :cost_category_id2, length: { maximum: Constants::COST_CATEGORY_ID_MAX_LENGTH }, allow_nil: true
+
+    # Format validations (codes and patterns)
+    validates :currency_code, inclusion: { in: Constants::CURRENCY_CODES }, allow_nil: true
+    validates :bank_country, inclusion: { in: Constants::COUNTRY_CODES }, allow_nil: true
+    validates :ship_from_country, inclusion: { in: Constants::COUNTRY_CODES }, allow_nil: true
+    validates :ship_to_country, inclusion: { in: Constants::COUNTRY_CODES }, allow_nil: true
+    validates :invoice_id, format: { with: Constants::INVOICE_ID_PATTERN }, allow_blank: true
+    validates :internal_invoice_id, format: { with: Constants::INTERNAL_INVOICE_ID_PATTERN }, allow_blank: true
+    validates :order_id, format: { with: Constants::ORDER_ID_PATTERN }, allow_blank: true
+    validates :iban, format: { with: Constants::IBAN_PATTERN }, allow_blank: true
+    validates :swift_code, format: { with: Constants::SWIFT_PATTERN }, allow_blank: true
+    validates :vat_id, format: { with: Constants::VAT_ID_PATTERN }, allow_blank: true
+
+    # Date range validations
+    validates :date, date_range: true, allow_nil: true
+    validates :due_date, date_range: true, allow_nil: true
+    validates :delivery_date, date_range: true, allow_nil: true
+    validates :paid_at, date_range: true, allow_nil: true
+    validates :discount_payment_date, date_range: true, allow_nil: true
+    validates :discount_payment_date_2, date_range: true, allow_nil: true
+
+    # Complex validators
+    validates_with Validators::DiscountDatesValidator
+    validates_with Validators::PaymentConditionsValidator
+    validates_with Validators::ConsolidationValidator
+
+    # Base element fields (from DATEV base xsd:extension)
+    attribute :date, :date                    # Document date (required)
+    attribute :amount, :decimal               # Amount (required, non-zero)
+    attribute :discount_amount, :decimal      # Discount amount (tier 1)
+    attribute :account_no, :integer           # General ledger account (4-8 digits)
+    attribute :bu_code, :integer              # Booking key
+    attribute :cost_amount, :decimal          # Cost quantity (KOST Menge)
+    attribute :cost_category_id, :string      # Cost center 1 (KOST1)
+    attribute :cost_category_id2, :string     # Cost center 2 (KOST2)
+    attribute :tax, :decimal                  # Tax rate percentage
+    attribute :information, :string           # Free text (max 120 chars)
+
+    # Base1 element fields (from DATEV base1 xsd:extension)
+    attribute :currency_code, :string         # ISO 4217 currency code (required)
+    attribute :invoice_id, :string            # Invoice number (required, max 36 chars)
+    attribute :booking_text, :string          # Booking text (max 60 chars)
+    attribute :type_of_receivable, :string    # Type of receivable
+    attribute :own_vat_id, :string            # Own VAT ID (for OSS procedure)
+    attribute :ship_from_country, :string     # Ship from country code (ISO 3166)
+    attribute :party_id, :string              # Customer/supplier number
+    attribute :paid_at, :date                 # Payment date
+    attribute :internal_invoice_id, :string   # Internal invoice number (max 12 chars)
+    attribute :vat_id, :string                # Business partner VAT ID (max 15 chars)
+    attribute :ship_to_country, :string       # Ship to country code (ISO 3166)
+    attribute :exchange_rate, :decimal        # Exchange rate
+    attribute :bank_code, :string             # Bank code (max 10 chars)
+    attribute :bank_account, :string          # Bank account number (max 30 chars)
+    attribute :bank_country, :string          # Bank country code (ISO 3166)
+    attribute :iban, :string                  # IBAN (max 34 chars)
+    attribute :swift_code, :string            # SWIFT/BIC code (max 11 chars)
+    attribute :account_name, :string          # Name of GL account (max 40 chars)
+    attribute :payment_conditions_id, :integer # Payment terms ID
+    attribute :payment_order, :boolean        # Direct debit checkbox
+    attribute :discount_percentage, :decimal  # Discount percentage tier 1
+    attribute :discount_payment_date, :date   # Due date with discount tier 1
+    attribute :discount_amount_2, :decimal    # Discount amount tier 2
+    attribute :discount_percentage_2, :decimal # Discount percentage tier 2
+    attribute :discount_payment_date_2, :date # Due date with discount tier 2
+    attribute :due_date, :date                # Due date without discount
+    attribute :bp_account_no, :integer        # Business partner account number
+    attribute :delivery_date, :date           # Service/delivery date
+    attribute :order_id, :string              # Order number (max 30 chars)
+
+    # accountsPayableLedger specific fields
+    attribute :supplier_name, :string         # Supplier's name (max 50 chars)
+    attribute :supplier_city, :string         # Supplier's location (max 30 chars)
+
+    # Initialize with optional line_items array
+    def initialize(attributes = {})
+      super
+      @line_items = []
+    end
+
+    # @return [Array<LineItem>] The line items for this invoice
+    attr_reader :line_items
+
+    # Add a line item to this invoice.
+    #
+    # When line items are added, consolidation values are computed from
+    # the line items rather than from the invoice's own attributes.
+    #
+    # @param attributes [Hash] Line item attributes
+    # @return [LineItem] The created line item
+    def add_line_item(**attributes)
+      line_item = LineItem.new(**attributes)
+      @line_items << line_item
+      line_item
+    end
+
+    # Check if this invoice has multiple line items.
+    #
+    # @return [Boolean] true if the invoice has line items
+    def multi_line?
+      @line_items.any?
+    end
+
+    # Consolidated amount for the DATEV consolidate element.
+    # When there are line items, sums all line item amounts.
+    # Otherwise, returns the invoice's amount.
+    #
+    # @return [BigDecimal, nil] The consolidated amount
+    def consolidated_amount
+      if multi_line?
+        @line_items.sum { |item| item.amount || BigDecimal("0") }
+      else
+        amount
+      end
+    end
+
+    # Consolidated date for the DATEV consolidate element.
+    # When there are line items, returns the date from the first line item.
+    # Otherwise, returns the invoice's date.
+    #
+    # @return [Date, nil] The consolidated date
+    def consolidated_date
+      if multi_line?
+        @line_items.first.date || date
+      else
+        date
+      end
+    end
+
+    # Consolidated invoice ID for the DATEV consolidate element.
+    # When there are line items, returns the invoice_id from the first line item.
+    # Otherwise, returns the invoice's invoice_id.
+    #
+    # @return [String, nil] The consolidated invoice ID
+    def consolidated_invoice_id
+      if multi_line?
+        @line_items.first.invoice_id || invoice_id
+      else
+        invoice_id
+      end
+    end
+
+    # Consolidated currency code for the DATEV consolidate element.
+    # When there are line items, returns the currency_code from the first line item.
+    # Otherwise, returns the invoice's currency_code.
+    #
+    # @return [String, nil] The consolidated currency code
+    def consolidated_currency_code
+      if multi_line?
+        @line_items.first.currency_code || currency_code
+      else
+        currency_code
+      end
+    end
+
+    # Consolidated delivery date for the DATEV consolidate element.
+    # When there are line items, returns the delivery_date from the first line item.
+    # Otherwise, returns the invoice's delivery_date.
+    #
+    # @return [Date, nil] The consolidated delivery date
+    def consolidated_delivery_date
+      if multi_line?
+        @line_items.first.delivery_date || delivery_date
+      else
+        delivery_date
+      end
+    end
+
+    # Consolidated order ID for the DATEV consolidate element.
+    # When there are line items, returns the order_id from the first line item.
+    # Otherwise, returns the invoice's order_id.
+    #
+    # @return [String, nil] The consolidated order ID
+    def consolidated_order_id
+      if multi_line?
+        @line_items.first.order_id || order_id
+      else
+        order_id
+      end
+    end
+
+    # Return a hash of all attributes with non-nil values.
+    # Does not include line_items.
+    #
+    # @return [Hash] Attributes hash
+    def to_h
+      attributes.compact.transform_keys(&:to_sym)
+    end
+  end
+end

data/lib/zipdatev/line_item.rb

@@ -0,0 +1,203 @@
+# frozen_string_literal: true
+
+require "active_model"
+require "date"
+
+module ZipDatev
+  # Represents a single line item within an invoice.
+  #
+  # Line items are used when an invoice has multiple tax rates or needs
+  # to be split across different accounts. Each line item becomes an
+  # individual <accountsPayableLedger> entry in the generated XML.
+  #
+  # Line items contain most of the fields from the DATEV base and base1
+  # element specifications, allowing detailed per-item data.
+  #
+  # @example Creating a line item with 19% tax
+  #   line_item = ZipDatev::LineItem.new(
+  #     amount: 119.00,
+  #     tax: 19.00,
+  #     account_no: 8400,
+  #     booking_text: "Revenue 19%"
+  #   )
+  class LineItem
+    include ActiveModel::Model
+    include ActiveModel::Attributes
+
+    # Amount validations (amount is optional for line items, inherited from invoice)
+    validates :amount, numericality: {
+      other_than: 0,
+      greater_than_or_equal_to: Constants::MIN_AMOUNT,
+      less_than_or_equal_to: Constants::MAX_AMOUNT
+    }, allow_nil: true
+    validates :amount, decimal_precision: { places: 2 }, allow_nil: true
+
+    # Discount amount validations
+    validates :discount_amount, numericality: {
+      greater_than_or_equal_to: Constants::MIN_DISCOUNT_AMOUNT,
+      less_than_or_equal_to: Constants::MAX_DISCOUNT_AMOUNT
+    }, allow_nil: true
+    validates :discount_amount, decimal_precision: { places: 2 }, allow_nil: true
+
+    validates :discount_amount_2, numericality: {
+      greater_than_or_equal_to: Constants::MIN_DISCOUNT_AMOUNT,
+      less_than_or_equal_to: Constants::MAX_DISCOUNT_AMOUNT
+    }, allow_nil: true
+    validates :discount_amount_2, decimal_precision: { places: 2 }, allow_nil: true
+
+    # Tax validations
+    validates :tax, numericality: {
+      greater_than_or_equal_to: Constants::MIN_TAX,
+      less_than_or_equal_to: Constants::MAX_TAX
+    }, allow_nil: true
+    validates :tax, decimal_precision: { places: 2 }, allow_nil: true
+
+    # Discount percentage validations
+    validates :discount_percentage, numericality: {
+      greater_than_or_equal_to: Constants::MIN_TAX,
+      less_than_or_equal_to: Constants::MAX_TAX
+    }, allow_nil: true
+    validates :discount_percentage, decimal_precision: { places: 2 }, allow_nil: true
+
+    validates :discount_percentage_2, numericality: {
+      greater_than_or_equal_to: Constants::MIN_TAX,
+      less_than_or_equal_to: Constants::MAX_TAX
+    }, allow_nil: true
+    validates :discount_percentage_2, decimal_precision: { places: 2 }, allow_nil: true
+
+    # Exchange rate validations
+    validates :exchange_rate, numericality: {
+      greater_than_or_equal_to: Constants::MIN_EXCHANGE_RATE,
+      less_than_or_equal_to: Constants::MAX_EXCHANGE_RATE
+    }, allow_nil: true
+    validates :exchange_rate, decimal_precision: { places: 6 }, allow_nil: true
+
+    # Cost amount validations
+    validates :cost_amount, decimal_precision: { places: 4 }, allow_nil: true
+
+    # Account number validations
+    validates :account_no, numericality: {
+      only_integer: true,
+      greater_than_or_equal_to: Constants::MIN_ACCOUNT_NO,
+      less_than_or_equal_to: Constants::MAX_ACCOUNT_NO
+    }, allow_nil: true
+
+    validates :bp_account_no, numericality: {
+      only_integer: true,
+      greater_than_or_equal_to: Constants::MIN_BP_ACCOUNT_NO,
+      less_than_or_equal_to: Constants::MAX_BP_ACCOUNT_NO
+    }, allow_nil: true
+
+    validates :bu_code, numericality: {
+      only_integer: true,
+      greater_than_or_equal_to: Constants::MIN_BU_CODE,
+      less_than_or_equal_to: Constants::MAX_BU_CODE
+    }, allow_nil: true
+
+    validates :payment_conditions_id, numericality: {
+      only_integer: true,
+      greater_than_or_equal_to: Constants::MIN_PAYMENT_CONDITIONS_ID,
+      less_than_or_equal_to: Constants::MAX_PAYMENT_CONDITIONS_ID
+    }, allow_nil: true
+
+    # String length validations
+    validates :invoice_id, length: { maximum: Constants::INVOICE_ID_MAX_LENGTH }, allow_nil: true
+    validates :internal_invoice_id, length: { maximum: Constants::INTERNAL_INVOICE_ID_MAX_LENGTH }, allow_nil: true
+    validates :order_id, length: { maximum: Constants::ORDER_ID_MAX_LENGTH }, allow_nil: true
+    validates :booking_text, length: { maximum: Constants::BOOKING_TEXT_MAX_LENGTH }, allow_nil: true
+    validates :information, length: { maximum: Constants::INFORMATION_MAX_LENGTH }, allow_nil: true
+    validates :supplier_name, length: { maximum: Constants::SUPPLIER_NAME_MAX_LENGTH }, allow_nil: true
+    validates :supplier_city, length: { maximum: Constants::SUPPLIER_CITY_MAX_LENGTH }, allow_nil: true
+    validates :account_name, length: { maximum: Constants::ACCOUNT_NAME_MAX_LENGTH }, allow_nil: true
+    validates :party_id, length: { maximum: Constants::PARTY_ID_MAX_LENGTH }, allow_nil: true
+    validates :vat_id, length: { maximum: Constants::VAT_ID_MAX_LENGTH }, allow_nil: true
+    validates :iban, length: { maximum: Constants::IBAN_MAX_LENGTH }, allow_nil: true
+    validates :swift_code, length: { maximum: Constants::SWIFT_MAX_LENGTH }, allow_nil: true
+    validates :bank_code, length: { maximum: Constants::BANK_CODE_MAX_LENGTH }, allow_nil: true
+    validates :bank_account, length: { maximum: Constants::BANK_ACCOUNT_MAX_LENGTH }, allow_nil: true
+    validates :cost_category_id, length: { maximum: Constants::COST_CATEGORY_ID_MAX_LENGTH }, allow_nil: true
+    validates :cost_category_id2, length: { maximum: Constants::COST_CATEGORY_ID_MAX_LENGTH }, allow_nil: true
+
+    # Format validations (codes and patterns)
+    validates :currency_code, inclusion: { in: Constants::CURRENCY_CODES }, allow_nil: true
+    validates :bank_country, inclusion: { in: Constants::COUNTRY_CODES }, allow_nil: true
+    validates :ship_from_country, inclusion: { in: Constants::COUNTRY_CODES }, allow_nil: true
+    validates :ship_to_country, inclusion: { in: Constants::COUNTRY_CODES }, allow_nil: true
+    validates :invoice_id, format: { with: Constants::INVOICE_ID_PATTERN }, allow_blank: true
+    validates :internal_invoice_id, format: { with: Constants::INTERNAL_INVOICE_ID_PATTERN }, allow_blank: true
+    validates :order_id, format: { with: Constants::ORDER_ID_PATTERN }, allow_blank: true
+    validates :iban, format: { with: Constants::IBAN_PATTERN }, allow_blank: true
+    validates :swift_code, format: { with: Constants::SWIFT_PATTERN }, allow_blank: true
+    validates :vat_id, format: { with: Constants::VAT_ID_PATTERN }, allow_blank: true
+
+    # Date range validations
+    validates :date, date_range: true, allow_nil: true
+    validates :due_date, date_range: true, allow_nil: true
+    validates :delivery_date, date_range: true, allow_nil: true
+    validates :paid_at, date_range: true, allow_nil: true
+    validates :discount_payment_date, date_range: true, allow_nil: true
+    validates :discount_payment_date_2, date_range: true, allow_nil: true
+
+    # Complex validators
+    validates_with Validators::DiscountDatesValidator
+    validates_with Validators::PaymentConditionsValidator
+
+    # Base element fields (from DATEV base xsd:extension)
+    attribute :date, :date                    # Document date
+    attribute :amount, :decimal               # Amount (gross recommended, non-zero)
+    attribute :discount_amount, :decimal      # Discount amount (tier 1)
+    attribute :account_no, :integer           # General ledger account (4-8 digits)
+    attribute :bu_code, :integer              # Booking key
+    attribute :cost_amount, :decimal          # Cost quantity (KOST Menge)
+    attribute :cost_category_id, :string      # Cost center 1 (KOST1)
+    attribute :cost_category_id2, :string     # Cost center 2 (KOST2)
+    attribute :tax, :decimal                  # Tax rate percentage
+    attribute :information, :string           # Free text (max 120 chars)
+
+    # Base1 element fields (from DATEV base1 xsd:extension)
+    attribute :currency_code, :string         # ISO 4217 currency code
+    attribute :invoice_id, :string            # Invoice number (max 36 chars)
+    attribute :booking_text, :string          # Booking text (max 60 chars)
+    attribute :type_of_receivable, :string    # Type of receivable
+    attribute :own_vat_id, :string            # Own VAT ID (for OSS procedure)
+    attribute :ship_from_country, :string     # Ship from country code (ISO 3166)
+    attribute :party_id, :string              # Customer/supplier number
+    attribute :paid_at, :date                 # Payment date
+    attribute :internal_invoice_id, :string   # Internal invoice number (max 12 chars)
+    attribute :vat_id, :string                # Business partner VAT ID (max 15 chars)
+    attribute :ship_to_country, :string       # Ship to country code (ISO 3166)
+    attribute :exchange_rate, :decimal        # Exchange rate
+    attribute :bank_code, :string             # Bank code (max 10 chars)
+    attribute :bank_account, :string          # Bank account number (max 30 chars)
+    attribute :bank_country, :string          # Bank country code (ISO 3166)
+    attribute :iban, :string                  # IBAN (max 34 chars)
+    attribute :swift_code, :string            # SWIFT/BIC code (max 11 chars)
+    attribute :account_name, :string          # Name of GL account (max 40 chars)
+    attribute :payment_conditions_id, :integer # Payment terms ID
+    attribute :payment_order, :boolean        # Direct debit checkbox
+    attribute :discount_percentage, :decimal  # Discount percentage tier 1
+    attribute :discount_payment_date, :date   # Due date with discount tier 1
+    attribute :discount_amount_2, :decimal    # Discount amount tier 2
+    attribute :discount_percentage_2, :decimal # Discount percentage tier 2
+    attribute :discount_payment_date_2, :date # Due date with discount tier 2
+    attribute :due_date, :date                # Due date without discount
+    attribute :bp_account_no, :integer        # Business partner account number
+    attribute :delivery_date, :date           # Service/delivery date
+    attribute :order_id, :string              # Order number (max 30 chars)
+
+    # accountsPayableLedger specific fields
+    attribute :supplier_name, :string         # Supplier's name (max 50 chars)
+    attribute :supplier_city, :string         # Supplier's location (max 30 chars)
+
+    # Return a hash of all attributes with non-nil values.
+    #
+    # @return [Hash] Attributes hash
+    def to_h
+      attributes.compact.transform_keys(&:to_sym)
+    end
+
+    # Backward compatibility: support keyword argument initialization
+    # ActiveModel::Model already provides this, but we ensure it works
+    # the same way as before.
+  end
+end