gobl 0.21.0 → 0.23.0

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

@@ -12,6 +12,44 @@ module GOBL
       # The Schema ID of the GOBL Invoice structure
       SCHEMA_ID = 'https://gobl.org/draft-0/bill/invoice'
 
+      # 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]
@@ -22,33 +60,42 @@ module GOBL
         'standard' => 'A regular commercial invoice document between a supplier and customer.',
         'proforma' => 'For a clients validation before sending a final invoice.',
         'corrective' => 'Corrected invoice that completely *replaces* the preceding document.',
-        'credit-note' => 'Reflects a refund either partial or complete of the preceding document. A
+        'credit-note' => 'Reflects a refund either partial or complete of the preceding document. A 
       credit note effectively *extends* the previous document.',
-        'debit-note' => 'An additional set of charges to be added to the preceding document.'
+        'debit-note' => 'An additional set of charges to be added to the preceding document.',
+        'other' => 'Any other type of invoice that does not fit into the standard categories and implies
+      that any scenarios defined in tax regimes or addons will not be applied.
+
+      This is useful for being able to create invoices with custom types in extensions,
+      but is not recommend for general use.'
       }.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.
-      # @return [String]
-      property :series, String
+      # 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.
-      # @return [String]
-      property :code, String
-      validates_presence_of :code
+      # 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
 
       # @!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]
@@ -60,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
 
@@ -70,70 +117,65 @@ 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.
-      # @return [Array<Preceding>]
-      property :preceding, [Preceding]
+      # 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
 
       # @!attribute [r] customer
-      # Legal entity receiving the goods or services, may be empty in certain circumstances such as simplified invoices.
+      # 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] 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.
@@ -144,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

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

@@ -10,27 +10,72 @@ module GOBL
     # LineCharge represents an amount added to the line, and will be applied before taxes.
     class LineCharge < GOBL::Object
       # The Schema ID of the GOBL LineCharge structure
-      SCHEMA_ID = 'https://gobl.org/draft-0/bill/invoice#/$defs/LineCharge'
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/line#/$defs/LineCharge'
+
+      # 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 are for reference only and may be extended by the issuer.
+      # @return [GOBL::CBC::Key]
+      property :key, GOBL::CBC::Key
+
+      # @!attribute [r] code
+      # Reference or ID for this charge defined 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 :reason, String
+
+      # @!attribute [r] base
+      # Base for percent calculations instead of the line's sum
+      # @return [GOBL::Num::Amount]
+      property :base, GOBL::Num::Amount
 
       # @!attribute [r] percent
-      # Percentage if fixed amount not applied
+      # Percentage of base or parent line's sum
       # @return [GOBL::Num::Percentage]
       property :percent, GOBL::Num::Percentage
 
+      # @!attribute [r] quantity
+      # Quantity of units to apply the charge to when using the rate instead of the line's quantity.
+      # @return [GOBL::Num::Amount]
+      property :quantity, GOBL::Num::Amount
+
+      # @!attribute [r] unit
+      # Unit to associate with the quantity when using the rate.
+      # @return [GOBL::Org::Unit]
+      property :unit, GOBL::Org::Unit
+
+      # @!attribute [r] rate
+      # Rate defines a price per unit to use instead of the percentage.
+      # @return [GOBL::Num::Amount]
+      property :rate, GOBL::Num::Amount
+
       # @!attribute [r] amount
       # Fixed or resulting charge amount to apply (calculated if percent present).
       # @return [GOBL::Num::Amount]
       property :amount, GOBL::Num::Amount
 
-      # @!attribute [r] code
-      # Reference code.
-      # @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
     end
   end
 end

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

@@ -10,27 +10,60 @@ module GOBL
     # LineDiscount represents an amount deducted from the line, and will be applied before taxes.
     class LineDiscount < GOBL::Object
       # The Schema ID of the GOBL LineDiscount structure
-      SCHEMA_ID = 'https://gobl.org/draft-0/bill/invoice#/$defs/LineDiscount'
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/line#/$defs/LineDiscount'
 
-      # @!attribute [r] percent
-      # Percentage if fixed amount not applied
-      # @return [GOBL::Num::Percentage]
-      property :percent, GOBL::Num::Percentage
+      # 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] amount
-      # Fixed discount amount to apply (calculated if percent present).
-      # @return [GOBL::Num::Amount]
-      property :amount, GOBL::Num::Amount
+      # @!attribute [r] key
+      # Key for identifying the type of discount being applied.
+      # @return [GOBL::CBC::Key]
+      property :key, GOBL::CBC::Key
 
       # @!attribute [r] code
-      # Reason code.
-      # @return [String]
-      property :code, String
+      # Code or reference for this discount defined 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 :reason, String
+
+      # @!attribute [r] base
+      # Base for percent calculations instead of the line's sum.
+      # @return [GOBL::Num::Amount]
+      property :base, GOBL::Num::Amount
+
+      # @!attribute [r] percent
+      # Percentage to apply to the base or line sum to calculate the discount amount
+      # @return [GOBL::Num::Percentage]
+      property :percent, GOBL::Num::Percentage
+
+      # @!attribute [r] amount
+      # Fixed discount amount to apply (calculated if percent present)
+      # @return [GOBL::Num::Amount]
+      property :amount, GOBL::Num::Amount
+
+      # @!attribute [r] ext
+      # Extension codes that apply to the discount
+      # @return [GOBL::Tax::Extensions]
+      property :ext, GOBL::Tax::Extensions
     end
   end
 end

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

@@ -0,0 +1,208 @@
+# frozen_string_literal: true
+
+##
+## DO NOT EDIT - This file was generated automatically.
+##
+##
+
+module GOBL
+  module Bill
+    # Order documents are used for the initial part of a order-to-invoice process where the buyer requests goods or services from the seller.
+    class Order < GOBL::Object
+      # The Schema ID of the GOBL Order structure
+      SCHEMA_ID = 'https://gobl.org/draft-0/bill/order'
+
+      # 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 = {
+        'purchase' => 'A purchase order is a document that a buyer sends to a seller to request goods or services.',
+        'sale' => 'A sales order is a document that a seller sends to a buyer to confirm the sale of goods or services.',
+        'quote' => 'A quote is a document that a seller sends to a buyer to provide a price for goods or services.'
+      }.freeze
+
+      # @!attribute [r] type
+      # Type of the order.
+      # @return [GOBL::CBC::Key]
+      property :type, GOBL::CBC::Key
+      validates_inclusion_of :type, in: TYPE_ENUM.keys, allow_blank: true
+
+      # @!attribute [r] series
+      # Series is used to identify groups of orders 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 order. 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 invoice was created.
+      # @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 order 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]
+      property :op_date, GOBL::Cal::Date
+
+      # @!attribute [r] value_date
+      # When the taxes of this invoice 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 invoice 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] contracts
+      # The identification of contracts.
+      # @return [Array<GOBL::Org::DocumentRef>]
+      property :contracts, [GOBL::Org::DocumentRef]
+
+      # @!attribute [r] preceding
+      # Key information regarding previous order documents.
+      # @return [Array<GOBL::Org::DocumentRef>]
+      property :preceding, [GOBL::Org::DocumentRef]
+
+      # @!attribute [r] identities
+      # 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] period
+      # Period of time in which the order is valid.
+      # @return [GOBL::Cal::Period]
+      property :period, GOBL::Cal::Period
+
+      # @!attribute [r] tax
+      # Special tax configuration for billing.
+      # @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] 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] 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] charges
+      # Charges or surcharges applied to order totals
+      # @return [Array<GOBL::Bill::Charge>]
+      property :charges, [GOBL::Bill::Charge]
+
+      # @!attribute [r] payment
+      # Information on when, how, and to whom a final invoice would be paid.
+      # @return [GOBL::Bill::PaymentDetails]
+      property :payment, GOBL::Bill::PaymentDetails
+
+      # @!attribute [r] delivery
+      # Specific details on delivery of the goods to copy to the final invoice.
+      # @return [GOBL::Bill::DeliveryDetails]
+      property :delivery, GOBL::Bill::DeliveryDetails
+
+      # @!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 order, 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 order.
+      # @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 order.
+      # @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