価格設定詳細のインポート
販売オーダーのインポート時の価格詳細の使用方法を指定します。
例
受注明細に次の2つの手数料があるとします。
|
当初オーダー |
ペイロードのインポート |
|---|---|
|
UnitListPriceは100です。 出荷手数料が20です。 税は10です。 |
価格は120です。 出荷手数料が24です。 税は12です。 |
次のように仮定します。
-
品目の現在の価格は130です。
-
実行時の配送料に20%を掛けた価格です。
-
実行時に計算される税金は、正味価格の合計と出荷の合計に10%を乗算した値です。
参照されていない戻り値を持つ属性の確定に使用できる値
インポートに、元の販売オーダーを参照しないオーダー明細または返品明細が含まれる場合は、次の値を使用します。
|
FreezePriceFlag |
FreezeShippingChargeFlag |
FreezeTaxFlag |
説明 |
|---|---|---|---|
|
Y |
Y |
N |
価格設定では、インポート・ペイロードの価格と出荷手数料を使用しますが、税金は計算されます。 価格は120です。 出荷手数料が25です。 税金は14.50です。 |
|
Y |
N |
N |
価格設定ではペイロードの価格を使用しますが、出荷と税金は計算されます。 価格は120です。 出荷手数料が24です。 税金は14.40です。 |
|
N |
Y |
N |
価格設定ではペイロードからの出荷手数料を使用しますが、価格設定管理で設定した価格を取得し、税金を計算します。 価格は130です。 出荷手数料が24です。 税金は15.40です。 |
参照されていない戻り値を持つ属性の確定に使用できない値
インポートに、元の販売オーダーを参照しないオーダー明細または返品明細が含まれる場合、次の値を使用します。
|
FreezePriceFlag |
FreezeShippingChargeFlag |
FreezeTaxFlag |
説明 |
|---|---|---|---|
|
N |
N |
Y |
価格設定では価格および出荷を計算できますが、インポートされた税金が価格および計算された出荷に対して正しいかどうかは検証できません。 |
|
Y |
N |
Y |
価格設定では出荷を計算できますが、インポートされた価格と税金が計算された出荷に対して正しいことを検証できません。 |
|
N |
Y |
Y |
価格設定では出荷および税金を計算できますが、インポートされた価格が計算された出荷および税金に対して正しいかどうかは検証できません。 |
参照返品明細
インポートに、元の受注を参照する返品明細が含まれているとします。
|
FreezePriceFlag |
FreezeShippingChargeFlag |
FreezeTaxFlag |
説明 |
|---|---|---|---|
|
Y |
Y |
Y |
価格設定では、元の販売オーダーは無視されます。 かわりに、インポート・ペイロードの値を使用します。 価格は120です。 出荷手数料が24です。 税は12です。 |
|
Y |
N |
Y |
これらの属性の少なくとも1つがNと等しい場合は、元の販売オーダーのすべての価格が価格設定され、インポート・ペイロードに含まれる価格、出荷手数料および税金が無視されます。 価格は100です。 出荷手数料が20です。 税は10です。 |
必須属性
価格設定を確定する場合は、インポート・ペイロードに必須属性の値を含める必要があります。 詳細は、「販売オーダーの価格を確定」を参照してください。
販売オーダーの手数料および手数料コンポーネントの検証
「Setup and Maintenance(設定および保守)」作業領域の「Manage Profile Options(プロファイル・オプションの管理)」タスクを使用して、次のプロファイル・オプションを手動で追加して有効にします。
| 属性 | 値 |
|---|---|
| プロファイル名 | FOM_VALIDATE_CHARGES_FULFILLMENT_RESPONSE |
| プロファイル表示名 | 販売オーダーの手数料および手数料コンポーネントの検証 |
| 適用 | オーダー管理 |
| モジュール | オーダーの管理 |
| 説明 | 他のシステムとの統合時にOrder Managementに送信するレスポンスに手数料および手数料コンポーネントが含まれる属性を検証します。 |
プロファイル・オプションを有効にすると、Order Managementによって様々な検証が実行されます。 次のことを確認します:
- レスポンスにはSourceChargeIdentifierが1つのみあります。
- 応答には、ApplyTo属性にPRICEが含まれる手数料が少なくとも1つあります。
- オーダー明細には、ChargeDefinitionCode属性ごとに一意の値があります。 たとえば、この行には、QP_SALE_PRICEと等しいChargeDefinitionCodeが1つのみあります。
- 各使用料金にはレート・プランがあります。
料金のRollupFlagがNの場合、レスポンス内の他の料金に次のものがないことが確認されます:
- RECURRINGを含むPriceType
- ApplyTo属性にPRICEまたはSHIPPINGが含まれるプライマリ手数料
- ChargeDefinitionCode属性に同じ値
次の条件が適用されます。
- IntegratedSubscription属性にNが含まれている場合は、PriceTypeCodeにORA_USAGEが含まれていないことを確認してください。
- 品目がサブスクリプションまたはカバレッジでない場合は、サブスクリプションまたはカバレッジでのみ使用できる属性(契約開始日や期間など)が応答に含まれていないことを確認してください。
- サブスクリプションまたはカバレッジで使用する属性がオーダー明細に含まれている場合は、サブスクリプションまたはカバレッジに必要な機能が使用可能であることを確認してください。
レスポンスがこれらの検証のいずれかに失敗した場合、Order Managementは、失敗とその修正方法の詳細を含むエラー・メッセージで応答します。
Order Managementは、手数料がある受注明細にのみこれらの検証を適用します。 明細に手数料がない場合、Order Managementでは検証は実行されません。
「販売オーダーの手数料および手数料コンポーネントの検証」プロファイル・オプションは、手数料および手数料コンポーネントを含む各属性を検証します。 これらの属性は、履行レスポンス・サービスまたはオーダー履行レスポンス・サービスからOrder Managementに送信するレスポンスで指定します。 詳細は、「REST APIおよびWebサービスを使用したOrder Managementの統合」を参照してください。
このプロファイルはデフォルトの「はい」の値のままにすることをお薦めします。 使用不可にすると、Order Managementでは、インポートした手数料および手数料コンポーネントの値は検証されません。
プロファイルを有効にする場合は、インポート・ペイロードが検証要件を満たしていることを確認する必要があります。
各オーダー手数料エンティティの検証
| 属性 | ペイロードに含める必要がある | Oracle Pricingにすでに存在している必要があります |
|---|---|---|
| ApplyTo | Y | Y |
| ChargeDefinitionCode | Y | Y |
| ChargeSubTypeCode | Y | Y |
| ChargeTypeCode | Y | Y |
| PricePeriodicityCode | Y | Y |
| PriceTypeCode | Y | Y |
| SourceChargeIdentifier | Y | N |
ノート
- 「ペイロードに含める必要がある」は、インポート・ペイロードに属性を含める必要があることを意味します。
- 「Oracle Pricingにすでに存在している必要があります」は、インポート・ペイロードの属性に指定する値がOracle Pricingのデータにすでに存在している必要があることを意味します。
- ChargeSubTypeCode属性で指定する参照コードが、ORA_QP_CHARGE_SUBTYPES価格設定参照で有効になっていることを確認します。
- ChargeTypeCode属性で指定する参照コードが、ORA_QP_CHARGE_TYPE価格設定参照で有効になっていることを確認します。
- 繰返し料金がある場合のみ、pricePeriodicityCodeを含めます。
次の属性のインポート・ペイロードに指定する値の組合せに対して、Oracle Pricingに手数料定義が存在することを確認する必要があります:
- ChargeDefinitionCode
- ChargeTypeCode
- ChargeSubtypeCode
- PriceTypeCode
各手数料コンポーネント・エンティティの検証
| 属性 | ペイロードに含める必要がある | Oracle Pricingにすでに存在している必要があります |
|---|---|---|
| ChargeCurrencyCode | Y | Y |
| HeaderCurrencyCode | Y | Y |
| HeaderCurrencyDurationExtendedAmount | Y | N |
| HeaderCurrencyExtendedAmount | Y | N |
| HeaderCurrencyUnitPrice | Y | N |
| PriceElementCode | Y | Y |
| PriceElementUsageCode | Y | Y |
| SourceChargeComponentIdentifier | Y | N |
ノート
- 手数料に複数の定価または複数の正価が含まれていないことを確認してください。
- オーダー履行レスポンス・サービスでは、SourceChargeComponentIdentifierのかわりにChargeInterfaceKeyが使用されます。
- 繰返し料金がある場合のみ、HeaderCurrencyDurationExtendedAmountを含めます。
- PriceElementUsageCodeは、定価または正価にのみ使用します。
各手数料階層エンティティの検証
| 属性 | ペイロードに含める必要がある | Oracle Pricingにすでに存在している必要があります |
|---|---|---|
| AdjustmentAmount | Y | N |
| ApplicationMethod | Y | N |
| ApplicationMethodCode | Y | N |
| BlockSize | Y | N |
| SourceOrderChargeTierId | Y | N |
| TierFrom | Y | N |
| TierSequenceNumber | Y | N |
| TierTo | Y | N |
ノート
- ApplicationMethodに値を含める場合は、BlockSizeにも値を含める必要があります。
- TierToの値がTierFromの値以上であることを確認してください。