fortnox-api 1.0.0.rc15 → 1.0.0.rc16

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab7ad12aa41343980f10d5669c15e92c00ffe1b144f3e2d7eb250205c8f1ddaf
-  data.tar.gz: b88c8debe218e7e0bfcfe8f89ae3c14ac5eaf7f0c9466563c23dd7d13a153b22
+  metadata.gz: 7350800553373489f35a73af7206ae013a6004024b53db948e2778e85c0f61b5
+  data.tar.gz: 359f4b9fb46a0b17aa67180b977021a9bcab6653a722043df93954ccc68b470d
 SHA512:
-  metadata.gz: 3e3580f904dc0ab0b6ade2d540e858bd6e4b282c7589508c32431da156f12634365283ed28bd1e117d81f84f8081596612b9f6ae8736e8c8063b3d11b6f2b653
-  data.tar.gz: b9150f40236d1f2c22d3410f51e774b424af4612f905d3e63174c1f333b4b5b85b474648e0ac3e6999e2c243cc1994b71bd5b89c02146769644a0099b30f887f
+  metadata.gz: c9f62481c8990889206483a455a6f8b6c11060c4f60aad75c8ebbe97825efa5747f7176506a1de69e66df0d0d56592b35d713154a4a033176da5646bc8c7aa2d
+  data.tar.gz: a2e684f757d98304b7ed7e08c167900abaecb027fb31b291b59d1fe57c5cc0f89753e3d0110d9f8cd01c90ce36964c09c28d7b85b8474ea9758507366e647672

data/CHANGELOG.md

@@ -8,6 +8,23 @@ and this project adheres to
 
 ## [Unreleased]
 
+## [1.0.0.rc16] - 2026-08-19
+
+### Added
+
+- **Housework types grouped by tax reduction type.**
+  `Fortnox::Types::HOUSEWORK_TYPES_BY_TAX_REDUCTION` maps `'rot'`, `'rut'`
+  and `'green'` to the housework types a document of that type may carry,
+  with `ROT_HOUSEWORK_TYPES`, `RUT_HOUSEWORK_TYPES`, `GREEN_HOUSEWORK_TYPES`
+  and `ANY_TAX_REDUCTION_HOUSEWORK_TYPES` available individually. Fortnox
+  enforces the grouping — a document declaring one reduction type is
+  rejected outright if it carries a row from another ("Dokument med
+  skattereduktionstypen 'rut' får inte innehålla rader med ...") — but the
+  gem previously exposed only the flat `CURRENT_HOUSEWORK_TYPES`, leaving
+  every consumer to hard-code the split in order to build a UI that cannot
+  produce an unsaveable document. `OTHERCOSTS` and `EMPTYHOUSEWORK` mark a
+  row as not being housework and appear under every reduction type.
+
 ## [1.0.0.rc15] - 2026-08-18
 
 ### Fixed
@@ -419,7 +436,8 @@ 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.rc15...HEAD
+[Unreleased]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc16...HEAD
+[1.0.0.rc16]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc15...v1.0.0.rc16
 [1.0.0.rc15]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc14...v1.0.0.rc15
 [1.0.0.rc14]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc13...v1.0.0.rc14
 [1.0.0.rc13]: https://github.com/accodeing/fortnox-api/compare/v1.0.0.rc12...v1.0.0.rc13

data/lib/fortnox/types/housework.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Fortnox
+  module Types
+    # The housework (ROT/RUT/green) categories a document row can carry.
+    #
+    # Should be included in Fortnox::Types, so every constant here is also reachable
+    # as `Fortnox::Types::CURRENT_HOUSEWORK_TYPES` and friends.
+    module Housework
+      # Which tax reduction each housework type belongs to. Fortnox enforces
+      # this: a document declaring one reduction type is rejected outright if
+      # it carries a row from another, with "Dokument med
+      # skattereduktionstypen 'rut' får inte innehålla rader med ...".
+      # Consumers building a UI need the grouping to keep users from
+      # assembling a document that cannot be saved.
+      ROT_HOUSEWORK_TYPES = [
+        'CONSTRUCTION', 'ELECTRICITY', 'GLASSMETALWORK', 'GROUNDDRAINAGEWORK',
+        'MASONRY', 'PAINTINGWALLPAPERING', 'HVAC'
+      ].freeze
+
+      RUT_HOUSEWORK_TYPES = [
+        'MAJORAPPLIANCEREPAIR', 'MOVINGSERVICES', 'ITSERVICES', 'CLEANING',
+        'TEXTILECLOTHING', 'SNOWPLOWING', 'GARDENING', 'BABYSITTING',
+        'OTHERCARE', 'FURNISHING', 'HOMEMAINTENANCE', 'TRANSPORTATIONSERVICES',
+        'WASHINGANDCAREOFCLOTHING'
+      ].freeze
+
+      GREEN_HOUSEWORK_TYPES = [
+        'SOLARCELLS', 'STORAGESELFPRODUCEDELECTRICITY',
+        'CHARGINGSTATIONELECTRICVEHICLE'
+      ].freeze
+
+      # Accepted under any tax reduction type. Both mark a row as not being
+      # housework and must be sent with `housework` false.
+      ANY_TAX_REDUCTION_HOUSEWORK_TYPES = ['OTHERCOSTS', 'EMPTYHOUSEWORK'].freeze
+
+      # Every type Fortnox still accepts on a new document — the groups above
+      # are the definition, this is only their sum. Anything added to a group
+      # lands here, and in the HouseworkTypes enum, on its own.
+      CURRENT_HOUSEWORK_TYPES = (
+        ROT_HOUSEWORK_TYPES + RUT_HOUSEWORK_TYPES + GREEN_HOUSEWORK_TYPES +
+        ANY_TAX_REDUCTION_HOUSEWORK_TYPES
+      ).freeze
+
+      # Fortnox no longer grants a reduction for these, but old documents
+      # still come back carrying them, so the enum has to accept them.
+      LEGACY_HOUSEWORK_TYPES = ['COOKING', 'TUTORING'].freeze
+
+      # The types a document may carry, keyed by its tax reduction type.
+      HOUSEWORK_TYPES_BY_TAX_REDUCTION = {
+        'rot' => (ROT_HOUSEWORK_TYPES + ANY_TAX_REDUCTION_HOUSEWORK_TYPES).freeze,
+        'rut' => (RUT_HOUSEWORK_TYPES + ANY_TAX_REDUCTION_HOUSEWORK_TYPES).freeze,
+        'green' => (GREEN_HOUSEWORK_TYPES + ANY_TAX_REDUCTION_HOUSEWORK_TYPES).freeze
+      }.freeze
+    end
+  end
+end

data/lib/fortnox/types.rb

@@ -6,6 +6,7 @@ require 'dry-types'
 module Fortnox
   module Types
     include Dry.Types()
+    include Housework
 
     # Booleans reach us as strings whenever the caller is a Rails app passing
     # controller params through. Resource attributes already coerce those:
@@ -23,18 +24,6 @@ module Fortnox
       'AMOUNT', 'PERCENT'
     )
 
-    CURRENT_HOUSEWORK_TYPES = [
-      'CONSTRUCTION', 'ELECTRICITY', 'GLASSMETALWORK', 'GROUNDDRAINAGEWORK',
-      'MASONRY', 'PAINTINGWALLPAPERING', 'HVAC', 'MAJORAPPLIANCEREPAIR',
-      'MOVINGSERVICES', 'ITSERVICES', 'CLEANING', 'TEXTILECLOTHING',
-      'SNOWPLOWING', 'GARDENING', 'BABYSITTING', 'OTHERCARE', 'OTHERCOSTS',
-      'FURNISHING', 'HOMEMAINTENANCE', 'TRANSPORTATIONSERVICES',
-      'WASHINGANDCAREOFCLOTHING', 'SOLARCELLS', 'STORAGESELFPRODUCEDELECTRICITY',
-      'CHARGINGSTATIONELECTRICVEHICLE', 'EMPTYHOUSEWORK'
-    ].freeze
-
-    LEGACY_HOUSEWORK_TYPES = ['COOKING', 'TUTORING'].freeze
-
     HouseworkTypes = Types::Strict::String.enum(
       *(CURRENT_HOUSEWORK_TYPES + LEGACY_HOUSEWORK_TYPES)
     )

data/lib/fortnox/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fortnox-api
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc15
+  version: 1.0.0.rc16
 platform: ruby
 authors:
 - Jonas Schubert Erlandsson
@@ -11,7 +11,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-08-18 00:00:00.000000000 Z
+date: 2026-08-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: base64
@@ -120,6 +120,7 @@ files:
 - lib/fortnox/structs/invoice_row.rb
 - lib/fortnox/structs/order_row.rb
 - lib/fortnox/types.rb
+- lib/fortnox/types/housework.rb
 - lib/fortnox/version.rb
 homepage: https://github.com/accodeing/fortnox
 licenses: