Oracle Service Contracts Import Scope and Limitations
Oracle Service Contracts Import Scope and Limitations
Scope: Bulk import all types of Service contracts. Import all type of covered levels. Import contracts in different status types (Entered, Canceled, Signed, Active, Expired) Import of Sales person, Contract Administrator at the header level. Import of customer Billing contact for the lines is possible. Ability to associate a contract with only one contract group Import of sales credits for the contract header. Import of only Fully billed of Fully Unbilled contracts. Import of Standard coverage alone is possible. Instantiation of counters for imported contracts Import only Intangible Subscription contracts. Import of header Notes is possible
Limitations: Import of contracts in the status (Terminated, QA Hold) are not supported Contract versions will not be imported Contract Auto-numbering will not be supported Importing sales credits at the line level is not possible. Import of Attachments is not possible Importing Mutiple contract groups is not possible Imported contracts can have a maximum of 3 billing streams. Partially billed contracts cannot be imported The fully billed imported contracts will not have any billing details (no invoice information) Import of customized coverage is not possible. Import of Fulfillment schedules for tangible subscription is not possible. Import of manual price adjustments is not possible Tax calls will not be made. Tax information should be specified in the interface table Defaulting the attributes from the contract template is not possible Importing lines /sublines to existing service contracts is not possible. Defaulting the Contract group, QA checklist, Approval Work flow from the GCD while importing is not possible. Import of contracts with Sales Order details is not possible. Importing Service contracts with Credit cards is not possible. No flex fields will be imported Billing of new lines/Sublines added to the fully billed contract is not possible. Credit upon termination of fully billed contracts is not possible, because of the lack of billing information.
Process 1. Populate interface tables. Apart from the relevant columns that contain contract information, populate a unique batch id in the batch_id column 2. Run Service Contracts Import program with batch id, mode,number of workers,commit size as input. 3. Run the program in Validate only mode . 4. Review the output/log file which summarize the successful and failed records. 5. Re-run the Program in Import Mode to get the data into the base tables 6. Review the imported contract in the Authoring Form 7. Run the Service Contracts import Purge Program to purge the Successful records.
Concurrent Programs: Service Contracts import Program: This program does the validation and import of the interface table data to our base tables. Parameters:
Sr. No. 1 2 3 Parameter Descriptioon
Service Contracts Import Purge: This program can be run to purge the successfully processed records. Parameters:
Sr. No. 1 2 Parameter Descriptioon
Architecture
1
AD Parallel framework Identify Con-current Work Units
Validation
Attribute Level validation (bulk) Spawn Multiple Workers Entity validation (bulk) Assign Work Unit to each Worker Cross entity validation (bulk)
Validation Bulk validation against interface table for each attributes, entity, cross entity (possibility of merging related attributes)
Processing
Fisrt validation will insert into staging table with proper error flag Subsequent validation will update the error flag of the corresponding record in staging table
1
Amount & Tax rollup
3
Error Logging Log errors to error table
Load / Insert
Flag Error Records on Interface Tables Rollup Errors to Contract Header Level and update interface table.
Bulk Create Contract Header, Party Roles, Contacts, Sales Credit, K Group etc
Processing
Bulk Create Lines for Service, Warranty, Ext-warranty, Subscription, Usage etc
Load / Insert
Bulk Create Covered Levels, usage counters Create billing & PM Schedule, subscription fulfillment etc
Post Processing
4 4
Usage
Subscription
Cov Levsls
Usage Counters
List of Interface Tables: OKS_HEADERS_INTERFACE This table must be populated with all Header details,along with the batch number.Header_interface_id is the primary key to all the other interface tables. OKS_LINES_INTERFACE This table must be populated with the line details,with proper header_interface_id . Line_interface_id is the primary key.Populate the Header_interface_id from oks_headers_interface. OKS_COVERED_LEVELS_INTERFACE This table should be populated with all covered level details.covered_level_interface_id is the primary key.Populate line_interface_id from the oks_lines_interface. OKS_USAGE_COUNTERS_INTERFACE This table must be populated with the counter details. Usage_counter_interface_id is the primary key for this table.Line_interface_id must be populated from oks_lines_interface. OKS_SALES_CREDITS_INTERFACE This should be populated with the sales credit details.sales_credits_interface_id being the primary key.Header_interface_id should correspond to the oks_headers_interface OKS_NOTES_INTERFACE Populate this table with required notes information. Notes_interface_id is the primary key.The header_interface_id and line_interface_id should be populated corresponding to the header_interface_id of the oks_headers_interface table and line_interface_id from the oks_lines_interface.
Headers_interface_id
OKS_HEADERS_INTERFACE OKS_SALE_CREITS INTERFACE
Headers_interface_id
Headers_interface_id
OKS_NOTES INTERFACE
Line_ Interface_id
Line_interface_id OKS_LINES_INTERFACE
Line_interface_id
OKS_COVERED EVELS_INTERFACE
OKS_HEADERS_INTERFACE
Primary Key: OKS_HEADERS_INTERFACE_PK
HEADER_INTERFACE_ID
Unique Index: OKS_HEADERS_INTERFACE_U1
HEADER_INTERFACE_ID
Not Unique Index: OKS_HEADER_INTERFACE_N1
BATCH_ID
Columns
CATEGORY
Lengt Optionalit Comment h y NOT NUMBER Primary Key NULL VARCHAR NOT 120 Contract Number 2 NULL VARCHAR Contract Number 120 NULL 2 modifier Contract Category. Possible values are VARCHAR NOT 30 SUBSCRIPTION 2 NULL , SERVICE or WARRANTY NOT DATE Contract start date NULL NOT DATE Contract end date NULL VARCHAR NOT Contract status 240 2 NULL code. VARCHAR 300 NULL Known as 2 VARCHAR NOT Contract 1995 2 NULL description NOT NUMBER Operating Unit NULL VARCHAR Customer Party 360 NULL 2 Name VARCHAR 30 NULL Customer Party 2 Datatype
CUSTOMER_PARTY_ID THIRD_PARTY_NAME THIRD_PARTY_NUMBER THIRD_PARTY_ID BILL_TO_SITE_USAGE_CODE BILL_TO_SITE_USAGE_ID SHIP_TO_SITE_USAGE_CODE SHIP_TO_SITE_USAGE_ID SALESPERSON_NAME SALESPERSON_ID SALESGROUP_ID
NUMBER VARCHAR 360 2 VARCHAR 30 2 NUMBER VARCHAR 40 2 NUMBER VARCHAR 40 2 NUMBER VARCHAR 360 2 NUMBER NUMBER
NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NOT NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL
Customer Id Third Party Name Third Party Number Third Party Not supported Bill to site usage id Not supported Ship to usage id Sales Person Sales Person ID Sales Group ID Customer Contract administrator Customer Contract Administrator Contract Currency code Currency Conversion Type Currency Conversion Rate Currency Conversion Date Agreement Name Agreement Id Price List Name Price List Id Payment Terms Payment Terms Id Payment Instruction Po Required
CUSTOMER_CONTRACT_ADMIN_NAM VARCHAR 360 E 2 CUSTOMER_CONTRACT_ADMIN_ID CONTRACT_CURRENCY_CODE CURRENCY_CONVERSION_TYPE CURRENCY_CONVERSION_RATE CURRENCY_CONVERSION_DATE AGREEMENT_NAME AGREEMENT_ID PRICE_LIST_NAME PRICE_LIST_ID PAYMENT_TERMS_NAME PAYMENT_TERMS_ID PAYMENT_INSTRUCTION PO_REQUIRED NUMBER VARCHAR 15 2 VARCHAR 30 2 NUMBER DATE VARCHAR 240 2 NUMBER VARCHAR 240 2 NUMBER VARCHAR 15 2 NUMBER VARCHAR 3 2 VARCHAR 3
PAYMENT_INSTRUCTION_DETAILS PAYMENT_METHOD_CODE COMMITMENT_ID TAX_EXEMPTION_CONTROL TAX_EXEMPTION_NUMBER BILL_SERVICES BILLING_TRANSACTION_TYPE_ID ACCOUNTING_RULE_NAME ACCOUNTING_RULE_ID INVOICING_RULE_NAME INVOICING_RULE_ID HOLD_CREDITS SUMMARY_PRINT SUMMARY_TRANSACTIONS SERVICE_CHRG_PREPAY_REQ SERVICE_CHARGES_PO_REQUIRED SERVICE_CHARGES_PO_NUMBER RENEWAL_PROCESS APPROVAL_REQUIRED RENEW_UP_TO PRICING_METHOD RENEWAL_PRICE_LIST_NAME
2 VARCHAR 150 2 VARCHAR 30 2 NUMBER VARCHAR 30 2 VARCHAR 80 2 VARCHAR 1 2 NUMBER VARCHAR 30 2 NUMBER VARCHAR 30 2 NUMBER VARCHAR 1 2 VARCHAR 1 2 VARCHAR 1 2 VARCHAR 1 2 VARCHAR 2 VARCHAR 2 VARCHAR 2 VARCHAR 2 DATE VARCHAR 30 2 VARCHAR 240 2 1 240 30 30
NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL
Payment Instruction Details Payment Method Code Commitment ID Tax Status Tax Exemption Number AR Interface flag Inventory Transaction type. Accounting Rule Accounting Rule ID Invoicing Rule Invoicing Rule ID Hold credits Inventory Print Profile Summary Transaction. Service Charges Prepay Required flag Service PO required flag Service PO Number Renewal Type Code Approval Type Renew up to date Renewal Pricing Method Renewal Price List Name
RENEWAL_PRICE_LIST_ID RENEWAL_MARKUP RENEWAL_BILLING_PROFILE_ID RENEWAL_PO_NUMBER RENEWAL_PO_REQUIRED RENEWAL_GRACE_DURATION RENEWAL_GRACE_PERIOD RENEWAL_ESTIMATED_PERCENT RENEWAL_ESTIMATED_DURATION RENEWAL_ESTIMATED_PERIOD QUOTE_TO_PARTY_SITE QUOTE_TO_CONTACT QUOTE_TO_PHONE QUOTE_TO_FAX QUOTE_TO_EMAIL DATE_APPROVED DATE_SIGNED DATE_CANCELED CANCELLATION_REASON GRACE_DURATION GRACE_PERIOD ESTIMATION_PERCENT ESTIMATION_DATE FOLLOW_UP_DUE_DATE FOLLOW_UP_ACTION
NUMBER NUMBER NUMBER VARCHAR 240 2 VARCHAR 1 2 NUMBER VARCHAR 30 2 NUMBER NUMBER VARCHAR 30 2 NUMBER NUMBER NUMBER NUMBER NUMBER DATE DATE DATE VARCHAR 30 2 NUMBER VARCHAR 30 2 NUMBER DATE DATE VARCHAR 30 2
NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL
Renewal Price List ID Markup % Billing Profile ID Renewal PO Number Renewal PO Required flag Renewal grace duration Renewal Grace Period Renewal Estimated Percent Renewal Estimated Duration Renewal Estimated Period Quote to party site id Quote To Contact Quote To Phone Number Quote To Fax number Quote To Email Approval Date Signed Date Canceled date Cancellation Reason Code Grace Duration Grace Period Estimated Percent Estimation Date Follow up due date Follow up action
QA_CHECKLIST CONTRACT_GROUP_NAME CONTRACT_GROUP_ID APPROVAL_PROCESS_ID FULLY_BILLED SOURCE DOCUMENT INTERFACE_STATUS INV_ORGANIZATION_ID EXEMPT_REASON_CODE BATCH_ID PARENT_REQUEST_ID
NUMBER VARCHAR 150 2 NUMBER NUMBER VARCHAR 1 2 VARCHAR 80 2 VARCHAR 240 2 VARCHAR 1 2 NUMBER VARCHAR 30 2 NUMBER NUMBER
NULL NULL NULL NULL NOT NULL NULL NULL NULL NULL NULL NOT NULL NULL
QA Checklist Contract group name Contract Group Approval process used Fully Billed Source Document E=Error, S=Success, R=Reprocess Inventory Organization Id Exempt Reason Code Batch Number Request Id to be stamped by the import process
OKS_LINES_INTERFACE:
Primary Key: OKS_LINES_INTERFACE_PK
LINE_INTERFACE_ID
Unique Index: OKS_LINES_INTERFACE_U1
LINE_INTERFACE_ID
Not Unique Index: OKS_LINES_INTERFACE_N1
HEADER_INTERFACE_ID
Columns
Name
Datatype
Length Optionality
Comment
LINE_INTERFACE_ID HEADER_INTERFACE_ID LINE_NUMBER LINE_TYPE ITEM_ORGANIZATION_ID ITEM_NAME ITEM_ID REFERENCE_TEMPLATE_ID LINE_REFERENCE STATUS_CODE START_DATE END_DATE BILL_TO_SITE_USAGE_CODE BILL_TO_SITE_USAGE_ID SHIP_TO_SITE_USAGE_CODE SHIP_TO_SITE_USAGE_ID BILLING_CONTACT_NAME BILLING_CONTACT_ID SHIPPING_CONTACT_NAME SHIPPING_CONTACT_ID RENEWAL_TYPE_CODE CANCELLATION_DATE CANCELLATION_REASON PRICE_LIST_NAME PRICE_LIST_ID INVOICE_TEXT PRINT_INVOICE SUBTOTAL
NUMBER NUMBER NUMBER VARCHAR2 25 NUMBER VARCHAR2 800 NUMBER NUMBER VARCHAR2 300 VARCHAR2 30 DATE DATE VARCHAR2 40 NUMBER VARCHAR2 40 NUMBER VARCHAR2 360 NUMBER VARCHAR2 360 NUMBER VARCHAR2 30 DATE VARCHAR2 30 VARCHAR2 240 NUMBER VARCHAR2 2000 VARCHAR2 1 NUMBER
NOT NULL NOT NULL NULL NOT NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL
Primary Key Header Interface ID Line Number Line Type Item Organization Item Name Item Id Coverage ID Line Reference Status Line start date Line end date Bill to site usage code Bill to site usage id Ship to site usage code Ship to site usage id Billing contact name Billing contact id Shipping Contact Name Shipping Contact Id Renewal Type Code Cancellation Date Cancellation Reason Price List Name Price List Id Invoice Text Print Invoice Subtotal to be populated for Subsciption lines Tax Amount to be populated for Subsciption lines
TAX_AMOUNT
NUMBER
NULL
NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL
PAYMENT_INSTRUCTION_DETAILS VARCHAR2 150 PAYMENT_METHOD_CODE COMMITMENT_ID ACCOUNTING_RULE_NAME ACCOUNTING_RULE_ID INVOICING_RULE_NAME INVOICING_RULE_ID BILLING_INTERVAL_DURATION BILLING_INTERVAL_PERIOD FIRST_BILL_UPTO_DATE EXEMPT_REASON_CODE RECUR_BILL_OCCURANCES SUBSCRIPTION_QUANTITY VARCHAR2 30 NUMBER VARCHAR2 30 NUMBER VARCHAR2 30 NUMBER NUMBER VARCHAR2 30 DATE VARCHAR2 30 NUMBER NUMBER
Tax Exemption Control Tax Exemption Number Tax Classification Code Payment Instruction Po Required Payment Instruction Details Payment Method Code Commitment Id Accounting Rule Accounting Rule Id Invoicing Rule Name Invoicing Rule Id Billing Interval Duration Billing Interval Period First Bill Upto Date Exempt Reason Code Frequency Subscription Quantity to be populated for Subsciption lines Subscription quantity unit of measure code to be populated for Subsciption lines Subscription price unit of measure code to be populated for Subsciption lines Subscription unit price to be populated for Subsciption lines Subscription first bill amount to be populated for Subsciption lines Subscription last bill amount to be populated for Subsciption lines
QUANTITY_UOM
VARCHAR2 3
NULL
PRICE_UOM
VARCHAR2 3
NULL
UNIT_PRICE
NUMBER
NULL
FIRST_BILLED_AMOUNT
NUMBER
NULL
LAST_BILLED_AMOUNT
NUMBER
NULL
Usage Type Usage Period Averaging Interval Settlement Interval Usage Termination Method
OKS_COVERED_LEVELS_INTERFACE:
Primary Key: OKS_COVERED_LEVEL_INTERFACE_PK
COVERED_LEVEL_INTERFACE_ID
Unique Index: OKS_COVERED_LEVEL_INTERFACE_U1
COVERED_LEVEL_INTERFACE_ID
Not Unique Index: OKS_COVERED_LEVEL_INTERFACE_N1
LINE_INTERFACE_ID
Columns
Name
Datatype
COVERED_LEVEL_INTERFACE_ID NUMBER LINE_INTERFACE_ID LINE_NUMBER COVERED_SERIAL_NUMBER COVERED_INSTANCE_NUMBER COVERED_INSTANCE_ID COVERED_ITEM_NAME COVERED_ITEM_ID COVERED_ITEM_ORG_ID COVERED_SYSTEM_ID COVERED_ACCOUNT_NUMBER COVERED_ACCOUNT_ID COVERED_SITE_NUMBER NUMBER NUMBER
Length Optionality Comment NOT Primary Key NULL NOT Line Interface ID NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL Line Number Serial Number Instance Number Instance Id Item Name Item Id Item Organization System Id Account Number Account Id Site Number
VARCHAR2 30 VARCHAR2 30 NUMBER VARCHAR2 800 NUMBER NUMBER NUMBER VARCHAR2 30 NUMBER VARCHAR2 30
COVERED_SITE_ID COVERED_PARTY_NAME COVERED_PARTY_NUMBER COVERED_PARTY_ID LINE_REFERENCE STATUS_CODE START_DATE END_DATE RENEWAL_TYPE_CODE CANCELLATION_DATE CANCELLATION_REASON INVOICE_TEXT PRINT_INVOICE QUANTITY_COVERED QUANTITY_UOM PRICE_UOM SUBTOTAL TAX_AMOUNT FIRST_BILL_AMOUNT LAST_BILL_AMOUNT
NUMBER VARCHAR2 360 VARCHAR2 30 NUMBER VARCHAR2 300 VARCHAR2 30 DATE DATE VARCHAR2 30 DATE VARCHAR2 30 VARCHAR2 2000 VARCHAR2 1 NUMBER VARCHAR2 3 VARCHAR2 3 NUMBER NUMBER NUMBER NUMBER
NULL NULL NULL NULL NULL NOT NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL
Site Id Party Name Party Number Party Id Line Reference Status Line Start Date Line End Date Renewal Type Cancellation Date Cancellation reason Invoice text Invoice Print flag Covered quantity Covered quantity unit of measure code Price unit of measure code Subtotal Tax amount First bill amount Last bill amount
OKS_USAGE_COUNTERS_INTERFACE:
Primary Key: OKS_USAGE_COUNTERS_INTERFACE
USAGE_COUNTER_INTERFACE_ID
Unique Index: OKS_USAGE_COUNTER_INTERFACE_U1
USAGE_COUNTER_INTERFACE_ID
Not Unique Index: OKS_USAGE_COUNTER_INTERFACE_N1
LINE_INTERFACE_ID
Columns
Name
Datatype
USAGE_COUNTER_INTERFACE_ID NUMBER LINE_INTERFACE_ID LINE_NUMBER COUNTER_ID LINE_REFERENCE STATUS_CODE START_DATE END_DATE RENEWAL_TYPE_CODE CANCELLATION_DATE CANCELLATION_REASON INVOICE_TEXT PRINT_INVOICE SUBTOTAL TAX_AMOUNT FIXED_USG_CNT MINIMUM_USG_CNT DEFAULT_USG_CNT FILL_YN ESTIMATION_METHOD ESTIMATION_START_DATE LEVEL_YN NUMBER NUMBER NUMBER
Length Optionality Comment NOT Primary Key NULL NOT Line Interface Id NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL NULL Line Number Counter Id Line Reference Status Code Start Date End Date Renewal Type Cancellation date Cancellation Reason Code Invoice Text Invoice Print Flag (Y or N) Subtotal Tax Amount Fixed Minimum Default Fill 'Y'/ 'N' Estimation method Estimation start date Level
VARCHAR2 300 VARCHAR2 30 DATE DATE VARCHAR2 30 DATE VARCHAR2 30 VARCHAR2 2000 VARCHAR2 1 NUMBER NUMBER NUMBER NUMBER NUMBER VARCHAR2 1 VARCHAR2 30 DATE VARCHAR2 1
OKS_SALES_CREDITS_INTERFACE:
Primary Key: OKS_SALES_CREDITS_INTERFACE_PK
SALES_CREDIT_INTERFACE_ID
Unique Index: OKS_SALES_CREDITS_INTERFACE_U1
SALES_CREDIT_INTERFACE_ID
Not Unique Index: OKS_SALES_CREDITS_INTERFACE_N1
HEADER_INTERFACE_ID
Columns
Name
Datatype
Length Optionality
Comment
SALES_CREDIT_INTERFACE_ID NUMBER HEADER_INTERFACE_ID SALESPERSON_NAME SALESPERSON_ID SALESGROUP_ID SALES_CREDIT_TYPE PERCENT NUMBER VARCHAR2 150 NUMBER NUMBER VARCHAR2 40 NUMBER
NOT NULL Primary Key NOT NULL Header interface id NULL NULL NULL NULL NULL Sales person name Sales person id Sales group id Sales credit type Percent
OKS_NOTES_INTERFACE:
Primary Key: OKS_NOTES_INTERFACE_PK
NOTES_INTERFACE_ID
Unique Index: OKS_NOTES_INTERFACE_U1
NOTES_INTERFACE_ID
Not Unique Index: OKS_NOTES_INTERFACE_N1
HEADER_INTERFACE_ID
Not Unique Index: OKS_NOTES_INTERFACE_N2
LINE_INTERFACE_ID
Columns
Name NOTES_INTERFACE_ID
Datatype NUMBER
Comment
NULL HEADER_INTERFACE_ID NUMBER NULL Foreign Key reference to OKS_HEADERS_INTERFACE. HEADER_INTERFACE_ID Foreign Key reference to OKS_LINES_INTERFACE. LINE_INTERFACE_ID Notes Additional details for notes. Indicates whether the note is Public, Private or Publish. Foreign Key reference to JTF_NOTE_STATUS Type of Note. Foreign Key reference to JTF_NOTE_TYPE FND User who created the note Date on which the FND User created the note
NOTE_STATUS
VARCHAR2 1
NULL