クレジットの作成
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" } ] }