カバレッジおよびサブスクリプションを含むソース・オーダーのインポート
対象品目、カバレッジ品目またはサブスクリプションを含むソース・オーダーをOrder Managementにインポートおよび更新します。
このトピックでは、カバレッジを含むソース・オーダーをインポートまたは更新する方法について説明します。 ただし、これを使用してサブスクリプションをインポートすることもできます。
オーダー管理にカバレッジを含むソース・オーダーをインポートします。
-
ソース・オーダーをインポートするテクノロジを選択します。
-
Oracle Application Development Framework (ADF)のWebサービス。
-
Oracle Service-Oriented Architecture (SOA)のWebサービス。
-
Oracle Collaboration Messaging FrameworkでのB2Bメッセージング。
-
ファイル・ベース・インポート。 詳細は、「オーダー管理にオーダーをインポート」を参照してください。
-
-
ソース・オーダーに必須属性が含まれていることを確認してください。
属性
値
文書参照タイプ
タイプを指定します。
対象品目とカバレッジ品目の間の関係が作成されます。
文書明細ID
ソース・トランザクションの明細ID。
このIDはカバレッジ品目を識別します。
文書サブ明細ID
ソース・トランザクションの明細ID。
このIDはカバレッジ品目を識別します。
品目を購入し、その品目のカバレッジを適用します。
-
「同時に」。 このサブ明細は、同じソース順序に配置できます。
-
「後で」。 このサブ明細は、すでにインポートした別の販売オーダーのクローズ済オーダー明細に存在できます。
文書ID
対象明細のソース・オーダーID。
文書番号
対象明細の販売オーダー番号。
文書明細追加ID
ソース・トランザクションの明細ID。
このIDは、構成品目のルート親のカバレッジを識別します。
インポートでは、これらの属性を使用して、カバレッジ品目と対象品目の間の関係を確立します。 使用するインポート・プロセスでは、ソース・オーダーのインポート・ペイロードにあるこれらの各属性をオーダー管理の販売オーダーの属性にマップする必要があります。
-
-
ソース・オーダーに、カバレッジ品目の請求期間数属性の値が含まれていることを確認してください。
-
ソース・オーダーに価格詳細が含まれているかどうかに応じて、ソース・オーダーにカバレッジ品目属性の値が含まれていることを確認してください。
価格詳細を含む
価格詳細を含まない
Oracle Pricingでは品目の価格が設定されません。
-
期間金額には値が含まれている必要があり、この値はオーダー・ヘッダーで使用される通貨と同じ通貨を使用する必要があります。
-
契約開始日には値を含める必要があります。
-
期間、期間および契約終了日の値は空にできます。
Oracle Pricingで品目の価格を設定します。
これらの各属性に値が含まれている必要があります。
-
期間
-
期間
-
契約開始日
-
-
製品情報管理作業領域の設定を確認します。
-
契約カバレッジ使用可能属性および販売製品タイプ属性を設定して、対象品目をサポートするようにしてください。 詳細は、「販売オーダーの補償範囲の設定」を参照してください。
-
サブスクリプション品目を指定するには、Sales Product TypeをSubscriptionに設定します。 サブスクリプションを対象品目として使用するには、サブスクリプションに対して契約カバレッジを有効にします。
サブスクリプションは、カバレッジ品目に類似しています。 これには、期間、期間、契約開始日および契約終了日が含まれます。 通常、カバレッジ品目のインポート時に適用されるルールは、サブスクリプションのインポート時にも適用されます。 詳細は、「販売オーダーのサブスクリプションの設定」を参照してください。
-
-
設定に応じて、期間と期間の値を設定します。
Product Information Managementのサービス期間タイプ
説明
固定
ソース・オーダーの期間と期間が、Product Information Managementの期間と期間に設定した値と一致していることを確認してください。
無期限
カバレッジ品目を含むソース・オーダーをインポートし、カバレッジ品目に価格詳細が含まれていない場合は、インポートに期間および期間の値が含まれていることを確認してください。
-
カバレッジ数量の値が対象数量の値と等しいことを確認してください。
-
カバレッジ単位の値が対象単位の値と等しいことを確認してください。
-
オーダー管理がすでにオーダー履行のために発行している対象品目をカバレッジ品目が対象とする場合は、対象品目のステータスがクローズ済であることを確認します。
-
インポート・ペイロードを確認します。 カバレッジ明細を識別する文書参照が、1つの対象明細にのみマップされていることを確認します。
1つのカバレッジ明細でカバーできる対象明細は1つのみです。 カバレッジ明細は複数の対象明細をカバーできません。
インポート日時
オプションとして、契約開始日のタイム・スタンプおよびカバレッジまたはサブスクリプションの契約終了日のタイム・スタンプを指定します。 タイム・スタンプには日時が含まれます。
-
開始タイムスタンプ、期間および期間をインポートすると、オーダー管理ではこれらの値を使用して終了タイムスタンプが自動的に計算されます。 オーダー管理では、1日の終わりを23:59:59、UTC (協定世界時)に設定します。
-
開始タイムスタンプと終了タイムスタンプをインポートすると、オーダー管理ではこれらの値を使用して期間と期間が自動的に計算されます。
たとえば、REST APIを使用して、契約期間、開始タイムスタンプおよび終了タイム・スタンプをインポートします。 詳細と例については、「Oracle Supply Chain Management CloudのREST API」、Order Management、「オーダー・ハブの販売オーダーをクリック」の順に展開します。
この例のペイロードは、OAL_EW_2Y_VAR保証をインポートします。
-
期間2
-
0zEの期間 -
2019-12-13T19:51:49+05:30の契約開始タイムスタンプ
-
終了タイム・スタンプの値がありません
ノート
-
タイムスタンプをUTCでインポートします。
-
UTCからのオフセットを含めることができます。 たとえば、
2019-12-13T19:51:49+05:30には+05:30のオフセットが含まれます。 -
オーダー管理データベースでは、タイムスタンプ値がUTCで格納されます。 オーダー管理作業領域では、これらがUPTZ (ユーザー・プリファレンス・タイム・ゾーン)に表示されます。 詳細は、「オーダー管理でのタイム・ゾーンの差異」を参照してください。
-
期間には整数を使用します。 小数値を含めないでください。
テクノロジごとに異なる属性を使用します。
|
テクノロジ |
属性 |
|---|---|
|
Order Hub REST APIまたはApplication Development Framework (ADF) webサービスの販売オーダー。 |
|
|
SourceSalesOrderImportTemplate FBDIテンプレート。 |
これらの属性を使用します。
|
価格設定済の構成済品目によるカバレッジのインポート
ソース・オーダーに構成品目の価格詳細が含まれ、ソース・オーダーで次の各属性をYに設定した場合:
-
価格の凍結
-
配送料を確定
-
税金の凍結
次に、入力ペイロードに、契約カバレッジに対して有効にする各構成オプションのカバレッジが含まれていることを確認します。
製品情報管理作業領域の「品目の編集」ページで契約カバレッジ使用可能属性をYに設定すると、契約カバレッジの構成オプションが有効になります。
インポートで次の検証が実行されていることを確認してください:
-
各構成オプションのカバレッジがソース・オーダーに含まれていない場合は、ソース・オーダーを否認します。
-
各構成オプションのカバレッジ数量および単位が対象品目の明細数量および単位と一致しない場合は、ソース・オーダーを否認します。
契約カバレッジに対して有効になっている構成オプションごとに、これらの検証が実行されていることを確認します。
詳細は、「対象品目の価格設定」を参照してください。
価格設定されていない構成済品目によるカバレッジのインポート
ソース・オーダーに価格詳細が含まれず、ソース・オーダーで次の属性のいずれかをNに設定した場合:
-
価格の凍結
-
配送料を確定
-
税金の凍結
その後、Oracle Pricingで価格が設定されます。
ノート
-
ソース・オーダーには、各構成オプションではなく、ルート親である構成品目のカバレッジのみを含める必要があります。
-
契約カバレッジの構成オプションを使用可能にする場合、インポート・プロセスで各構成オプションのカバレッジ明細を作成する必要があります。 各構成オプションは、オプション区分またはオプション品目にできます。
-
入力ペイロードにルート親のカバレッジと1つ以上の構成オプションが含まれる場合、インポートではソース・オーダーを拒否する必要があります。
返品が含まれるカバレッジのインポート
返品を含む対象品目をインポートできます。
-
対象品目を保持し、カバレッジ品目のみを返品できます。 インポート・ペイロードにカバレッジ品目の返品明細のみが含まれていることを確認してください。
-
カバレッジ明細の契約終了日がカバレッジ明細の返品日より前に発生する場合は、カバレッジ明細を返品できません。
返品には次の詳細が含まれている必要があります:
-
対象明細およびカバレッジ明細のステータスは、それぞれクローズ済です。
-
返品数量がゼロを超えています。
-
返品数量が返品可能な数量を超えていません。 たとえば、販売オーダーに数量10が含まれ、すでに数量6を返品している場合、返品数量は4を超えることはできません。
-
返品カバレッジ明細には、Original_Sales_Order文書参照タイプが必要です。
-
対象明細には、Source_Coverage_Covered_Associationドキュメント参照タイプが必要です。
ソース・オーダーに価格詳細が含まれているかどうかに応じて、対象品目を返品するときに次の点に注意してください:
|
価格詳細を含む |
価格詳細を含まない |
|---|---|
|
Oracle Pricingで品目の価格が設定されていない場合は、対象品目をカバーするカバレッジ品目を返品できます。 インポート・ペイロードにこれらの詳細が含まれていることを確認してください。
|
Oracle Pricingで品目の価格を設定する場合、インポート・ペイロードで対象品目およびカバレッジ明細を返品するように指定できます。 インポート・ペイロードに対象品目の返品明細が含まれていることを確認してください。 Oracle Applicationsは、カバレッジ明細の返品明細を作成します。 |
インポート・ペイロードでカバレッジ品目のみが返された場合は、次の点に注意してください:
-
カバレッジ明細の数量は、対象明細の合計返品可能数量と一致する必要があります。 インポート・ペイロードでは、返品可能数量の一部のみを返すことはできません。
-
インポート・ペイロードのカバレッジ返品単位は、対象明細単位と一致する必要があります。
-
ソース・オーダーに価格詳細が含まれている場合、インポート・ペイロードに返品手数料が含まれている必要があります。
Webサービスを介した補償内容およびサブスクリプションの更新
FulfillmentResponseServiceペイロードの属性を使用して、契約日を更新します。
-
ContractStartDate
-
ContractStartDateTime
-
ContractEndDate
-
ContractEndDateTime
ノート
|
インポートする場合 |
説明 |
|---|---|
|
開始日のみ。 |
オーダー管理では、履行明細の期間と期間を使用して契約終了日が計算されます。 |
|
契約開始日および契約終了日。 |
カバレッジの設定時にサービス期間タイプを変数に設定し、契約開始日と契約終了日をインポートすると、オーダー管理によって履行明細の期間が再計算されます。 ただし、改訂期間では履行明細の価格変更は行われません。 サービス期間タイプについて学習します。 詳細は、「販売オーダーの補償範囲の設定」を参照してください。 |
|
契約終了日のみ。 |
オーダー管理ではリクエストが無視され、契約開始日が必要なため、日付は更新されません。 |
FulfillmentResponseServiceを使用して契約日を更新する場合は、カバレッジ明細の他の属性に対する後続の更新で同じ契約日を指定していることを確認してください。 後続の更新で契約日を指定しない場合、Order Managementではカバレッジ開始日パラメータと実際の出荷日または実際の搬送日を使用して、契約日の値の設定方法が決定されます。 詳細は、オーダー管理パラメータの管理を参照してください。
明細の分割
FulfillmentResponseServiceリクエストを使用して分割することはできません:
-
対象品目があり、同じリクエストを使用して対象品目をカバーするカバレッジ明細の契約日を更新するオーダー明細。 かわりに、1つのリクエストを使用して対象品目を含む明細を分割し、次のリクエストを送信してカバレッジ品目を更新します。
-
カバレッジ明細のみ。 オーダー管理では、対象明細を分割すると、カバレッジ明細が自動的に処理されます。
オーダー管理で明細がすでに分割されている場合は、Application Development Framework (ADF)を使用して明細にカバレッジを追加できません。 分割明細にカバレッジを追加するために使用できるのは、オーダー管理作業領域またはREST APIのみです。
FulfillmentResponseServiceの使用方法の詳細は、「オーダー管理を履行システムに接続」を参照してください。
請求プランをインポート
請求プランをインポートする場合は、インポート・ペイロードのオーダー明細のBillingPlansエンティティにPeriodicityCode属性に1回ずつ含まれていないことを確認してください。
例について考えてみます。
"shipToCustomer": [
{
"PartyId": 1006,
"SideId": 1036,
}
],
"lines": {
{
"SourceTransactionLineId": "CPQ_LINE_ID_001",
"SourceTransactionLineNumber": "CPQ_LINE_NUM_001",
"SourceTransactionScheduleId": "CPQ_SCH_ID_001",
"SourceScheduleNumber": "CPQ_SCH_NUM_001",
"ProductNumber": "CPQ_SCH_NUM_001",
"InvoicingRule": "CPQ_SCH_NUM_001",
"BillingTransactionTypeName": "CPQ_SCH_NUM_001",
"PaymentTermsCode": "CPQ_SCH_NUM_001",
"TransactionLineType": "Buy",
"OrderedUOM": "Each",
"PurchasingUOMCode": "Ea",
"OrderedQuantity": 1,
"ServiceDuration": 1,
"ServiceDurationPeriodName": "YEAR",
"ContractStartDateTime": "2020-10-01",
"ContractStartEndDateTime ": "2021-09-30",
"SubscriptionProfileName": "Subs_Profile",
"ExternalPriceBookName": "CPQ_Price_List",
"billingPlans": [
{
"BillingNumberOfPeriods": 12,
"BillingPlanTypeCode": "PERIODIC",
"PeriodicityCode": "MONTH",
}
]
''charges" : [
{
"SourceChargeId": "C1-OT",
"ApplyTo": "Price",
"PriceType": "One_time",
ここでは、billingPlansエンティティに"PeriodicityCode": "MONTH"があり、正常に動作します。 ただし、"PeriodicityCode": "ONE TIME"は失敗します。