gobl 0.23.0 → 0.24.1

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

@@ -26,12 +26,15 @@ module GOBL
         'ES' => 'Spain',
         'FR' => 'France',
         'GB' => 'United Kingdom',
+        'IE' => 'Ireland',
         'IN' => 'India',
         'IT' => 'Italy',
         'MX' => 'Mexico',
         'NL' => 'The Netherlands',
         'PL' => 'Poland',
         'PT' => 'Portugal',
+        'SE' => 'Sweden',
+        'SG' => 'Singapore',
         'US' => 'United States of America'
       }.freeze
 
@@ -46,7 +49,7 @@ module GOBL
       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.
+      # Tags are used to help identify specific tax scenarios or requirements that may apply changes to the contents of the document or imply a specific meaning. Converters may use tags to help identify specific situations that do not have a specific extension, for example; self-billed or partial invoices may be identified by their respective tags.
       # @return [Array<GOBL::CBC::Key>]
       property :$tags, [GOBL::CBC::Key]
 

data/lib/generated/gobl/org/attachment.rb

@@ -52,11 +52,6 @@ module GOBL
       # MIME type of the attachment.
       # @return [String]
       property :mime, String
-
-      # @!attribute [r] data
-      # Data is the base64 encoded data of the attachment directly embedded inside the GOBL document. This should only be used when the URL cannot be used as it can dramatically increase the size of the JSON document, thus effecting usability and performance.
-      # @return [String]
-      property :data, String
     end
   end
 end

data/lib/generated/gobl/org/document_ref.rb

@@ -17,8 +17,13 @@ module GOBL
       # @return [String]
       property :uuid, String
 
+      # @!attribute [r] schema
+      # Schema of the referenced document if different from that of the parent.
+      # @return [String]
+      property :schema, String
+
       # @!attribute [r] type
-      # Type of the document referenced.
+      # Type of the document referenced according to the defined schema or that of the parent document.
       # @return [GOBL::CBC::Key]
       property :type, GOBL::CBC::Key
 

data/lib/generated/gobl/org/item.rb

@@ -43,6 +43,11 @@ module GOBL
       # @return [String]
       property :description, String
 
+      # @!attribute [r] images
+      # Images associated with the item.
+      # @return [Array<GOBL::Org::Image>]
+      property :images, [GOBL::Org::Image]
+
       # @!attribute [r] currency
       # Currency used for the item's price.
       # @return [GOBL::Currency::Code]

data/lib/generated/gobl/org/person.rb

@@ -22,17 +22,32 @@ module GOBL
       # @return [String]
       property :label, String
 
+      # @!attribute [r] key
+      # Key used to identify the role of the person inside the context of the object.
+      # @return [GOBL::CBC::Key]
+      property :key, GOBL::CBC::Key
+
       # @!attribute [r] name
-      # Complete details on the name of the person
+      # Complete details on the name of the person.
       # @return [GOBL::Org::Name]
       property :name, GOBL::Org::Name
       validates_presence_of :name
 
       # @!attribute [r] role
-      # What they do within an organization
+      # Role or job title of the responsibilities of the person within an organization.
       # @return [String]
       property :role, String
 
+      # @!attribute [r] identities
+      # Set of codes used to identify the person, such as ID numbers, social security, driving licenses, etc. that can be attributed to the individual.
+      # @return [Array<GOBL::Org::Identity>]
+      property :identities, [GOBL::Org::Identity]
+
+      # @!attribute [r] addresses
+      # Regular post addresses for where information should be sent if needed.
+      # @return [Array<GOBL::Org::Address>]
+      property :addresses, [GOBL::Org::Address]
+
       # @!attribute [r] emails
       # Electronic mail addresses that belong to the person.
       # @return [Array<GOBL::Org::Email>]

data/lib/generated/gobl/org/unit.rb

@@ -21,11 +21,20 @@ module GOBL
         't' => 'Metric tons',
         'mm' => 'Milimetres',
         'cm' => 'Centimetres',
+        'dm' => 'A unit of length equal to one-tenth of a metre.',
         'm' => 'Metres',
         'km' => 'Kilometers',
         'in' => 'Inches',
         'ft' => 'Feet',
+        'mm2' => 'Square millimetres',
+        'cm2' => 'Square centimetres',
+        'dm2' => 'Square decimetres',
         'm2' => 'Square metres',
+        'ac' => 'A unit of area equal to 43,560 square feet.',
+        'ha' => 'A unit of area equal to 10,000 square metres.',
+        'mm3' => 'Cubic millimetres',
+        'cm3' => 'Cubic centimetres',
+        'dm3' => 'Cubic decimetres',
         'm3' => 'Cubic metres',
         'ml' => 'Millilitres',
         'cl' => 'Centilitres',

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

@@ -39,8 +39,18 @@ module GOBL
       # @return [Boolean]
       property :retained, Boolean
 
+      # @!attribute [r] informative
+      # Informative when true implies that the tax amount will be calculated and reported but will not affect the invoice totals. Typically used for taxes that are embedded in the base amount or don't impact the final payable amount.
+      # @return [Boolean]
+      property :informative, Boolean
+
+      # @!attribute [r] keys
+      # Specific tax definitions inside this category.
+      # @return [Array<KeyDef>]
+      property :keys, [KeyDef]
+
       # @!attribute [r] rates
-      # Specific tax definitions inside this category. Order is important.
+      # Rates defines the set of rates that can be used with this category.
       # @return [Array<RateDef>]
       property :rates, [RateDef]
 

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

@@ -21,6 +21,10 @@ module GOBL
       # @return [Boolean]
       property :retained, Boolean
 
+      # @!attribute [r] informative
+      # @return [Boolean]
+      property :informative, Boolean
+
       # @!attribute [r] rates
       # @return [Array<RateTotal>]
       property :rates, [RateTotal]

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

@@ -23,18 +23,23 @@ module GOBL
       # @return [GOBL::L10n::TaxCountryCode]
       property :country, GOBL::L10n::TaxCountryCode
 
+      # @!attribute [r] key
+      # Key helps determine the tax situation within the category.
+      # @return [GOBL::CBC::Key]
+      property :key, GOBL::CBC::Key
+
       # @!attribute [r] rate
-      # Rate within a category to apply.
+      # Rate within a category and for a given key to apply.
       # @return [GOBL::CBC::Key]
       property :rate, GOBL::CBC::Key
 
       # @!attribute [r] percent
-      # Percent defines the percentage set manually or determined from the rate key (calculated if rate present). A nil percent implies that this tax combo is **exempt** from tax.
+      # Percent defines the percentage set manually or determined from the key. A nil percent implies that this tax combo is either exempt or not-subject.
       # @return [GOBL::Num::Percentage]
       property :percent, GOBL::Num::Percentage
 
       # @!attribute [r] surcharge
-      # Some countries require an additional surcharge (calculated if rate present).
+      # Some countries require an additional surcharge (may be determined if key present).
       # @return [GOBL::Num::Percentage]
       property :surcharge, GOBL::Num::Percentage
 

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

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+##
+## DO NOT EDIT - This file was generated automatically.
+##
+##
+
+module GOBL
+  module Tax
+    # KeyDef defines a key that can be used inside a tax category.
+    class KeyDef < GOBL::Object
+      # The Schema ID of the GOBL KeyDef structure
+      SCHEMA_ID = 'https://gobl.org/draft-0/tax/regime-def#/$defs/KeyDef'
+
+      # @!attribute [r] key
+      # Key identifies this rate within the system
+      # @return [GOBL::CBC::Key]
+      property :key, GOBL::CBC::Key
+
+      # @!attribute [r] name
+      # Human name of the rate set
+      # @return [GOBL::I18n::String]
+      property :name, GOBL::I18n::String
+
+      # @!attribute [r] desc
+      # Useful description of the rate.
+      # @return [GOBL::I18n::String]
+      property :desc, GOBL::I18n::String
+
+      # @!attribute [r] no_percent
+      # NoPercent when true implies that the rate when used in a tax Combo should not define a percent value.
+      # @return [Boolean]
+      property :no_percent, Boolean
+    end
+  end
+end

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

@@ -12,11 +12,16 @@ module GOBL
       # The Schema ID of the GOBL RateDef structure
       SCHEMA_ID = 'https://gobl.org/draft-0/tax/regime-def#/$defs/RateDef'
 
-      # @!attribute [r] key
-      # Key identifies this rate within the system
+      # @!attribute [r] rate
+      # Rate defines the key for which this rate applies.
       # @return [GOBL::CBC::Key]
-      property :key, GOBL::CBC::Key
-      validates_presence_of :key
+      property :rate, GOBL::CBC::Key
+      validates_presence_of :rate
+
+      # @!attribute [r] keys
+      # Keys identifies the set of tax keys defined in the category that this rate can be used with.
+      # @return [Array<GOBL::CBC::Key>]
+      property :keys, [GOBL::CBC::Key]
 
       # @!attribute [r] name
       # Human name of the rate
@@ -29,21 +34,11 @@ module GOBL
       # @return [GOBL::I18n::String]
       property :desc, GOBL::I18n::String
 
-      # @!attribute [r] exempt
-      # Exempt when true implies that the rate when used in a tax Combo should not define a percent value.
-      # @return [Boolean]
-      property :exempt, Boolean
-
       # @!attribute [r] values
       # Values contains a list of Value objects that contain the current and historical percentage values for the rate and additional filters. Order is important, newer values should come before older values.
       # @return [Array<RateValueDef>]
       property :values, [RateValueDef]
 
-      # @!attribute [r] ext
-      # Extensions key-value pair that will be copied to the tax combo if this rate is used.
-      # @return [GOBL::Tax::Extensions]
-      property :ext, GOBL::Tax::Extensions
-
       # @!attribute [r] meta
       # Meta contains additional information about the rate that is relevant for local frequently used implementations.
       # @return [GOBL::CBC::Meta]

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

@@ -12,16 +12,16 @@ module GOBL
       # The Schema ID of the GOBL RateTotal structure
       SCHEMA_ID = 'https://gobl.org/draft-0/tax/total#/$defs/RateTotal'
 
-      # @!attribute [r] key
-      # Optional rate key is required when grouping.
-      # @return [GOBL::CBC::Key]
-      property :key, GOBL::CBC::Key
-
       # @!attribute [r] country
       # Country code override when issuing with taxes applied from different countries, it'd be very strange to mix rates from different countries, but in theory this would be possible.
       # @return [GOBL::L10n::TaxCountryCode]
       property :country, GOBL::L10n::TaxCountryCode
 
+      # @!attribute [r] key
+      # Tax key if supported by the category.
+      # @return [GOBL::CBC::Key]
+      property :key, GOBL::CBC::Key
+
       # @!attribute [r] ext
       # If the rate is defined with extensions, they'll be used to group by also.
       # @return [GOBL::Tax::Extensions]

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

@@ -12,13 +12,8 @@ module GOBL
       # The Schema ID of the GOBL RateValueDef structure
       SCHEMA_ID = 'https://gobl.org/draft-0/tax/regime-def#/$defs/RateValueDef'
 
-      # @!attribute [r] tags
-      # Only apply this rate if one of the tags is present in the invoice.
-      # @return [Array<GOBL::CBC::Key>]
-      property :tags, [GOBL::CBC::Key]
-
       # @!attribute [r] ext
-      # Ext map of keys that can be used to filter to determine if the rate applies.
+      # Only apply this rate if one of the tags is present in the invoice. Tags []cbc.Key `json:"tags,omitempty" jsonschema:"title=Tags"` Ext map of keys that can be used to filter to determine if the rate applies.
       # @return [GOBL::Tax::Extensions]
       property :ext, GOBL::Tax::Extensions
 

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

@@ -17,6 +17,11 @@ module GOBL
       # @return [GOBL::I18n::String]
       property :name, GOBL::I18n::String
 
+      # @!attribute [r] desc
+      # Description of the scenario for documentation purposes.
+      # @return [GOBL::I18n::String]
+      property :desc, GOBL::I18n::String
+
       # @!attribute [r] type
       # Type of document, if present.
       # @return [Array<GOBL::CBC::Key>]

data/lib/gobl/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GOBL
-  VERSION = '0.23.0'
+  VERSION = '0.24.1'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gobl
 version: !ruby/object:Gem::Version
-  version: 0.23.0
+  version: 0.24.1
 platform: ruby
 authors:
 - Luismi Cavalle
@@ -11,7 +11,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-06-25 00:00:00.000000000 Z
+date: 2025-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -75,12 +75,15 @@ files:
 - data/regimes/fr.json
 - data/regimes/gb.json
 - data/regimes/gr.json
+- data/regimes/ie.json
 - data/regimes/in.json
 - data/regimes/it.json
 - data/regimes/mx.json
 - data/regimes/nl.json
 - data/regimes/pl.json
 - data/regimes/pt.json
+- data/regimes/se.json
+- data/regimes/sg.json
 - data/regimes/us.json
 - lib/generated/gobl/bill/charge.rb
 - lib/generated/gobl/bill/correction_options.rb
@@ -166,6 +169,7 @@ files:
 - lib/generated/gobl/tax/correction_set.rb
 - lib/generated/gobl/tax/extensions.rb
 - lib/generated/gobl/tax/identity.rb
+- lib/generated/gobl/tax/key_def.rb
 - lib/generated/gobl/tax/rate_def.rb
 - lib/generated/gobl/tax/rate_total.rb
 - lib/generated/gobl/tax/rate_total_surcharge.rb