HR to ERP
Oracle HCM Cloud to SAP S/4HANA integration: workers from Oracle as employees and business partners in S/4HANA
With an integration between Oracle HCM Cloud and SAP S/4HANA, every employee from Oracle appears in S/4HANA automatically, with work agreement, company code and cost centre, and with the business partner that purchasing and expenses need. A hire that is cancelled or a departure in Oracle also takes effect in S/4HANA, so no active employees remain who are not there.
What the integration does
Organisations with Oracle HCM Cloud as HR system and SAP S/4HANA for finance and purchasing upload employees into S/4HANA by hand or have finance create them. A candidate who does not show up on day one stays in S/4HANA, and a transfer in Oracle only reaches the cost centre in SAP after weeks.
- Oracle HCM publishes a hire, assignment change or termination in an Atom feed.
- KoppelHet looks up the worker through the REST API and translates legal employer and department into company code and cost centre.
- KoppelHet sends the employee to the S/4HANA replication API.
- KoppelHet checks whether both the employee and the business partner succeeded in S/4HANA, and reports errors to HR or finance.
- A termination or cancelled work relationship sets the work agreement in S/4HANA to inactive.
What to watch for with Oracle HCM Cloud and SAP S/4HANA
- Oracle HCM has a separate feed for a work relationship that is cancelled, for example when someone does not show up on the agreed start date or declines an offer. KoppelHet then sets the work agreement in S/4HANA to inactive from the start date, so no business partner remains that can receive orders or expenses.
- Replication in S/4HANA has two steps: first the employee data, then the synchronisation to the business partner. SAP states that both must succeed. KoppelHet checks both outcomes, because a successful call does not yet mean a usable business partner.
- Oracle HCM also publishes feeds for contingent workers and pending workers. In S/4HANA an external is a service performer, which requires a work order with supplier and validity. KoppelHet does not send pending workers, and contingent workers only if purchasing has recorded the supplier.
- Oracle's assignment feed also fires on a salary change. S/4HANA needs no salary for purchasing and expenses; KoppelHet compares the fields that go to SAP and only sends when legal employer, department or manager has actually changed.
- A new hire with a future start date already appears in Oracle's feed. KoppelHet sends that employee to S/4HANA straight away with the right effective date, so purchasing and travel costs work from the first working day.
- A global transfer in Oracle opens a new work relationship with another legal employer. In S/4HANA that is another company code. KoppelHet ends the old work agreement and sends the new one for the same person, so finance keeps one business partner.
How we build and run it
- The integration runs on the KoppelHet platform, hosted in a data centre in the EU.
- Every sync and every error is visible in the functional log; on an error your administrator is notified.
- A change that cannot go through is not half-applied but queued for another attempt.
- KoppelHet is ISO 27001 certified. Data travels encrypted and stays on the platform no longer than needed.
- After go-live we manage the integration and adjust it when your process changes.
- The integration fits next to your existing integration layer. Only the fields in the design are transferred; the platform keeps no register of its own.
Implementation and price
This is not an app you switch on. We build the integration for your organisation on our platform, with building blocks we reuse on every project. So it is custom work that does not start from scratch.
A consultant prepares the intake and analyses both systems. We then record the mapping and exceptions field by field, test in the test or acceptance environment and go live at a moment you choose. Costs are a one-off amount for the setup and a monthly amount for platform, monitoring and support.
Frequently asked questions
Does salary from Oracle go to S/4HANA?
No. For purchasing, expenses and approvals, work agreement, company code and cost centre are enough. The payroll journal is a separate integration.
Does this also work with S/4HANA on-premise?
This page assumes S/4HANA Cloud Public Edition. For on-premise we choose the interface that fits the release at the start.
Technical details for IT
For those who want to know how it works under the hood: APIs, fields and sources used.
- Oracle HCM Cloud through the employee Atom feeds (/hcmRestApi/atomservlet/employee/ newhire, empassignment, empupdate, termination, cancelworkrelship, workrelshipupdate) and the workers REST resource with workRelationships, assignments and names.
- SAP S/4HANA Cloud Public Edition through the SOAP API Replicate Basic Master Data for Workforce from External HR Systems (WORKFORCEPERSONMASTERDATAREPLI), scope item 1FD, communication arrangement SAP_COM_0301. Errors in the response or in Message Monitoring. A service performer requires a WorkOrder with ValidityPeriod and Supplier.
Which fields are transferred
The key fields. The full mapping is agreed per customer.
| Field in Oracle HCM Cloud | Field in SAP S/4HANA | Notes |
|---|---|---|
PersonNumber | PersonExternalID | |
AssignmentNumber | PersonWorkAgreementExternalID | |
Names (FirstName, LastName) | Naam van de persoon | |
Work email | E-mailadres | |
LegalEmployerName | Bedrijfscode | Through a table from legal employer to company code |
DepartmentName | Kostenplaats | Through a table finance maintains |
ManagerId | Manager | |
Termination of cancelworkrelship | Status inactief |
Related
Ashby → Oracle HCM Cloud
Ashby to Oracle HCM integration: an accepted offer on an opening becomes a pending worker
Bullhorn → Oracle HCM Cloud
Bullhorn to Oracle HCM integration: an approved placement of an employee becomes a pending worker
Carerix → Oracle HCM Cloud
Carerix to Oracle HCM integration: successful placement as a pending worker in Oracle HCM Cloud
Greenhouse → Oracle HCM Cloud
Greenhouse to Oracle HCM integration: accepted offer as a pending worker in Oracle HCM Cloud