Exact Online APIで特定のエンドポイントに対するユーザーの権限について

私たちはInvantive Data Hubを使用して、Exact Onlineからデータを抽出しています。PurchaseInvoicesやPurchaseInvoiceLinesにアクセスしても、データが表示されません。Exact Online上では、実際に仕入請求書が登録されていることが確認できます。これらの仕入請求書は、APIで使用しているユーザーからも閲覧・アクセスが可能です。

テーブルを取得した際に空のままになる原因は何でしょうか? やはりユーザーの権限に関係しているのでしょうか。もしそうであれば、どこで調整できますか?

すぐに動作するはずのように聞こえます。

REST APIの場合、権限がないとデータは返ってきません。

Exact Online の XML API の場合は、裏側でエラーメッセージが返されます。これは、Exact Online のドライバー属性 ignore-xml-no-access-errors が true に設定されている場合には表示されません。これはバージョン20.1以降のデフォルト設定です。つまり、バージョン20.0ではエラーメッセージが表示されていました。

総じて、権限が不足しているように見えます。

Exact Online API の権限は、以下の手順で確認します:

  1. サブスクリプションホルダーはそのモジュール(例:「Handel」)に対する権限を持っているか?
  2. ユーザーはそのモジュールに対する権限を持っているか?
  3. 管理(administratie)にデータが含まれているか?
  4. アプリ(「クライアント」)はそのモジュールの「スコープ」に対する権限を持っているか?
  5. これらの質問すべてに「はい」と答えられる場合、ユーザーは権限を持っています。

以下のテキストでは、各ステップについて追加の説明をしています。

サブスクリプションホルダーの権限

サブスクリプションホルダーは、サブスクリプション内で明確に権限を持っています。どうやらそれらを入力できるようです。

ユーザーの権限

Exact Online のユーザーも権限を持っているとテキストから理解しています。どうやらそれらを入力・閲覧できるようです。

正しい管理(Administratie)

これも違いを生む可能性があります。仕入請求書が Exact の別の管理(administratie)に存在する場合があります。Query Tool の sessionios@datadictionary で、インタラクティブユーザーとアプリケーションの両方が同じ管理を使用しているかを確認してください。これは URL 内の Division で識別できます。

また、こちらに記載されているように、アプリがその管理に対する権限を持っていることも確認してください。本来であればエラーメッセージが表示されるはずですが、「division scoping」機能はまだ比較的新しいため、いくつかの不具合が残っている可能性は十分にあります。

アプリの権限

最後に、Exact は2020年に data scoping を導入しました。アプリ(「クライアント」)が権限を持っていないデータを REST API 経由で読み取ろうとすると、本来はエラーメッセージが表示されるはずですが……。https://apps.exactonline.com にアクセスし、「Mijn apps(マイアプリ)」からログインした後、アプリケーションの設定を確認してください:

例えば、このアプリ(Gratis inlezen vreemde valuta wisselkoersen in Exact Online)は、オランダでは為替レート(「currencies」という命名はやや不適切ですが)の読み取りと書き込みの両方が許可されています:

REST API 経由での権限の取得

権限は、以下の3つのテーブルを通じて取得することもできます:

  • UserHasRights: ユーザーがあるエンドポイントでのアクションに対する権限を持っているかどうか。
  • UserRoles: ユーザーごとのロール一覧。
  • UserRolesPerDivision: 管理(administratie)ごとのロール。

しかし、経験上、これらの API は本番環境での真剣な利用にはまだ十分に成熟していません。そのため、利用はお勧めしません。

そのほか、どのモジュールが有効になっているかを確認するために(安定している)Settings テーブルや、ライセンス情報を確認するための AvailableFeatures テーブルがよく使われています。

Exact の権限に関するその他の参考記事

2021年の開発に関しては、以下のトピックが参考になります:

さて、どうする?パニック?

これらすべてを試しても Exact Online 上の権限の問題が解決しない場合は、Exact Online サポートの API デスクに問い合わせるか、コンサルタントに相談することをお勧めします。

De abonnee heeft inderdaad rechten: deze klant voert inkoopfacturen in.
De user lijkt ook rechten te hebben: we kunnen de facturen zien, openen etc.
Bij de scopes van de geregistreerde app staat op alles ‘lezen’. Hier wijkt dus niks af.

Vanmorgen weer een nieuwe klant gekoppeld, en zelfde probleem op een andere endpoint: hier krijg ik geen enkele verkoopfactuur terug (terwijl ze er wel zouden moeten zijn).

Ik heb een ticket ingeschoten bij Exact. Is wel handig om te weten hoe we dit kunnen aanpassen zodat altijd alles goed staat. Kunnen we dan ook bij onboarding mee sturen aan een klant.

Ik voeg de oplossing toe aan ticket zodra ik die weet.

Is nog gelukt om voor het ontbreken van data een oplossing te vinden?

Hebben gehoord van Exact dat deze specifieke klanten geen licentie heeft voor inkoopfacturen. Dit is reactie Exact:

In Exact online is er een verschil tussen inkoopfacturen en inkoopboekingen. Inkoopfacturen kunnen alleen aangemaakt worden in een handels- en productieomgeving. KLANT X heeft niet zo’n licentie.
Zij maken gebruik van Inkoopboekingen en die kunt u via PurchaseEntries en PurchaseEntryLines wel ophalen. Daar heeft gebruiker X ook de rechten voor

Was bij de klant niet direct duidelijk, aangezien zij zelf het idee hebben wel degelijk gebruik te maken van inkoopfacturen.

OK, dan is technisch correct. Is inderdaad verwarrend voor users. In de Exact Online Premium boekhouden kun je wel verkooporders importeren maar dat worden dan meer verkoopfacturen.