fortnox-api 1.0.0.rc7 → 1.0.0.rc9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1572886bdede9cde4d2de4970160e66e53b83f2dbd19f7cd5ab6165fe28a3c6b
-  data.tar.gz: f76deefb58d635d1fc1a0583fa96a398d47131fbdb9eb5b9e5454281eeac4686
+  metadata.gz: a20aeb0e4dd1618609c445e649bc8b1d5014febdc7eafcb733d4477a054dca60
+  data.tar.gz: '02592cebf00ea6190f2d0d863a54441346e973e06e0f65fd4e436cda63c57587'
 SHA512:
-  metadata.gz: a99b87e8f1d3ef0370b3258000c4a6fe65561305338a9c1d52590faacd0ecd851e6423973c8043857a3b9aadeb750c703e51cdda3362303dda628e953ecfd521
-  data.tar.gz: baa027a8995db227621be745ca00856c84d60f93f6772e21ca0f3c5666c94a96d0b85c992a3682b6688054eab68c4aca383936fc866e3d71057851a338617990
+  metadata.gz: d65bbab5d39d6428068de1132c2e5d0251acfd3c4e70fe120d37fbb0680d6e82f861935106e6386c4b3b2951f8a513b19b821009459a6e5c4a69f38a9368d50f
+  data.tar.gz: 95858ca85e8694c9d699ec7dd054f5c93e7a1fce3ca078d8bb690ee61f0e691a44cff23f4c3a5633459659234560815a766391ca2d12dce3b1f804f54abb486f

data/CHANGELOG.md

@@ -8,6 +8,33 @@ and this project adheres to
 
 ## [Unreleased]
 
+## [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 +244,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.rc7...HEAD
+[Unreleased]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc9...HEAD
+[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/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'
     )

data/lib/fortnox/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Fortnox
-  VERSION = '1.0.0.rc7'
+  VERSION = '1.0.0.rc9'
 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.rc9
 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-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64