Fortnoxは2026年9月30日から有効となる変更を策定しました。
通知 – APIスコープ強制の変更について、2026-09-30から有効
一部のAPIエンドポイントにおけるスコープ強制の不一致を確認したため、お知らせいたします。過去1か月間に、あなたの組織に登録されている少なくとも1つのclientIdがAPIトラフィックを生成している記録があるため、この通知を受け取っています。
私たちが見つけたこと
現在、3つのエンドポイントカテゴリーが正しくスコープの検証を実施していません。これらのエンドポイントへのリクエストは、必要なスコープが提示されたJWTに含まれていなくても受理され、200 OKを返し、完全なレスポンスペイロードを含んでいます。これは意図された動作から逸脱しています。これらの呼び出しは、対応するスコープが付与されていない場合、拒否されるべきです。影響を受けるエンドポイント
エンドポイントカテゴリ 必要なスコープ /api/warehouse/* warehouse /api/warehouse/documentdeliveries/custom/* warehousecustomdocument /api/time/* timereporting 変更内容と時期
2026-09-30から、上記のエンドポイントへの呼び出しは、対応する必須スコープを含まないJWTを添付した場合、403 Forbiddenを返します。これは新しい制限ではなく、現在実施されていない正しい動作です。
なぜこれが重要か
あなたの統合がこれらのエンドポイントをスコープを明示的に発行されずに呼び出していた場合、この強制のギャップにより呼び出しは成功していました。しかし2026-09-30以降、そのようなリクエストは成功したレスポンスの代わりに403 Forbiddenで失敗します。
2026-09-30前に行うべきこと
上記の表に対してあなたの統合の現在のスコープ設定を確認してください。使用しているエンドポイントに対してあなたのclientIdに正しいスコープが発行されているか確認してください。
必須スコープが欠落している場合、生産中の中断を避けるため、強制施行日よりもずっと前に追加を要求してください。現在アクティブなJWTでこれらのスコープがないものは、上記のエンドポイントで引き続き機能するために正しいスコープで更新する必要があります。これは、Auth Codeステップで、使用ケースに関連するすべてのスコープをスコープパラメータに含める必要があることを意味します。このため、ユーザーは現在欠落しているスコープを含む新しい同意を発行する必要があります。