Coupa
Coupaはビジネス支出管理プラットフォームです。 企業向けに、調達、請求書処理、経費、支払いの各機能をサポートします。 Coupaを使用すると、購買申請や請求書を含む調達プロセスを作成および承認できます。 また、Coupa内で経費レポートを直接送信および承認できる統合経費モジュールも備えています。 この情報は通常、会計や支払いの実行など、その他のビジネス機能のために、NetSuite、Oracle EBS、またはSAPなどのERPシステムと同期されます。
APIバージョン
CoupaコネクターはCoupa Core REST APIを使用します。
Coupa OAuth 2.0コネクション設定
Coupaコネクターは、2022年1月以降、OAuth 2.0ベースの接続をサポートしています。 OAuthコネクションは、APIキーベースのコネクションよりも安全です。 OAuthを使用すると、Workatoコネクション設定で使用予定の正確なスコープを指定できます。 Coupaコネクターは、OAuth 2.0 Client CredentialsおよびOAuth 2.0 Authorization Code Grantコネクションをサポートしています。 詳細については、OpenID Connect Clientsを参照してください。
APIキー認証
APIキー認証は非推奨
Coupaは、Workatoへのコネクションに対するAPIキー認証をサポートしなくなりました。 OAuth方式を使用してCoupaをWorkatoに接続してください。 詳細については、OAuth 2.0 and OIDCを参照してください。
APIキーは、このWorkatoコネクションがユーザーの情報を扱うことを許可されていることをCoupaに知らせるために生成するキーです。 Coupa APIキーを生成するには、次の手順を実行します。
Coupaアカウントにサインインするか、Coupaインスタンスに移動します。 例: https://[your-instance-name].coupacloud.com/api_keys。
Setup > Integrations > API Keysに移動します。
コネクション名フィールドに、コネクションの一意の名前を入力します。
HostとAPI keyを入力します。
Link your accountをクリックします。
OAuth 2.0でCoupaに接続する方法
Coupaインスタンスにサインインします。例：https://[your-instance-name].coupacloud.com/oauth2/clients。
作成をクリックして、新しいOAuthクライアントを作成します。
付与タイプドロップダウンメニューを使用して、認可コードまたはクライアント資格情報を選択します。 Workatoの認証タイプで同じオプションを選択する必要があります。
Nameフィールドに名前を入力します。 例：Workato Coupa OAuth connection。
使用予定のリダイレクトURIをリダイレクトURIフィールドに入力します。 認可コードを使用する予定の場合は、リンクhttps://www.workato.com/oauth/callbackを追加します。
Workatoに提供する予定のスコープを選択します。 Coupaコネクターで自動化する予定のすべてのオブジェクトおよび機能を含めます。 選択するスコープは、Workatoで設定するスコープと一致している必要があります。 コネクションを確立するには、少なくともcore.common.readおよびoffline_accessスコープを含める必要があります。
新しいクライアントを作成
保存をクリックします。
Workatoで使用するために、識別子とシークレットをコピーして保存します。
Workatoアカウントに戻り、コネクションを追加する予定のプロジェクトに移動します。
作成 > コネクションをクリックするか、Cを2回押します。
新規コネクションページで、コネクションとしてCoupaを検索して選択します。
コネクション名フィールドに、コネクションの一意の名前を入力します。
ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。
認証ドロップダウンを使用して、Coupaで指定した付与タイプを選択します。
クライアントIDとクライアントシークレットを入力します。
インスタンスのCoupa URLをホストフィールドに入力します。 たとえば、URLがhttp://acme.coupacloud.comの場合は、acmeと入力します。
スコープドロップダウンメニューを使用して、Coupaで設定したものと同じスコープを選択します。 正常に接続するには、必須スコープcore.common.readおよびoffline_accessを含めます。
接続をクリックします。
Coupaコネクターオブジェクト
Coupaコネクターでは、次のオブジェクト、項目、戻り値の型を使用します:
オブジェクト
Coupaデータは、Workatoのアクションとトリガー内でオブジェクトにグループ化されます。 Create Objectなどのアクションを選択するときは、発注書または請求書のどちらを作成する予定かを指定する必要があります。
次のリストは、一般的なCoupaオブジェクトを示しています。 Coupaオブジェクトの完全なリストを表示するには、CoupaのResourcesドキュメントを参照してください。 コネクターに含まれていないアクションを使用する予定の場合は、カスタムアクションを使用してカスタムHTTPリクエストを送信できます。 詳細については、カスタムアクションを参照してください。
WorkatoはCoupaで次のオブジェクトをサポートしています:
アカウント
財務構造に一致するアカウントをトリガー、クエリ、作成、または更新します。
住所
個人またはサプライヤーの支払先住所情報をトリガー、クエリ、作成、または更新します。
Approvals
購買申請または発注書の承認をトリガーまたはクエリします。
Contract
契約をトリガー、クエリ、作成、または更新します。
部門
部門情報をトリガー、クエリ、作成、または更新します。 部門を使用して会社の運用構造に一致させ、それに応じてグループとユーザーを整理します。
為替レート
為替レートをトリガー、クエリ、作成、または更新します。
Expense line
経費管理に使用する経費レポート明細をクエリまたは作成します。
Expense report
経費管理に使用する経費レポートをトリガー、クエリ、作成、または更新します。
連携
Coupaでインテグレーションをクエリまたは作成します。
Integration error
Coupaでインテグレーションエラーをクエリまたは作成します。
Integration run
Coupaでインテグレーション実行をクエリまたは作成します。
Integration history record
Coupaでインテグレーション履歴レコードをクエリまたは作成します。
インボイス
Coupaで請求書をトリガー、クエリ、作成、または更新します。
Inventory Transaction
在庫トランザクションをトリガー、クエリ、または作成します。 商品の受領は、Coupaでは在庫トランザクションと同じです。
項目
サプライヤーから提供されていない品目をトリガー、クエリ、作成、または更新します。 サプライヤーから提供された品目を扱う予定の場合は、supplier itemオブジェクトを使用します。
Lookup value
Coupaでルックアップ値をトリガー、クエリ、作成、または更新します。
発注書
Coupaで発注書明細をトリガー、クエリ、または作成します。
Purchase order line
Coupaで発注書明細をトリガー、クエリ、または作成します。
Remit to address
サプライヤーの支払先住所をトリガー、クエリ、作成、または更新します。 この住所は、サプライヤーへの支払いの送信に使用されます。
Requisition
Coupaで購買申請をトリガーまたはクエリします。
Supplier
サプライヤーをトリガー、クエリ、作成、または更新します。
Supplier information
サプライヤー情報をトリガー、クエリ、作成、または更新します。
Supplier item
購買申請の作成時にユーザーが選択できる、サプライヤーから提供された品目をトリガー、クエリ、作成、または更新します。
Supplier site
サプライヤーサイトをトリガー、クエリ、作成、または更新します。
ユーザー
ユーザーをトリガー、クエリ、作成、または更新します。
Coupaのカスタムオブジェクト項目
WorkatoのCoupaコネクターは、オブジェクトをリクエストすると、すべてのカスタム項目を自動的に取得します。 定義したカスタム項目を選択するには、Add/remove optional fieldsドロップダウンメニューを使用します。
Coupaの戻り値の型
Coupaのレコードは、複数の属性があるため大きくなることがあります。 そのため、レコードのバッチを取得するときにタイムアウトやパフォーマンスの低下が発生する可能性があります。 取得を改善するには、Return type入力項目を使用して、レコードごとに取得するデータ量を制御します。 レコードの変更を説明する出力データツリーは、選択した入力項目に合わせて自動的に更新されます。 次の戻り値の型を使用できます:
- Default: これはCoupaコネクターのデフォルトオプションです。 すべての項目と子属性が返されます。
- Shallow: オブジェクトのすべての属性または項目が呼び出され、1階層の関連付けのIDと自然キーが返されます。
- Limited: IDのみが返されます。 これはすべてのコマンドでサポートされています。
Last updated: