fortnox-api 1.0.0.rc7 → 1.0.0.rc10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1572886bdede9cde4d2de4970160e66e53b83f2dbd19f7cd5ab6165fe28a3c6b
-  data.tar.gz: f76deefb58d635d1fc1a0583fa96a398d47131fbdb9eb5b9e5454281eeac4686
+  metadata.gz: d90c382b3359e0c55cda22e41eee63112f77c721bdabfd490d903cd1d0dbc34f
+  data.tar.gz: 9198f60533f070aa7ccbb12e0e4950aaf0d69476541ad6b13b2d23c1cec86781
 SHA512:
-  metadata.gz: a99b87e8f1d3ef0370b3258000c4a6fe65561305338a9c1d52590faacd0ecd851e6423973c8043857a3b9aadeb750c703e51cdda3362303dda628e953ecfd521
-  data.tar.gz: baa027a8995db227621be745ca00856c84d60f93f6772e21ca0f3c5666c94a96d0b85c992a3682b6688054eab68c4aca383936fc866e3d71057851a338617990
+  metadata.gz: d1847fe3c20ce526ee13328f78d2114e5abb82ac3b5de5e4e08da49989f66a91dc6bbec9eaffed96f52b1af6588689a93834ebe6e095484a780f306ebb213013
+  data.tar.gz: c01f1d2cbf228d825dcfd1092efe7e53ad20fd653a5dc856e03084cce174ccfb1220317afd37b52c93aae30fc6b34ad2c6f3a20e1c8f06444229983b1a094d65

data/CHANGELOG.md

@@ -8,6 +8,46 @@ and this project adheres to
 
 ## [Unreleased]
 
+## [1.0.0.rc10] - 2026-05-27
+
+### Changed
+
+- Upgraded `rest-easy` dependency to `~> 1.3.1`.
+
+### Fixed
+
+- `Types::AccountNumber` no longer raises `Fortnox::ConstraintError` when
+  Fortnox returns `""` for an unset attribute using that type. Observed in production on
+  `Customer#sales_account`. Blank strings now coerce to `nil`.
+  This bug was introduced in 1.0.0.rc1 and did not exist in 0.x.
+
+## [1.0.0.rc9] - 2026-05-20
+
+### Added
+
+- `Fortnox::ALLOWED_CHARACTERS_REGEXP` constant, exposing the character
+  set Fortnox accepts in text fields. Sourced from the official Fortnox
+  docs. Useful for pre-validating strings before sending them to the API.
+
+### Changed
+
+- `Customer#default_delivery_types.invoice` now accepts `'ELECTRONICINVOICE'`
+  when returned by Fortnox. The value is read-only — attempting to set it from
+  consumer code raises `Fortnox::ConstraintError` at save time,
+  rather than letting Fortnox reject the request.
+  Unchanged values round-trip through `save` as before.
+
+## [1.0.0.rc8] - 2026-05-19
+
+### Changed
+
+- `fortnox-setup` now prints the authorization URL and asks before
+  opening a browser when a non-localhost redirect URI is used, defaulting
+  to not opening it. Previously it always opened the URL locally, so the
+  browser immediately followed the redirect and the URL was lost — making
+  it impossible to hand off to whoever should log in (e.g. a customer).
+  The local-server flow is unchanged.
+
 ## [1.0.0.rc7] - 2026-05-19
 
 ### Changed
@@ -217,7 +257,10 @@ 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.rc7...HEAD
+[Unreleased]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc10...HEAD
+[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
+[1.0.0.rc8]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc7...v1.0.0.rc8
 [1.0.0.rc7]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc6...v1.0.0.rc7
 [1.0.0.rc6]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc5...v1.0.0.rc6
 [1.0.0.rc5]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc4...v1.0.0.rc5

data/README.md

@@ -18,7 +18,7 @@ Adding more resources is quick and easy — see the
 ## Status
 
 Version 1.0 is a complete rewrite, currently in release candidate
-(`1.0.0.rc7`). It is built on
+(`1.0.0.rc8`). It is built on
 [rest-easy](https://github.com/accodeing/rest-easy), replacing the old
 HTTParty + Data Mapper architecture with a single resource class per entity.
 Authorization uses the Fortnox client credentials flow.
@@ -64,6 +64,16 @@ sending it to the API, which saves you API calls and time debugging. You can
 still get errors from the server; our implementation is not perfect. Also,
 Fortnox sometimes requires a specific combination of attributes.
 
+#### Allowed characters
+
+`Fortnox::ALLOWED_CHARACTERS_REGEXP` exposes the character set Fortnox
+accepts in text fields, sourced from the [official Fortnox docs][formats].
+The gem itself does not apply this regex to attribute values — it is
+provided so consumers can pre-validate or sanitize strings before
+sending them to the API.
+
+[formats]: https://www.fortnox.se/developer/guides-and-good-to-know/formats-and-encoding
+
 #### Exceptions
 
 The gem raises the following exceptions:

data/bin/fortnox-setup

@@ -154,15 +154,21 @@ auth_params = URI.encode_www_form(
 authorize_url = "#{OAUTH_ENDPOINT}/auth?#{auth_params}"
 
 puts
-puts 'Opening browser for Fortnox authorization...'
-
-open_browser(authorize_url)
 
 if use_local_server
+  puts 'Opening browser for Fortnox authorization...'
+  open_browser(authorize_url)
   puts
   puts 'Waiting for Fortnox to redirect back...'
   authorization_code = get_auth_code_from_server(LOCAL_PORT, nonce)
 else
+  puts 'Authorization URL. Open it to log in, or send it to whoever should'
+  puts 'log in to the Fortnox account being connected:'
+  puts
+  puts "  #{authorize_url}"
+  puts
+  open_here = prompt('Open it in your browser now?', default: 'n')
+  open_browser(authorize_url) if open_here.downcase.start_with?('y')
   authorization_code = auth_code_manually
 end
 

data/fortnox.gemspec

@@ -24,7 +24,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'base64'
   spec.add_dependency 'countries', '~> 7.1'
   spec.add_dependency 'dry-struct', '~> 1.5'
-  spec.add_dependency 'rest-easy', '~> 1.3.0'
+  spec.add_dependency 'rest-easy', '~> 1.3.1'
 
   spec.metadata['rubygems_mfa_required'] = 'true'
 end

data/lib/fortnox/resources/customer.rb

@@ -11,6 +11,10 @@ module Fortnox
       scope 'customer'
     end
 
+    before_serialise do |_attrs|
+      validate_electronic_invoice_delivery_type!(default_delivery_types&.invoice)
+    end
+
     # Direct URL to the record.
     attr :url <=> '@url', Coercible::String.optional, :read_only
 
@@ -205,5 +209,24 @@ module Fortnox
 
     # WWW Website URL
     attr :www <=> 'WWW', Sized::String[128]
+
+    private
+
+    # 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)
+      return unless type == DefaultInvoiceDeliveryTypeValues['ELECTRONICINVOICE']
+
+      set_by_consumer = meta.new? || __changes__.key?(:default_delivery_types)
+
+      return unless set_by_consumer
+
+      raise Fortnox::ConstraintError.new(
+        :default_delivery_types,
+        'ELECTRONICINVOICE',
+        "Customer#default_delivery_types.invoice cannot be changed to 'ELECTRONICINVOICE' " \
+        'via the API, you can only do that change from within Fortnox.'
+      )
+    end
   end
 end

data/lib/fortnox/structs/default_delivery_types.rb

@@ -3,13 +3,13 @@
 module Fortnox
   module Structs
     class DefaultDeliveryTypes < Fortnox::Struct
-      # Default delivery type for invoices. Can be PRINT EMAIL or PRINTSERVICE.
-      attribute? :invoice, Types::DefaultDeliveryTypeValues
+      # Default delivery type for invoices.
+      attribute? :invoice, Types::DefaultInvoiceDeliveryTypeValues
 
-      # Default delivery type for orders. Can be PRINT EMAIL or PRINTSERVICE.
+      # Default delivery type for orders.
       attribute? :order, Types::DefaultDeliveryTypeValues
 
-      # Default delivery type for offers. Can be PRINT EMAIL or PRINTSERVICE.
+      # Default delivery type for offers.
       attribute? :offer, Types::DefaultDeliveryTypeValues
     end
   end

data/lib/fortnox/types.rb

@@ -66,6 +66,10 @@ module Fortnox
       'PRINT', 'EMAIL', 'PRINTSERVICE'
     )
 
+    DefaultInvoiceDeliveryTypeValues = Types::Strict::String.enum(
+      'PRINT', 'EMAIL', 'PRINTSERVICE', 'ELECTRONICINVOICE'
+    )
+
     AccountingMethods = Types::Strict::String.enum(
       '', 'ACCRUAL', 'CASH'
     )
@@ -90,9 +94,13 @@ module Fortnox
       '', 'none', 'rot', 'rut', 'green'
     )
 
+    # Fortnox sometimes returns "" for unset attributes using AccountNumber as type.
+    # Without this constructor, "" 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 }
 
     Email = Strict::String
             .constrained(max_size: 1024, format: /\A\z|\A[[[:alnum:]]+-_.]+@[[[:alnum:]]+-_.]+\.[a-z]+\z/i)

data/lib/fortnox/version.rb

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

data/lib/fortnox.rb

@@ -93,6 +93,14 @@ module Fortnox
 
   OAUTH_TOKEN_URL = 'https://apps.fortnox.se/oauth-v1/token'
 
+  # Character set allowed in Fortnox text fields, per the official Fortnox docs.
+  # Useful for pre-validating strings before sending them to the API.
+  # See: https://www.fortnox.se/developer/guides-and-good-to-know/formats-and-encoding
+  # (The docs spell Unicode codepoints as \x{NNNN}; Ruby's regex parser uses
+  # \u{NNNN} for the same thing, so the three codepoints below are translated.)
+  ALLOWED_CHARACTERS_REGEXP =
+    %r{\A[\p{L}’\\\u{0308}\u{030a}a-zåäöéáœæøüA-ZÅÄÖÉÁÜŒÆØ0-9 –:.`´,;\^¤#%§£$€¢¥©™°&/()=+\-*_!?²³®½@\u{00a0}\n\r]*\z}
+
   class << self
     def access_token=(token)
       Thread.current[Auth::ThreadLocal::THREAD_LOCAL_KEY] = token

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fortnox-api
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc7
+  version: 1.0.0.rc10
 platform: ruby
 authors:
 - Jonas Schubert Erlandsson
@@ -11,7 +11,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-19 00:00:00.000000000 Z
+date: 2026-05-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -61,14 +61,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: 1.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.0
+        version: 1.3.1
 description: Fortnox F3 REST API library, based on rest-easy.
 email:
 - info@accodeing.com