CRM migration
Field-level mapping, validation, and rollback between Oracle EBS CRM and Nutshell. We move data and schema; workflows are rebuilt natively in Nutshell.
Oracle EBS CRM
Source
Nutshell
Destination
Compatibility
8 of 9
objects map 1:1 between Oracle EBS CRM and Nutshell.
Complexity
BStandard
Timeline
3-5 weeks
Overview
Moving from Oracle EBS CRM to Nutshell is a structural migration that extracts CRM data from the Oracle APPS schema — the same schema that houses financials, HR, and supply chain data — and lands it in a lightweight cloud CRM with a JSON-RPC API. There is no REST API for Oracle EBS CRM; we connect with read-only database credentials, enumerate the relevant base product tables, and run all extraction in parent-before-child order so that Nutshell's Account-Contact lookup chain resolves correctly. Oracle Workflows and Territory definitions do not migrate as code; we document them for the customer's admin to rebuild in Nutshell's automation tools. The migration is scoped to CRM records only, leaving the broader EBS suite intact.
Every standard and custom field arrives verified.
AI proposes the map; you confirm before any record moves.
Parent–child, lookups, and ownership stay linked.
Calls, emails, meetings — with original timestamps.
Documents, uploads, and inline notes move with the record.
Why teams make this switch
Leaving
What's pushing teams away
Choosing
What's pulling them in
Object mapping
Each row shows how a Oracle EBS CRM object lands in Nutshell, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
Oracle EBS CRM
Account / Customer
Nutshell
Account
1:1Oracle EBS Accounts are stored in the ARHZTARZ base tables and exposed through the APPS schema. We extract AR_CUSTOMERS and HZ_PARTIES with billing address, site use, and classification data. Account maps directly to Nutshell Account. The EBS customer number becomes a custom Account field for audit. We scope extraction to the CRM-relevant party rows and flag any Accounts that exist solely in financial modules so the customer can confirm they are in scope.
Oracle EBS CRM
Contact / Person
Nutshell
Person
1:1Contacts in EBS reside in the HR or AR schemas depending on whether they represent employees or external parties. We extract HZ_CONTACTS and HZ_PARTIES with relationship links preserved. Nutshell People records receive the contact name, email, phone, title, and address fields. The EBS party site address migrates as the Person's address. We resolve the Contact-to-Account link at migration time using the EBS customer account relationship.
Oracle EBS CRM
Opportunity (Collaborative Selling)
Nutshell
Deal
1:1Oracle EBS Opportunities are stored in the CZ (Collaborative Selling) schema or the deprecated ASF schema depending on the CRM module version deployed. We identify the correct schema at discovery, extract deal name, amount, stage, probability, close date, and owner. EBS opportunity stages map to Nutshell Deal stages, with stage names and probabilities stored as a configuration document before migration begins. Owner resolution uses the FND_USER email mapping.
Oracle EBS CRM
Territory
Nutshell
Team
1:1Oracle EBS Territory definitions are stored in AS_TERRITORIES and reference hierarchical org structures. We extract the territory hierarchy as a structured document listing parent-child relationships and assignment rules. Nutshell uses Teams (grouped by rep or region) as the equivalent access-control and assignment structure. The migration delivers a written territory-to-team mapping; the customer's admin rebuilds team membership in Nutshell because the two structures are conceptual rather than data-equivalent.
Oracle EBS CRM
Custom Object
Nutshell
Custom Fields / Linked Record
lossyCustom objects in Oracle EBS CRM are stored in user-defined tables within the base product schemas with FK columns pointing to core tables like RA_CUSTOMERS. We extract the DDL for each custom table, document the column-to-column and column-to-parent relationships, and map them to Nutshell custom fields (for scalar attributes) or linked Account/Person records (for one-to-many relationships). Custom object naming and field types are preserved in a schema document that the customer uses to configure Nutshell before migration begins.
Oracle EBS CRM
Sales Activity / Task
Nutshell
Activity
1:1Activities and tasks in EBS are stored across the deprecated Teleservice tables or the modern Interaction Center tables depending on the CRM module installed. We identify the correct schema at discovery, extract activity type, subject, date, owner, and the parent Contact or Account reference. Activities migrate to Nutshell Activity records with the original timestamp preserved for timeline ordering.
Oracle EBS CRM
Note / History
Nutshell
Note
1:1Notes and audit history in Oracle EBS CRM are stored in FZ_NOTES or the application-level audit trail as text blobs with timestamps and owner references. We extract the note body, creation date, and owner as a Note record linked to the parent Account or Person in Nutshell. Rich text formatting in EBS notes may flatten to plain text depending on the storage format encountered.
Oracle EBS CRM
Attachment
Nutshell
File Attachment
1:1Attachments in Oracle EBS CRM are stored as LOB data (BFILE or CLOB columns) or on the file system depending on the attachment configuration. We extract binary or BASE64-encoded blobs, map them to Nutshell file attachments linked to the parent Account or Person record. Very large attachments (over 10 MB per file) are flagged for the customer to handle outside the migration scope due to API payload constraints.
Oracle EBS CRM
User / Employee
Nutshell
User
1:1EBS users are employees sourced from the HR schema (PER_ALL_ASSIGNMENTS_F) with CRM-specific responsibilities assigned via FND_RESPONSIBILITIES. We extract FND_USER and FND_RESPONSIBILITY tables during discovery to produce an accurate user count and responsibility matrix. We resolve EBS users to Nutshell users by email. Any EBS user without a matching Nutshell account goes to a reconciliation queue for the customer's admin to provision before the migration runs.
| Oracle EBS CRM | Nutshell | Compatibility | |
|---|---|---|---|
| Account / Customer | Account1:1 | Fully supported | |
| Contact / Person | Person1:1 | Fully supported | |
| Opportunity (Collaborative Selling) | Deal1:1 | Fully supported | |
| Territory | Team1:1 | Fully supported | |
| Custom Object | Custom Fields / Linked Recordlossy | Fully supported | |
| Sales Activity / Task | Activity1:1 | Fully supported | |
| Note / History | Note1:1 | Fully supported | |
| Attachment | File Attachment1:1 | Fully supported | |
| User / Employee | User1:1 | Fully supported |
Gotchas + challenges
Platform-specific issues from each side, plus the pair-specific challenges that don't show up on either platform's page on its own.
Oracle EBS CRM gotchas
No native REST API for EBS CRM data extraction
APPS schema coupling spans CRM, ERP, and HR in one database
Premier Support for EBS 12.1 ended — Extended Support for 12.2 has a cost cliff
Oracle Workflow engine has no direct migration path to cloud CRM automation
Per-module licensing creates billing ambiguity at destination
Nutshell gotchas
Contact tier limits enforced on import
No bulk API endpoint requires paginated extraction
Email sequences not exportable via API
Foundation plan disables key sales features
Pair-specific challenges
Migration approach
Discovery and database access provisioning
We work with the customer's DBA to provision read-only database credentials scoped to the relevant CRM schemas (ARHZTARZ, HZ_, CZ, AS_, FZ_, FND_). We run discovery queries to enumerate Accounts, Contacts, Opportunities, custom tables, attachments, and the active Workflow and Territory definitions. We also extract FND_USER and FND_RESPONSIBILITY to establish the user count and responsibility matrix. The discovery output is a written scope document listing every object in scope, estimated row counts, and the EBS schema version (12.1 or 12.2) which determines support exposure.
Schema design and DDL review for custom objects
We review the DDL for any user-defined custom tables, document their column types, primary keys, and FK relationships to core CRM tables, and design the Nutshell custom field configuration for each. Custom scalar attributes become Nutshell custom fields; one-to-many relationships become linked Account or Person records. We produce a schema design document that the customer uses to configure Nutshell before data import begins, including any required picklist values, field lengths, and required-field decisions.
Sandbox migration and reconciliation
We run a full migration into a Nutshell trial or sandbox environment using production-like data volume to validate field mapping, parent-record resolution, and the Activity timeline ordering. The customer's RevOps lead spot-checks 25-50 records against the EBS source, verifies the Deal stage mapping, and confirms that the Territory-to-Team handoff document is accurate. Any mapping corrections are applied before production migration begins.
User provisioning and owner reconciliation
We extract every distinct EBS user referenced on Account, Contact, Deal, and Activity records and match by email against the Nutshell destination tenant's user list. Any EBS user without a matching Nutshell account is placed in a reconciliation queue for the customer's admin to provision. Migration cannot proceed past this step because OwnerId references are required on all standard records in Nutshell.
Production migration in dependency order
We run production migration in record-dependency order: Nutshell Users (manually provisioned and validated first), Accounts (from EBS AR_CUSTOMERS and HZ_PARTIES), People (with Account link resolved), Deals (with Owner resolved), Activities (Tasks and Notes with timestamps preserved), and Custom Objects last (because they often have lookups to standard objects). Each phase emits a row-count reconciliation report before the next phase begins. Attachments are extracted as BASE64 and uploaded to the corresponding Account or Person record.
Cutover, validation, and Workflow rebuild handoff
We freeze EBS CRM writes during cutover, run a final delta migration of any records modified during the migration window, then enable Nutshell as the system of record. We deliver the Workflow inventory and Territory-to-Team mapping document to the customer's admin team. We support a one-week hypercare window where we resolve any reconciliation issues raised by the sales team. We do not rebuild Oracle Workflows in Nutshell's automation tools inside the migration scope; that is a separate engagement.
Platform deep dives
Oracle EBS CRM
Source
Strengths
Weaknesses
Nutshell
Destination
Strengths
Weaknesses
Complexity grading
Standard CRM migration. 2 of 8 objects need a mapping; the rest are 1:1.
Overall complexity
Standard migration
Derived from compatibility, mapping clarity, API constraints, and data volume across Oracle EBS CRM and Nutshell.
Object compatibility
2 of 8 objects need a mapping; the rest are 1:1.
Field mapping clarity
Field mapping is derived from defaults — final spec confirmed during the sample migration.
Timeline complexity
8-object category — typical timelines run 2–7 days end-to-end.
API constraints
Oracle EBS CRM: Not applicable — direct database query, throttling depends on customer's DB server capacity and concurrent workload.
Data volume sensitivity
Oracle EBS CRM doesn't expose a bulk API — REST + parallelization used for high-volume runs.
Estimator
Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.
Step 1
Pick a category, then your source and destination platforms.
Category
FAQ
Answers to the questions buyers ask most during Oracle EBS CRM to Nutshell migration scoping. Not seeing yours? Book a call.
Walk through your Oracle EBS CRM to Nutshell migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave Oracle EBS CRM
Other ways to arrive at Nutshell
Ready when you are
Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.