サブスクリプション対象請求明細データのインポート
インポート管理を使用して、サブスクリプション対象請求明細レコードを作成または更新できます。
サブスクリプション対象請求明細レコードをインポートするには、次のタスクを実行します:
-
ソース・データをOracle Applications Cloudオブジェクト属性にマップします。
-
インポート用のソース・カンマ区切り値(CSV)ファイルを作成します。
-
インポート・アクティビティを作成します。
-
インポート結果をレビューします。
ソース・データのターゲット・オブジェクト属性へのマップ方法
サブスクリプション対象請求明細データをOracle Applications Cloudにインポートするには、CSVファイルにソース・データを移入し、そのソース・データをOracle Applications Cloudのターゲット・オブジェクト属性にマップする必要があります。
データ・インポート用のCSVファイルを作成する前に、次の手順を実行する必要があります。
-
ソース・データ属性がOracle Applications Cloudのターゲット・オブジェクト属性にマップする方法を確認します。
-
前提条件の設定が実行されていることを確認します(該当する場合)。
-
レコードを一意に識別するためのオプションを理解します。
-
子レコードをインポートする前に、親レコードが存在することを確認します。
-
正常にインポートするためにCSVファイルに必要なターゲット・オブジェクト属性を識別します。
開始する前に
インポートを開始する前に、いくつかの基本チェックを行う必要があります。 たとえば、次のことを確認してください。
-
ソース・データの各属性のインポートの前提条件がすべて完了している。
-
子レコードをインポートする前に、すべての親レコードを配置しておく。
レコードに対する一意の識別子の選択
Oracle Applications Cloudにデータをインポートするには、インポート・プロセスがレコードを一意に識別するための特定の属性がCSVファイルに含まれている必要があります。 ファイル・インポート・プロセスは、属性値を使用して、ソース・データをOracle Applications Cloudのターゲット・オブジェクト属性に自動的にマップします。
オブジェクト・レコードを一意に識別するための優先オプションは、公開一意識別子を使用することです。 新しいレコードを作成する場合は、わかりやすい公開一意識別子(数値で示され、通常はビジネス・オブジェクトのUIに表示される属性)を指定できます。 以前に番号属性を指定したレコード、または番号属性がオブジェクトのUIに表示されるレコードを更新する場合は、番号属性を使用してレコードを識別できます。 サブスクリプション対象請求明細オブジェクトの場合、属性は次のとおりです:
-
CoveredLevelPuid
-
BillLinePuid
-
TransactionNumber
-
NewCreditMemoPUID
サブスクリプション対象請求明細オブジェクトの必須属性および検証
Oracle Applications Cloudにデータを正常にインポートするには、CSVファイルに必須属性が含まれている必要があります。 属性に有効な値が指定されていることを確認します。 この表は、新規サブスクリプション対象請求明細レコードのインポートに必要な属性、サブスクリプション対象請求明細レコードの更新に必要な属性、属性の前提条件設定タスク、およびサブスクリプション対象請求明細インポートの特定の検証(ある場合)を示しています:
属性 |
説明 |
前提条件の設定タスクやインポート検証 |
サブスクリプション対象請求明細レコードの作成 |
既存のサブスクリプション対象請求明細レコードの更新 |
---|---|---|---|---|
BillLineId |
請求明細ID |
値を渡さない |
不要 |
不要 |
BillingPeriod |
請求期間 |
これは正の数で、製品に対して一意である必要があります。 |
必須 |
不要 |
DateToInterface |
インタフェースする日付 |
これは有効な日付である必要があります。 |
不要 |
不要 |
DateBilledFrom |
請求が開始する日付 |
これは有効な日付である必要があります。 |
必須 |
不要 |
DateBilledTo |
請求が有効になる日付 |
これは有効な日付である必要があります。 |
必須 |
不要 |
RecurringFlag |
この明細が繰返しかどうかを示すオプション |
YまたはN |
必須 |
不要 |
InterfacedFlag |
請求明細がインタフェースされているかどうかを示すオプション |
YまたはN |
必須 |
不要 |
CoveredLevelId |
対象レベルID |
値を渡さないでください。 |
不要 |
不要 |
CoveredLevelPuid |
対象レベルPUID |
有効な対象レベルPUIDである必要があります。 |
必須 |
不要 |
BillLinePuid |
請求明細PUID |
これは一意の請求明細PUIDである必要があります。 |
必須 |
必須 |
SubscriptionId |
サブスクリプションID |
値を渡さないでください。 |
不要 |
不要 |
SubscriptionProductId |
サブスクリプション製品ID |
値を渡さないでください。 |
不要 |
不要 |
ChargeId |
手数料ID |
これは有効な手数料IDである必要があります。 |
必須 |
不要 |
Amount |
金額 |
これは正の数である必要があります。 |
必須 |
不要 |
UsageFlag |
明細が使用明細かどうかを示すオプション |
YまたはN |
必須 |
不要 |
UsageAcquiredFlag |
使用状況が取得されたかどうかを示すオプション |
YまたはN |
不要 |
不要 |
UsagePricedFlag |
使用明細が価格設定されているかどうかを示すオプション |
YまたはN |
不要 |
不要 |
TransactionClass |
トランザクション区分 |
これは、請求書の場合はINV、クレジット・メモの場合はCMである必要があります。 |
必須 |
不要 |
TransactionTax |
トランザクション税金 |
これは正の数である必要があります。 |
不要 |
不要 |
TransactionAmount |
トランザクション金額 |
これは正の数である必要があります。 |
不要 |
不要 |
InvoiceBillLineId |
請求書請求明細ID |
値を渡さないでください。 |
不要 |
不要 |
UsageCaptureDate |
使用取得日 |
これは有効な日付である必要があります。 |
不要 |
不要 |
UsageQuantity |
使用数量 |
これは正の数である必要があります。 |
不要 |
不要 |
ChargePeriod |
課金期間 |
これは有効な課金期間である必要があります。 |
不要 |
不要 |
PricingError |
価格設定エラー |
値を渡さないでください。 |
不要 |
不要 |
ListPrice |
定価 |
これは、TransactionClassがINVの場合は正の数で、CMの場合は数値である必要があります。 |
必須 |
不要 |
RevenueLineId |
売上明細ID |
値を渡さないでください。 |
不要 |
不要 |
TransactionClassMeaning |
トランザクション区分参照の意味 |
請求書またはクレジット・メモ |
不要 |
不要 |
InvoiceDate |
請求書日付 |
これは有効な日付である必要があります。 |
不要 |
不要 |
NewCreditMemoPUID |
クレジット・メモPUID |
値を渡さないでください。 |
不要 |
不要 |
CreditMemoAmount |
クレジット・メモ金額 |
値を渡さないでください。 |
不要 |
不要 |
CreditMemoFlag |
クレジット・メモ・オプション |
値を渡さないでください。 |
不要 |
不要 |
CreditMemoReason |
クレジット・メモ事由 |
値を渡さないでください。 |
不要 |
不要 |
CustomerTrxTypeSequenceId |
顧客トランザクション・タイプ連番ID |
これは数値である必要があります。 |
不要 |
不要 |
インポート管理フローの「インポート・オブジェクトの管理」ページで、サブスクリプション対象請求明細オブジェクトとそのすべての子オブジェクトおよび属性を表示できます。 タイプ、長さ、説明などの属性情報をこのページで確認できます。
ソースCSVファイルの作成
Sales and Fusion ServiceにインポートするデータをソースCSVファイルに含めます。
「インポート・オブジェクト」UIページで使用可能なテンプレートを使用して、ソースCSVファイルを作成できます。 テンプレートをダウンロードするには:
-
に移動します。
-
表内の「サブスクリプション対象請求明細」オブジェクトを選択し、「ダウンロード」をクリックします。
これで、ダウンロードされたファイルを編集し、必要な属性に有効な値を指定できます。
インポート・アクティビティの作成
CSVファイルの準備が完了したら、インポート・アクティビティを作成して情報をインポートします。 インポート・アクティビティを作成するには:
-
に移動します。
-
「インポートの管理」ページで「インポート・アクティビティの作成」をクリックします。
-
「インポート・オプションの入力」ページで、インポート・アクティビティの名前を指定し、「オブジェクト」ドロップダウン・リストからサブスクリプション対象請求明細を選択します。
-
「ファイル名」フィールドでCSVファイルを選択し、「次」をクリックします。
-
ソース属性とターゲット属性が「フィールドのマップ」ページに自動的にマップされていることがわかります。 必要に応じてマッピングをレビューおよび編集します。
-
「データの検証」をクリックして、マップされていない列、またはデータ形式の問題があるかどうかについてファイルを確認します。 「次」をクリックします。
-
「レビューおよび発行」ページでインポート詳細をレビューし、準備ができたら「発行」をクリックします。
インポート結果のレビュー
「インポートの管理」ページでインポートが成功したかどうかを確認します。 このページには、すべてのアクティブなインポート、完了したインポートおよび失敗したインポートのステータスが表示されます。 インポート・アクティビティのステータスをチェックするには:
-
に移動します。
-
「すべてのインポート」をクリックし、以前に作成したインポート・アクティビティを検索します。
-
インポート・アクティビティの「ステータス」列をチェックします。 ステータスが「完了」と表示された場合、インポートは成功です。 インポート・アクティビティをドリルダウンして、インポート・アクティビティのステータス詳細を示す「インポート・ステータス」ページに移動できます。