e-invoice-api 0.33.0 → 0.34.0

data/lib/e_invoice_api/models/document_create_from_pdf_response.rb

@@ -34,6 +34,13 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :billing_address_recipient, String, nil?: true
 
+      # @!attribute buyer_reference
+      #   The buyer reference (BT-10), e.g. a cost centre or accounting reference
+      #   requested by the buyer
+      #
+      #   @return [String, nil]
+      optional :buyer_reference, String, nil?: true
+
       # @!attribute charges
       #
       #   @return [Array<EInvoiceAPI::Models::Charge>, nil]
@@ -88,6 +95,12 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :customer_peppol_id, String, nil?: true
 
+      # @!attribute customer_phone
+      #   The telephone number of the customer contact (BT-57)
+      #
+      #   @return [String, nil]
+      optional :customer_phone, String, nil?: true
+
       # @!attribute customer_tax_id
       #   Customer tax ID. For Belgium this is the VAT number. Must include the country
       #   prefix
@@ -170,6 +183,19 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :payment_term, String, nil?: true
 
+      # @!attribute preceding_invoice_date
+      #   The preceding invoice issue date (BT-26)
+      #
+      #   @return [Date, nil]
+      optional :preceding_invoice_date, Date, nil?: true
+
+      # @!attribute preceding_invoice_id
+      #   The preceding invoice reference (BT-25): the number of the invoice this document
+      #   corrects, for example the invoice a credit note credits
+      #
+      #   @return [String, nil]
+      optional :preceding_invoice_id, String, nil?: true
+
       # @!attribute purchase_order
       #   The purchase order reference number
       #
@@ -188,6 +214,21 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :remittance_address_recipient, String, nil?: true
 
+      # @!attribute rounding_amount
+      #   The amount added to the invoice total to round the amount for payment (BT-114),
+      #   for example to whole kronor (amount_due = invoice_total + rounding_amount when
+      #   nothing is prepaid). Can be negative. Between -5.00 and 5.00, rounded to maximum
+      #   2 decimals
+      #
+      #   @return [String, nil]
+      optional :rounding_amount, String, nil?: true
+
+      # @!attribute sales_order
+      #   The sales order reference (BT-14) assigned by the seller
+      #
+      #   @return [String, nil]
+      optional :sales_order, String, nil?: true
+
       # @!attribute service_address
       #   The address where services were performed or goods were delivered
       #
@@ -251,6 +292,14 @@ module EInvoiceAPI
       #   @return [Symbol, EInvoiceAPI::Models::DocumentCreateFromPdfResponse::TaxCode, nil]
       optional :tax_code, enum: -> { EInvoiceAPI::Models::DocumentCreateFromPdfResponse::TaxCode }
 
+      # @!attribute tax_currency
+      #   The VAT accounting currency (BT-6, ISO 4217 currency code), when VAT is
+      #   accounted in a currency other than the invoice currency. Must differ from
+      #   currency and requires total_tax_in_tax_currency
+      #
+      #   @return [String, nil]
+      optional :tax_currency, String, nil?: true
+
       # @!attribute tax_details
       #
       #   @return [Array<EInvoiceAPI::Models::DocumentCreateFromPdfResponse::TaxDetail>, nil]
@@ -273,6 +322,13 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :total_tax, String, nil?: true
 
+      # @!attribute total_tax_in_tax_currency
+      #   The total VAT amount in the VAT accounting currency tax_currency (BT-111). Does
+      #   not add to invoice_total. Requires tax_currency. Rounded to maximum 2 decimals
+      #
+      #   @return [String, nil]
+      optional :total_tax_in_tax_currency, String, nil?: true
+
       # @!attribute ubl_document
       #   The UBL document as an XML string
       #
@@ -324,6 +380,14 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :vendor_name, String, nil?: true
 
+      # @!attribute vendor_phone
+      #   The telephone number of the vendor contact (BT-42). Required when vendor and
+      #   customer are both in Germany (DE-R-006); it must then hold at least 3 digits
+      #   (DE-R-027, a warning).
+      #
+      #   @return [String, nil]
+      optional :vendor_phone, String, nil?: true
+
       # @!attribute vendor_tax_id
       #   Vendor tax ID. For Belgium this is the VAT number. Must include the country
       #   prefix
@@ -331,7 +395,7 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :vendor_tax_id, String, nil?: true
 
-      # @!method initialize(allowances: nil, amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: nil, charges: nil, currency: nil, customer_address: nil, customer_address_recipient: nil, customer_company_id: nil, customer_email: nil, customer_id: nil, customer_name: nil, customer_peppol_id: nil, customer_tax_id: nil, direction: nil, document_type: nil, due_date: nil, error_message: nil, error_type: nil, invoice_date: nil, invoice_id: nil, invoice_total: nil, items: nil, note: nil, payment_details: nil, payment_term: nil, purchase_order: nil, remittance_address: nil, remittance_address_recipient: nil, service_address: nil, service_address_recipient: nil, service_end_date: nil, service_start_date: nil, shipping_address: nil, shipping_address_recipient: nil, state: nil, subtotal: nil, success: nil, tax_code: nil, tax_details: nil, total_discount: nil, total_tax: nil, ubl_document: nil, vatex: nil, vatex_note: nil, vendor_address: nil, vendor_address_recipient: nil, vendor_company_id: nil, vendor_email: nil, vendor_name: nil, vendor_tax_id: nil)
+      # @!method initialize(allowances: nil, amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: nil, buyer_reference: nil, charges: nil, currency: nil, customer_address: nil, customer_address_recipient: nil, customer_company_id: nil, customer_email: nil, customer_id: nil, customer_name: nil, customer_peppol_id: nil, customer_phone: nil, customer_tax_id: nil, direction: nil, document_type: nil, due_date: nil, error_message: nil, error_type: nil, invoice_date: nil, invoice_id: nil, invoice_total: nil, items: nil, note: nil, payment_details: nil, payment_term: nil, preceding_invoice_date: nil, preceding_invoice_id: nil, purchase_order: nil, remittance_address: nil, remittance_address_recipient: nil, rounding_amount: nil, sales_order: nil, service_address: nil, service_address_recipient: nil, service_end_date: nil, service_start_date: nil, shipping_address: nil, shipping_address_recipient: nil, state: nil, subtotal: nil, success: nil, tax_code: nil, tax_currency: nil, tax_details: nil, total_discount: nil, total_tax: nil, total_tax_in_tax_currency: nil, ubl_document: nil, vatex: nil, vatex_note: nil, vendor_address: nil, vendor_address_recipient: nil, vendor_company_id: nil, vendor_email: nil, vendor_name: nil, vendor_phone: nil, vendor_tax_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {EInvoiceAPI::Models::DocumentCreateFromPdfResponse} for more details.
       #
@@ -345,6 +409,8 @@ module EInvoiceAPI
       #
       #   @param billing_address_recipient [String, nil] The recipient name at the billing address
       #
+      #   @param buyer_reference [String, nil] The buyer reference (BT-10), e.g. a cost centre or accounting reference requeste
+      #
       #   @param charges [Array<EInvoiceAPI::Models::Charge>, nil]
       #
       #   @param currency [Symbol, EInvoiceAPI::Models::CurrencyCode] Currency of the invoice (ISO 4217 currency code)
@@ -363,6 +429,8 @@ module EInvoiceAPI
       #
       #   @param customer_peppol_id [String, nil] Customer Peppol ID
       #
+      #   @param customer_phone [String, nil] The telephone number of the customer contact (BT-57)
+      #
       #   @param customer_tax_id [String, nil] Customer tax ID. For Belgium this is the VAT number. Must include the country pr
       #
       #   @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection] The direction of the document: INBOUND (purchases) or OUTBOUND (sales)
@@ -389,12 +457,20 @@ module EInvoiceAPI
       #
       #   @param payment_term [String, nil] The payment terms (e.g., 'Net 30', 'Due on receipt', '2/10 Net 30')
       #
+      #   @param preceding_invoice_date [Date, nil] The preceding invoice issue date (BT-26)
+      #
+      #   @param preceding_invoice_id [String, nil] The preceding invoice reference (BT-25): the number of the invoice this document
+      #
       #   @param purchase_order [String, nil] The purchase order reference number
       #
       #   @param remittance_address [String, nil] The address where payment should be sent or remitted to
       #
       #   @param remittance_address_recipient [String, nil] The recipient name at the remittance address
       #
+      #   @param rounding_amount [String, nil] The amount added to the invoice total to round the amount for payment (BT-114),
+      #
+      #   @param sales_order [String, nil] The sales order reference (BT-14) assigned by the seller
+      #
       #   @param service_address [String, nil] The address where services were performed or goods were delivered
       #
       #   @param service_address_recipient [String, nil] The recipient name at the service address
@@ -415,12 +491,16 @@ module EInvoiceAPI
       #
       #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentCreateFromPdfResponse::TaxCode] Tax category code of the invoice (e.g., S for standard rate, Z for zero rate, E
       #
+      #   @param tax_currency [String, nil] The VAT accounting currency (BT-6, ISO 4217 currency code), when VAT is accounte
+      #
       #   @param tax_details [Array<EInvoiceAPI::Models::DocumentCreateFromPdfResponse::TaxDetail>, nil]
       #
       #   @param total_discount [String, nil] The net financial discount/charge of the invoice (non-VAT charges minus non-VAT
       #
       #   @param total_tax [String, nil] The total tax amount of the invoice. Must be positive and rounded to maximum 2 d
       #
+      #   @param total_tax_in_tax_currency [String, nil] The total VAT amount in the VAT accounting currency tax_currency (BT-111). Does
+      #
       #   @param ubl_document [String, nil] The UBL document as an XML string
       #
       #   @param vatex [Symbol, EInvoiceAPI::Models::DocumentCreateFromPdfResponse::Vatex, nil] VATEX code list for VAT exemption reasons
@@ -437,6 +517,8 @@ module EInvoiceAPI
       #
       #   @param vendor_name [String, nil] The name of the vendor/seller/supplier
       #
+      #   @param vendor_phone [String, nil] The telephone number of the vendor contact (BT-42). Required when vendor and cus
+      #
       #   @param vendor_tax_id [String, nil] Vendor tax ID. For Belgium this is the VAT number. Must include the country pref
 
       class Item < EInvoiceAPI::Internal::Type::BaseModel
@@ -463,8 +545,8 @@ module EInvoiceAPI
 
         # @!attribute date
         #
-        #   @return [nil]
-        optional :date, NilClass
+        #   @return [Date, nil]
+        optional :date, Date, nil?: true
 
         # @!attribute description
         #   The description of the line item.
@@ -480,6 +562,23 @@ module EInvoiceAPI
                  -> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::Models::DocumentCreateFromPdfResponse::Item::ItemAttribute] },
                  nil?: true
 
+        # @!attribute name
+        #   The item name (BT-153), for example the product name. Written to
+        #   cac:Item/cbc:Name. When omitted or blank, `description` (BT-154) is used as the
+        #   item name. A posted line item needs a `name` or a `description`; a line item
+        #   with neither is rejected with 422.
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        # @!attribute price_base_quantity
+        #   The item price base quantity (BT-149). The number of item units to which the
+        #   unit price applies, for example 100 when the unit price is a price for each 100
+        #   units. Must be greater than 0. Defaults to 1.
+        #
+        #   @return [String, nil]
+        optional :price_base_quantity, String
+
         # @!attribute product_code
         #   The product code of the line item.
         #
@@ -520,7 +619,7 @@ module EInvoiceAPI
         #   @return [String, nil]
         optional :unit_price, String, nil?: true
 
-        # @!method initialize(allowances: nil, amount: nil, charges: nil, date: nil, description: nil, item_attributes: nil, product_code: nil, quantity: nil, tax: nil, tax_rate: nil, unit: nil, unit_price: nil)
+        # @!method initialize(allowances: nil, amount: nil, charges: nil, date: nil, description: nil, item_attributes: nil, name: nil, price_base_quantity: nil, product_code: nil, quantity: nil, tax: nil, tax_rate: nil, unit: nil, unit_price: nil)
         #   Some parameter documentations has been truncated, see
         #   {EInvoiceAPI::Models::DocumentCreateFromPdfResponse::Item} for more details.
         #
@@ -530,12 +629,16 @@ module EInvoiceAPI
         #
         #   @param charges [Array<EInvoiceAPI::Models::Charge>, nil] The charges of the line item.
         #
-        #   @param date [nil]
+        #   @param date [Date, nil]
         #
         #   @param description [String, nil] The description of the line item.
         #
         #   @param item_attributes [Array<EInvoiceAPI::Models::DocumentCreateFromPdfResponse::Item::ItemAttribute>, nil] Item-level attributes (BG-32) from cac:AdditionalItemProperty.
         #
+        #   @param name [String, nil] The item name (BT-153), for example the product name. Written to cac:Item/cbc:Na
+        #
+        #   @param price_base_quantity [String] The item price base quantity (BT-149). The number of item units to which the uni
+        #
         #   @param product_code [String, nil] The product code of the line item.
         #
         #   @param quantity [String, nil] The quantity of items (goods or services) that is the subject of the line item.

data/lib/e_invoice_api/models/document_lifecycle_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module EInvoiceAPI
+  module Models
+    # @see EInvoiceAPI::Resources::Documents#lifecycle
+    class DocumentLifecycleParams < EInvoiceAPI::Internal::Type::BaseModel
+      extend EInvoiceAPI::Internal::Type::RequestParameters::Converter
+      include EInvoiceAPI::Internal::Type::RequestParameters
+
+      # @!attribute document_id
+      #
+      #   @return [String]
+      required :document_id, String
+
+      # @!method initialize(document_id:, request_options: {})
+      #   @param document_id [String]
+      #   @param request_options [EInvoiceAPI::RequestOptions, Hash{Symbol=>Object}]
+    end
+  end
+end

data/lib/e_invoice_api/models/document_lifecycle_response.rb

@@ -0,0 +1,134 @@
+# frozen_string_literal: true
+
+module EInvoiceAPI
+  module Models
+    # @see EInvoiceAPI::Resources::Documents#lifecycle
+    class DocumentLifecycleResponse < EInvoiceAPI::Internal::Type::BaseModel
+      # @!attribute document_id
+      #
+      #   @return [String]
+      required :document_id, String
+
+      # @!attribute events
+      #
+      #   @return [Array<EInvoiceAPI::Models::DocumentLifecycleResponse::Event>]
+      required :events,
+               -> { EInvoiceAPI::Internal::Type::ArrayOf[EInvoiceAPI::Models::DocumentLifecycleResponse::Event] }
+
+      # @!method initialize(document_id:, events:)
+      #   @param document_id [String]
+      #   @param events [Array<EInvoiceAPI::Models::DocumentLifecycleResponse::Event>]
+
+      class Event < EInvoiceAPI::Internal::Type::BaseModel
+        # @!attribute canonical_status
+        #
+        #   @return [Symbol, EInvoiceAPI::Models::DocumentLifecycleResponse::Event::CanonicalStatus, nil]
+        required :canonical_status,
+                 enum: -> { EInvoiceAPI::Models::DocumentLifecycleResponse::Event::CanonicalStatus },
+                 nil?: true
+
+        # @!attribute direction
+        #
+        #   @return [Symbol, EInvoiceAPI::Models::DocumentLifecycleResponse::Event::Direction]
+        required :direction, enum: -> { EInvoiceAPI::Models::DocumentLifecycleResponse::Event::Direction }
+
+        # @!attribute level
+        #
+        #   @return [Symbol, EInvoiceAPI::Models::DocumentLifecycleResponse::Event::Level]
+        required :level, enum: -> { EInvoiceAPI::Models::DocumentLifecycleResponse::Event::Level }
+
+        # @!attribute native_code
+        #
+        #   @return [String, nil]
+        required :native_code, String, nil?: true
+
+        # @!attribute occurred_at
+        #
+        #   @return [Time]
+        required :occurred_at, Time
+
+        # @!attribute reason
+        #
+        #   @return [String, nil]
+        required :reason, String, nil?: true
+
+        # @!attribute reason_code
+        #
+        #   @return [String, nil]
+        required :reason_code, String, nil?: true
+
+        # @!attribute source
+        #
+        #   @return [Symbol, EInvoiceAPI::Models::DocumentLifecycleResponse::Event::Source]
+        required :source, enum: -> { EInvoiceAPI::Models::DocumentLifecycleResponse::Event::Source }
+
+        # @!method initialize(canonical_status:, direction:, level:, native_code:, occurred_at:, reason:, reason_code:, source:)
+        #   @param canonical_status [Symbol, EInvoiceAPI::Models::DocumentLifecycleResponse::Event::CanonicalStatus, nil]
+        #   @param direction [Symbol, EInvoiceAPI::Models::DocumentLifecycleResponse::Event::Direction]
+        #   @param level [Symbol, EInvoiceAPI::Models::DocumentLifecycleResponse::Event::Level]
+        #   @param native_code [String, nil]
+        #   @param occurred_at [Time]
+        #   @param reason [String, nil]
+        #   @param reason_code [String, nil]
+        #   @param source [Symbol, EInvoiceAPI::Models::DocumentLifecycleResponse::Event::Source]
+
+        # @see EInvoiceAPI::Models::DocumentLifecycleResponse::Event#canonical_status
+        module CanonicalStatus
+          extend EInvoiceAPI::Internal::Type::Enum
+
+          DEPOSITED = :deposited
+          EMITTED = :emitted
+          DELIVERED = :delivered
+          REJECTED = :rejected
+          ACKNOWLEDGED = :acknowledged
+          APPROVED = :approved
+          PARTIALLY_APPROVED = :partially_approved
+          DISPUTED = :disputed
+          ON_HOLD = :on_hold
+          REFUSED = :refused
+          PAYMENT_SENT = :payment_sent
+          PAID = :paid
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see EInvoiceAPI::Models::DocumentLifecycleResponse::Event#direction
+        module Direction
+          extend EInvoiceAPI::Internal::Type::Enum
+
+          IN = :in
+          OUT = :out
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see EInvoiceAPI::Models::DocumentLifecycleResponse::Event#level
+        module Level
+          extend EInvoiceAPI::Internal::Type::Enum
+
+          TRANSPORT = :transport
+          BUSINESS = :business
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+
+        # @see EInvoiceAPI::Models::DocumentLifecycleResponse::Event#source
+        module Source
+          extend EInvoiceAPI::Internal::Type::Enum
+
+          PEPPOL_MLR = :"peppol:mlr"
+          PEPPOL_MLS = :"peppol:mls"
+          PEPPOL_IMR = :"peppol:imr"
+          FR_SUPERPDP = :"fr:superpdp"
+          LOCAL = :local
+
+          # @!method self.values
+          #   @return [Array<Symbol>]
+        end
+      end
+    end
+  end
+end

data/lib/e_invoice_api/models/document_response.rb

@@ -46,6 +46,13 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :billing_address_recipient, String, nil?: true
 
+      # @!attribute buyer_reference
+      #   The buyer reference (BT-10), e.g. a cost centre or accounting reference
+      #   requested by the buyer
+      #
+      #   @return [String, nil]
+      optional :buyer_reference, String, nil?: true
+
       # @!attribute charges
       #
       #   @return [Array<EInvoiceAPI::Models::DocumentResponse::Charge>, nil]
@@ -102,6 +109,12 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :customer_peppol_id, String, nil?: true
 
+      # @!attribute customer_phone
+      #   The telephone number of the customer contact (BT-57)
+      #
+      #   @return [String, nil]
+      optional :customer_phone, String, nil?: true
+
       # @!attribute customer_tax_id
       #   Customer tax ID. For Belgium this is the VAT number. Must include the country
       #   prefix
@@ -172,6 +185,19 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :payment_term, String, nil?: true
 
+      # @!attribute preceding_invoice_date
+      #   The preceding invoice issue date (BT-26)
+      #
+      #   @return [Date, nil]
+      optional :preceding_invoice_date, Date, nil?: true
+
+      # @!attribute preceding_invoice_id
+      #   The preceding invoice reference (BT-25): the number of the invoice this document
+      #   corrects, for example the invoice a credit note credits
+      #
+      #   @return [String, nil]
+      optional :preceding_invoice_id, String, nil?: true
+
       # @!attribute purchase_order
       #   The purchase order reference number
       #
@@ -190,6 +216,21 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :remittance_address_recipient, String, nil?: true
 
+      # @!attribute rounding_amount
+      #   The amount added to the invoice total to round the amount for payment (BT-114),
+      #   for example to whole kronor (amount_due = invoice_total + rounding_amount when
+      #   nothing is prepaid). Can be negative. Between -5.00 and 5.00, rounded to maximum
+      #   2 decimals
+      #
+      #   @return [String, nil]
+      optional :rounding_amount, String, nil?: true
+
+      # @!attribute sales_order
+      #   The sales order reference (BT-14) assigned by the seller
+      #
+      #   @return [String, nil]
+      optional :sales_order, String, nil?: true
+
       # @!attribute service_address
       #   The address where services were performed or goods were delivered
       #
@@ -247,6 +288,14 @@ module EInvoiceAPI
       #   @return [Symbol, EInvoiceAPI::Models::DocumentResponse::TaxCode, nil]
       optional :tax_code, enum: -> { EInvoiceAPI::DocumentResponse::TaxCode }
 
+      # @!attribute tax_currency
+      #   The VAT accounting currency (BT-6, ISO 4217 currency code), when VAT is
+      #   accounted in a currency other than the invoice currency. Must differ from
+      #   currency and requires total_tax_in_tax_currency
+      #
+      #   @return [String, nil]
+      optional :tax_currency, String, nil?: true
+
       # @!attribute tax_details
       #
       #   @return [Array<EInvoiceAPI::Models::DocumentResponse::TaxDetail>, nil]
@@ -269,6 +318,13 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :total_tax, String, nil?: true
 
+      # @!attribute total_tax_in_tax_currency
+      #   The total VAT amount in the VAT accounting currency tax_currency (BT-111). Does
+      #   not add to invoice_total. Requires tax_currency. Rounded to maximum 2 decimals
+      #
+      #   @return [String, nil]
+      optional :total_tax_in_tax_currency, String, nil?: true
+
       # @!attribute vatex
       #   VATEX code list for VAT exemption reasons
       #
@@ -314,6 +370,14 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :vendor_name, String, nil?: true
 
+      # @!attribute vendor_phone
+      #   The telephone number of the vendor contact (BT-42). Required when vendor and
+      #   customer are both in Germany (DE-R-006); it must then hold at least 3 digits
+      #   (DE-R-027, a warning).
+      #
+      #   @return [String, nil]
+      optional :vendor_phone, String, nil?: true
+
       # @!attribute vendor_tax_id
       #   Vendor tax ID. For Belgium this is the VAT number. Must include the country
       #   prefix
@@ -321,7 +385,7 @@ module EInvoiceAPI
       #   @return [String, nil]
       optional :vendor_tax_id, String, nil?: true
 
-      # @!method initialize(id:, created_at:, allowances: nil, amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: nil, charges: nil, currency: nil, customer_address: nil, customer_address_recipient: nil, customer_company_id: nil, customer_email: nil, customer_id: nil, customer_name: nil, customer_peppol_id: nil, customer_tax_id: nil, direction: nil, document_type: nil, due_date: nil, invoice_date: nil, invoice_id: nil, invoice_total: nil, items: nil, note: nil, payment_details: nil, payment_term: nil, purchase_order: nil, remittance_address: nil, remittance_address_recipient: nil, service_address: nil, service_address_recipient: nil, service_end_date: nil, service_start_date: nil, shipping_address: nil, shipping_address_recipient: nil, state: nil, subtotal: nil, tax_code: nil, tax_details: nil, total_discount: nil, total_tax: nil, vatex: nil, vatex_note: nil, vendor_address: nil, vendor_address_recipient: nil, vendor_company_id: nil, vendor_email: nil, vendor_name: nil, vendor_tax_id: nil)
+      # @!method initialize(id:, created_at:, allowances: nil, amount_due: nil, attachments: nil, billing_address: nil, billing_address_recipient: nil, buyer_reference: nil, charges: nil, currency: nil, customer_address: nil, customer_address_recipient: nil, customer_company_id: nil, customer_email: nil, customer_id: nil, customer_name: nil, customer_peppol_id: nil, customer_phone: 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, preceding_invoice_date: nil, preceding_invoice_id: nil, purchase_order: nil, remittance_address: nil, remittance_address_recipient: nil, rounding_amount: nil, sales_order: 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_currency: nil, tax_details: nil, total_discount: nil, total_tax: nil, total_tax_in_tax_currency: nil, vatex: nil, vatex_note: nil, vendor_address: nil, vendor_address_recipient: nil, vendor_company_id: nil, vendor_email: nil, vendor_name: nil, vendor_phone: nil, vendor_tax_id: nil)
       #   Some parameter documentations has been truncated, see
       #   {EInvoiceAPI::Models::DocumentResponse} for more details.
       #
@@ -339,6 +403,8 @@ module EInvoiceAPI
       #
       #   @param billing_address_recipient [String, nil] The recipient name at the billing address
       #
+      #   @param buyer_reference [String, nil] The buyer reference (BT-10), e.g. a cost centre or accounting reference requeste
+      #
       #   @param charges [Array<EInvoiceAPI::Models::DocumentResponse::Charge>, nil]
       #
       #   @param currency [Symbol, EInvoiceAPI::Models::CurrencyCode] Currency of the invoice (ISO 4217 currency code)
@@ -357,6 +423,8 @@ module EInvoiceAPI
       #
       #   @param customer_peppol_id [String, nil] Customer Peppol ID
       #
+      #   @param customer_phone [String, nil] The telephone number of the customer contact (BT-57)
+      #
       #   @param customer_tax_id [String, nil] Customer tax ID. For Belgium this is the VAT number. Must include the country pr
       #
       #   @param direction [Symbol, EInvoiceAPI::Models::DocumentDirection] The direction of the document: INBOUND (purchases) or OUTBOUND (sales)
@@ -379,12 +447,20 @@ module EInvoiceAPI
       #
       #   @param payment_term [String, nil] The payment terms (e.g., 'Net 30', 'Due on receipt', '2/10 Net 30')
       #
+      #   @param preceding_invoice_date [Date, nil] The preceding invoice issue date (BT-26)
+      #
+      #   @param preceding_invoice_id [String, nil] The preceding invoice reference (BT-25): the number of the invoice this document
+      #
       #   @param purchase_order [String, nil] The purchase order reference number
       #
       #   @param remittance_address [String, nil] The address where payment should be sent or remitted to
       #
       #   @param remittance_address_recipient [String, nil] The recipient name at the remittance address
       #
+      #   @param rounding_amount [String, nil] The amount added to the invoice total to round the amount for payment (BT-114),
+      #
+      #   @param sales_order [String, nil] The sales order reference (BT-14) assigned by the seller
+      #
       #   @param service_address [String, nil] The address where services were performed or goods were delivered
       #
       #   @param service_address_recipient [String, nil] The recipient name at the service address
@@ -403,12 +479,16 @@ module EInvoiceAPI
       #
       #   @param tax_code [Symbol, EInvoiceAPI::Models::DocumentResponse::TaxCode] Tax category code of the invoice (e.g., S for standard rate, Z for zero rate, E
       #
+      #   @param tax_currency [String, nil] The VAT accounting currency (BT-6, ISO 4217 currency code), when VAT is accounte
+      #
       #   @param tax_details [Array<EInvoiceAPI::Models::DocumentResponse::TaxDetail>, nil]
       #
       #   @param total_discount [String, nil] The net financial discount/charge of the invoice (non-VAT charges minus non-VAT
       #
       #   @param total_tax [String, nil] The total tax amount of the invoice. Must be positive and rounded to maximum 2 d
       #
+      #   @param total_tax_in_tax_currency [String, nil] The total VAT amount in the VAT accounting currency tax_currency (BT-111). Does
+      #
       #   @param vatex [Symbol, EInvoiceAPI::Models::DocumentResponse::Vatex, nil] VATEX code list for VAT exemption reasons
       #
       #   @param vatex_note [String, nil] Textual explanation for VAT exemption
@@ -423,6 +503,8 @@ module EInvoiceAPI
       #
       #   @param vendor_name [String, nil] The name of the vendor/seller/supplier
       #
+      #   @param vendor_phone [String, nil] The telephone number of the vendor contact (BT-42). Required when vendor and cus
+      #
       #   @param vendor_tax_id [String, nil] Vendor tax ID. For Belgium this is the VAT number. Must include the country pref
 
       class Allowance < EInvoiceAPI::Internal::Type::BaseModel
@@ -844,8 +926,8 @@ module EInvoiceAPI
 
         # @!attribute date
         #
-        #   @return [nil]
-        optional :date, NilClass
+        #   @return [Date, nil]
+        optional :date, Date, nil?: true
 
         # @!attribute description
         #   The description of the line item.
@@ -863,6 +945,23 @@ module EInvoiceAPI
                  },
                  nil?: true
 
+        # @!attribute name
+        #   The item name (BT-153), for example the product name. Written to
+        #   cac:Item/cbc:Name. When omitted or blank, `description` (BT-154) is used as the
+        #   item name. A posted line item needs a `name` or a `description`; a line item
+        #   with neither is rejected with 422.
+        #
+        #   @return [String, nil]
+        optional :name, String, nil?: true
+
+        # @!attribute price_base_quantity
+        #   The item price base quantity (BT-149). The number of item units to which the
+        #   unit price applies, for example 100 when the unit price is a price for each 100
+        #   units. Must be greater than 0. Defaults to 1.
+        #
+        #   @return [String, nil]
+        optional :price_base_quantity, String
+
         # @!attribute product_code
         #   The product code of the line item.
         #
@@ -903,7 +1002,7 @@ module EInvoiceAPI
         #   @return [String, nil]
         optional :unit_price, String, nil?: true
 
-        # @!method initialize(allowances: nil, amount: nil, charges: nil, date: nil, description: nil, item_attributes: nil, product_code: nil, quantity: nil, tax: nil, tax_rate: nil, unit: nil, unit_price: nil)
+        # @!method initialize(allowances: nil, amount: nil, charges: nil, date: nil, description: nil, item_attributes: nil, name: nil, price_base_quantity: nil, product_code: nil, quantity: nil, tax: nil, tax_rate: nil, unit: nil, unit_price: nil)
         #   Some parameter documentations has been truncated, see
         #   {EInvoiceAPI::Models::DocumentResponse::Item} for more details.
         #
@@ -913,12 +1012,16 @@ module EInvoiceAPI
         #
         #   @param charges [Array<EInvoiceAPI::Models::Charge>, nil] The charges of the line item.
         #
-        #   @param date [nil]
+        #   @param date [Date, nil]
         #
         #   @param description [String, nil] The description of the line item.
         #
         #   @param item_attributes [Array<EInvoiceAPI::Models::DocumentResponse::Item::ItemAttribute>, nil] Item-level attributes (BG-32) from cac:AdditionalItemProperty.
         #
+        #   @param name [String, nil] The item name (BT-153), for example the product name. Written to cac:Item/cbc:Na
+        #
+        #   @param price_base_quantity [String] The item price base quantity (BT-149). The number of item units to which the uni
+        #
         #   @param product_code [String, nil] The product code of the line item.
         #
         #   @param quantity [String, nil] The quantity of items (goods or services) that is the subject of the line item.
@@ -975,7 +1078,9 @@ module EInvoiceAPI
         optional :payment_reference, String, nil?: true
 
         # @!attribute swift
-        #   SWIFT/BIC code of the bank
+        #   The payment service provider identifier (BT-86): the BIC of the payee's bank, or
+        #   `SE:BANKGIRO` / `SE:PLUSGIRO` when `bank_account_number` is a Swedish bankgiro
+        #   or plusgiro number.
         #
         #   @return [String, nil]
         optional :swift, String, nil?: true
@@ -990,7 +1095,7 @@ module EInvoiceAPI
         #
         #   @param payment_reference [String, nil] Structured payment reference or communication (e.g., structured communication fo
         #
-        #   @param swift [String, nil] SWIFT/BIC code of the bank
+        #   @param swift [String, nil] The payment service provider identifier (BT-86): the BIC of the payee's bank, or
       end
 
       # Tax category code of the invoice (e.g., S for standard rate, Z for zero rate, E