fiscalrail 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d2a0b93b946f75e4d2733bafaea87dee185f6b7abf5db7c60b7d73864472d63f
-  data.tar.gz: 40ec395e28ee22197bdeb479517022bdf4894c3b89b721fd80a9db8c693309cf
+  metadata.gz: 4d9fcbcf8bfd05d48cce8ca79c50e6053d989ef54c0a2b67b5c386764f71b8a0
+  data.tar.gz: e1026a8001318bfb1914add9feb13409818b1f8d54937fc7569c4776474763a9
 SHA512:
-  metadata.gz: c4b48066bb84842295979af02f44e7e002fadf22c88bb73252684f748bb71ac82ec3867673bc8c3227a2b18ac7e1b22df98f0ded6c180bf824550e6bb745f5ff
-  data.tar.gz: 8fff2a61e27c474e4ae2c43fb688d3c5aac67212dda270ac332b6c112a256fb0844a248117801798700804c1236437cbaeeb0229fce437f2c13b95cb1b9fbf38
+  metadata.gz: 85026a467a16b3bc54a33306720743d41aba4ea63b7e3072e30240f2b4d67bb6d54cf38293d92098b9ad0b05da755e671c39e6e559bd0675c942a5fe78c05995
+  data.tar.gz: ef408ec27b12fe12d907de2abaa8d15a9be13485437f1c5985f442d94fde4615dc519975805221c266acbfdb1834aaaa0c8ee8f39918db98c743bf3d9371f43a

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.5.0 — 2026-09-28
+
+- Match the deployed current-account API routes and split invoicing settings into a dedicated resource.
+- Use `/tax-ids/{id}` for tax ID retrieval.
+- Regenerate response and request types from the updated FiscalRail OpenAPI contract.
+
 ## 0.4.0 — 2026-09-07
 
 - Start at 0.4.0 to match the Python SDK release with full resource coverage.

data/README.md

@@ -5,7 +5,7 @@ A Ruby client for issuing immutable invoices through FiscalRail. Ruby 3.3 or lat
 Install with Bundler:
 
 ```ruby
-gem "fiscalrail", "~> 0.4.0"
+gem "fiscalrail", "~> 0.5.0"
 ```
 
 ## Issue an invoice
@@ -83,9 +83,10 @@ By default, the SDK makes at most two retries for connection failures, timeouts,
 
 | Resource | Methods |
 | --- | --- |
-| `accounts` | `list`, `retrieve`, `update` |
-| `balances` | `retrieve(account_id)` |
-| `account_tax_regimes` | `retrieve(account_id)` |
+| `accounts` | `retrieve`, `update` |
+| `account_invoicing` | `retrieve`, `update` |
+| `balances` | `retrieve` |
+| `account_tax_regimes` | `retrieve` |
 | `api_keys` | `list`, `create`, `retrieve`, `delete` |
 | `customers` | `list`, `create`, `retrieve`, `update`, `delete` |
 | `event_destinations` | `list`, `create`, `retrieve`, `update`, `delete`, `enable`, `disable` |
@@ -114,7 +115,7 @@ end
 first_ten = client.customers.auto_paging_each.lazy.take(10).to_a
 ```
 
-Automatic iteration proceeds forward and preserves filters. Use `list(starting_after: ...)` or `list(ending_before: ...)` to manage cursors yourself. Accounts and tax regimes return single lists and do not expose automatic pagination.
+Automatic iteration proceeds forward and preserves filters. Use `list(starting_after: ...)` or `list(ending_before: ...)` to manage cursors yourself. Account, account invoicing, balance, and account tax regime resources return single objects.
 
 ## Payment instructions
 
@@ -129,7 +130,7 @@ instruction = client.payment_instructions.create(
   }
 )
 
-client.accounts.update("acct_...", default_payment_instructions: [instruction.id])
+client.account_invoicing.update(default_payment_instructions: [instruction.id])
 
 invoice = client.invoices.issue(
   payment_terms: { due_date: Date.new(2026, 9, 30) },
@@ -182,7 +183,7 @@ FiscalRail::Client.open(
   write_timeout: 30,
   max_retries: 2
 ) do |client|
-  client.accounts.list
+  client.accounts.retrieve
 end
 ```
 

data/lib/fiscalrail/client.rb

@@ -2,7 +2,7 @@
 
 module FiscalRail
   class Client
-    attr_reader :accounts, :balances, :account_tax_regimes, :api_keys, :customers,
+    attr_reader :accounts, :account_invoicing, :balances, :account_tax_regimes, :api_keys, :customers,
       :event_destinations, :events, :invoice_series, :invoices, :invoice_pdfs,
       :payment_instructions, :tax_ids, :tax_regimes
 
@@ -20,6 +20,7 @@ module FiscalRail
       @adapter = adapter || NetHTTPAdapter.new(open_timeout: open_timeout, read_timeout: read_timeout, write_timeout: write_timeout)
       transport = Transport.new(api_key: api_key, base_url: base_url, max_retries: max_retries, adapter: @adapter)
       @accounts = Resources::Accounts.new(transport)
+      @account_invoicing = Resources::AccountInvoicing.new(transport)
       @balances = Resources::Balances.new(transport)
       @account_tax_regimes = Resources::AccountTaxRegimes.new(transport)
       @api_keys = Resources::ApiKeys.new(transport)

data/lib/fiscalrail/generated/contract.rb

@@ -19,15 +19,6 @@ module FiscalRail
           "format": "date-time",
           "type": "string"
         },
-        "default_payment_instructions": {
-          "items": {
-            "$ref": "#/components/schemas/PaymentInstructionId"
-          },
-          "type": "array"
-        },
-        "default_series": {
-          "$ref": "#/components/schemas/AccountDefaultSeries"
-        },
         "email": {
           "type": [
             "string",
@@ -37,12 +28,6 @@ module FiscalRail
         "id": {
           "$ref": "#/components/schemas/AccountId"
         },
-        "invoice_locale": {
-          "type": "string"
-        },
-        "invoice_numbering_scope": {
-          "$ref": "#/components/schemas/AccountInvoiceNumberingScope"
-        },
         "live": {
           "$ref": "#/components/schemas/Live"
         },
@@ -84,10 +69,6 @@ module FiscalRail
         "address",
         "tax_regime",
         "timezone",
-        "invoice_locale",
-        "invoice_numbering_scope",
-        "default_series",
-        "default_payment_instructions",
         "created_at",
         "updated_at"
       ],
@@ -133,30 +114,72 @@ module FiscalRail
     "AccountInvoiceNumberingScope": {
       "type": "string"
     },
-    "AccountList": {
-      "model": "AccountList",
+    "AccountInvoicing": {
+      "model": "AccountInvoicing",
       "properties": {
-        "data": {
+        "default_payment_instructions": {
           "items": {
-            "$ref": "#/components/schemas/Account"
+            "$ref": "#/components/schemas/PaymentInstructionId"
           },
           "type": "array"
         },
-        "has_more": {
-          "type": "boolean"
+        "default_series": {
+          "$ref": "#/components/schemas/AccountDefaultSeries"
+        },
+        "footer": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "locale": {
+          "type": "string"
+        },
+        "numbering_scope": {
+          "$ref": "#/components/schemas/AccountInvoiceNumberingScope"
         },
         "object": {
-          "const": "list",
+          "const": "account_invoicing",
           "type": "string"
         }
       },
       "required": [
         "object",
-        "has_more",
-        "data"
+        "locale",
+        "footer",
+        "numbering_scope",
+        "default_series",
+        "default_payment_instructions"
       ],
       "type": "object"
     },
+    "AccountInvoicingUpdate": {
+      "model": "AccountInvoicingUpdate",
+      "properties": {
+        "default_payment_instructions": {
+          "items": {
+            "$ref": "#/components/schemas/PaymentInstructionId"
+          },
+          "type": "array"
+        },
+        "default_series": {
+          "$ref": "#/components/schemas/AccountDefaultSeries"
+        },
+        "footer": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "locale": {
+          "type": "string"
+        },
+        "numbering_scope": {
+          "$ref": "#/components/schemas/AccountInvoiceNumberingScope"
+        }
+      },
+      "type": "object"
+    },
     "AccountNotConfiguredErrorResponse": {
       "model": "AccountNotConfiguredErrorResponse",
       "properties": {
@@ -206,17 +229,20 @@ module FiscalRail
         "address": {
           "$ref": "#/components/schemas/AddressUpdate"
         },
-        "default_payment_instructions": {
-          "items": {
-            "$ref": "#/components/schemas/PaymentInstructionId"
-          },
-          "type": "array"
+        "email": {
+          "type": [
+            "string",
+            "null"
+          ]
         },
-        "default_series": {
-          "$ref": "#/components/schemas/AccountDefaultSeries"
+        "name": {
+          "type": "string"
         },
-        "invoice_numbering_scope": {
-          "$ref": "#/components/schemas/AccountInvoiceNumberingScope"
+        "phone": {
+          "type": [
+            "string",
+            "null"
+          ]
         }
       },
       "type": "object"
@@ -3056,16 +3082,6 @@ module FiscalRail
         }
       }
     },
-    "listAccounts": {
-      "method": "GET",
-      "path": "/accounts",
-      "parameters": [],
-      "responses": {
-        "200": {
-          "$ref": "#/components/schemas/AccountList"
-        }
-      }
-    },
     "listApiKeys": {
       "method": "GET",
       "path": "/api-keys",
@@ -3290,30 +3306,28 @@ module FiscalRail
     },
     "retrieveAccount": {
       "method": "GET",
-      "path": "/accounts/{id}",
-      "parameters": [
-        {
-          "name": "id",
-          "in": "path",
-          "required": true
-        }
-      ],
+      "path": "/account",
+      "parameters": [],
       "responses": {
         "200": {
           "$ref": "#/components/schemas/Account"
         }
       }
     },
-    "retrieveAccountTaxRegime": {
+    "retrieveAccountInvoicing": {
       "method": "GET",
-      "path": "/accounts/{account_id}/tax-regime",
-      "parameters": [
-        {
-          "name": "account_id",
-          "in": "path",
-          "required": true
+      "path": "/account/invoicing",
+      "parameters": [],
+      "responses": {
+        "200": {
+          "$ref": "#/components/schemas/AccountInvoicing"
         }
-      ],
+      }
+    },
+    "retrieveAccountTaxRegime": {
+      "method": "GET",
+      "path": "/account/tax-regime",
+      "parameters": [],
       "responses": {
         "200": {
           "$ref": "#/components/schemas/AccountTaxRegime"
@@ -3338,14 +3352,8 @@ module FiscalRail
     },
     "retrieveBalance": {
       "method": "GET",
-      "path": "/accounts/{account_id}/balance",
-      "parameters": [
-        {
-          "name": "account_id",
-          "in": "path",
-          "required": true
-        }
-      ],
+      "path": "/account/balance",
+      "parameters": [],
       "responses": {
         "200": {
           "$ref": "#/components/schemas/Balance"
@@ -3466,7 +3474,7 @@ module FiscalRail
     },
     "retrieveTaxId": {
       "method": "GET",
-      "path": "/tax_ids/{id}",
+      "path": "/tax-ids/{id}",
       "parameters": [
         {
           "name": "id",
@@ -3498,20 +3506,24 @@ module FiscalRail
     },
     "updateAccount": {
       "method": "PATCH",
-      "path": "/accounts/{id}",
-      "parameters": [
-        {
-          "name": "id",
-          "in": "path",
-          "required": true
-        }
-      ],
+      "path": "/account",
+      "parameters": [],
       "responses": {
         "200": {
           "$ref": "#/components/schemas/Account"
         }
       }
     },
+    "updateAccountInvoicing": {
+      "method": "PATCH",
+      "path": "/account/invoicing",
+      "parameters": [],
+      "responses": {
+        "200": {
+          "$ref": "#/components/schemas/AccountInvoicing"
+        }
+      }
+    },
     "updateCustomer": {
       "method": "PATCH",
       "path": "/customers/{id}",

data/lib/fiscalrail/generated/models.rb

@@ -6,12 +6,8 @@ module FiscalRail
     class Account < Model
       def address = self["address"]
       def created_at = self["created_at"]
-      def default_payment_instructions = self["default_payment_instructions"]
-      def default_series = self["default_series"]
       def email = self["email"]
       def id = self["id"]
-      def invoice_locale = self["invoice_locale"]
-      def invoice_numbering_scope = self["invoice_numbering_scope"]
       def live = self["live"]
       def name = self["name"]
       def object = self["object"]
@@ -28,12 +24,23 @@ module FiscalRail
       def invoice = self["invoice"]
     end
 
-    class AccountList < Page
-      def data = self["data"]
-      def has_more = self["has_more"]
+    class AccountInvoicing < Model
+      def default_payment_instructions = self["default_payment_instructions"]
+      def default_series = self["default_series"]
+      def footer = self["footer"]
+      def locale = self["locale"]
+      def numbering_scope = self["numbering_scope"]
       def object = self["object"]
     end
 
+    class AccountInvoicingUpdate < Model
+      def default_payment_instructions = self["default_payment_instructions"]
+      def default_series = self["default_series"]
+      def footer = self["footer"]
+      def locale = self["locale"]
+      def numbering_scope = self["numbering_scope"]
+    end
+
     class AccountNotConfiguredError < Model
       def code = self["code"]
       def message = self["message"]
@@ -45,9 +52,9 @@ module FiscalRail
 
     class AccountUpdate < Model
       def address = self["address"]
-      def default_payment_instructions = self["default_payment_instructions"]
-      def default_series = self["default_series"]
-      def invoice_numbering_scope = self["invoice_numbering_scope"]
+      def email = self["email"]
+      def name = self["name"]
+      def phone = self["phone"]
     end
 
     class Address < Model

data/lib/fiscalrail/resources/accounts.rb

@@ -3,28 +3,34 @@
 module FiscalRail
   module Resources
     class Accounts < Resource
-      def list
-        request("listAccounts", retry_safe: true)
+      def retrieve
+        request("retrieveAccount", retry_safe: true)
       end
 
-      def retrieve(account_id)
-        request("retrieveAccount", path: { id: account_id }, retry_safe: true)
+      def update(**params)
+        request("updateAccount", body: params)
+      end
+    end
+
+    class AccountInvoicing < Resource
+      def retrieve
+        request("retrieveAccountInvoicing", retry_safe: true)
       end
 
-      def update(account_id, **params)
-        request("updateAccount", path: { id: account_id }, body: params)
+      def update(**params)
+        request("updateAccountInvoicing", body: params)
       end
     end
 
     class Balances < Resource
-      def retrieve(account_id)
-        request("retrieveBalance", path: { account_id: account_id }, retry_safe: true)
+      def retrieve
+        request("retrieveBalance", retry_safe: true)
       end
     end
 
     class AccountTaxRegimes < Resource
-      def retrieve(account_id)
-        request("retrieveAccountTaxRegime", path: { account_id: account_id }, retry_safe: true)
+      def retrieve
+        request("retrieveAccountTaxRegime", retry_safe: true)
       end
     end
   end

data/lib/fiscalrail/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module FiscalRail
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: fiscalrail
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - FiscalRail