Supported syncing
| Sync Type | Description | Supported Sync Modes | API documentation |
|---|---|---|---|
| Sales Orders | Sync data from any source to SAP S/4HANA as sales orders | Upsert, Update, Insert | Sales Orders |
For more information about sync modes, refer to the sync modes docs.
Connect to SAP S/4HANA
Go to the Destinations overview page and click the Add destination button. Select SAP S/4HANA and click Continue.
Choose the environment that you would like to connect to SAP S/4HANA in. This will be either Sandbox or Production.
For Sandbox environments, input your API key. You can find your sandbox API key in any of the API resource pages, such as this page for sales orders.
Make sure that your API key has read and write access to your SAP S/4HANA instance.
For Production environments, you will need to set up the following in your Communication Management app:
- Communication Users
- Communication Systems
- Communication Arrangements
Use these guides from SAP S/4HANA to create communication arrangements with the necessary permissions and a user:
- Maintaining communication users
- Creating communication arrangement
- Introductory guide to testing your API
Once you have completed setting up the above, enter the following fields to connect to SAP S/4HANA:
- Host: You can get this from the API environment that you can see in the communication arrangement you activated earlier. In your SAP S/4HANA URL, this is the first section of the URL after the
https://prefix, i.e https://HOSTNAME.s4hana.ondemand.com. - Port: The default value is 443. You can also find this value the communication arrangement.
- User: Username of the user created in Communication Management.
- Password: The password for the user specified above.
Sync configuration
Once you've set up your SAP S/4HANA destination and have a model to pull data from, you can set up your sync configuration to begin syncing data. Go to the Syncs overview page and click the Add sync button to begin. Then, select the relevant model and the SAP S/4HANA destination you want to sync to.
Sync mode
Hightouch supports Upsert, Update, and Insert mode with the SAP ODATA API for Sales Orders.
Field mapping
Hightouch supports syncing the Sales Order object and its nested fields.
Use Hightouch's object inline mapping to construct SAP S/4HANA's object values from your source.
Record matching
In Update and Upsert mode, Hightouch requires a unique identifier in your model with item IDs from SAP S/4HANA. Rows without item IDs will fail to sync.
Tips and troubleshooting
Common errors
If you encounter an error or question not listed below and need assistance, don't hesitate to . We're here to help.
Live debugger
Hightouch provides complete visibility into the API calls made during each of your sync runs. We recommend reading our article on debugging tips and tricks to learn more.
Sync alerts
Hightouch can alert you of sync issues via Slack, PagerDuty, SMS, or email. For details, please visit our article on alerting.