gobl 0.22.0 → 0.23.0

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

@@ -10,27 +10,47 @@ module GOBL
     # Charge represents a surchange applied to the complete document independent from the individual lines.
     class Charge < GOBL::Object
       # The Schema ID of the GOBL Charge structure
-      SCHEMA_ID = 'https://gobl.org/draft-0/bill/invoice#/$defs/Charge'
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/charge'
 
       # @!attribute [r] uuid
       # Universally Unique Identifier.
       # @return [String]
       property :uuid, String
 
-      # @!attribute [r] key
-      # Key for grouping or identifying charges for tax purposes.
-      # @return [GOBL::CBC::Key]
-      property :key, GOBL::CBC::Key
-
       # @!attribute [r] i
       # Line number inside the list of charges (calculated).
       # @return [Integer]
       property :i, Integer
 
-      # @!attribute [r] ref
-      # Code to used to refer to the this charge
+      # Enumeration of possible values for {#key} with their corresponding descriptions
+      KEY_ENUM = {
+        'stamp-duty' => 'Stamp Duty',
+        'outlay' => 'Outlay',
+        'tax' => 'Tax',
+        'customs' => 'Customs',
+        'delivery' => 'Delivery',
+        'packing' => 'Packing',
+        'handling' => 'Handling',
+        'insurance' => 'Insurance',
+        'storage' => 'Storage',
+        'admin' => 'Administration',
+        'cleaning' => 'Cleaning'
+      }.freeze
+
+      # @!attribute [r] key
+      # Key for grouping or identifying charges for tax purposes. A suggested list of keys is provided, but these may be extended by the issuer.
+      # @return [GOBL::CBC::Key]
+      property :key, GOBL::CBC::Key
+
+      # @!attribute [r] code
+      # Code to used to refer to the this charge by the issuer
+      # @return [GOBL::CBC::Code]
+      property :code, GOBL::CBC::Code
+
+      # @!attribute [r] reason
+      # Text description as to why the charge was applied
       # @return [String]
-      property :ref, String
+      property :reason, String
 
       # @!attribute [r] base
       # Base represents the value used as a base for percent calculations instead of the invoice's sum of lines.
@@ -38,7 +58,7 @@ module GOBL
       property :base, GOBL::Num::Amount
 
       # @!attribute [r] percent
-      # Percentage to apply to the Base or Invoice Sum
+      # Percentage to apply to the sum of all lines
       # @return [GOBL::Num::Percentage]
       property :percent, GOBL::Num::Percentage
 
@@ -52,15 +72,10 @@ module GOBL
       # @return [GOBL::Tax::Set]
       property :taxes, GOBL::Tax::Set
 
-      # @!attribute [r] code
-      # Code for why was this charge applied?
-      # @return [String]
-      property :code, String
-
-      # @!attribute [r] reason
-      # Text description as to why the charge was applied
-      # @return [String]
-      property :reason, String
+      # @!attribute [r] ext
+      # Extension codes that apply to the charge
+      # @return [GOBL::Tax::Extensions]
+      property :ext, GOBL::Tax::Extensions
 
       # @!attribute [r] meta
       # Additional semi-structured information.

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

@@ -39,9 +39,14 @@ module GOBL
       property :reason, String
 
       # @!attribute [r] ext
-      # Extensions for region specific requirements.
+      # Extensions for region specific requirements that may be added in the preceding or at the document level, according to the local rules.
       # @return [GOBL::Tax::Extensions]
       property :ext, GOBL::Tax::Extensions
+
+      # @!attribute [r] copy_tax
+      # CopyTax when true will copy the tax totals from the previous document to the preceding document data.
+      # @return [Boolean]
+      property :copy_tax, Boolean
     end
   end
 end

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

@@ -7,35 +7,203 @@
 
 module GOBL
   module Bill
-    # Delivery covers the details of the destination for the products described in the invoice body.
+    # Delivery document used to describe the delivery of goods or potentially also services.
     class Delivery < GOBL::Object
       # The Schema ID of the GOBL Delivery structure
-      SCHEMA_ID = 'https://gobl.org/draft-0/bill/invoice#/$defs/Delivery'
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/delivery'
+
+      # 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 = {
+        'advice' => 'A delivery or despatch advice document send by the supplier to indicate how
+      an order is to be delivered.',
+        'note' => 'A delivery note is a document accompanying a shipment of goods that lists the
+      items included in the shipment.',
+        'waybill' => 'A waybill is a document issued by a carrier giving details and instructions
+      relating to the shipment of a consignment of goods.',
+        'receipt' => 'A delivery receipt is a document that is signed by the person who receives
+      goods to confirm that they have been received.'
+      }.freeze
+
+      # @!attribute [r] type
+      # Type of delivery document.
+      # @return [GOBL::CBC::Key]
+      property :type, GOBL::CBC::Key
+      validates_presence_of :type
+      validates_inclusion_of :type, in: TYPE_ENUM.keys
+
+      # @!attribute [r] series
+      # Series is used to identify groups of deliveries 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 delivery. 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 delivery document is to be 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 delivery was issued. Some regions and formats may require this field to be set. An empty string will be automatically updated to reflect the current time, otherwise the field can be left with a nil value.
+      # @return [GOBL::Cal::Time]
+      property :issue_time, GOBL::Cal::Time
+
+      # @!attribute [r] value_date
+      # When the taxes of this delivery become accountable, if none set, the issue date is used.
+      # @return [GOBL::Cal::Date]
+      property :value_date, GOBL::Cal::Date
+
+      # @!attribute [r] currency
+      # Currency for all delivery totals.
+      # @return [GOBL::Currency::Code]
+      property :currency, GOBL::Currency::Code
+
+      # @!attribute [r] exchange_rates
+      # Exchange rates to be used when converting the invoices monetary values into other currencies.
+      # @return [Array<GOBL::Currency::ExchangeRate>]
+      property :exchange_rates, [GOBL::Currency::ExchangeRate]
+
+      # @!attribute [r] ordering
+      # Ordering details for the delivery, including links to other documents.
+      # @return [GOBL::Bill::Ordering]
+      property :ordering, GOBL::Bill::Ordering
+
+      # @!attribute [r] preceding
+      # Key information regarding previous delivery documents that this one will either extend or replace.
+      # @return [Array<GOBL::Org::DocumentRef>]
+      property :preceding, [GOBL::Org::DocumentRef]
+
+      # @!attribute [r] tracking
+      # Tracking is used to define specific codes or IDs that may be used to identify and track delivery.
+      # @return [Tracking]
+      property :tracking, Tracking
+
+      # @!attribute [r] despatch_date
+      # DespatchDate is the date when the goods are expected to be despatched.
+      # @return [GOBL::Cal::Date]
+      property :despatch_date, GOBL::Cal::Date
+
+      # @!attribute [r] receive_date
+      # ReceiveDate is the date when the goods are expected to be received.
+      # @return [GOBL::Cal::Date]
+      property :receive_date, GOBL::Cal::Date
+
+      # @!attribute [r] tax
+      # Special tax configuration for calculating totals.
+      # @return [GOBL::Bill::Tax]
+      property :tax, GOBL::Bill::Tax
+
+      # @!attribute [r] supplier
+      # The entity supplying the goods or services and usually responsible for paying taxes.
+      # @return [GOBL::Org::Party]
+      property :supplier, GOBL::Org::Party
+      validates_presence_of :supplier
+
+      # @!attribute [r] customer
+      # Legal entity receiving the goods or services, may be nil in certain circumstances such as simplified invoices.
+      # @return [GOBL::Org::Party]
+      property :customer, GOBL::Org::Party
+
+      # @!attribute [r] despatcher
+      # The party who will despatch the goods defined in the invoice.
+      # @return [GOBL::Org::Party]
+      property :despatcher, GOBL::Org::Party
 
       # @!attribute [r] receiver
-      # The party who will receive delivery of the goods defined in the invoice and is not responsible for taxes.
+      # The party who will receive delivery of the goods defined in the invoice.
       # @return [GOBL::Org::Party]
       property :receiver, GOBL::Org::Party
 
-      # @!attribute [r] identities
-      # Identities is used to define specific codes or IDs that may be used to identify the delivery.
-      # @return [Array<GOBL::Org::Identity>]
-      property :identities, [GOBL::Org::Identity]
+      # @!attribute [r] courier
+      # The courier responsible for delivering the goods.
+      # @return [GOBL::Org::Party]
+      property :courier, GOBL::Org::Party
 
-      # @!attribute [r] date
-      # When the goods should be expected.
-      # @return [GOBL::Cal::Date]
-      property :date, GOBL::Cal::Date
+      # @!attribute [r] lines
+      # List of lines representing each of the items to be ordered.
+      # @return [Array<GOBL::Bill::Line>]
+      property :lines, [GOBL::Bill::Line]
+
+      # @!attribute [r] discounts
+      # Discounts or allowances applied to order totals
+      # @return [Array<GOBL::Bill::Discount>]
+      property :discounts, [GOBL::Bill::Discount]
 
-      # @!attribute [r] period
-      # Period of time in which to expect delivery if a specific date is not available.
-      # @return [GOBL::Cal::Period]
-      property :period, GOBL::Cal::Period
+      # @!attribute [r] charges
+      # Charges or surcharges applied to order totals
+      # @return [Array<GOBL::Bill::Charge>]
+      property :charges, [GOBL::Bill::Charge]
+
+      # @!attribute [r] totals
+      # Summary of all the order totals, including taxes (calculated).
+      # @return [GOBL::Bill::Totals]
+      property :totals, GOBL::Bill::Totals
+
+      # @!attribute [r] notes
+      # Unstructured information that is relevant to the delivery, 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 delivery.
+      # @return [Array<GOBL::Schema::Object>]
+      property :complements, [GOBL::Schema::Object]
 
       # @!attribute [r] meta
-      # Additional custom data.
+      # Additional semi-structured data that doesn't fit into the body of the delivery.
       # @return [GOBL::CBC::Meta]
       property :meta, GOBL::CBC::Meta
+
+      # @!attribute [r] attachments
+      # Attachments provide additional information or supporting documents that are not included in the main document. It is important that attachments are not used for alternative versions of the PDF, for that, see "links" inside the envelope headers.
+      # @return [Array<GOBL::Org::Attachment>]
+      property :attachments, [GOBL::Org::Attachment]
     end
   end
 end

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

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+##
+## DO NOT EDIT - This file was generated automatically.
+##
+##
+
+module GOBL
+  module Bill
+    # DeliveryDetails covers the details of the destination for the products described in the invoice body.
+    class DeliveryDetails < GOBL::Object
+      # The Schema ID of the GOBL DeliveryDetails structure
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/delivery-details'
+
+      # @!attribute [r] receiver
+      # The party who will receive delivery of the goods defined in the invoice and is not responsible for taxes.
+      # @return [GOBL::Org::Party]
+      property :receiver, GOBL::Org::Party
+
+      # @!attribute [r] identities
+      # Identities is used to define specific codes or IDs that may be used to identify the delivery.
+      # @return [Array<GOBL::Org::Identity>]
+      property :identities, [GOBL::Org::Identity]
+
+      # @!attribute [r] date
+      # When the goods should be expected.
+      # @return [GOBL::Cal::Date]
+      property :date, GOBL::Cal::Date
+
+      # @!attribute [r] period
+      # Period of time in which to expect delivery if a specific date is not available.
+      # @return [GOBL::Cal::Period]
+      property :period, GOBL::Cal::Period
+
+      # @!attribute [r] meta
+      # Additional custom data.
+      # @return [GOBL::CBC::Meta]
+      property :meta, GOBL::CBC::Meta
+    end
+  end
+end

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

@@ -10,7 +10,7 @@ module GOBL
     # Discount represents an allowance applied to the complete document independent from the individual lines.
     class Discount < GOBL::Object
       # The Schema ID of the GOBL Discount structure
-      SCHEMA_ID = 'https://gobl.org/draft-0/bill/invoice#/$defs/Discount'
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/discount'
 
       # @!attribute [r] uuid
       # Universally Unique Identifier.
@@ -22,10 +22,38 @@ module GOBL
       # @return [Integer]
       property :i, Integer
 
-      # @!attribute [r] ref
-      # Reference or ID for this Discount
+      # Enumeration of possible values for {#key} with their corresponding descriptions
+      KEY_ENUM = {
+        'early-completion' => 'Bonus for works ahead of schedule',
+        'military' => 'Military Discount',
+        'work-accident' => 'Work Accident Discount',
+        'special-agreement' => 'Special Agreement Discount',
+        'production-error' => 'Production Error Discount',
+        'new-outlet' => 'New Outlet Discount',
+        'sample' => 'Sample Discount',
+        'end-of-range' => 'End of Range Discount',
+        'incoterm' => 'Incoterm Discount',
+        'pos-threshold' => 'Point of Sale Threshold Discount',
+        'special-rebate' => 'Special Rebate',
+        'temporary' => 'Temporary',
+        'standard' => 'Standard',
+        'yearly-turnover' => 'Yearly Turnover'
+      }.freeze
+
+      # @!attribute [r] key
+      # Key for identifying the type of discount being applied.
+      # @return [GOBL::CBC::Key]
+      property :key, GOBL::CBC::Key
+
+      # @!attribute [r] code
+      # Code to used to refer to the this discount by the issuer
+      # @return [GOBL::CBC::Code]
+      property :code, GOBL::CBC::Code
+
+      # @!attribute [r] reason
+      # Text description as to why the discount was applied
       # @return [String]
-      property :ref, String
+      property :reason, String
 
       # @!attribute [r] base
       # Base represents the value used as a base for percent calculations instead of the invoice's sum of lines.
@@ -47,15 +75,10 @@ module GOBL
       # @return [GOBL::Tax::Set]
       property :taxes, GOBL::Tax::Set
 
-      # @!attribute [r] code
-      # Code for the reason this discount applied
-      # @return [String]
-      property :code, String
-
-      # @!attribute [r] reason
-      # Text description as to why the discount was applied
-      # @return [String]
-      property :reason, String
+      # @!attribute [r] ext
+      # Extension codes that apply to the discount
+      # @return [GOBL::Tax::Extensions]
+      property :ext, GOBL::Tax::Extensions
 
       # @!attribute [r] meta
       # Additional semi-structured information.

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

@@ -14,8 +14,10 @@ module GOBL
 
       # 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',
@@ -24,6 +26,7 @@ module GOBL
         'ES' => 'Spain',
         'FR' => 'France',
         'GB' => 'United Kingdom',
+        'IN' => 'India',
         'IT' => 'Italy',
         'MX' => 'Mexico',
         'NL' => 'The Netherlands',
@@ -68,27 +71,31 @@ module GOBL
       }.freeze
 
       # @!attribute [r] type
-      # Type of invoice document subject to the requirements of the local tax regime.
+      # Type of invoice document. May be restricted by local tax regime requirements.
       # @return [GOBL::CBC::Key]
       property :type, GOBL::CBC::Key
       validates_inclusion_of :type, in: TYPE_ENUM.keys, allow_blank: true
 
       # @!attribute [r] series
-      # Used as a prefix to group codes.
+      # Series is used to identify groups of invoices by date, business area, project, type of document, customer type, 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
-      # Sequential code used to identify this invoice in tax declarations.
+      # Code is a sequential identifier that uniquely identifies the invoice. The code can be left empty initially, but is **required** to **sign** the invoice.
       # @return [GOBL::CBC::Code]
       property :code, GOBL::CBC::Code
-      validates_presence_of :code
 
       # @!attribute [r] issue_date
-      # When the invoice was created.
+      # Issue date for when the invoice was created and issued. Todays date is used if none is set. There are often legal restrictions on how far back or in the future an invoice can be 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 invoice was issued. Some regions and formats may require this field to be set. An empty string will be automatically updated to reflect the current time, otherwise the field can be left with a nil value.
+      # @return [GOBL::Cal::Time]
+      property :issue_time, GOBL::Cal::Time
+
       # @!attribute [r] op_date
       # Date when the operation defined by the invoice became effective.
       # @return [GOBL::Cal::Date]
@@ -100,7 +107,7 @@ module GOBL
       property :value_date, GOBL::Cal::Date
 
       # @!attribute [r] currency
-      # Currency for all invoice totals.
+      # Currency for all invoice amounts and totals, unless explicitly stated otherwise.
       # @return [GOBL::Currency::Code]
       property :currency, GOBL::Currency::Code
 
@@ -110,17 +117,17 @@ module GOBL
       property :exchange_rates, [GOBL::Currency::ExchangeRate]
 
       # @!attribute [r] preceding
-      # Key information regarding previous invoices and potentially details as to why they were corrected.
+      # Document references for previous invoices that this document replaces or extends.
       # @return [Array<GOBL::Org::DocumentRef>]
       property :preceding, [GOBL::Org::DocumentRef]
 
       # @!attribute [r] tax
-      # Special tax configuration for billing.
-      # @return [Tax]
-      property :tax, Tax
+      # Special billing tax configuration options.
+      # @return [GOBL::Bill::Tax]
+      property :tax, GOBL::Bill::Tax
 
       # @!attribute [r] supplier
-      # The taxable entity supplying the goods or services.
+      # The entity supplying the goods or services and usually responsible for paying taxes.
       # @return [GOBL::Org::Party]
       property :supplier, GOBL::Org::Party
       validates_presence_of :supplier
@@ -132,48 +139,43 @@ module GOBL
 
       # @!attribute [r] lines
       # List of invoice lines representing each of the items sold to the customer.
-      # @return [Array<Line>]
-      property :lines, [Line]
+      # @return [Array<GOBL::Bill::Line>]
+      property :lines, [GOBL::Bill::Line]
 
       # @!attribute [r] discounts
       # Discounts or allowances applied to the complete invoice
-      # @return [Array<Discount>]
-      property :discounts, [Discount]
+      # @return [Array<GOBL::Bill::Discount>]
+      property :discounts, [GOBL::Bill::Discount]
 
       # @!attribute [r] charges
       # Charges or surcharges applied to the complete invoice
-      # @return [Array<Charge>]
-      property :charges, [Charge]
-
-      # @!attribute [r] outlays
-      # Expenses paid for by the supplier but invoiced directly to the customer.
-      # @return [Array<Outlay>]
-      property :outlays, [Outlay]
+      # @return [Array<GOBL::Bill::Charge>]
+      property :charges, [GOBL::Bill::Charge]
 
       # @!attribute [r] ordering
       # Ordering details including document references and buyer or seller parties.
-      # @return [Ordering]
-      property :ordering, Ordering
+      # @return [GOBL::Bill::Ordering]
+      property :ordering, GOBL::Bill::Ordering
 
       # @!attribute [r] payment
       # Information on when, how, and to whom the invoice should be paid.
-      # @return [Payment]
-      property :payment, Payment
+      # @return [GOBL::Bill::PaymentDetails]
+      property :payment, GOBL::Bill::PaymentDetails
 
       # @!attribute [r] delivery
       # Specific details on delivery of the goods referenced in the invoice.
-      # @return [Delivery]
-      property :delivery, Delivery
+      # @return [GOBL::Bill::DeliveryDetails]
+      property :delivery, GOBL::Bill::DeliveryDetails
 
       # @!attribute [r] totals
       # Summary of all the invoice totals, including taxes (calculated).
-      # @return [Totals]
-      property :totals, Totals
+      # @return [GOBL::Bill::Totals]
+      property :totals, GOBL::Bill::Totals
 
       # @!attribute [r] notes
       # Unstructured information that is relevant to the invoice, such as correction or additional legal details.
-      # @return [Array<GOBL::CBC::Note>]
-      property :notes, [GOBL::CBC::Note]
+      # @return [Array<GOBL::Org::Note>]
+      property :notes, [GOBL::Org::Note]
 
       # @!attribute [r] complements
       # Additional complementary objects that add relevant information to the invoice.
@@ -184,6 +186,11 @@ module GOBL
       # Additional semi-structured data that doesn't fit into the body of the invoice.
       # @return [GOBL::CBC::Meta]
       property :meta, GOBL::CBC::Meta
+
+      # @!attribute [r] attachments
+      # Attachments provide additional information or supporting documents that are not included in the main document. It is important that attachments are not used for alternative versions of the PDF, for that, see "links" inside the envelope headers.
+      # @return [Array<GOBL::Org::Attachment>]
+      property :attachments, [GOBL::Org::Attachment]
     end
   end
 end

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

@@ -10,7 +10,7 @@ module GOBL
     # Line is a single row in an invoice.
     class Line < GOBL::Object
       # The Schema ID of the GOBL Line structure
-      SCHEMA_ID = 'https://gobl.org/draft-0/bill/invoice#/$defs/Line'
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/line'
 
       # @!attribute [r] uuid
       # Universally Unique Identifier.
@@ -28,12 +28,37 @@ module GOBL
       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 what is being sold
+      # 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] breakdown
+      # Breakdown of the line item for more detailed information. The sum of all lines will be used for the item price.
+      # @return [Array<SubLine>]
+      property :breakdown, [SubLine]
+
       # @!attribute [r] sum
       # Result of quantity multiplied by the item's price (calculated)
       # @return [GOBL::Num::Amount]
@@ -59,10 +84,20 @@ module GOBL
       # @return [GOBL::Num::Amount]
       property :total, GOBL::Num::Amount
 
+      # @!attribute [r] substituted
+      # List of substituted lines. Useful for deliveries or corrective documents in order to indicate to the recipient which of the requested lines are being replaced. This is for purely informative purposes, and will not be used for calculations.
+      # @return [Array<SubLine>]
+      property :substituted, [SubLine]
+
       # @!attribute [r] notes
       # Set of specific notes for this line that may be required for clarification.
-      # @return [Array<GOBL::CBC::Note>]
-      property :notes, [GOBL::CBC::Note]
+      # @return [Array<GOBL::Org::Note>]
+      property :notes, [GOBL::Org::Note]
+
+      # @!attribute [r] ext
+      # Extension codes that apply to the line
+      # @return [GOBL::Tax::Extensions]
+      property :ext, GOBL::Tax::Extensions
     end
   end
 end