Sage Intacctをデータパイプラインソースとして設定 ​

Sage Intacct XML APIから仕訳、請求書、支払請求書、支払い、品目、ディメンションなどの会計データおよび財務データを抽出し、宛先に同期するために、Sage Intacctをデータパイプラインソースとして設定します。

このガイドを使用して、機能と前提条件を確認し、Sage Intacctをデータパイプラインソースとして接続し、パイプラインを設定し、サポートされるオブジェクト、同期モード、スキーマ処理、制限事項を理解します。

サポートされている機能 ​

Sage Intacctをパイプラインソースとして使用する場合、次の機能がサポートされます:

• クラウド接続: https経由でSage Intacct XML APIに接続します。 オンプレミスエージェントは不要です。
• 動的オブジェクト検出: コネクション時に、標準オブジェクトやカスタムPlatform Servicesオブジェクトなど、Sage Intacct会社で利用可能なオブジェクトを検出します。
• オブジェクトレベルの選択: パイプラインを設定するときに、同期するオブジェクトを選択します。
• 同期モード: サポートされる主キーと変更タイムスタンプを持つオブジェクトは増分同期されます。 その他のすべてのオブジェクトはフル同期を使用します。 コネクターは各オブジェクトの同期モードを自動的に検出します。
• カスタムフィールドのサポート: 標準オブジェクトに定義されたカスタムフィールドは、追加の列として同期されます。 カスタムオブジェクトは独自のテーブルとして同期されます。
• スキーマドリフト処理: ソースで新しく追加されたフィールドを自動同期するかブロックするかを選択します。
• フィールドレベルのデータ保護：転送先に到達する前に、フィールド値をそのままレプリケートするか、機密値をハッシュ化します。
• 設定可能な同期頻度：時間ベースまたはcronベースのスケジュールで同期をスケジュールします。 最小間隔は15分です。

前提条件 ​

Sage Intacctをデータパイプラインソースとして設定する前に、次の要件を満たしてください:

• Web Servicesを契約しているSage Intacct会社。
• 同期するオブジェクトへの読み取りアクセス権を持つWeb Servicesユーザー。 設定手順については、IntacctでWeb Servicesユーザーを設定を参照してください。
• 会社のWeb Servicesに対して承認された送信者ID。 Sage Intacctのアカウント担当者から送信者IDを取得してから、承認します。 設定手順については、Intacct Web ServicesでWorkatoを承認を参照してください。

サポートされるコネクションタイプ ​

Sage Intacctデータパイプラインでは、1つの認証方法がサポートされています:

• Web Services認証情報: 会社とWeb Servicesユーザーの認証情報を使用してSage Intacct XML APIに認証し、承認済みの送信者IDでスコープを設定します。 コネクターは同期ごとにセッションを取得し、自動的に更新します。

Sage Intacct（Custom）ワークフローコネクターで使用されるSage Developer Workspace経由のOAuth 2.0は、データパイプラインでは利用できません。 パイプラインソースはXML APIを使用します。

Sage Intacctに接続 ​

Sage Intacctに接続するには、次の手順を実行します。

パイプラインの設定 ​

Sage Intacctをデータパイプラインソースとして設定するには、次の手順を実行します。

[minute] [hour] [day of month] [month] [day of week]

0 8 * * *

サポートされるオブジェクト ​

Sage Intacctデータパイプラインは、Sage Intacct XML APIからデータを同期します。 接続時に、コネクターは会社で利用可能なオブジェクトを検出します。そのため、正確なセットは、契約モジュール、エディション、および会社が定義したカスタムオブジェクトによって異なります。 標準オブジェクトはキュレーションされたカタログから取得され、カスタムPlatform Servicesオブジェクトはそれらと並んで表示されます。 各オブジェクトは、宛先内の個別のテーブルとして同期されます。

次のテーブルは、完全なセットではなく代表的なサンプルとして、コア財務モジュールで一般的に利用可能なオブジェクトを示します。 Inventory Control、Project & Resource Management、Employee Expenses、Contracts & Revenue Managementなどの追加モジュールのオブジェクトは、会社がそれらのモジュールを契約している場合に表示されます。

総勘定元帳 ​

次のオブジェクトは、仕訳、勘定科目定義、勘定残高を記述します:

売掛金 ​

次のオブジェクトは、顧客請求書、支払い、および顧客マスターを記述します:

買掛金 ​

次のオブジェクトは、ベンダー請求書、支払い、およびベンダーマスターを記述します:

受注入力と購買 ​

次のオブジェクトは、販売トランザクションと購買トランザクション、それらの明細品目、および品目マスターを記述します:

ディメンションと参照データ ​

次のオブジェクトは、トランザクションを分類するディメンションと、それらをサポートする参照データを記述します:

同期モード ​

Sage Intacctデータパイプラインでは、完全同期と増分同期がサポートされています。 コネクターは、オブジェクトのメタデータから各オブジェクトの同期モードを自動的に検出します。

フル同期 ​

完全同期は、実行ごとにオブジェクトの利用可能なすべてのレコードを読み取り、宛先内のオブジェクトのレコードセットを置き換えます。 コネクターは、GL_DETAILのようなデータベースビューなど、増分同期できないオブジェクトに完全同期を使用します。

増分同期 ​

増分同期では、前回の実行以降に作成または更新されたレコードのみを読み取ります。 ほとんどの標準オブジェクトは、最終変更タイムスタンプを使用して新規レコードと更新済みレコードの両方を取得し、増分同期されます。 標準オブジェクトではこのためにWHENMODIFIEDフィールドを使用し、カスタムオブジェクトではupdatedAtを使用します。

ARINVOICEITEM、APBILLITEM、SODOCUMENTENTRY、PODOCUMENTENTRYなどの子明細品目は、個別のオブジェクトとして選択およびクエリできます。 それらの親子関係はパイプラインUIのメタデータとして公開され、抽出ルーティングは変更されません。

各オブジェクトの同期モードを確認するには、サポートされるオブジェクトの表を参照してください。

削除追跡 ​

コネクターは削除を追跡しません。 Sage Intacctは、パイプラインが同期済みデータに一致させられる方法で削除済みレコードを公開しないため、削除にフラグを付けたり、宛先に論理削除列を追加したりしません。

増分同期されるオブジェクトは削除を検出しません。これは、増分実行では前回の実行以降に変更されたレコードのみが読み取られるためです。 完全同期されるオブジェクトは実行ごとに完全なレコードセットを再読み取りするため、Sage Intacctで削除されたレコードは次回の完全同期後に表示されなくなります。

スキーマとデータ型の処理 ​

コネクターは、オブジェクトを選択したときに、会社が定義したカスタムフィールドやカスタムオブジェクトを含め、各オブジェクトのスキーマをSage Intacctから取得します。 次の動作は特定のケースに適用されます。

Order Entryオブジェクトのカスタムフィールド ​

SODOCUMENTおよびSODOCUMENTENTRYオブジェクトのカスタムフィールドは、Sage Intacct会社でトランザクション定義オブジェクトが有効になっている場合にのみ同期されます。 宛先スキーマにOrder Entryカスタムフィールドを含めるには、インスタンスで有効にします。

未契約のモジュール ​

オブジェクトが会社で契約していないSage Intacctモジュールを必要とする場合、メタデータ抽出は利用不可オブジェクトエラーを返します。 モジュールを有効にするか、契約済みモジュールからオブジェクトを選択します。

タイムスタンプ ​

Sage Intacctは、タイムスタンプとともにタイムゾーンを常に返すとは限りません。 タイムゾーンがない場合、コネクターは値をUTCとして解釈します。 会社間でタイムスタンプ列を解釈する際には、この点を考慮してください。

機密データの処理 ​

Sage Intacctオブジェクトには、個人を特定できる情報（PII）、金融口座の詳細、税識別子が含まれる場合があります。 次のオブジェクトには、一般的に機密フィールドが含まれます:

銀行口座番号、ルーティング番号、従業員の社会保障番号は最も高いリスクを伴います。 パイプライン設定時にフィールドレベルのデータ保護でHashオプションを使用して、これらのフィールドが宛先に到達する前に保護します。 Workatoでは、SOC 2、GDPR、CCPA、またはPCI-DSSの下で運用されるパイプラインで、これらのフィールドをハッシュ化することをお勧めします。 詳細については、パイプラインを構成手順を参照してください。

制限事項 ​

Sage Intacctをデータパイプラインソースとして使用する場合、次の制限事項が適用されます:

複数エンティティ会社ではエンティティごとにコネクションが必要 ​

コネクションはLocation IDフィールドを通じて単一のエンティティにスコープ設定されます。 複数エンティティ会社で複数のエンティティを同期するには、エンティティごとに個別のパイプラインコネクションを作成します。 Location IDのない最上位コネクションは統合アクセスを提供しますが、すべてのエンティティ固有のトランザクションを公開しない場合があります。

最小同期頻度 ​

サポートされる最小同期間隔は15分です。 これより高い頻度で同期をトリガーすることはできません。

クエリできないフィールドはnull値を生成する可能性あり ​

Sage Intacctは、オブジェクトメタデータにフィールドを報告しても、データクエリでそれを拒否する場合があります。 この場合、コネクターは最小限のクエリ可能なフィールド選択でクエリを再試行します。 コネクターは選択された宛先スキーマを保持しますが、要求された他のフィールドの値は、その抽出でnullになる場合があります。