REST APIを使用した価格設定詳細の管理
REST APIを使用して、価格設定詳細を作成、読取り、更新または削除できます。
価格表の作成と承認
Vision Operationsビジネス・ユニットにMy Price Listという名前の価格表を作成する必要があるとします。 REST APIを使用して作成および承認できます。
-
REST APIリクエストを送信して価格リストを作成します。
-
priceListsリソースでPOSTアクションを使用します。
cURLコマンドを次に示します。
https://servername/fscmRestApi/resources/version/priceLists -
ここが体です。
"PriceListName": "My Price List", "PriceListDescription": "Created from REST API", "PriceListType": "Segment price list", "PriceListTypeCode": "SEGMENT", "BusinessUnit": "VISION OPERATIONS", "Currency": "US Dollar", "CurrencyCode": "USD", "Status": "Approved", "StatusCode": "APPROVED", "StartDate": "2021-01-01T19:58:00+00:00", "EndDate": null, "PricingChargeDefinition": "Sale Price", "PricingChargeDefinitionCode": "QP_SALE_PRICE", "LineType": "Buy", "LineTypeCode": "ORA_BUY", "CalculationMethod": "Price", "CalculationMethodCode": "PRICE", "items": [ { "Item": "PMC - Std Item", "PricingUOM": "Each", "PricingUOMCode": "Ea", "LineType": "Buy", "LineTypeCode": "ORA_BUY", "PrimaryPricingUOM": "Y", "ServiceDurationPeriod": null, "ServiceDurationPeriodCode": null, "ServiceDuration": null, "ItemLevelCode": "ITEM", "ItemLevel": "Item", "charges": [ { "PricingChargeDefinition": "Sale Price", "PricingChargeDefinitionCode": "QP_SALE_PRICE", "PricePeriodicity": null, "PricePeriodicityCode": null, "CalculationMethod": "Price", "CalculationMethodCode": "PRICE", "CalculationType": null, "CalculationTypeCode": null, "AllowManualAdjustment": "Y", "BasePrice": 10, "CostCalculationAmount": null, "StartDate": "2000-04-06T22:30:00+00:00", "EndDate": null, "ChargeLineNumber": 1, "MatrixId": null } ] } ], "accessSets": [ { "AccessSetName": "Common Set", "AccessSetCode": "COMMON", "AccessSetId": 0, "AccessSetDescription": null } ] } -
レスポンスを受け取ったとします。
"PriceListName": "My Price List", "PriceListId": 300000081320934, "PriceListDescription": "Created from REST API", "PriceListType": "Segment price list", "PriceListTypeCode": "SEGMENT", "BusinessUnit": "VISION OPERATIONS", "BusinessUnitId": 300000002843138, "Currency": "US Dollar", "CurrencyCode": "USD", "Status": "Approved", "StatusCode": "IN_PROGRESS", "StartDate": "2021-01-01T19:58:00+00:00", . . .リクエストには
"Status": "Approved"および"StatusCode": "APPROVED"が含まれますが、レスポンスには"Status": "Approved"および"StatusCode": "IN_PROGRESS"が含まれます。 POSTアクションでは、StatusCodeをIN_PROGRESSに設定できますが、APPROVEDに設定することはできません。 次に、PATCHリクエストを送信して、StatusCodeをAPPROVEDに設定します。
-
-
価格表を承認します。 priceListsリソースでPATCHアクションを使用します。
-
cURL形式は次のとおりです。
https://servername/fscmRestApi/resources/version/priceLists/PriceListIdこの例のcURLコマンドを次に示します。
https://servername/fscmRestApi/resources/version/priceLists/300000081320934 -
ここが体です。
{ "Status": "Approved", "StatusCode": "APPROVED" }
-
構成品目の価格設定詳細の取得
priceSalesTransaction REST APIペイロードでこれらの属性を使用して、親モデルおよびモデルの子に対する料金詳細を取得できます。
| 属性 | 説明 |
|---|---|
| RootLineId | 構成モデルを含む行番号を指定します。 |
|
ComponentIdPath
|
構成モデルのInventoryItemNumberを指定してから、子のインベントリ品目IDを指定します。 モデルのIDがPTO54222で、子のIDがOP44136であるとします。 コードは次のとおりです:
|
この構成モデルがあるとします。
PTO54222 Laptop Computer
OP44136 Keyboard Option Class
KB18761 Standard Keyboard
KB18759 Keyboard with Touchpad
説明
- PTO54222は、親モデルを識別します。
- OP44136は、PTO54222モデルにあるオプション・クラスを識別します。
- KB18761は、OP44136オプション・クラスにある構成オプションを識別します。
- KB18759は、OP44136オプション・クラスにある構成オプションを識別します。
親モデルおよびその子の価格詳細を取得するペイロードの例を次に示します。
{
"Header": [
{
"AllowCurrencyOverrideFlag": false,
"CalculatePricingChargesFlag": true,
"CalculateShippingChargesFlag": false,
"CalculateTaxFlag": false,
"CustomerId": 1006,
"HeaderId": 1,
"SellingBusinessUnitId": 204,
"SellingLegalEntityId": 204,
"TransactionTypeCode": "ORA_SALES_ORDER"
}
],
"Line": [
{
"HeaderId": 1,
"InventoryItemNumber": "PTO54222",
"InventoryOrganizationId": 204,
"LineCategoryCode": "ORDER",
"LineId": 1001,
"LineQuantityUOMCode": "Ea",
"LineQuantity": {
"Value": 1,
"UomCode": "Ea"
},
"LineTypeCode": "ORA_BUY"
},
{
"HeaderId": 1,
"ComponentPath": "PTO54222> OP44136",
"InventoryItemNumber": "KB18759",
"InventoryOrganizationId": 204,
"LineCategoryCode": "ORDER",
"LineId": 1002,
"LineQuantityUOMCode": "Ea",
"LineQuantity": {
"Value": 1,
"UomCode": "Ea"
},
"LineTypeCode": "ORA_BUY",
"RootLineId": 1001
},
{
"HeaderId": 1,
"ComponentPath": "PTO54222> OP44136",
"InventoryItemNumber": "KB18761",
"InventoryOrganizationId": 204,
"LineCategoryCode": "ORDER",
"LineId": 1003,
"LineQuantityUOMCode": "Ea",
"LineQuantity": {
"Value": 1,
"UomCode": "Ea"
},
"LineTypeCode": "ORA_BUY",
"RootLineId": 1001
}
],
"PricingServiceParameter": {
"PricingContext": "SALES",
"PerformValueIdConversionsFlag": "true"
}
}
REST APIのトラブルシューティング
| 問題 | 解決 |
|---|---|
|
値SYSDATEを使用して、priceSalesTransaction REST APIペイロードの品目の単価の開始日を設定します。 ただし、インポートの完了後、価格設定管理作業領域に表示される日付は予想した日付と異なります。 |
正しいUTCフォーマット(YYYY-MM-DDTHH:MM:SS)を使用していることを確認してください。 たとえば、2019-08-20T10:40:51.88です。 UTCは12時間ではなく24時間制です。 詳細は、次を参照してください。 |
詳細は、「価格設定のトラブルシューティング」および「レート・プランのある価格表の管理」を参照してください。