明細の作成
post
/fscmRestApi/resources/11.13.18.05/publicShoppingListLines
リクエスト
ヘッダー・パラメータ
- Effective-Of:
このヘッダーは文字列値を受け入れます。 この文字列は、セミコロンで区切られた
= 有効日範囲操作の実行に使用されます。 受け入れられるパラメータは、RangeMode、RangeSpan、RangeStartDate、RangeEndDate、RangeStartSequenceおよびRangeEndSequenceです。 パラメータ値は常に文字列です。 RangeModeに指定できる値は、SET_LOGICAL_START、SET_LOGICAL_END、END_DATE、SET_EFFECTIVE_START、SET_EFFECTIVE_END、REPLACE_CORRECTION、REPLACE_UPDATE、RECONCILE_CORRECTION、CORRECTION、RECONCILE_UPDATE、UPDATE、ZAPおよびDELETE_CHANGESです。 RangeSpanに指定できる値は、PHYSICAL_ROW_END_DATEおよびLOGICAL_ROW_END_DATEです。 RangeStartDateおよびRangeEndDateの値は、yyyy-MM-dd形式の日付の文字列表現である必要があります。 RangeStartSequenceおよびRangeEndSequenceの値は、解析時に正の整数が生成されるように文字列である必要があります。のリストです。 - 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
-
Agreement: string
タイトル:
Agreement
公開ショッピング・リスト明細によって参照されるソース契約を識別する番号です。 -
AgreementLine: number
タイトル:
Agreement Line
公開ショッピング・リスト明細によって参照されるソース契約の明細を識別する番号です。 -
AgreementLineId: integer (int64)
タイトル:
Agreement Line ID
公開ショッピング・リスト明細によって参照されるソース契約の明細を一意に識別する値。 -
Item: string
公開ショッピング・リスト明細の品目の名前。
-
ItemId: integer (int64)
品目を一意に識別する値。
-
ProcurementBU: string
タイトル:
Procurement BU
公開ショッピング・リストが作成される調達ビジネス・ユニットの名前。 -
ProcurementBUId: integer
公開ショッピング・リストが作成される調達ビジネス・ユニットを一意に識別する値。
-
PublicShoppingList: string
公開ショッピング・リストの名前。
-
PublicShoppingListHeaderId: integer (int64)
公開ショッピング・リストを一意に識別する値。
-
Sequence: number
品目を作成者または依頼者に表示する順序。
-
SuggestedQuantity: number
カタログ管理者が作成者または依頼者に提示した数量です。
レスポンス
サポートされているメディア・タイプ
- application/json
デフォルトのレスポンス
次の表では、このタスクに対するデフォルトのレスポンスについて説明します。
ヘッダー
- Metadata-Context(required):
REST APIがランタイム・カスタマイズをサポートしている場合、サービスのシェイプはランタイム中に変更される可能性があります。 RESTクライアントは、これらの変更から自身を分離したり、このヘッダーを指定して最新バージョンのAPIと対話することを選択できます。 たとえば: Metadata-Context:sandbox="TrackEmployeeFeature".
- REST-Framework-Version(required):
RESTクライアントとサービスの間のプロトコル・バージョン。 クライアントがリクエストでこのヘッダーを指定しない場合、サーバーはAPIのデフォルト・バージョンを選択します。
ルート・スキーマ : publicShoppingListLines-item-response
タイプ:
ソースを表示
object
-
Agreement: string
タイトル:
Agreement
公開ショッピング・リスト明細によって参照されるソース契約を識別する番号です。 -
AgreementLine: number
タイトル:
Agreement Line
公開ショッピング・リスト明細によって参照されるソース契約の明細を識別する番号です。 -
AgreementLineId: integer (int64)
タイトル:
Agreement Line ID
公開ショッピング・リスト明細によって参照されるソース契約の明細を一意に識別する値。 -
Amount: number
読取り専用:
true
ショッピング・リスト明細の合計金額。 -
Buyer: string
タイトル:
Buyer
読取り専用:true
最大長:240
参照契約のバイヤー名。 -
CategoryId: string
読取り専用:
true
最大長:255
購買カテゴリを一意に識別する値。 -
CategoryName: string
タイトル:
Category Name
読取り専用:true
最大長:255
作成される購買の分類に使用される購買カテゴリの名前です。 -
CreatedBy: string
読取り専用:
true
最大長:64
公開ショッピング・リスト明細を作成したユーザー。 -
CreationDate: string (date-time)
読取り専用:
true
ユーザーが公開ショッピング・リスト明細を作成した日時。 -
CurrencyCode: string
読取り専用:
true
最大長:255
ショッピング・リスト明細通貨を識別する略称です。 -
IndexSyncPendingFlag: boolean
タイトル:
Synchronization Pending
読取り専用:true
次のいずれかの値が含まれます: YまたはN。 Yの場合、更新はショッピング用に公開できます。 Nの場合、更新はショッピング用に公開できません。 デフォルト値はNです。 -
InventoryOrganization: string
読取り専用:
true
最大長:255
品目が定義されている組織の名前です。 -
InventoryOrganizationId: integer
読取り専用:
true
品目が定義されている組織を一意に識別する値。 -
Item: string
公開ショッピング・リスト明細の品目の名前。
-
ItemDescription: string
タイトル:
Description
読取り専用:true
最大長:240
品目の摘要。 -
ItemId: integer (int64)
品目を一意に識別する値。
-
ItemRevision: string
タイトル:
Revision
読取り専用:true
最大長:18
品目の改訂です。 -
LastUpdateDate: string (date-time)
読取り専用:
true
ユーザーが公開ショッピング・リスト明細を最後に更新した日時。 -
LastUpdatedBy: string
読取り専用:
true
最大長:64
公開ショッピング・リスト明細を最後に更新したユーザー。 -
LineType: string
タイトル:
Line Type
読取り専用:true
最大長:30
明細が商品またはサービスのいずれであるかを示す値です。 -
links: array Links
タイトル:
Links
リソース・インスタンスに関連付けられたリンク関係。 -
NegotiatedFlag: boolean
タイトル:
Negotiated
読取り専用:true
最大長:1
次のいずれかの値が含まれます: YまたはN。 Yの場合、公開ショッピング・ラインの価格は、購買会社とサプライヤとの間で事前に合意されます。 Nの場合、価格は事前に合意されません。 この属性にはデフォルト値がありません。 -
NegotiationRequiredFlag: boolean
タイトル:
Negotiation Required
読取り専用:true
最大長:1
次のいずれかの値が含まれます: YまたはN。 Yの場合は、ソーシング・ネゴシエーションが必要です。 Nの場合、ソーシング・ネゴシエーションは不要です。 この属性にはデフォルト値がありません。 -
Price: number
読取り専用:
true
品目の価格。 -
ProcurementBU: string
タイトル:
Procurement BU
公開ショッピング・リストが作成される調達ビジネス・ユニットの名前。 -
ProcurementBUId: integer
公開ショッピング・リストが作成される調達ビジネス・ユニットを一意に識別する値。
-
PublicShoppingList: string
公開ショッピング・リストの名前。
-
PublicShoppingListDescription: string
読取り専用:
true
最大長:250
公開ショッピング・リストの説明。 -
PublicShoppingListEndDate: string (date)
読取り専用:
true
公開ショッピング・リストが非アクティブ化される日時。 -
PublicShoppingListHeaderId: integer (int64)
公開ショッピング・リストを一意に識別する値。
-
PublicShoppingListLineId: integer (int64)
読取り専用:
true
公開ショッピング・リスト明細を一意に識別する値。 -
PublicShoppingListStartDate: string (date)
読取り専用:
true
公開ショッピング・リストがアクティブ化される日時。 -
Sequence: number
品目を作成者または依頼者に表示する順序。
-
SuggestedQuantity: number
カタログ管理者が作成者または依頼者に提示した数量です。
-
Supplier: string
タイトル:
Supplier
読取り専用:true
最大長:360
参照契約のサプライヤの名前。 -
SupplierItem: string
タイトル:
Supplier Item
読取り専用:true
最大長:300
契約から追加された商品またはサービスのサプライヤまたはコードを識別する値です。 -
UOM: string
読取り専用:
true
最大長:255
品目数量の単位。
ネストされたスキーマ : リンク
タイプ:
ソースを表示
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.
例
この例では、明細の作成方法について説明します。
例1 cURLコマンド
次のcURLコマンドを使用して、RESTリソースに対するリクエストを送信します。
curl -u username:password -X POST -H "Content-Type:application/vnd.oracle.adf.resourceitem+json" -d 'request payload' "https://servername/fscmRestApi/resources/version/publicShoppingListLines"
例1 リクエスト本文
次の例には、JSON形式のリクエスト本文のコンテンツが含まれます。 cURLコマンドの「リクエスト・ペイロード」は、リクエスト本文の例の内容に置き換えます。 リクエスト・ペイロードでは、コマンドが作成するレコードで使用される属性値を指定します。
{ "ProcurementBU": "Vision Operations", "PublicShoppingList": "MP_PSL02", "Item": "RCV-100", "SuggestedQuantity": 9 }
例1 レスポンス本文
次の例には、レスポンス本文の内容がJSON形式で含まれます:
{ "ProcurementBUId": 204, "ProcurementBU": "Vision Operations", "PublicShoppingListHeaderId": 300100187519046, "PublicShoppingList": "MP_PSL02", "PublicShoppingListDescription": "MP_PSL02 VO Desc", "PublicShoppingListEndDate": null, "PublicShoppingListStartDate": "2020-07-24", "PublicShoppingListLineId": 300100197614441, "Sequence": null, "LineType": null, "ItemId": 663907, "Item": "RCV-100", "ItemRevision": null, "ItemDescription": "Plain Item", "CategoryName": null, "CategoryId": null, "SuggestedQuantity": 9, "UOM": null, "Price": null, "CurrencyCode": null, "Amount": null, "Supplier": null, "SupplierItem": null, "AgreementLineId": -2, "Agreement": null, "AgreementLine": null, "Buyer": null, "NegotiatedFlag": null, "NegotiationRequiredFlag": null, "CreatedBy": "CVRQST01", "CreationDate": "2020-08-20T03:24:17+00:00", "LastUpdateDate": "2020-08-20T03:24:17.251+00:00", "LastUpdatedBy": "CVRQST01", "InventoryOrganizationId": null, "InventoryOrganization": null, "IndexSyncPendingFlag": null, "links": [ { "rel": "self", "href": "https://servername/fscmRestApi/resources/version/publicShoppingListLines/300100197614441", "name": "publicShoppingListLines", "kind": "item", "properties": { "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B02000078700000000178" } }, { "rel": "canonical", "href": "https://servername/fscmRestApi/resources/version/publicShoppingListLines/300100197614441", "name": "publicShoppingListLines", "kind": "item" } ] }
例2 cURLコマンド
次のcURLコマンドを使用して、RESTリソースに対するリクエストを送信します。
curl -u username:password -X POST -H "Content-Type:application/vnd.oracle.adf.action+json" -d 'request payload' "https://servername/fscmRestApi/resources/version"
例2 リクエスト本文
次の例には、JSON形式のリクエスト本文のコンテンツが含まれます。 cURLコマンドの「リクエスト・ペイロード」は、リクエスト本文の例の内容に置き換えます。 リクエスト・ペイロードでは、コマンドが作成するレコードで使用される属性値を指定します。
{ "parts": [ { "id": "part0", "path": "/publicShoppingListLines", "operation": "create", "payload": { "ProcurementBUId": 204, "ProcurementBU": "Vision Operations", "PublicShoppingList": "POR_PSL01", "Sequence": null, "Item": "CoolingPad 9", "SuggestedQuantity": 1, "Agreement": "1002641", "AgreementLine": 5 } }, { "id": "part1", "path": "/publicShoppingListLines", "operation": "create", "payload": { "ProcurementBUId": 204, "ProcurementBU": "Vision Operations", "PublicShoppingList": "POR_PSL01", "Sequence": 1, "ItemId": 100100106982337, "SuggestedQuantity": 4 } }, { "id": "part2", "path": "/publicShoppingListLines", "operation": "create", "payload": { "ProcurementBUId": 204, "ProcurementBU": "Vision Operations", "PublicShoppingList": "POR_PSL01", "Agreement": "1002258", "AgreementLine": 2 } }, { "id": "part3", "path": "/publicShoppingListLines", "operation": "create", "payload": { "ProcurementBUId": 204, "ProcurementBU": "Vision Operations", "PublicShoppingList": "POR_PSL01", "Sequence": 4, "AgreementLineId": 100000020118480, "Agreement": "1000529", "AgreementLine": 2 } } ] }
例2 レスポンス本文
次の例には、レスポンス本文の内容がJSON形式で含まれます:
{ "parts": [ { "id": "part0", "path": "https://servername/fscmRestApi/resources/version/publicShoppingListLines", "operation": "create", "payload": { "ProcurementBUId": 204, "ProcurementBU": "Vision Operations", "PublicShoppingListHeaderId": 300100188021751, "PublicShoppingList": "POR_PSL01", "PublicShoppingListDescription": "Test PSL", "PublicShoppingListEndDate": null, "PublicShoppingListStartDate": "2020-08-11", "PublicShoppingListLineId": 300100197614437, "Sequence": null, "LineType": "Goods", "ItemId": 100100106982346, "Item": "CoolingPad 9", "ItemRevision": null, "ItemDescription": "PORSHO Agreement Item 19", "CategoryName": "Miscellaneous_1", "CategoryId": "1", "SuggestedQuantity": 1, "UOM": "Each", "Price": 5119, "CurrencyCode": "USD", "Amount": 5119, "Supplier": "CV_SuppA01", "SupplierItem": "SItem2", "AgreementLineId": 519018, "Agreement": "1002641", "AgreementLine": 5120, "Buyer": "PON00020, PRC", "NegotiatedFlag": true, "NegotiationRequiredFlag": null, "CreatedBy": "CVRQST01", "CreationDate": "2020-08-20T03:22:56+00:00", "LastUpdateDate": "2020-08-20T03:22:57.161+00:00", "LastUpdatedBy": "CVRQST01", "InventoryOrganizationId": 204, "InventoryOrganization": "Vision Operations", "IndexSyncPendingFlag": true, "links": [ { "rel": "self", "href": "https://servername/fscmRestApi/resources/version/publicShoppingListLines/300100197614437", "name": "publicShoppingListLines", "kind": "item", "properties": { "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A657870000000017704000000017372001B6F7261636C652E6A626F2E646F6D61696E2E4E756C6C56616C75655899C1C58DAABEEB02000149000A6D53514C54797065496478700000000C78" } }, { "rel": "canonical", "href": "https://servername/fscmRestApi/resources/version/publicShoppingListLines/300100197614437", "name": "publicShoppingListLines", "kind": "item" } ] } }, { "id": "part1", "path": "https://servername/fscmRestApi/resources/version/publicShoppingListLines", "operation": "create", "payload": { "ProcurementBUId": 204, "ProcurementBU": "Vision Operations", "PublicShoppingListHeaderId": 300100188021751, "PublicShoppingList": "POR_PSL01", "PublicShoppingListDescription": "Test PSL", "PublicShoppingListEndDate": null, "PublicShoppingListStartDate": "2020-08-11", "PublicShoppingListLineId": 300100197614438, "Sequence": 1, "LineType": null, "ItemId": 100100106982337, "Item": "CoolingPad 19", "ItemRevision": null, "ItemDescription": "PORSHO MasterItem 19", "CategoryName": "Miscellaneous_1", "CategoryId": "1", "SuggestedQuantity": 4, "UOM": "Each", "Price": 5018, "CurrencyCode": "USD", "Amount": 20072, "Supplier": null, "SupplierItem": null, "AgreementLineId": -2, "Agreement": null, "AgreementLine": null, "Buyer": null, "NegotiatedFlag": null, "NegotiationRequiredFlag": null, "CreatedBy": "CVRQST01", "CreationDate": "2020-08-20T03:22:56.253+00:00", "LastUpdateDate": "2020-08-20T03:22:57.178+00:00", "LastUpdatedBy": "CVRQST01", "InventoryOrganizationId": 204, "InventoryOrganization": "Vision Operations", "IndexSyncPendingFlag": true, "links": [ { "rel": "self", "href": "https://servername/fscmRestApi/resources/version/publicShoppingListLines/300100197614438", "name": "publicShoppingListLines", "kind": "item", "properties": { "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A657870000000017704000000017372001B6F7261636C652E6A626F2E646F6D61696E2E4E756C6C56616C75655899C1C58DAABEEB02000149000A6D53514C54797065496478700000000C78" } }, { "rel": "canonical", "href": "https://servername/fscmRestApi/resources/version/publicShoppingListLines/300100197614438", "name": "publicShoppingListLines", "kind": "item" } ] } }, { "id": "part2", "path": "https://servername/fscmRestApi/resources/version/publicShoppingListLines", "operation": "create", "payload": { "ProcurementBUId": 204, "ProcurementBU": "Vision Operations", "PublicShoppingListHeaderId": 300100188021751, "PublicShoppingList": "POR_PSL01", "PublicShoppingListDescription": "Test PSL", "PublicShoppingListEndDate": null, "PublicShoppingListStartDate": "2020-08-11", "PublicShoppingListLineId": 300100197614439, "Sequence": null, "LineType": "Goods", "ItemId": 663908, "Item": "RCV-101", "ItemRevision": null, "ItemDescription": "Lot Item", "CategoryName": "Miscellaneous_1", "CategoryId": "1", "SuggestedQuantity": 1, "UOM": "Each", "Price": 10, "CurrencyCode": "USD", "Amount": 10, "Supplier": "CV_SuppA01", "SupplierItem": null, "AgreementLineId": 385370, "Agreement": "1002258", "AgreementLine": 2, "Buyer": "Furey,Clare", "NegotiatedFlag": true, "NegotiationRequiredFlag": null, "CreatedBy": "CVRQST01", "CreationDate": "2020-08-20T03:22:56.772+00:00", "LastUpdateDate": "2020-08-20T03:22:57.179+00:00", "LastUpdatedBy": "CVRQST01", "InventoryOrganizationId": 204, "InventoryOrganization": "Vision Operations", "IndexSyncPendingFlag": true, "links": [ { "rel": "self", "href": "https://servername/fscmRestApi/resources/version/publicShoppingListLines/300100197614439", "name": "publicShoppingListLines", "kind": "item", "properties": { "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A657870000000017704000000017372001B6F7261636C652E6A626F2E646F6D61696E2E4E756C6C56616C75655899C1C58DAABEEB02000149000A6D53514C54797065496478700000000C78" } }, { "rel": "canonical", "href": "https://servername/fscmRestApi/resources/version/publicShoppingListLines/300100197614439", "name": "publicShoppingListLines", "kind": "item" } ] } }, { "id": "part3", "path": "https://servername/fscmRestApi/resources/version/publicShoppingListLines", "operation": "create", "payload": { "ProcurementBUId": 204, "ProcurementBU": "Vision Operations", "PublicShoppingListHeaderId": 300100188021751, "PublicShoppingList": "POR_PSL01", "PublicShoppingListDescription": "Test PSL", "PublicShoppingListEndDate": null, "PublicShoppingListStartDate": "2020-08-11", "PublicShoppingListLineId": 300100197614440, "Sequence": 4, "LineType": "Fixed Price Services", "ItemId": -2, "Item": null, "ItemRevision": null, "ItemDescription": "Item 02", "CategoryName": "Miscellaneous_1", "CategoryId": "1", "SuggestedQuantity": null, "UOM": null, "Price": null, "CurrencyCode": "USD", "Amount": 100, "Supplier": "General Electric", "SupplierItem": null, "AgreementLineId": 100000020118480, "Agreement": "1000529", "AgreementLine": 2, "Buyer": "Furey,Clare", "NegotiatedFlag": true, "NegotiationRequiredFlag": null, "CreatedBy": "CVRQST01", "CreationDate": "2020-08-20T03:22:56.972+00:00", "LastUpdateDate": "2020-08-20T03:22:57.182+00:00", "LastUpdatedBy": "CVRQST01", "InventoryOrganizationId": 204, "InventoryOrganization": "Vision Operations", "IndexSyncPendingFlag": true, "links": [ { "rel": "self", "href": "https://servername/fscmRestApi/resources/version/publicShoppingListLines/300100197614440", "name": "publicShoppingListLines", "kind": "item", "properties": { "changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A657870000000017704000000017372001B6F7261636C652E6A626F2E646F6D61696E2E4E756C6C56616C75655899C1C58DAABEEB02000149000A6D53514C54797065496478700000000C78" } }, { "rel": "canonical", "href": "https://servername/fscmRestApi/resources/version/publicShoppingListLines/300100197614440", "name": "publicShoppingListLines", "kind": "item" } ] } } ] }