SAP S/4HANA Cloud RESTコネクター
APIドキュメント
Section titled “APIドキュメント”SAP API Business Hubにある、SAP S/4HANA CloudのTrial Balance API(API_OPLACCTGDOCITEMCUBE_SRV)とJournal Entry Item - Basic API(API_JOURNALENTRYITEMBASIC_SRV)に、このコネクターが使用するODataエンドポイントが記載されています。また、Communication Arrangementを通じて公開されるSOAPの仕訳一括作成サービスも使用します。
認証の仕組み
Section titled “認証の仕組み”この接続は、OAuth2クライアント資格情報を使用してアプリケーションとして認証します。Communication ArrangementのクライアントIDとシークレットを、テナントのOAuth2トークンエンドポイントでアクセストークンに交換します。対話型のサインインはありません。
| フィールド | タイプ | 説明 |
|---|---|---|
| 名前 | テキスト | この接続の表示名。 |
| ホスト | テキスト | S/4HANA Cloudテナントのホスト(例:https://yourorg.s4hana.ondemand.com)。 |
| トークンURL | テキスト | Communication ArrangementのOAuth2トークンエンドポイント。 |
| クライアントID | テキスト | Communication ArrangementのOAuth2クライアントID。 |
| クライアントシークレット | テキスト | Communication ArrangementのOAuth2クライアントシークレット。暗号化して保存されます。 |
インポートできるエンティティ
Section titled “インポートできるエンティティ”Import S/4HANA Entityステップは、trial_balance(API_OPLACCTGDOCITEMCUBE_SRV経由の、集計された期末の総勘定元帳勘定科目残高)とjournal_entry_items(API_JOURNALENTRYITEMBASIC_SRV経由の、転記済みの仕訳明細行)の2つのエンティティに対応しています。どちらもCompanyCode、GLAccount、CostCenter、ProfitCenter、FiscalYear、FiscalPeriod、Ledgerに対するサーバー側フィルターに対応しており、PostingDate、FiscalYear、FiscalPeriodではge/leの範囲の境界を指定できます。フィールドの詳細はImport S/4HANA Entityステップを参照してください。
S/4HANA: Post Journal Entryステップは、PlaidCloudの共通ERP書き込みパイプラインを通じて総勘定元帳の仕訳を転記します。S/4HANA CloudのJournalEntryBulkCreateRequest_In SOAPサービスで送信し、JournalEntryBulkCreateConfirmation_Outの確認をポーリングし、確認してから仕訳を転記済みとして報告します。訂正では、元の仕訳を編集するのではなく、借方と貸方を入れ替えた新しい取消仕訳を転記します。フィールドのリファレンスはS/4HANA: Post Journal Entryステップを、転記の手順全体はSAP S/4HANA Cloudへの接続を参照してください。
既知の制限事項
Section titled “既知の制限事項”| 制限事項 | 意味 |
|---|---|
| 確認の待ち時間 | SOAPの一括作成サービスはリクエストを非同期で処理するため、同じサイズの同期ODataによる書き込みよりもかなり遅くなります。 |
| フィルターできるフィールドはCommunication Scenarioによって異なる | お使いのCommunication Scenarioで公開されていないコストオブジェクトやディメンションは、サーバー側でフィルターできません。取得後にワークフロー内で絞り込んでください。 |
- SAP S/4HANA Cloudへの接続(ガイド) — 接続の作成、テスト、エンティティのインポート、仕訳の転記までの手順。
- Import S/4HANA Entity
- S/4HANA: Post Journal Entry
- ERP転記履歴の確認
- SAP ECC / S/4HANAコネクター — オンプレミスまたはプライベートクラウドのS/4HANA向けの、RFC/エージェントベースの別のコネクター。