価格表の作成
post
/crmRestApi/resources/11.13.18.05/priceBookHeaders
リクエスト
ヘッダー・パラメータ
- 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-
CurrencyCode: string
タイトル:
Currency最大長:15価格台帳金額の通貨。 この属性は、CRM拡張フレームワークで使用されます。 有効な値のリストは、参照ZCA_COMMON_CORPORATE_CURRENCYで定義されます。 「設定およびメンテナンス」作業領域の通貨プロファイル・オプションの管理タスクを使用して、プロファイル・オプションをレビューおよび更新します。 -
DefaultPricebookFlag: boolean
タイトル:
Default Price Book最大長:1デフォルト値:false通貨のデフォルト価格台帳であるかどうかを示します。 -
Description: string
タイトル:
Description最大長:1999価格台帳の簡単な説明。 -
HeaderExternalKey: string
タイトル:
Header External Key最大長:120価格台帳の外部キー値。 -
HeaderExternalSource: string
タイトル:
Header External Source最大長:120デフォルト値:PB_HEADER価格台帳の外部キーのソース。 -
Name(required): string
タイトル:
Name最大長:150価格台帳の名前。 -
PricebookCode: string
タイトル:
Price Book Code最大長:80価格台帳を示すコード。 この値は、価格表の作成時に自動生成されます。 -
PricebookId: integer (int64)
タイトル:
Price Book ID価格台帳の一意の識別子。 -
PriceBookItem: array Price Book Items
タイトル:
Price Book Items価格表明細リソースは、価格台帳で選択した品目の品目識別子、一意の識別子および一意の識別子を表示、作成、更新および削除するために使用します。 また、品目の摘要、価格および単位も含まれます。 -
StatusCode: string
タイトル:
Status最大長:30デフォルト値:DRAFT価格台帳のステータスを示すコード。 たとえば、ドラフト、アクティブまたは失効済です。 -
StatusSearchLovVA: array Status Search
タイトル:
Status Searchステータス検索リソースを使用すると、価格表のステータスを検索できます。
ネストされたスキーマ : 価格表アイテム
タイプ:
arrayタイトル:
Price Book Items価格表明細リソースは、価格台帳で選択した品目の品目識別子、一意の識別子および一意の識別子を表示、作成、更新および削除するために使用します。 また、品目の摘要、価格および単位も含まれます。
ソースを表示
ネストされたスキーマ : priceBookHeaders-PriceBookItem-item-post-request
タイプ:
ソースを表示
object-
CurrencyCode: string
最大長:
15価格台帳金額の通貨。 この属性は、CRM拡張フレームワークで使用されます。 有効な値のリストは、参照ZCA_COMMON_CORPORATE_CURRENCYで定義されます。 「設定およびメンテナンス」作業領域を使用して、プロファイル・オプションをレビューおよび更新します。 -
InvItemId: integer (int64)
タイトル:
Inventory Item ID価格台帳で選択された品目の一意の識別子。 -
InvOrgId: integer (int64)
価格台帳で選択された品目に関連付けられた在庫組織の一意の識別子。
-
ItemDescription: string
タイトル:
Name価格台帳品目の簡単な摘要。 -
ItemExternalKey: string
タイトル:
External Key最大長:120価格台帳品目の外部キー値。 -
ItemExternalSource: string
タイトル:
External Source最大長:120デフォルト値:PB_LINE価格台帳品目の外部キーのソース。 -
ListPrice: number
タイトル:
List Priceデフォルト値:0品目の価格。 -
PricebookCode: string
タイトル:
Price Book Code最大長:80 -
PricebookId: integer (int64)
価格台帳の一意の識別子。
-
PricebookItemId: integer (int64)
価格台帳品目の一意の識別子。
-
PriceUOMCode: string
タイトル:
UOM最大長:30品目の単位。
応答
サポートされるメディア・タイプ
- application/json
デフォルトのレスポンス
次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
- Metadata-Context(required):
REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 次に例を示します : Metadata-Context:sandbox="TrackEmployeeFeature".
- REST-Framework-Version(required):
RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
ルート・スキーマ : priceBookHeaders-item-response
タイプ:
ソースを表示
object-
CreatedBy: string
タイトル:
Created By読取り専用:true最大長:64レコードを作成したユーザー。 -
CreationDate: string (date-time)
タイトル:
Creation Date読取り専用:trueレコードが作成された日付。 -
CurrencyCode: string
タイトル:
Currency最大長:15価格台帳金額の通貨。 この属性は、CRM拡張フレームワークで使用されます。 有効な値のリストは、参照ZCA_COMMON_CORPORATE_CURRENCYで定義されます。 「設定およびメンテナンス」作業領域の通貨プロファイル・オプションの管理タスクを使用して、プロファイル・オプションをレビューおよび更新します。 -
DefaultPricebookFlag: boolean
タイトル:
Default Price Book最大長:1デフォルト値:false通貨のデフォルト価格台帳であるかどうかを示します。 -
DeleteFlag: boolean
読取り専用:
true価格台帳を削除できるかどうかを示します。 デフォルト値はtrueです。 -
Description: string
タイトル:
Description最大長:1999価格台帳の簡単な説明。 -
HeaderExternalKey: string
タイトル:
Header External Key最大長:120価格台帳の外部キー値。 -
HeaderExternalSource: string
タイトル:
Header External Source最大長:120デフォルト値:PB_HEADER価格台帳の外部キーのソース。 -
LastUpdateDate: string (date-time)
タイトル:
Last Updated Date読取り専用:trueレコードが最後に更新された日付。 -
LastUpdatedBy: string
タイトル:
Last Updated By読取り専用:true最大長:64レコードを最後に更新したユーザー。 -
LastUpdateLogin: string
タイトル:
Last Update Login読取り専用:true最大長:32レコードを最後に更新したユーザーのログイン。 -
links: array Links
タイトル:
Linksリソース・インスタンスに関連付けられたリンク関係。 -
Name: string
タイトル:
Name最大長:150価格台帳の名前。 -
PricebookCode: string
タイトル:
Price Book Code最大長:80価格台帳を示すコード。 この値は、価格表の作成時に自動生成されます。 -
PricebookId: integer (int64)
タイトル:
Price Book ID価格台帳の一意の識別子。 -
PriceBookItem: array Price Book Items
タイトル:
Price Book Items価格表明細リソースは、価格台帳で選択した品目の品目識別子、一意の識別子および一意の識別子を表示、作成、更新および削除するために使用します。 また、品目の摘要、価格および単位も含まれます。 -
StatusCode: string
タイトル:
Status最大長:30デフォルト値:DRAFT価格台帳のステータスを示すコード。 たとえば、ドラフト、アクティブまたは失効済です。 -
StatusSearchLovVA: array Status Search
タイトル:
Status Searchステータス検索リソースを使用すると、価格表のステータスを検索できます。 -
UpdateFlag: boolean
読取り専用:
true価格台帳を更新できるかどうかを示します。 デフォルト値はtrueです。
ネストされたスキーマ : 価格表アイテム
タイプ:
arrayタイトル:
Price Book Items価格表明細リソースは、価格台帳で選択した品目の品目識別子、一意の識別子および一意の識別子を表示、作成、更新および削除するために使用します。 また、品目の摘要、価格および単位も含まれます。
ソースを表示
ネストされたスキーマ : リンク
タイプ:
ソースを表示
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値を変更します。
ネストされたスキーマ : priceBookHeaders-PriceBookItem-item-response
タイプ:
ソースを表示
object-
CreatedBy: string
読取り専用:
true最大長:64レコードを作成したユーザー。 -
CreationDate: string (date-time)
読取り専用:
trueレコードが作成された日付。 -
CurrencyCode: string
最大長:
15価格台帳金額の通貨。 この属性は、CRM拡張フレームワークで使用されます。 有効な値のリストは、参照ZCA_COMMON_CORPORATE_CURRENCYで定義されます。 「設定およびメンテナンス」作業領域を使用して、プロファイル・オプションをレビューおよび更新します。 -
InvItemId: integer (int64)
タイトル:
Inventory Item ID価格台帳で選択された品目の一意の識別子。 -
InvOrgId: integer (int64)
価格台帳で選択された品目に関連付けられた在庫組織の一意の識別子。
-
ItemDescription: string
タイトル:
Name価格台帳品目の簡単な摘要。 -
ItemExternalKey: string
タイトル:
External Key最大長:120価格台帳品目の外部キー値。 -
ItemExternalSource: string
タイトル:
External Source最大長:120デフォルト値:PB_LINE価格台帳品目の外部キーのソース。 -
ItemNumber: string
読取り専用:
true最大長:300価格台帳金額の品目。 この属性は、CRM拡張フレームワークで使用されます。 有効な値のリストは、参照ZCA_COMMON_CORPORATE_ITEMで定義されます。 「設定およびメンテナンス」作業領域を使用して、プロファイル・オプションをレビューおよび更新します。 -
LastUpdateDate: string (date-time)
読取り専用:
trueレコードが最後に更新された日付。 -
LastUpdatedBy: string
読取り専用:
true最大長:64レコードを最後に更新したユーザー。 -
LastUpdateLogin: string
読取り専用:
true最大長:32レコードを最後に更新したユーザーのログイン。 -
links: array Links
タイトル:
Linksリソース・インスタンスに関連付けられたリンク関係。 -
ListPrice: number
タイトル:
List Priceデフォルト値:0品目の価格。 -
PricebookCode: string
タイトル:
Price Book Code最大長:80 -
PricebookId: integer (int64)
価格台帳の一意の識別子。
-
PricebookItemId: integer (int64)
価格台帳品目の一意の識別子。
-
PriceUOMCode: string
タイトル:
UOM最大長:30品目の単位。
ネストされたスキーマ : priceBookHeaders-StatusSearchLovVA-item-response
タイプ:
ソースを表示
object-
links: array Links
タイトル:
Linksリソース・インスタンスに関連付けられたリンク関係。 -
LookupCode: string
タイトル:
Lookup Code読取り専用:true最大長:30FND参照のタイプを示すコード。 有効な値のリストは、参照ORA_QSC_PRICE_BOOK_STATUSで定義されます。 -
LookupType: string
タイトル:
Lookup Type読取り専用:true最大長:30FND参照のタイプ。 -
Meaning: string
タイトル:
Meaning読取り専用:true最大長:80参照の意味。 -
Tag: string
タイトル:
Tag読取り専用:true最大長:150
リンク
- PriceBookItem
-
パラメータ:
- priceBookHeaders_Id:
$request.path.priceBookHeaders_Id
価格表明細リソースは、価格台帳で選択した品目の品目識別子、一意の識別子および一意の識別子を表示、作成、更新および削除するために使用します。 また、品目の摘要、価格および単位も含まれます。 - priceBookHeaders_Id:
- StatusCodeLovForUIVA
-
パラメータ:
- ファインダ:
LookupTypeFinder%3BBindLookupType%3DORA_QSC_PRICE_BOOK_STATUS
価格台帳に関連付けられた様々なステータス・コードのリスト。 この属性の最大値は30です。
LOVリンク関連では、次のプロパティが定義されます:
- ソース属性: StatusCode;ターゲット属性: LookupCode
- 表示属性: 意味
- ファインダ:
- StatusSearchLovVA
-
操作: /crmRestApi/resources/11.13.18.05/priceBookHeaders/{priceBookHeaders_Id}/child/StatusSearchLovVAパラメータ:
- priceBookHeaders_Id:
$request.path.priceBookHeaders_Id
ステータス検索リソースを使用すると、価格表のステータスを検索できます。 - priceBookHeaders_Id:
- YesNoPricebookFlagFndLookupsVA
-
パラメータ:
- ファインダ:
LookupTypeIsActiveEnabledFinder%3BBindLookupType%3DYES_NO
価格台帳が通貨のデフォルトであるかどうかを示す値リスト。 有効な値はYおよびNです。
LOVリンク関連では、次のプロパティが定義されます:
- ソース属性: DefaultPricebookFlag;ターゲット属性: LookupCode
- 表示属性: 意味
- ファインダ:
例:
次の例は、cURLを使用してRESTリソースに対してPOSTリクエストを発行することによって、価格表ヘッダーを作成する方法を示しています。
cURLコマンド
curl -u <username:password> \ -X POST https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/priceBookHeaders
リクエスト本文の例
次の例は、JSON形式のリクエスト本文のコンテンツを示しています。
{
"CurrencyCode" : "USD",
"Name" : "Test/PriceBook/001",
"Description" : "Test Pricebook 001",
"StatusCode" : "DRAFT"
}
レスポンス本文の例
次の例は、JSON形式のレスポンス本文のコンテンツを示しています。
{
"PricebookCode" : "74c5a19c-fc12-4999-8ffc-f2996a1149c6",
"CurrencyCode" : "USD",
"Name" : "Test/PriceBook/001",
"Description" : "Test Pricebook 001",
"StatusCode" : "DRAFT",
"CustomAttr_c" : null,
"TestSearch_c" : "tw",
"TestAttr_c" : null,
"links" : [ {
. . .
} ]
}