gobl 0.21.0 → 0.23.0

data/lib/generated/gobl/bill/ordering.rb

@@ -10,67 +10,72 @@ module GOBL
     # Ordering provides additional information about the ordering process including references to other documents and alternative parties involved in the order-to-delivery process.
     class Ordering < GOBL::Object
       # The Schema ID of the GOBL Ordering structure
-      SCHEMA_ID = 'https://gobl.org/draft-0/bill/invoice#/$defs/Ordering'
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/ordering'
 
       # @!attribute [r] code
       # Identifier assigned by the customer or buyer for internal routing purposes.
-      # @return [String]
-      property :code, String
+      # @return [GOBL::CBC::Code]
+      property :code, GOBL::CBC::Code
 
       # @!attribute [r] identities
       # Any additional Codes, IDs, SKUs, or other regional or custom identifiers that may be used to identify the order.
       # @return [Array<GOBL::Org::Identity>]
       property :identities, [GOBL::Org::Identity]
 
+      # @!attribute [r] cost
+      # Buyer accounting reference cost code associated with the document.
+      # @return [GOBL::CBC::Code]
+      property :cost, GOBL::CBC::Code
+
       # @!attribute [r] period
       # Period of time that the invoice document refers to often used in addition to the details provided in the individual line items.
       # @return [GOBL::Cal::Period]
       property :period, GOBL::Cal::Period
 
-      # @!attribute [r] project
-      # Project this invoice refers to.
-      # @return [DocumentReference]
-      property :project, DocumentReference
+      # @!attribute [r] buyer
+      # Party who is responsible for issuing payment, if not the same as the customer.
+      # @return [GOBL::Org::Party]
+      property :buyer, GOBL::Org::Party
+
+      # @!attribute [r] seller
+      # Seller is the party liable to pay taxes on the transaction if not the same as the supplier.
+      # @return [GOBL::Org::Party]
+      property :seller, GOBL::Org::Party
+
+      # @!attribute [r] projects
+      # Projects this invoice refers to.
+      # @return [Array<GOBL::Org::DocumentRef>]
+      property :projects, [GOBL::Org::DocumentRef]
 
-      # @!attribute [r] contract
-      # The identification of a contract.
-      # @return [DocumentReference]
-      property :contract, DocumentReference
+      # @!attribute [r] contracts
+      # The identification of contracts.
+      # @return [Array<GOBL::Org::DocumentRef>]
+      property :contracts, [GOBL::Org::DocumentRef]
 
-      # @!attribute [r] purchase
-      # Purchase order issued by the customer or buyer.
-      # @return [DocumentReference]
-      property :purchase, DocumentReference
+      # @!attribute [r] purchases
+      # Purchase orders issued by the customer or buyer.
+      # @return [Array<GOBL::Org::DocumentRef>]
+      property :purchases, [GOBL::Org::DocumentRef]
 
-      # @!attribute [r] sale
-      # Sales order issued by the supplier or seller.
-      # @return [DocumentReference]
-      property :sale, DocumentReference
+      # @!attribute [r] sales
+      # Sales orders issued by the supplier or seller.
+      # @return [Array<GOBL::Org::DocumentRef>]
+      property :sales, [GOBL::Org::DocumentRef]
 
       # @!attribute [r] receiving
       # Receiving Advice.
-      # @return [DocumentReference]
-      property :receiving, DocumentReference
+      # @return [Array<GOBL::Org::DocumentRef>]
+      property :receiving, [GOBL::Org::DocumentRef]
 
       # @!attribute [r] despatch
       # Despatch advice.
-      # @return [DocumentReference]
-      property :despatch, DocumentReference
+      # @return [Array<GOBL::Org::DocumentRef>]
+      property :despatch, [GOBL::Org::DocumentRef]
 
       # @!attribute [r] tender
       # Tender advice, the identification of the call for tender or lot the invoice relates to.
-      # @return [DocumentReference]
-      property :tender, DocumentReference
-
-      # @!attribute [r] buyer
-      # Party who is responsible for making the purchase, but is not responsible for handling taxes.
-      # @return [GOBL::Org::Party]
-      property :buyer, GOBL::Org::Party
-
-      # @!attribute [r] seller
-      # Party who is selling the goods but is not responsible for taxes like the supplier.
-      # @return [GOBL::Org::Party]
-      property :seller, GOBL::Org::Party
+      # @return [Array<GOBL::Org::DocumentRef>]
+      property :tender, [GOBL::Org::DocumentRef]
     end
   end
 end

data/lib/generated/gobl/bill/payment.rb

@@ -7,30 +7,170 @@
 
 module GOBL
   module Bill
-    # Payment contains details as to how the invoice should be paid.
+    # A Payment is used to link an invoice or invoices with a payment transaction.
     class Payment < GOBL::Object
       # The Schema ID of the GOBL Payment structure
-      SCHEMA_ID = 'https://gobl.org/draft-0/bill/invoice#/$defs/Payment'
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/payment'
+
+      # Enumeration of possible values for {#$regime} with their corresponding descriptions
+      $REGIME_ENUM = {
+        'AE' => 'United Arab Emirates',
+        'AT' => 'Austria',
+        'BE' => 'Belgium',
+        'BR' => 'Brazil',
+        'CA' => 'Canada',
+        'CH' => 'Switzerland',
+        'CO' => 'Colombia',
+        'DE' => 'Germany',
+        'EL' => 'Greece',
+        'ES' => 'Spain',
+        'FR' => 'France',
+        'GB' => 'United Kingdom',
+        'IN' => 'India',
+        'IT' => 'Italy',
+        'MX' => 'Mexico',
+        'NL' => 'The Netherlands',
+        'PL' => 'Poland',
+        'PT' => 'Portugal',
+        'US' => 'United States of America'
+      }.freeze
+
+      # @!attribute [r] $regime
+      # @return [GOBL::L10n::TaxCountryCode]
+      property :$regime, GOBL::L10n::TaxCountryCode
+      validates_inclusion_of :$regime, in: $REGIME_ENUM.keys, allow_blank: true
+
+      # @!attribute [r] $addons
+      # Addons defines a list of keys used to identify tax addons that apply special normalization, scenarios, and validation rules to a document.
+      # @return [Array<GOBL::CBC::Key>]
+      property :$addons, [GOBL::CBC::Key]
+
+      # @!attribute [r] $tags
+      # Tags are used to help identify specific tax scenarios or requirements that will apply changes to the contents of the invoice. Tags by design should always be optional, it should always be possible to build a valid invoice without any tags.
+      # @return [Array<GOBL::CBC::Key>]
+      property :$tags, [GOBL::CBC::Key]
+
+      # @!attribute [r] uuid
+      # Universally Unique Identifier.
+      # @return [String]
+      property :uuid, String
+
+      # Enumeration of possible values for {#type} with their corresponding descriptions
+      TYPE_ENUM = {
+        'request' => 'A payment request sent from the supplier to a customer indicating that they are
+      requesting a transfer of funds from the customer directly or a payer.
+      This is used to request payment for specific documents and invoices.',
+        'advice' => 'A remittance advice sent from the customer to the supplier reflecting that payment for
+      the referenced documents has been made.',
+        'receipt' => 'A payment receipt sent from the supplier to a customer indicating that they have
+      received a transfer of funds from the customer directly or a payer.
+      This is the default payment type and may be required by some tax
+      regimes in order to communicate the payment of specific documents and invoices.'
+      }.freeze
+
+      # @!attribute [r] type
+      # Type of payment document being issued.
+      # @return [GOBL::CBC::Key]
+      property :type, GOBL::CBC::Key
+      validates_inclusion_of :type, in: TYPE_ENUM.keys, allow_blank: true
+
+      # @!attribute [r] method
+      # Details on how the payment was made based on the original instructions.
+      # @return [GOBL::Pay::Instructions]
+      property :method, GOBL::Pay::Instructions
+
+      # @!attribute [r] series
+      # Series is used to identify groups of payments by date, business area, project, type, customer, a combination of any, or other company specific data. If the output format does not support the series as a separate field, it will be prepended to the code for presentation with a dash (`-`) for separation.
+      # @return [GOBL::CBC::Code]
+      property :series, GOBL::CBC::Code
+
+      # @!attribute [r] code
+      # Code is a sequential identifier that uniquely identifies the payment. The code can be left empty initially, but is **required** to **sign** the document.
+      # @return [GOBL::CBC::Code]
+      property :code, GOBL::CBC::Code
+
+      # @!attribute [r] issue_date
+      # When the payment was issued.
+      # @return [GOBL::Cal::Date]
+      property :issue_date, GOBL::Cal::Date
+
+      # @!attribute [r] issue_time
+      # IssueTime is an optional field that may be useful to indicate the time of day when the payment was issued.
+      # @return [GOBL::Cal::Time]
+      property :issue_time, GOBL::Cal::Time
+
+      # @!attribute [r] value_date
+      # When the taxes of this payment become accountable, if none set, the issue date is assumed.
+      # @return [GOBL::Cal::Date]
+      property :value_date, GOBL::Cal::Date
+
+      # @!attribute [r] currency
+      # Currency for all payment totals.
+      # @return [GOBL::Currency::Code]
+      property :currency, GOBL::Currency::Code
+
+      # @!attribute [r] exchange_rates
+      # Exchange rates to be used when converting the payment's monetary values into other currencies.
+      # @return [Array<GOBL::Currency::ExchangeRate>]
+      property :exchange_rates, [GOBL::Currency::ExchangeRate]
+
+      # @!attribute [r] ext
+      # Extensions for additional codes that may be required.
+      # @return [GOBL::Tax::Extensions]
+      property :ext, GOBL::Tax::Extensions
+
+      # @!attribute [r] preceding
+      # Key information regarding previous versions of this document.
+      # @return [Array<GOBL::Org::DocumentRef>]
+      property :preceding, [GOBL::Org::DocumentRef]
+
+      # @!attribute [r] supplier
+      # The taxable entity who is responsible for supplying goods or services.
+      # @return [GOBL::Org::Party]
+      property :supplier, GOBL::Org::Party
+      validates_presence_of :supplier
+
+      # @!attribute [r] customer
+      # Legal entity that receives the goods or services.
+      # @return [GOBL::Org::Party]
+      property :customer, GOBL::Org::Party
 
       # @!attribute [r] payee
-      # The party responsible for receiving payment of the invoice, if not the supplier.
+      # Legal entity that receives the payment if not the supplier.
       # @return [GOBL::Org::Party]
       property :payee, GOBL::Org::Party
 
-      # @!attribute [r] terms
-      # Payment terms or conditions.
-      # @return [GOBL::Pay::Terms]
-      property :terms, GOBL::Pay::Terms
+      # @!attribute [r] lines
+      # List of documents that are being paid for.
+      # @return [Array<PaymentLine>]
+      property :lines, [PaymentLine]
+      validates_presence_of :lines
 
-      # @!attribute [r] advances
-      # Any amounts that have been paid in advance and should be deducted from the amount due.
-      # @return [Array<GOBL::Pay::Advance>]
-      property :advances, [GOBL::Pay::Advance]
+      # @!attribute [r] ordering
+      # Ordering allows for additional information about the ordering process including references to other documents and alternative parties involved in the order-to-delivery process.
+      # @return [GOBL::Bill::Ordering]
+      property :ordering, GOBL::Bill::Ordering
 
-      # @!attribute [r] instructions
-      # Details on how payment should be made.
-      # @return [GOBL::Pay::Instructions]
-      property :instructions, GOBL::Pay::Instructions
+      # @!attribute [r] total
+      # Total amount to be paid in this payment, either positive or negative according to the line types and totals. Calculated automatically.
+      # @return [GOBL::Num::Amount]
+      property :total, GOBL::Num::Amount
+      validates_presence_of :total
+
+      # @!attribute [r] notes
+      # Unstructured information that is relevant to the payment, such as correction or additional legal details.
+      # @return [Array<GOBL::Org::Note>]
+      property :notes, [GOBL::Org::Note]
+
+      # @!attribute [r] complements
+      # Additional complementary objects that add relevant information to the payment.
+      # @return [Array<GOBL::Schema::Object>]
+      property :complements, [GOBL::Schema::Object]
+
+      # @!attribute [r] meta
+      # Additional semi-structured data that doesn't fit into the body of the invoice.
+      # @return [GOBL::CBC::Meta]
+      property :meta, GOBL::CBC::Meta
     end
   end
 end

data/lib/generated/gobl/bill/payment_details.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+##
+## DO NOT EDIT - This file was generated automatically.
+##
+##
+
+module GOBL
+  module Bill
+    # PaymentDetails contains details as to how the invoice should be paid.
+    class PaymentDetails < GOBL::Object
+      # The Schema ID of the GOBL PaymentDetails structure
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/payment-details'
+
+      # @!attribute [r] payee
+      # The party responsible for receiving payment of the invoice, if not the supplier.
+      # @return [GOBL::Org::Party]
+      property :payee, GOBL::Org::Party
+
+      # @!attribute [r] terms
+      # Payment terms or conditions.
+      # @return [GOBL::Pay::Terms]
+      property :terms, GOBL::Pay::Terms
+
+      # @!attribute [r] advances
+      # Any amounts that have been paid in advance and should be deducted from the amount due.
+      # @return [Array<GOBL::Pay::Advance>]
+      property :advances, [GOBL::Pay::Advance]
+
+      # @!attribute [r] instructions
+      # Details on how payment should be made.
+      # @return [GOBL::Pay::Instructions]
+      property :instructions, GOBL::Pay::Instructions
+    end
+  end
+end

data/lib/generated/gobl/bill/payment_line.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+##
+## DO NOT EDIT - This file was generated automatically.
+##
+##
+
+module GOBL
+  module Bill
+    # PaymentLine defines the details of a line item in a payment document.
+    class PaymentLine < GOBL::Object
+      # The Schema ID of the GOBL PaymentLine structure
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/payment#/$defs/PaymentLine'
+
+      # @!attribute [r] uuid
+      # Universally Unique Identifier.
+      # @return [String]
+      property :uuid, String
+
+      # @!attribute [r] i
+      # Line number within the parent document (automatically calculated)
+      # @return [Integer]
+      property :i, Integer
+
+      # @!attribute [r] refund
+      # Indicates whether this payment is a refund of a previous payment, effectively reversing the flow of funds between the supplier and customer or their representatives.
+      # @return [Boolean]
+      property :refund, Boolean
+
+      # @!attribute [r] document
+      # Reference to the document being paid
+      # @return [GOBL::Org::DocumentRef]
+      property :document, GOBL::Org::DocumentRef
+
+      # @!attribute [r] installment
+      # When making multiple payments for a single document, this specifies the installment number for this payment line.
+      # @return [Integer]
+      property :installment, Integer
+
+      # @!attribute [r] description
+      # Additional human readable description of the payment line which may be useful for explaining the purpose or special conditions. Notes should be used for more formal comments.
+      # @return [String]
+      property :description, String
+
+      # @!attribute [r] payable
+      # Payable reflects the amount of the document that is payable. This will be calculated from the embedded document's amount automatically and converted to the currency of the document.
+      # @return [GOBL::Num::Amount]
+      property :payable, GOBL::Num::Amount
+
+      # @!attribute [r] advances
+      # Amount already paid in previous installments, which may be required by some tax regimes or specific use cases.
+      # @return [GOBL::Num::Amount]
+      property :advances, GOBL::Num::Amount
+
+      # @!attribute [r] amount
+      # Amount of the total payment allocated to the referenced document.
+      # @return [GOBL::Num::Amount]
+      property :amount, GOBL::Num::Amount
+      validates_presence_of :amount
+
+      # @!attribute [r] due
+      # Due reflects how much still needs to be paid
+      # @return [GOBL::Num::Amount]
+      property :due, GOBL::Num::Amount
+
+      # @!attribute [r] tax
+      # Tax contains a breakdown of the taxes that will be applied to this payment line after taking into account currency conversion and the relative amounts.
+      # @return [GOBL::Tax::Total]
+      property :tax, GOBL::Tax::Total
+
+      # @!attribute [r] notes
+      # Additional notes specific to this line item for clarification purposes
+      # @return [Array<GOBL::Org::Note>]
+      property :notes, [GOBL::Org::Note]
+    end
+  end
+end

data/lib/generated/gobl/bill/sub_line.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+##
+## DO NOT EDIT - This file was generated automatically.
+##
+##
+
+module GOBL
+  module Bill
+    # SubLine provides a simplified line that can be embedded inside other lines to provide a more detailed breakdown of the items being sold or substituted.
+    class SubLine < GOBL::Object
+      # The Schema ID of the GOBL SubLine structure
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/line#/$defs/SubLine'
+
+      # @!attribute [r] uuid
+      # Universally Unique Identifier.
+      # @return [String]
+      property :uuid, String
+
+      # @!attribute [r] i
+      # Line number inside the parent (calculated)
+      # @return [Integer]
+      property :i, Integer
+
+      # @!attribute [r] quantity
+      # Number of items
+      # @return [GOBL::Num::Amount]
+      property :quantity, GOBL::Num::Amount
+      validates_presence_of :quantity
+
+      # @!attribute [r] identifier
+      # Single identifier provided by the supplier for an object on which the line item is based and is not considered a universal identity. Examples include a subscription number, telephone number, meter point, etc. Utilize the label property to provide a description of the identifier.
+      # @return [GOBL::Org::Identity]
+      property :identifier, GOBL::Org::Identity
+
+      # @!attribute [r] period
+      # A period of time relevant to when the service or item is delivered.
+      # @return [GOBL::Cal::Period]
+      property :period, GOBL::Cal::Period
+
+      # @!attribute [r] order
+      # Order reference for a specific line within a purchase order provided by the buyer.
+      # @return [GOBL::CBC::Code]
+      property :order, GOBL::CBC::Code
+
+      # @!attribute [r] cost
+      # Buyer accounting reference cost code to associate with the line.
+      # @return [GOBL::CBC::Code]
+      property :cost, GOBL::CBC::Code
+
+      # @!attribute [r] item
+      # Details about the item, service or good, that is being sold
+      # @return [GOBL::Org::Item]
+      property :item, GOBL::Org::Item
+      validates_presence_of :item
+
+      # @!attribute [r] sum
+      # Result of quantity multiplied by the item's price (calculated)
+      # @return [GOBL::Num::Amount]
+      property :sum, GOBL::Num::Amount
+
+      # @!attribute [r] discounts
+      # Discounts applied to this sub-line
+      # @return [Array<LineDiscount>]
+      property :discounts, [LineDiscount]
+
+      # @!attribute [r] charges
+      # Charges applied to this sub-line
+      # @return [Array<LineCharge>]
+      property :charges, [LineCharge]
+
+      # @!attribute [r] total
+      # Total sub-line amount after applying discounts to the sum (calculated).
+      # @return [GOBL::Num::Amount]
+      property :total, GOBL::Num::Amount
+
+      # @!attribute [r] notes
+      # Set of specific notes for this sub-line that may be required for clarification.
+      # @return [Array<GOBL::Org::Note>]
+      property :notes, [GOBL::Org::Note]
+    end
+  end
+end

data/lib/generated/gobl/bill/tax.rb

@@ -10,17 +10,31 @@ module GOBL
     # Tax defines a summary of the taxes which may be applied to an invoice.
     class Tax < GOBL::Object
       # The Schema ID of the GOBL Tax structure
-      SCHEMA_ID = 'https://gobl.org/draft-0/bill/invoice#/$defs/Tax'
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/tax'
 
       # @!attribute [r] prices_include
       # Category of the tax already included in the line item prices, especially useful for B2C retailers with customers who prefer final prices inclusive of tax.
       # @return [GOBL::CBC::Code]
       property :prices_include, GOBL::CBC::Code
 
-      # @!attribute [r] tags
-      # Special tax tags that apply to this invoice according to local requirements.
-      # @return [Array<GOBL::CBC::Key>]
-      property :tags, [GOBL::CBC::Key]
+      # Enumeration of possible values for {#rounding} with their corresponding descriptions
+      ROUNDING_ENUM = {
+        'precise' => 'The default method of calculating the totals in GOBL, and provides the best results
+      for most cases as the precision is maintained to the maximum amount possible. The
+      tradeoff however is that sometimes the totals may not sum exactly based on what is visible.',
+        'currency' => 'The alternative method of calculating the totals that will first round all the amounts
+      to the currencys precision before making the sums. Totals using this approach can always
+      be recalculated using the amounts presented, but can lead to rounding errors in the case
+      of pre-payments and when line item prices include tax.s precision before making the sums. Totals using this approach can always
+      be recalculated using the amounts presented, but can lead to rounding errors in the case
+      of pre-payments and when line item prices include tax.'
+      }.freeze
+
+      # @!attribute [r] rounding
+      # Rounding model used to perform tax calculations on the invoice. This will be configured automatically based on the tax regime, or `sum-then-round` by default, but you can override here if needed. Use with caution, as some conversion tools may make assumptions about the rounding model used.
+      # @return [GOBL::CBC::Key]
+      property :rounding, GOBL::CBC::Key
+      validates_inclusion_of :rounding, in: ROUNDING_ENUM.keys, allow_blank: true
 
       # @!attribute [r] ext
       # Additional extensions that are applied to the invoice as a whole as opposed to specific sections.

data/lib/generated/gobl/bill/totals.rb

@@ -10,74 +10,74 @@ module GOBL
     # Totals contains the summaries of all calculations for the invoice.
     class Totals < GOBL::Object
       # The Schema ID of the GOBL Totals structure
-      SCHEMA_ID = 'https://gobl.org/draft-0/bill/invoice#/$defs/Totals'
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/totals'
 
       # @!attribute [r] sum
-      # Sum of all line item sums
+      # Total of all line item amounts.
       # @return [GOBL::Num::Amount]
       property :sum, GOBL::Num::Amount
       validates_presence_of :sum
 
       # @!attribute [r] discount
-      # Sum of all document level discounts
+      # Total of all discounts applied at the document level.
       # @return [GOBL::Num::Amount]
       property :discount, GOBL::Num::Amount
 
       # @!attribute [r] charge
-      # Sum of all document level charges
+      # Total of all charges applied at the document level.
       # @return [GOBL::Num::Amount]
       property :charge, GOBL::Num::Amount
 
       # @!attribute [r] tax_included
-      # If prices include tax, this is the total tax included in the price.
+      # Total tax amount included in the prices, if prices are tax-inclusive.
       # @return [GOBL::Num::Amount]
       property :tax_included, GOBL::Num::Amount
 
       # @!attribute [r] total
-      # Sum of all line sums minus the discounts, plus the charges, without tax.
+      # Net total amount after subtracting discounts and adding charges, excluding tax.
       # @return [GOBL::Num::Amount]
       property :total, GOBL::Num::Amount
       validates_presence_of :total
 
       # @!attribute [r] taxes
-      # Summary of all the taxes included in the invoice.
+      # Detailed breakdown of all taxes applied to the invoice.
       # @return [GOBL::Tax::Total]
       property :taxes, GOBL::Tax::Total
 
       # @!attribute [r] tax
-      # Total amount of tax to apply to the invoice.
+      # Total indirect tax amount to be applied to the invoice.
       # @return [GOBL::Num::Amount]
       property :tax, GOBL::Num::Amount
 
       # @!attribute [r] total_with_tax
-      # Grand total after all taxes have been applied.
+      # Final total amount after applying indirect taxes.
       # @return [GOBL::Num::Amount]
       property :total_with_tax, GOBL::Num::Amount
       validates_presence_of :total_with_tax
 
-      # @!attribute [r] rounding
-      # Rounding amount to apply to the invoice in case the total and payable amounts don't quite match.
+      # @!attribute [r] retained_tax
+      # Total tax amount retained or withheld by the customer to be paid to the tax authority.
       # @return [GOBL::Num::Amount]
-      property :rounding, GOBL::Num::Amount
+      property :retained_tax, GOBL::Num::Amount
 
-      # @!attribute [r] outlays
-      # Total paid in outlays that need to be reimbursed
+      # @!attribute [r] rounding
+      # Adjustment amount applied to the invoice totals to meet rounding rules or expectations.
       # @return [GOBL::Num::Amount]
-      property :outlays, GOBL::Num::Amount
+      property :rounding, GOBL::Num::Amount
 
       # @!attribute [r] payable
-      # Total amount to be paid after applying taxes and outlays.
+      # Final amount to be paid after retained taxes and rounding adjustments.
       # @return [GOBL::Num::Amount]
       property :payable, GOBL::Num::Amount
       validates_presence_of :payable
 
       # @!attribute [r] advance
-      # Total amount already paid in advance.
+      # Total amount already paid in advance by the customer.
       # @return [GOBL::Num::Amount]
       property :advance, GOBL::Num::Amount
 
       # @!attribute [r] due
-      # How much actually needs to be paid now.
+      # Remaining amount that needs to be paid.
       # @return [GOBL::Num::Amount]
       property :due, GOBL::Num::Amount
     end

data/lib/generated/gobl/bill/tracking.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+##
+## DO NOT EDIT - This file was generated automatically.
+##
+##
+
+module GOBL
+  module Bill
+    # Tracking stores tracking information about a delivery.
+    class Tracking < GOBL::Object
+      # The Schema ID of the GOBL Tracking structure
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/delivery#/$defs/Tracking'
+
+      # @!attribute [r] code
+      # Code used for tracking
+      # @return [GOBL::CBC::Code]
+      property :code, GOBL::CBC::Code
+
+      # @!attribute [r] website
+      # Website to access for more tracking details
+      # @return [GOBL::Org::Website]
+      property :website, GOBL::Org::Website
+    end
+  end
+end

data/lib/generated/gobl/cal/date_time.rb

@@ -8,7 +8,7 @@
 module GOBL
   module Cal
     # Civil date time in simplified ISO format with no time zone
-    # information, for example: 2021-05-26T13:45:00
+    # nor location information, for example: 2021-05-26T13:45:00
     class DateTime < String
       # The Schema ID of the GOBL DateTime structure
       SCHEMA_ID = 'https://gobl.org/draft-0/cal/date-time'