fortnox-api 1.0.0.rc11 → 1.0.0.rc13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7616a9760dec5aa02b7295ec094013aaffe962f98c402f613636a039f3d1891c
-  data.tar.gz: 6d8665d732a8f5125ad02991d2f9daf6277cef5cb9e9ce7123da32680f60a9f3
+  metadata.gz: 695db94ae3937bdcc80a1737e65b730cc58dd6784b79eedf6296490b716ab31a
+  data.tar.gz: 3a25be836c8d7251578d71b40364c122673176c89b878a7a8ed21d68c0eb2377
 SHA512:
-  metadata.gz: 734e2f06e8e55583e789b9830092bcf6d53ee0d3b8511693cac15edab25a3658fd126d91ba18bcc8ebe33b823659a20494b16389c02adff0799b3faf8cf7a9bd
-  data.tar.gz: bf07508b1a70cbfabbba0fc9611866f2a87c3cb8fff564acfc9dbae3fca66d70fafbc2a1b8e1f5e594950800bb850fb5f592fdd38e4a61233d2f6568b8276411
+  metadata.gz: c8fb345adff538fbb9e0d1db6c0d653bebbfa35014ecb0b78e7ee5940c9f8f6f77eab563a2378f2d0827822a44a56fe0bf0fffc06e4c961e84850ae07b83adf9
+  data.tar.gz: '05914af9563412c342711d69418462bbd47335ea09aa46d13bf581906fd80a81fea2d1b997dc5a27f61c98b54f705637f502c4b44c3d66fcc78aea8c0368dd5c'

data/CHANGELOG.md

@@ -8,6 +8,68 @@ and this project adheres to
 
 ## [Unreleased]
 
+## [1.0.0.rc13] - 2026-08-04
+
+### Changed
+
+- String attributes now normalise `''` to `nil` at the type level. This
+  is the mechanism behind the reset fix below: Fortnox silently ignores
+  empty strings in update payloads — updating an attribute to `''` kept
+  the original value — and a field can only be cleared with an explicit
+  `null`. Normalising in the type also changes the read side: unset
+  string attributes read as `nil` in the model, never `''`. Fortnox
+  spells "unset" as `""` or `null` depending on endpoint and record
+  history, so the model value was previously unpredictable. Consumers
+  comparing against `''` must switch to `nil` checks (or call `.to_s`
+  if they prefer empty strings). On create, an attribute set to `''`
+  is now omitted from the POST body entirely (new records strip
+  `nil`s), leaving the field to Fortnox's default — previously `""`
+  was sent, which Fortnox ignores, with the same end result.
+  Enum-typed attributes whose value set
+  includes `''` (`payment_way`, `accounting_method`, `invoice_type`,
+  `tax_reduction_type`, `delivery_state`) are exempt: there `''` is a
+  real Fortnox value, not an unset spelling. For required string attributes
+  (`Customer#name`, `Article#description`, `Unit#code`/`#description`,
+  `TermsOfPayment#code`) this means updating to `''` now raises
+  `Fortnox::MissingAttributeError` before any request is made —
+  previously the empty string was sent and silently ignored by Fortnox
+  (clearing a required field is invalid: Fortnox rejects `null` for
+  them with a 400 and ignores `""`).
+
+### Fixed
+
+- Resetting a string attribute to `''` on update now clears the value in
+  Fortnox. Previously the empty string was silently ignored by Fortnox
+  and the old value was left intact (reported for `Customer#comments`).
+  Since `''` now coerces to `nil` (see above), both `update(attr: '')`
+  and `update(attr: nil)` reach Fortnox as `null`, which clears. This
+  includes the country attributes on documents (`country_code`,
+  `delivery_country`), whose mapper previously turned `nil` back into
+  `""` on the wire, so countries could never be cleared at all.
+- Numeric attributes no longer raise `Fortnox::ConstraintError` when
+  Fortnox returns `""` for an unset value — blank coerces to `nil`,
+  extending the 1.0.0.rc10 `Types::AccountNumber` fix to all integer
+  and float attributes (e.g. `Customer#invoice_discount`,
+  `Invoice#balance`). Like that bug, this was introduced in 1.0.0.rc1
+  and did not exist in 0.x, which coerced `""` to `0`/`0.0`.
+- `#update`, `#serialise` (and `#to_api`, which goes through it) and
+  `.new` now raise Fortnox-namespaced errors. A coercion failure like
+  `customer.update(email: 'not-an-email')` previously leaked
+  `RestEasy::ConstraintError`, which `rescue Fortnox::ConstraintError`
+  blocks don't catch — error translation only covered `save`, `parse`,
+  `find`, `stub` and the other class-level paths.
+
+## [1.0.0.rc12] - 2026-06-26
+
+### Fixed
+
+- `Fortnox::Customer` no longer sends `OrganisationNumber` when updating a
+  customer that has an active e-fakturakoppling
+  (`default_delivery_types.invoice == ELECTRONICINVOICE`). Fortnox rejects edits
+  to the org/personal number for such customers, and field-level dirty tracking
+  meant an unchanged `OrganisationNumber` was always included on update,
+  blocking every other update to those customers.
+
 ## [1.0.0.rc11] - 2026-06-26
 
 ### Changed
@@ -270,7 +332,9 @@ for the full list of breaking changes.
 For changes prior to the 1.0 rewrite, see the
 [0.x changelog](https://github.com/accodeing/fortnox-api/blob/v0.9.2/CHANGELOG.md).
 
-[Unreleased]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc11...HEAD
+[Unreleased]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc13...HEAD
+[1.0.0.rc13]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc12...v1.0.0.rc13
+[1.0.0.rc12]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc11...v1.0.0.rc12
 [1.0.0.rc11]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc10...v1.0.0.rc11
 [1.0.0.rc10]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc9...v1.0.0.rc10
 [1.0.0.rc9]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc8...v1.0.0.rc9

data/lib/fortnox/mappers/country_code.rb

@@ -7,8 +7,11 @@ module Fortnox
     module CountryCode
       ISO3166.configure { |config| config.locales = [:en, :sv] }
 
+      # Blank maps to nil in both directions, mirroring the string types:
+      # Fortnox spells "unset" country as "" on reads, and on updates only
+      # an explicit null clears the field — "" is silently ignored.
       def self.parse(country)
-        return '' if country.nil? || country == ''
+        return nil if country.nil? || country == ''
 
         # Fortnox only supports Swedish translation of Sweden
         return 'SE' if country =~ /^s(e$|we|ve)/i
@@ -23,7 +26,7 @@ module Fortnox
       end
 
       def self.serialise(country_code)
-        return '' if country_code.nil? || country_code == ''
+        return nil if country_code.nil? || country_code == ''
 
         return 'Sverige' if country_code == 'SE'
 

data/lib/fortnox/resource.rb

@@ -24,24 +24,29 @@ module Fortnox
       end
     end
 
-    after_serialise do |data|
-      if meta.new?
-        # Strip nils for new records — rely on Fortnox defaults
-        data = data.compact
-      elsif __changes__.any?
-        # Send only the attributes passed to .update — field-level dirty
-        # tracking, not a value diff, so an attribute equal to its stored
-        # value is still sent, and an explicit nil reaches Fortnox as a clear.
-        changed_api_names = __changes__.keys.filter_map do |model_name|
-          self.class.all_attribute_definitions[model_name]&.api_name
-        end
-        data = data.slice(*changed_api_names)
-      end
+    after_serialise { |data| default_after_serialise(data) }
 
-      # TODO: rest-easy should do this wrapping for us.
-      { config.instance_wrapper => data }
+    # Translate rest-easy errors at the gem boundary so callers only see
+    # Fortnox-namespaced exceptions.
+    module ErrorTranslation
+      private
+
+      def with_translated_errors
+        yield
+      rescue RestEasy::ConstraintError => e
+        raise Fortnox::ConstraintError.new(e.attribute_name, e.value, e.message)
+      rescue RestEasy::MissingAttributeError => e
+        raise Fortnox::MissingAttributeError, e.attribute_name
+      rescue RestEasy::AttributeError => e
+        raise Fortnox::AttributeError, e.message
+      rescue RestEasy::RequestError => e
+        raise Fortnox::RequestError, e.response || e.message
+      end
     end
 
+    include ErrorTranslation # instance-level methods
+    extend ErrorTranslation # class-level methods
+
     class << self
       attr_reader :registered_resources
 
@@ -58,6 +63,10 @@ module Fortnox
         end
       end
 
+      def new(...)
+        with_translated_errors { super }
+      end
+
       def stub(**model_data)
         with_translated_errors { super }
       end
@@ -110,20 +119,6 @@ module Fortnox
 
       private
 
-      # Translate rest-easy errors at the gem boundary so callers only see
-      # Fortnox-namespaced exceptions.
-      def with_translated_errors
-        yield
-      rescue RestEasy::ConstraintError => e
-        raise Fortnox::ConstraintError.new(e.attribute_name, e.value, e.message)
-      rescue RestEasy::MissingAttributeError => e
-        raise Fortnox::MissingAttributeError, e.attribute_name
-      rescue RestEasy::AttributeError => e
-        raise Fortnox::AttributeError, e.message
-      rescue RestEasy::RequestError => e
-        raise Fortnox::RequestError, e.response || e.message
-      end
-
       def extract_pagination(data)
         return {} unless data.is_a?(Hash) && data.key?('MetaInformation')
 
@@ -135,5 +130,33 @@ module Fortnox
         }
       end
     end
+
+    def update(...)
+      with_translated_errors { super }
+    end
+
+    def serialise(...)
+      with_translated_errors { super }
+    end
+
+    private
+
+    # Shared serialisation tail used by the base after_serialise hook. Exposed
+    # as an instance method so subclass hooks can post-process the payload (e.g.
+    # drop a field) and still reuse it — rest-easy hooks override, not chain.
+    def default_after_serialise(data)
+      if meta.new?
+        # Strip nils for new records — rely on Fortnox defaults
+        data = data.compact
+      elsif __changes__.any?
+        # Send only the attributes passed to .update — field-level dirty
+        # tracking, not a value diff, so an attribute equal to its stored
+        # value is still sent, and an explicit nil reaches Fortnox as a clear.
+        data = data.slice(*__changes__.keys.filter_map { |name| self.class.all_attribute_definitions[name]&.api_name })
+      end
+
+      # TODO: rest-easy should do this wrapping for us.
+      { config.instance_wrapper => data }
+    end
   end
 end

data/lib/fortnox/resources/article.rb

@@ -12,7 +12,7 @@ module Fortnox
     end
 
     # @url Direct URL to the record.
-    attr :url <=> '@url', Coercible::String.optional, :read_only
+    attr :url <=> '@url', UnsizedString, :read_only
 
     # True If the article is active
     attr :active, Bool.optional, Boolean
@@ -34,7 +34,7 @@ module Fortnox
     attr :description, Sized::String[200], :required
 
     # DisposableQuantity Disposable quantity of the article.
-    attr :disposable_quantity, Coercible::Float.optional, :read_only
+    attr :disposable_quantity, UnsizedFloat, :read_only
 
     # EAN EAN bar code
     attr :ean <=> 'EAN', Sized::String[30]
@@ -80,14 +80,14 @@ module Fortnox
     attr :quantity_in_stock, Sized::Float[-100_000_000_000_000.0, 99_999_999_999_999.9]
 
     # ReservedQuantity Reserved quantity of the article
-    attr :reserved_quantity, Coercible::Float.optional, :read_only
+    attr :reserved_quantity, UnsizedFloat, :read_only
 
     # SalesAccount Account number for the sales account in Sweden.
     # The number must be of an existing account.
     attr :sales_account, Types::AccountNumber
 
     # SalesPrice Price of article for its default price list
-    attr :sales_price, Coercible::Float.optional, :read_only
+    attr :sales_price, UnsizedFloat, :read_only
 
     # StockGoods If the article is stock goods
     attr :stock_goods, Bool.optional, Boolean
@@ -96,27 +96,27 @@ module Fortnox
     attr :stock_place, Sized::String[100]
 
     # StockValue Value in stock of the article
-    attr :stock_value, Coercible::Float.optional, :read_only
+    attr :stock_value, UnsizedFloat, :read_only
 
     # StockWarning When to start warning for low quantity in stock
     attr :stock_warning, Sized::Float[0.0, 99_999_999_999_999.9]
 
     # SupplierName Name of the supplier
-    attr :supplier_name, Coercible::String.optional, :read_only
+    attr :supplier_name, UnsizedString, :read_only
 
     # SupplierNumber Supplier number for the article.
     # The number must be of an existing supplier.
-    attr :supplier_number, Coercible::String.optional
+    attr :supplier_number, UnsizedString
 
     # Type The type of the article
     attr :type, ArticleTypes
 
     # Unit Unit code for the article.
     # The code must be of an existing unit.
-    attr :unit, Coercible::String.optional
+    attr :unit, UnsizedString
 
     # VAT VAT percent, this is predefined by the VAT for the sales account
-    attr :vat <=> 'VAT', Coercible::Float.optional
+    attr :vat <=> 'VAT', UnsizedFloat
 
     # WebshopArticle If the article is a webshop article
     attr :webshop_article, Bool.optional, Boolean
@@ -131,7 +131,7 @@ module Fortnox
     attr :expired, Bool.optional, Boolean
 
     # CostCalculationMethod Cost calculation method used for the article.
-    attr :cost_calculation_method, Coercible::String.optional
+    attr :cost_calculation_method, UnsizedString
 
     # StockAccount Account number for stock.
     attr :stock_account, Types::AccountNumber
@@ -140,21 +140,21 @@ module Fortnox
     attr :stock_change_account, Types::AccountNumber
 
     # DirectCost Direct cost of the article.
-    attr :direct_cost, Coercible::Float.optional
+    attr :direct_cost, UnsizedFloat
 
     # FreightCost Freight cost of the article.
-    attr :freight_cost, Coercible::Float.optional
+    attr :freight_cost, UnsizedFloat
 
     # OtherCost Other cost of the article.
-    attr :other_cost, Coercible::Float.optional
+    attr :other_cost, UnsizedFloat
 
     # DefaultStockPoint Default stock point for the article.
-    attr :default_stock_point, Coercible::String.optional
+    attr :default_stock_point, UnsizedString
 
     # DefaultStockLocation Default stock location for the article.
-    attr :default_stock_location, Coercible::String.optional
+    attr :default_stock_location, UnsizedString
 
     # CommodityCode Commodity code of the article.
-    attr :commodity_code, Coercible::String.optional, :read_only
+    attr :commodity_code, UnsizedString, :read_only
   end
 end

data/lib/fortnox/resources/customer.rb

@@ -15,8 +15,17 @@ module Fortnox
       validate_electronic_invoice_delivery_type!(default_delivery_types&.invoice)
     end
 
+    # Fortnox refuses to edit OrganisationNumber once a customer has an active
+    # e-fakturakoppling. Drop it from the update payload in that case so the rest
+    # of the customer can still be updated. Field-level dirty tracking means an
+    # unchanged OrganisationNumber would otherwise always be sent on update.
+    after_serialise do |data|
+      data = data.except(organisation_number_api_name) if drop_organisation_number?
+      default_after_serialise(data)
+    end
+
     # Direct URL to the record.
-    attr :url <=> '@url', Coercible::String.optional, :read_only
+    attr :url <=> '@url', UnsizedString, :read_only
 
     # First address of the customer
     attr :address1, Sized::String[1024]
@@ -28,7 +37,7 @@ module Fortnox
     attr :city, Sized::String[1024]
 
     # Country of the customer
-    attr :country, Coercible::String.optional, :read_only
+    attr :country, UnsizedString, :read_only
 
     # Comments
     attr :comments, Sized::String[1024]
@@ -37,7 +46,7 @@ module Fortnox
     attr :currency, Currencies
 
     # Cost center of the customer
-    attr :cost_center, Coercible::String.optional
+    attr :cost_center, UnsizedString
 
     # Country code of the customer
     attr :country_code, Sized::String[2]
@@ -61,7 +70,7 @@ module Fortnox
     attr :delivery_city, Sized::String[1024]
 
     # Delivery country of the customer
-    attr :delivery_country, Coercible::String.optional, :read_only
+    attr :delivery_country, UnsizedString, :read_only
 
     # Delivery country code of the customer
     attr :delivery_country_code, Sized::String[2]
@@ -136,7 +145,7 @@ module Fortnox
     attr :our_reference, Sized::String[50]
 
     # Phone number of the customer. Only present in collection responses.
-    attr :phone, Coercible::String.optional, :read_only
+    attr :phone, UnsizedString, :read_only
 
     # First phone number of the customer
     attr :phone1, Sized::String[1024]
@@ -145,10 +154,10 @@ module Fortnox
     attr :phone2, Sized::String[1024]
 
     # Price list of the customer
-    attr :price_list, Coercible::String.optional
+    attr :price_list, UnsizedString
 
     # Project of the customer
-    attr :project, Coercible::String.optional
+    attr :project, UnsizedString
 
     # Sales account of the customer
     attr :sales_account, Types::AccountNumber
@@ -157,16 +166,16 @@ module Fortnox
     attr :show_price_vat_included <=> 'ShowPriceVATIncluded', Bool.optional, Boolean
 
     # Terms of delivery code
-    attr :terms_of_delivery, Coercible::String.optional
+    attr :terms_of_delivery, UnsizedString
 
     # Terms of payment code
-    attr :terms_of_payment, Coercible::String.optional
+    attr :terms_of_payment, UnsizedString
 
     # Customer type
     attr :type, CustomerTypes
 
     # VAT number of the customer
-    attr :vat_number <=> 'VATNumber', Coercible::String.optional
+    attr :vat_number <=> 'VATNumber', UnsizedString
 
     # VAT type of the customer
     attr :vat_type <=> 'VATType', VATTypes
@@ -178,7 +187,7 @@ module Fortnox
     attr :visiting_city, Sized::String[128]
 
     # Visit country of the customer
-    attr :visiting_country, Coercible::String.optional, :read_only
+    attr :visiting_country, UnsizedString, :read_only
 
     # Visiting country code
     attr :visiting_country_code, Sized::String[2]
@@ -187,7 +196,7 @@ module Fortnox
     attr :visiting_zip_code, Sized::String[10]
 
     # Way of delivery code
-    attr :way_of_delivery, Coercible::String.optional
+    attr :way_of_delivery, UnsizedString
 
     # Your reference
     attr :your_reference, Sized::String[50]
@@ -212,6 +221,14 @@ module Fortnox
 
     private
 
+    def drop_organisation_number? = !meta.new? && electronic_invoice_active?
+
+    def electronic_invoice_active?
+      default_delivery_types&.invoice == DefaultInvoiceDeliveryTypeValues['ELECTRONICINVOICE']
+    end
+
+    def organisation_number_api_name = self.class.all_attribute_definitions[:organisation_number].api_name
+
     # ELECTRONICINVOICE is only possible to set in the Fortnox UI.
     # Raise if a consumer tries to set it from this gem.
     def validate_electronic_invoice_delivery_type!(type)

data/lib/fortnox/resources/document.rb

@@ -8,16 +8,16 @@ module Fortnox
     using RestEasy::Refinements
 
     # Url Direct url to the record.
-    attr :url <=> '@url', Coercible::String.optional, :read_only
+    attr :url <=> '@url', UnsizedString, :read_only
 
     # @urlTaxReductionList Direct URL to the tax reduction list.
-    attr :tax_reduction_list_url <=> '@urlTaxReductionList', Coercible::String.optional, :read_only
+    attr :tax_reduction_list_url <=> '@urlTaxReductionList', UnsizedString, :read_only
 
     # AdministrationFee The document administration fee.
-    attr :administration_fee, Coercible::Float.optional
+    attr :administration_fee, UnsizedFloat
 
     # AdministrationFeeVAT VAT of the document administration fee.
-    attr :administration_fee_vat <=> 'AdministrationFeeVAT', Coercible::Float.optional, :read_only
+    attr :administration_fee_vat <=> 'AdministrationFeeVAT', UnsizedFloat, :read_only
 
     # Address1 Document address 1.
     attr :address1, Sized::String[1024]
@@ -26,7 +26,7 @@ module Fortnox
     attr :address2, Sized::String[1024]
 
     # BasisTaxReduction Basis of tax reduction.
-    attr :basis_tax_reduction, Coercible::Float.optional, :read_only
+    attr :basis_tax_reduction, UnsizedFloat, :read_only
 
     # Cancelled If the document is cancelled.
     attr :cancelled, Bool.optional, :read_only, Boolean
@@ -38,25 +38,25 @@ module Fortnox
     attr :comments, Sized::String[1024]
 
     # ContributionPercent Document contribution in percent.
-    attr :contribution_percent, Coercible::Float.optional, :read_only
+    attr :contribution_percent, UnsizedFloat, :read_only
 
     # ContributionValue Document contribution in amount.
-    attr :contribution_value, Coercible::Float.optional, :read_only
+    attr :contribution_value, UnsizedFloat, :read_only
 
     # Country Country for the document address.
     attr :country_code <=> 'Country', Sized::String[2], Mappers::CountryCode
 
     # CostCenter Code of the cost center.
-    attr :cost_center, Coercible::String.optional
+    attr :cost_center, UnsizedString
 
     # Currency Code of the currency.
     attr :currency, Currencies
 
     # CurrencyRate Currency rate used for the document
-    attr :currency_rate, Coercible::Float.optional
+    attr :currency_rate, UnsizedFloat
 
     # CurrencyUnit Currency unit used for the document
-    attr :currency_unit, Coercible::Float.optional
+    attr :currency_unit, UnsizedFloat
 
     # CustomerName Name of the customer
     attr :customer_name, Sized::String[1024]
@@ -86,7 +86,7 @@ module Fortnox
     attr :delivery_zip_code, Sized::String[1024]
 
     # DocumentNumber The document number.
-    key :document_number, Coercible::Integer.optional
+    key :document_number, UnsizedInteger
 
     # EmailInformation Separate EmailInformation object
     attr :email_information, Structs::EmailInformation, Mappers::EmailInformation
@@ -101,10 +101,10 @@ module Fortnox
     attr :freight, Sized::Float[0.0, 99_999_999_999.9]
 
     # FreightVAT VAT of the freight cost.
-    attr :freight_vat <=> 'FreightVAT', Coercible::Float.optional, :read_only
+    attr :freight_vat <=> 'FreightVAT', UnsizedFloat, :read_only
 
     # Gross Gross value of the document
-    attr :gross, Coercible::Float.optional, :read_only
+    attr :gross, UnsizedFloat, :read_only
 
     # HouseWork If there is any row of the document marked "housework".
     attr :housework <=> 'HouseWork', Bool.optional, :read_only, Boolean
@@ -113,16 +113,16 @@ module Fortnox
     attr :labels, Strict::Array.of(Types.Instance(Label)), Mappers::LabelReferences
 
     # Net Net amount
-    attr :net, Coercible::Float.optional, :read_only
+    attr :net, UnsizedFloat, :read_only
 
     # NotCompleted If the document is set as not completed.
     attr :not_completed, Bool.optional, Boolean
 
     # OfferReference Reference to the offer, if one exists.
-    attr :offer_reference, Coercible::Integer.optional, :read_only
+    attr :offer_reference, UnsizedInteger, :read_only
 
     # OrganisationNumber Organisation number of the customer for the document.
-    attr :organisation_number, Coercible::String.optional, :read_only
+    attr :organisation_number, UnsizedString, :read_only
 
     # OurReference Our reference
     attr :our_reference, Sized::String[50]
@@ -134,46 +134,46 @@ module Fortnox
     attr :phone2, Sized::String[1024]
 
     # PriceList Code of the price list.
-    attr :price_list, Coercible::String.optional
+    attr :price_list, UnsizedString
 
     # PrintTemplate Print template of the document.
-    attr :print_template, Coercible::String.optional
+    attr :print_template, UnsizedString
 
     # Project Code of the project.
-    attr :project, Coercible::String.optional
+    attr :project, UnsizedString
 
     # Remarks Remarks of the document
     attr :remarks, Sized::String[1024]
 
     # RoundOff Round off amount for the document.
-    attr :round_off, Coercible::Float.optional, :read_only
+    attr :round_off, UnsizedFloat, :read_only
 
     # Sent If the document is printed or sent in any way.
     attr :sent, Bool.optional, :read_only, Boolean
 
     # TaxReduction The amount of tax reduction.
-    attr :tax_reduction, Coercible::Integer.optional, :read_only
+    attr :tax_reduction, UnsizedInteger, :read_only
 
     # TaxReductionType Type of tax reduction.
     attr :tax_reduction_type, TaxReductionTypes
 
     # TermsOfDelivery Code of the terms of delivery.
-    attr :terms_of_delivery, Coercible::String.optional
+    attr :terms_of_delivery, UnsizedString
 
     # TermsOfPayment Code of the terms of payment.
-    attr :terms_of_payment, Coercible::String.optional
+    attr :terms_of_payment, UnsizedString
 
     # Total The total amount of the document.
-    attr :total, Coercible::Float.optional, :read_only
+    attr :total, UnsizedFloat, :read_only
 
     # TotalVAT The total VAT amount of the document.
-    attr :total_vat <=> 'TotalVAT', Coercible::Float.optional, :read_only
+    attr :total_vat <=> 'TotalVAT', UnsizedFloat, :read_only
 
     # VATIncluded If the price of the document is including VAT.
     attr :vat_included <=> 'VATIncluded', Bool.optional, Boolean
 
     # WayOfDelivery Code of the way of delivery.
-    attr :way_of_delivery, Coercible::String.optional
+    attr :way_of_delivery, UnsizedString
 
     # YourOrderNumber Your order number
     attr :your_order_number, Sized::String[75]
@@ -185,16 +185,16 @@ module Fortnox
     attr :zip_code, Sized::String[1024]
 
     # Language Language code.
-    attr :language, Coercible::String.optional
+    attr :language, UnsizedString
 
     # OutboundDate Date of outbound delivery.
     attr :outbound_date, Date.optional, Mappers::Date
 
     # TimeBasisReference Reference to time basis.
-    attr :time_basis_reference, Coercible::Integer.optional, :read_only
+    attr :time_basis_reference, UnsizedInteger, :read_only
 
     # TotalToPay Total amount to pay.
-    attr :total_to_pay, Coercible::Float.optional, :read_only
+    attr :total_to_pay, UnsizedFloat, :read_only
 
     # WarehouseReady If the document is warehouse ready.
     attr :warehouse_ready, Bool.optional, :read_only, Boolean

data/lib/fortnox/resources/invoice.rb

@@ -15,7 +15,7 @@ module Fortnox
     attr :accounting_method, AccountingMethods, :read_only
 
     # Balance Balance of the invoice.
-    attr :balance, Coercible::Float.optional, :read_only
+    attr :balance, UnsizedFloat, :read_only
 
     # Booked If the invoice is bookkept.
     attr :booked, Bool.optional, :read_only, Boolean
@@ -24,10 +24,10 @@ module Fortnox
     attr :credit, Bool.optional, :read_only, Boolean
 
     # CreditInvoiceReference Reference to the credit invoice, if one exists.
-    attr :credit_invoice_reference, Coercible::Integer.optional
+    attr :credit_invoice_reference, UnsizedInteger
 
     # ContractReference Reference to the contract, if one exists.
-    attr :contract_reference, Coercible::Integer.optional, :read_only
+    attr :contract_reference, UnsizedInteger, :read_only
 
     # DueDate Due date of the invoice.
     attr :due_date, Date.optional, Mappers::Date
@@ -51,10 +51,10 @@ module Fortnox
     attr :invoice_period_end, Date.optional, :read_only, Mappers::Date
 
     # InvoicePeriodReference Reference to the invoice period.
-    attr :invoice_period_reference, Coercible::String.optional, :read_only
+    attr :invoice_period_reference, UnsizedString, :read_only
 
     # InvoiceReference Reference to another invoice.
-    attr :invoice_reference, Coercible::String.optional, :read_only
+    attr :invoice_reference, UnsizedString, :read_only
 
     # InvoiceRows Separate object
     attr :invoice_rows, Strict::Array.of(Structs::InvoiceRow), Mappers::StructArray.for(Mappers::InvoiceRow)
@@ -69,24 +69,24 @@ module Fortnox
     attr :nox_finans, Bool.optional, :read_only, Boolean
 
     # OCR OCR number of the invoice.
-    attr :ocr <=> 'OCR', Coercible::String.optional
+    attr :ocr <=> 'OCR', UnsizedString
 
     # OrderReference Reference to the order, if one exists.
-    attr :order_reference, Coercible::Integer.optional, :read_only
+    attr :order_reference, UnsizedInteger, :read_only
 
     # PaymentWay Payment way of the invoice.
     attr :payment_way, PaymentWays
 
     # Reminders Number of reminders sent to the customer.
-    attr :reminders, Coercible::Integer.optional, :read_only
+    attr :reminders, UnsizedInteger, :read_only
 
     # VoucherNumber Voucher number for the invoice.
-    attr :voucher_number, Coercible::Integer.optional, :read_only
+    attr :voucher_number, UnsizedInteger, :read_only
 
     # VoucherSeries Voucher series for the invoice.
-    attr :voucher_series, Coercible::String.optional, :read_only
+    attr :voucher_series, UnsizedString, :read_only
 
     # VoucherYear Voucher year for the invoice.
-    attr :voucher_year, Coercible::Integer.optional, :read_only
+    attr :voucher_year, UnsizedInteger, :read_only
   end
 end

data/lib/fortnox/resources/label.rb

@@ -9,7 +9,7 @@ module Fortnox
       scope 'settings'
     end
 
-    attr :id, Coercible::Integer.optional, :read_only, :key
+    attr :id, UnsizedInteger, :read_only, :key
     attr :description, Sized::String[25]
   end
 end

data/lib/fortnox/resources/order.rb

@@ -15,7 +15,7 @@ module Fortnox
     attr :copy_remarks, Bool.optional, Boolean
 
     # InvoiceReference Reference if an invoice is created from order
-    attr :invoice_reference, Coercible::Integer.optional, :read_only
+    attr :invoice_reference, UnsizedInteger, :read_only
 
     # OrderDate Date of order
     attr :order_date, Date.optional, Mappers::Date
@@ -27,12 +27,12 @@ module Fortnox
     attr :delivery_state, DeliveryStates
 
     # OrderType Type of order.
-    attr :order_type, Coercible::String.optional
+    attr :order_type, UnsizedString
 
     # StockPointCode Code of the stock point.
-    attr :stock_point_code, Coercible::String.optional
+    attr :stock_point_code, UnsizedString
 
     # StockPointId ID of the stock point.
-    attr :stock_point_id, Coercible::String.optional
+    attr :stock_point_id, UnsizedString
   end
 end

data/lib/fortnox/resources/project.rb

@@ -12,7 +12,7 @@ module Fortnox
     end
 
     # @url Direct URL to the record.
-    attr :url <=> '@url', Coercible::String.optional, :read_only
+    attr :url <=> '@url', UnsizedString, :read_only
 
     # Comments Comments on project
     attr :comments, Sized::String[512]

data/lib/fortnox/resources/terms_of_payment.rb

@@ -12,7 +12,7 @@ module Fortnox
     end
 
     # @url Direct URL to the record.
-    attr :url <=> '@url', Coercible::String.optional, :read_only
+    attr :url <=> '@url', UnsizedString, :read_only
 
     # Code The code of the term of payment.
     key :code, Sized::String[25], :required

data/lib/fortnox/resources/unit.rb

@@ -12,7 +12,7 @@ module Fortnox
     end
 
     # @url Direct URL to the record.
-    attr :url <=> '@url', Coercible::String.optional, :read_only
+    attr :url <=> '@url', UnsizedString, :read_only
 
     # Code The code of the unit.
     key :code, Sized::String[20], :required

data/lib/fortnox/structs/document_row.rb

@@ -10,13 +10,13 @@ module Fortnox
       attribute? :article_number, Types::Sized::String[50]
 
       # ContributionPercent Contribution Percent.
-      attribute? :contribution_percent, Types::Coercible::Float.optional, :read_only
+      attribute? :contribution_percent, Types::UnsizedFloat, :read_only
 
       # ContributionValue Contribution Value.
-      attribute? :contribution_value, Types::Coercible::Float.optional, :read_only
+      attribute? :contribution_value, Types::UnsizedFloat, :read_only
 
       # CostCenter Code of the cost center for the row.
-      attribute? :cost_center, Types::Coercible::String.optional
+      attribute? :cost_center, Types::UnsizedString
 
       # DeliveredQuantity Delivered quantity. 14 digits
       attribute? :delivered_quantity, Types::Sized::Float[-9_999_999_999_999.9, 9_999_999_999_999.9]
@@ -47,16 +47,16 @@ module Fortnox
       attribute? :price, Types::Sized::Float[-99_999_999_999.9, 99_999_999_999.9]
 
       # Project Code of the project for the row.
-      attribute? :project, Types::Coercible::String.optional
+      attribute? :project, Types::UnsizedString
 
       # Total Total amount for the row.
-      attribute? :total, Types::Coercible::Float.optional, :read_only
+      attribute? :total, Types::UnsizedFloat, :read_only
 
       # Unit Code of the unit for the row.
-      attribute? :unit, Types::Coercible::String.optional
+      attribute? :unit, Types::UnsizedString
 
       # VAT VAT percentage of the row.
-      attribute? :vat, Types::Coercible::Integer.optional
+      attribute? :vat, Types::UnsizedInteger
     end
   end
 end

data/lib/fortnox/structs/edi_information.rb

@@ -4,22 +4,22 @@ module Fortnox
   module Structs
     class EDIInformation < Fortnox::Struct
       # EDIGlobalLocationNumber Invoice address GLN for EDI
-      attribute? :edi_global_location_number, Types::Coercible::String.optional
+      attribute? :edi_global_location_number, Types::UnsizedString
 
       # EDIGlobalLocationNumberDelivery Delivery address GLN for EDI
-      attribute? :edi_global_location_number_delivery, Types::Coercible::String.optional
+      attribute? :edi_global_location_number_delivery, Types::UnsizedString
 
       # EDIInvoiceExtra1 Extra EDI Information
-      attribute? :edi_invoice_extra1, Types::Coercible::String.optional
+      attribute? :edi_invoice_extra1, Types::UnsizedString
 
       # EDIInvoiceExtra2 Extra EDI Information
-      attribute? :edi_invoice_extra2, Types::Coercible::String.optional
+      attribute? :edi_invoice_extra2, Types::UnsizedString
 
       # EDIOurElectronicReference Our electronic reference for EDI
-      attribute? :edi_our_electronic_reference, Types::Coercible::String.optional
+      attribute? :edi_our_electronic_reference, Types::UnsizedString
 
       # EDIYourElectronicReference Your electronic reference for EDI
-      attribute? :edi_your_electronic_reference, Types::Coercible::String.optional
+      attribute? :edi_your_electronic_reference, Types::UnsizedString
     end
   end
 end

data/lib/fortnox/structs/invoice_row.rb

@@ -4,10 +4,10 @@ module Fortnox
   module Structs
     class InvoiceRow < DocumentRow
       # PriceExcludingVAT Price per unit excluding VAT.
-      attribute? :price_excluding_vat, Types::Coercible::Float.optional, :read_only
+      attribute? :price_excluding_vat, Types::UnsizedFloat, :read_only
 
       # TotalExcludingVAT Total amount for the row excluding VAT.
-      attribute? :total_excluding_vat, Types::Coercible::Float.optional, :read_only
+      attribute? :total_excluding_vat, Types::UnsizedFloat, :read_only
     end
   end
 end

data/lib/fortnox/types.rb

@@ -94,35 +94,65 @@ module Fortnox
       '', 'none', 'rot', 'rut', 'green'
     )
 
+    # Fortnox silently ignores "" in update payloads — updating an
+    # attribute to '' keeps the original value; only an explicit null
+    # clears it. On reads, Fortnox spells "unset" as "" or null depending
+    # on endpoint and record history. Normalise at the type boundary:
+    # blank coerces to nil on parse and update alike, so "no value" is
+    # always nil in the model and always null on the wire. (Enum types
+    # that include '' as a valid member are exempt on purpose.)
+    BLANK_TO_NIL = ->(value) { value == '' ? nil : value }
+
     # Fortnox sometimes returns "" for unset attributes using AccountNumber as type.
-    # Without this constructor, "" falls through to Coercible::Integer and
+    # Without the blank normalisation, "" falls through to Coercible::Integer and
     # `Integer("")` raises, surfacing as Fortnox::ConstraintError.
     AccountNumber = Coercible::Integer
                     .constrained(gteq: 0, lteq: 9999)
                     .optional
-                    .constructor { |v| v == '' ? nil : v }
+                    .constructor(BLANK_TO_NIL)
 
     Email = Strict::String
-            .constrained(max_size: 1024, format: /\A\z|\A[[[:alnum:]]+-_.]+@[[[:alnum:]]+-_.]+\.[a-z]+\z/i)
+            .constrained(max_size: 1024, format: /\A[[[:alnum:]]+-_.]+@[[[:alnum:]]+-_.]+\.[a-z]+\z/i)
             .optional
-            .constructor { |v| v&.to_s&.downcase }
+            .constructor { |value| BLANK_TO_NIL[value]&.to_s&.downcase }
+
+    UnsizedString = Types::Coercible::String
+                    .optional
+                    .constructor(BLANK_TO_NIL)
+
+    UnsizedInteger = Types::Coercible::Integer
+                     .optional
+                     .constructor(BLANK_TO_NIL)
+
+    UnsizedFloat = Types::Coercible::Float
+                   .optional
+                   .constructor(BLANK_TO_NIL)
 
     module Sized
       module String
         def self.[](size)
-          Types::Coercible::String.constrained(max_size: size).optional
+          Types::Coercible::String
+            .constrained(max_size: size)
+            .optional
+            .constructor(BLANK_TO_NIL)
         end
       end
 
       module Integer
         def self.[](low, high)
-          Types::Coercible::Integer.constrained(gteq: low, lteq: high).optional
+          Types::Coercible::Integer
+            .constrained(gteq: low, lteq: high)
+            .optional
+            .constructor(BLANK_TO_NIL)
         end
       end
 
       module Float
         def self.[](low, high)
-          Types::Coercible::Float.constrained(gteq: low, lteq: high).optional
+          Types::Coercible::Float
+            .constrained(gteq: low, lteq: high)
+            .optional
+            .constructor(BLANK_TO_NIL)
         end
       end
     end

data/lib/fortnox/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fortnox
-  VERSION = '1.0.0.rc11'
+  VERSION = '1.0.0.rc13'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fortnox-api
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc11
+  version: 1.0.0.rc13
 platform: ruby
 authors:
 - Jonas Schubert Erlandsson
@@ -11,7 +11,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-06-26 00:00:00.000000000 Z
+date: 2026-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64