クレジットの作成
post
/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/{TransactionId}/child/Credits
リクエスト
パス・パラメータ
- TransactionId(required): integer(int64)
トランザクションの一意の識別子。
ヘッダー・パラメータ
- Metadata-Context:
REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
- REST-Framework-Version:
RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
- Upsert-Mode:
次のいずれかの値が含まれます: trueまたはfalse。 trueの場合、サーバーは作成操作ではなくアップサート操作を実行します。 アップサート操作中、サーバーはペイロードに一致する既存のリソースを検索しようとします。 一致が見つかった場合、サーバーは、新しいリソースを作成するのではなく、既存のリソースを更新します。 見つからないかfalse (デフォルト)の場合、サーバーは作成操作を実行します。 アップサート操作は、有効日RESTリソースではサポートされていないことに注意してください。
サポートされるメディア・タイプ
- application/json
次の表では、このタスクのリクエストの本文パラメータについて説明します。
ルート・スキーマ : スキーマ
タイプ:
ソースを表示
object-
AdjustmentComments: string
タイトル:
Comment最大長:1000クレジットに対する修正のコメントです。 -
CreditAmount: number
タイトル:
Credit Amount処理通貨での貸方金額。 -
CreditCategoryId: integer (int64)
タイトル:
Name分類プロセスを上書きするときに使用するクレジット・カテゴリの一意のレコード識別子。 クレジット・カテゴリは、報酬目的でクレジットを分類するために使用されるユーザー定義のビジネス・カテゴリです。 -
CreditDate: 文字列(日付)
タイトル:
Credit Dateクレジット受領者がクレジットを受け取る日付。 この日付は、トランザクションに対するクレジット・ルールの処理時にクレジット受領者を決定するために使用されます。 -
CreditedParticipantId: integer (int64)
タイトル:
Credit Receiverクレジットを所有する関係者の一意の識別子。 -
HoldFlag: boolean
タイトル:
Hold最大長:1アプリケーションでトランザクションをさらに処理から除外する必要があるかどうかを示します。 -
ObjectStatus: string
タイトル:
Process Status最大長:30クレジット、廃止、積上など、クレジットの現在の状態を示す参照コード。 設定およびメンテナンス、インセンティブ報酬参照の管理タスクを使用して、参照タイプCN_TP_CREDIT_OBJECT_STATUSの使用可能な参照コードをレビューします。 -
ProcessCode: string
タイトル:
Override最大長:30トランザクションに関連付けられたプロセス・コードは、トランザクションの分類上書き、クレジットの保持、ロールアップしない、および計算しないの値の組合せを決定する5文字のコードです。 -
RevenueType: string
タイトル:
Revenue Type最大長:30実績を収益または非収益として分類する参照コード。 設定およびメンテナンス、インセンティブ報酬参照の管理タスクを使用して、参照タイプCN_RS_REVENUE_TYPEの使用可能な参照コードをレビューします。 -
RoleId: integer (int64)
タイトル:
Roleクレジット受領者に割り当てられたロールの一意の識別子。 -
SourceCreditId: integer (int64)
タイトル:
Source Credit ID積上クレジットが生成されるソース・クレジットまたは集計済クレジット・レコードの一意の識別子。 -
SplitPct: number
タイトル:
Split Percentクレジット受領者が受領したトランザクション金額のパーセント。
応答
サポートされるメディア・タイプ
- application/json
デフォルトのレスポンス
次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
- Metadata-Context(required):
REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
- REST-Framework-Version(required):
RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
ルート・スキーマ : incentiveCompensationTransactions-Credits-item-response
タイプ:
ソースを表示
object-
AdjustmentComments: string
タイトル:
Comment最大長:1000クレジットに対する修正のコメントです。 -
AdjustmentStatus: string
タイトル:
Adjustment Status読取り専用:true最大長:30クレジットの調整状態を示す参照コード。 設定およびメンテナンス、インセンティブ報酬参照の管理タスクを使用して、参照タイプCN_TP_CREDIT_ADJ_STATUSの使用可能な参照コードをレビューします。 -
BusinessUnitId: integer (int64)
タイトル:
Business Unit読取り専用:trueビジネス・ユニットの一意の識別子。 -
BusinessUnitName: string
タイトル:
Business Unit読取り専用:true最大長:240ビジネス・ユニットの名前。 -
CalculationConversionRate: number
タイトル:
Calculation Currency Conversion Rate読取り専用:trueソース通貨から処理通貨に換算する換算レート。 -
CalculationCurrencyCode: string
タイトル:
Currency読取り専用:true最大長:15貸方金額の処理通貨を示すコード。 処理通貨は、ビジネス・ユニットの営業通貨または参加者ホーム通貨として選択されます。 「設定およびメンテナンス」作業領域のパラメータの管理タスクを使用して、処理通貨パラメータをレビューします。 -
ChangedCreditFlag: boolean
タイトル:
Change Indicator読取り専用:true最大長:1クレジットが新規か変更済かを示します。 -
ClsfnRuleId: integer (int64)
タイトル:
Classification Rule読取り専用:trueクレジット・カテゴリをクレジットに割り当てるのに使用される分類ルールの一意の識別子です。 -
CollectionStatus: string
タイトル:
Collection Status読取り専用:true最大長:30収集エラーの事由を示す参照コード。 設定およびメンテナンス、インセンティブ報酬参照の管理タスクを使用して、参照タイプCN_TP_CREDIT_COLL_STATUSの使用可能な参照コードをレビューします。 -
CreatedBy: string
読取り専用:
true最大長:64レコードを作成したユーザー。 -
CreatedDuring: string
タイトル:
Credit Process Type読取り専用:true最大長:30このクレジット・レコードが作成された日を示す参照コード。 「設定およびメンテナンス」、「インセンティブ報酬参照の管理」タスクを使用して、使用可能な参照コードCN_TP_CREDIT_CREATED_DURINGをレビューします。 -
CreationDate: string (date-time)
読取り専用:
trueレコードが作成された日付。 -
CreditAmount: number
タイトル:
Credit Amount処理通貨での貸方金額。 -
CreditCategoryId: integer (int64)
タイトル:
Name分類プロセスを上書きするときに使用するクレジット・カテゴリの一意のレコード識別子。 クレジット・カテゴリは、報酬目的でクレジットを分類するために使用されるユーザー定義のビジネス・カテゴリです。 -
CreditDate: 文字列(日付)
タイトル:
Credit Dateクレジット受領者がクレジットを受け取る日付。 この日付は、トランザクションに対するクレジット・ルールの処理時にクレジット受領者を決定するために使用されます。 -
CreditedParticipantId: integer (int64)
タイトル:
Credit Receiverクレジットを所有する関係者の一意の識別子。 -
CreditId: integer (int64)
タイトル:
Credit ID読取り専用:trueクレジットの一意の識別子。 -
CreditRuleId: integer (int64)
タイトル:
Credit Rule読取り専用:trueクレジットの作成に使用されるクレジット・ルールの一意のレコード識別子。 -
CreditType: string
タイトル:
Credit Type読取り専用:true最大長:30直接、間接、要約など、クレジットの性質を示します。 -
DirectParticipantId: integer (int64)
タイトル:
Direct Participant読取り専用:trueクローズ・トランザクションに直接関与する関係者の一意の識別子。 -
DirectRuleId: integer (int64)
読取り専用:
trueこのクレジットに対応する直接クレジットの作成に使用されるクレジット・ルールの一意の識別子。 -
ErrorCode: string
読取り専用:
true最大長:30貸方がエラー・ステータスの場合の事由コード。 設定およびメンテナンス、インセンティブ報酬参照の管理タスクを使用して、参照タイプORA_CN_PROCESS_ERR_REASON LOOKUP_TYPEに使用可能な参照コードをレビューします。 -
ErrorMeaning: string
読取り専用:
true最大長:80与信がエラー・ステータスである理由を説明する事由。 -
EventDate: 文字列(日付)
タイトル:
Event Date読取り専用:trueインセンティブ・イベント日。 イベント日は、参加者のホーム通貨が処理通貨として使用される場合に、有効な通貨換算レートを決定するために使用されます。 -
HoldFlag: boolean
タイトル:
Hold最大長:1アプリケーションでトランザクションをさらに処理から除外する必要があるかどうかを示します。 -
HomeConversionRate: number
タイトル:
Home Currency Conversion Rate読取り専用:true処理通貨からホーム通貨に換算する換算レート。 -
HomeCreditAmount: number
タイトル:
Home Credit Amount読取り専用:true参加者のホーム通貨でのトランザクション金額。 -
HomeCurrencyCode: string
タイトル:
Home Currency読取り専用:true最大長:15参加者のホーム通貨を示すコード。 -
LastUpdateDate: string (date-time)
タイトル:
Last Updated Date読取り専用:trueレコードが最後に更新された日付。 -
LastUpdatedBy: string
タイトル:
Last Updated By読取り専用:true最大長:64レコードを最後に更新したユーザー。 -
LastUpdateLogin: string
読取り専用:
true最大長:32レコードを最後に更新したユーザーのログイン。 -
links: array Links
タイトル:
Linksリソース・インスタンスに関連付けられたリンク関係。 -
ObjectStatus: string
タイトル:
Process Status最大長:30クレジット、廃止、積上など、クレジットの現在の状態を示す参照コード。 設定およびメンテナンス、インセンティブ報酬参照の管理タスクを使用して、参照タイプCN_TP_CREDIT_OBJECT_STATUSの使用可能な参照コードをレビューします。 -
OperatingConversionRate: number
タイトル:
Operating Currency Conversion Rate読取り専用:trueソース通貨から営業通貨に換算する換算レート。 -
OperatingCreditAmount: number
タイトル:
Operating Credit Amount読取り専用:trueビジネス・ユニット営業通貨での貸方金額。 -
OperatingCurrency: string
タイトル:
Operating Currency読取り専用:true最大長:10ビジネス・ユニットの機能通貨を示すコード。 -
ProcessCode: string
タイトル:
Override最大長:30トランザクションに関連付けられたプロセス・コードは、トランザクションの分類上書き、クレジットの保持、ロールアップしない、および計算しないの値の組合せを決定する5文字のコードです。 -
ReasonCode: string
タイトル:
Reason読取り専用:true最大長:30貸方修正の事由を示す参照コード。 CN_TP_ADJUSTMENT_REASON参照は、設定およびメンテナンス、インセンティブ報酬参照の管理タスクから表示できます。 -
RevenueType: string
タイトル:
Revenue Type最大長:30実績を収益または非収益として分類する参照コード。 設定およびメンテナンス、インセンティブ報酬参照の管理タスクを使用して、参照タイプCN_RS_REVENUE_TYPEの使用可能な参照コードをレビューします。 -
RoleId: integer (int64)
タイトル:
Roleクレジット受領者に割り当てられたロールの一意の識別子。 -
RollupDate: 文字列(日付)
タイトル:
Rollup Date読取り専用:trueトランザクションに対する積上ルールの処理時に積上クレジット受領者を決定するために使用する日付です。 -
RollupLevel: integer (int64)
タイトル:
Rollup Level読取り専用:true積上階層の積上ルールのレベルです。 この値は、積上クレジットの場合に適用できます。 -
SourceBusinessUnitId: integer (int64)
タイトル:
Source BU読取り専用:trueソース・トランザクション・ビジネス・ユニットの一意の識別子。 -
SourceCreditAmount: number
タイトル:
Source Credit Amount読取り専用:trueトランザクションのソース通貨での貸方金額。 -
SourceCreditId: integer (int64)
タイトル:
Source Credit ID積上クレジットが生成されるソース・クレジットまたは集計済クレジット・レコードの一意の識別子。 -
SourceCurrencyCode: string
タイトル:
Source Currency読取り専用:true最大長:15ソース・アプリケーションの通貨トランザクション金額の通貨を表す通貨コード。 -
SourceTransactionAmount: number
タイトル:
Source Transaction Amount読取り専用:trueトランザクションのソース通貨でのトランザクション金額。 -
SplitPct: number
タイトル:
Split Percentクレジット受領者が受領したトランザクション金額のパーセント。 -
SummaryCreditId: integer (int64)
読取り専用:
trueクレジットが関連付けられている要約クレジットの一意の識別子。 -
TransactionAmount: number
タイトル:
Transaction Amount読取り専用:true処理通貨でのトランザクション金額。 -
TransactionId: integer (int64)
タイトル:
Transaction ID読取り専用:trueトランザクションの一意の識別子。 -
TransactionNumber: string
タイトル:
Transaction Number読取り専用:true最大長:30請求書番号やオーダー番号など、ユーザーが認識して検索できるトランザクション識別子。 -
TransactionQuantity: number
タイトル:
Quantity読取り専用:trueトランザクション明細アイテムの数量。 -
TransactionType: string
タイトル:
Transaction Type読取り専用:true最大長:30オーダー、請求書またはクレジット・メモなど、トランザクションのソースを示すトランザクションのタイプ。 設定およびメンテナンス、インセンティブ報酬参照の管理タスクを使用して、参照タイプCN_TP_TRANSACTION_TYPEの使用可能な参照コードをレビューします。
ネストされたスキーマ : リンク
タイプ:
ソースを表示
object-
href: string
タイトル:
hyperlink reference関連リソースへのURI。 -
kind: string
タイトル:
kind許可された値:[ "collection", "item", "describe", "other" ]関連リソースの種類。 -
name: string
タイトル:
name関連リソースへのリンクの名前。 -
properties: object properties
-
rel: string
タイトル:
relation許可された値:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]リソース・インスタンスとの関係の名前。 例: self.
ネストされたスキーマ : properties
タイプ:
ソースを表示
object-
changeIndicator: string
リソース・インスタンスのインジケータまたはETag値を変更します。
例:
次の例は、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、インセンティブ報酬トランザクションのクレジットを作成する方法を示しています。
cURLコマンド
curl --user sales_cloud_user https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/10001/child/Credits
リクエスト本文の例
次の例は、JSON形式のリクエスト本文のコンテンツを示しています。
{
"CreditedParticipantId": 999666333000595
}
レスポンス本文の例
次の例は、JSON形式のレスポンス本文のコンテンツを示しています。
{
"CreditId": 300100186676412,
"TransactionId": 10001,
"TransactionNumber": "OTBI001",
"TransactionType": "MANUAL",
"CreditDate": "2009-01-01",
"CreditedParticipantId": 999666333000595,
"DirectParticipantId": 999666333000586,
"CreditCategoryId": null,
"CreditAmount": 10000,
"SplitPct": 100,
"CalculationCurrencyCode": "USD",
"CalculationConversionRate": 1,
"SourceTransactionAmount": 10000,
"SourceCurrencyCode": "USD",
"TransactionAmount": 10000,
"SourceCreditAmount": 10000,
"OperatingCreditAmount": 10000,
"OperatingCurrency": "USD",
"OperatingConversionRate": 1,
"HomeCreditAmount": 10000,
"HomeCurrencyCode": "USD",
"HomeConversionRate": null,
"ObjectStatus": "CREDITED",
"ErrorCode": null,
"ErrorMeaning": null,
"AdjustmentStatus": "NONE",
"CreditRuleId": null,
"LastUpdatedBy": "OIC_MGR_OPERATIONS",
"LastUpdateDate": "2020-06-16T09:18:59.807+00:00",
"TransactionQuantity": null,
"RevenueType": "REVENUE",
"CreditType": "DIRECT",
"CreatedDuring": "CREDITING",
"CreatedBy": "OIC_MGR_OPERATIONS",
"CreationDate": "2020-06-16T09:18:58+00:00",
"BusinessUnitId": 204,
"BusinessUnitName": null,
"AdjustmentComments": null,
"ReasonCode": null,
"RollupLevel": null,
"RoleId": null,
"RollupDate": "2009-01-01",
"EventDate": "2009-01-01",
"CollectionStatus": null,
"HoldFlag": null,
"ProcessCode": "CCREC",
"ChangedCreditFlag": null,
"SourceBusinessUnitId": 204,
"DirectRuleId": null,
"SourceCreditId": null,
"SummaryCreditId": null,
"LastUpdateLogin": "A6BFDB90D59FD19BE0535498F20A7428",
"ClsfnRuleId": null,
"links": [
{
"rel": "self",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/10001/child/Credits/300100186676412",
"name": "Credits",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178"
}
},
{
"rel": "canonical",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/10001/child/Credits/300100186676412",
"name": "Credits",
"kind": "item"
},
{
"rel": "parent",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/10001",
"name": "incentiveCompensationTransactions",
"kind": "item"
},
{
"rel": "lov",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/10001/child/Credits/300100186676412/lov/BusinessUnitVVO",
"name": "BusinessUnitVVO",
"kind": "collection"
},
{
"rel": "lov",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/10001/child/Credits/300100186676412/lov/CreditTypeVVO",
"name": "CreditTypeVVO",
"kind": "collection"
},
{
"rel": "lov",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/10001/child/Credits/300100186676412/lov/RevenueTypeVVO",
"name": "RevenueTypeVVO",
"kind": "collection"
},
{
"rel": "lov",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/10001/child/Credits/300100186676412/lov/CreditCategoryVVO",
"name": "CreditCategoryVVO",
"kind": "collection"
},
{
"rel": "lov",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/10001/child/Credits/300100186676412/lov/ObjectStatusVVO",
"name": "ObjectStatusVVO",
"kind": "collection"
},
{
"rel": "lov",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/10001/child/Credits/300100186676412/lov/CreditRuleVVO",
"name": "CreditRuleVVO",
"kind": "collection"
},
{
"rel": "lov",
"href": "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/incentiveCompensationTransactions/10001/child/Credits/300100186676412/lov/CurrencyVVO",
"name": "CurrencyVVO",
"kind": "collection"
}
]
}