Overview
Integrating SAP S/4HANA unlocks additional features designed to save time and improve decision-making:
View credit insights from payment history data in SAP S/4HANA: Visualize every customer's credit utilization percentage, Days Sales Outstanding (DSO), A/R aging analytics, and more in one place.
Push customer data to SAP S/4HANA: Automate the setup of customer accounts and avoid manual, time-consuming, and error-prone data entry.
Sync payment terms & credit limits: Push updates to payment terms and credit limits from Nuvo's approval portal directly into the SAP S/4HANA business partner record.
What You'll Need
Before you begin, ensure the following:
You have administrator access to your SAP S/4HANA system.
The following OData services are activated in your SAP system:
API_BUSINESS_PARTNER(Customer/Supplier management)API_BILLING_DOCUMENT_SRV(Invoices)API_SALES_ORDER_SRV(Sales Orders)API_OPLACCTGDOCITEMCUBE_SRV(Accounting Documents/Payments)
You have decided which authentication method to use (see Step One).
Required Permissions
Nuvo requires access to the following SAP S/4HANA OData APIs. Ensure the user, OAuth2 client, or API key you configure has the appropriate authorization for each:
OData Service | Access Level | What Nuvo Uses It For |
| Read + Write | Pull existing customers into Nuvo; push new/updated customer records and addresses back to SAP; read payment terms from customer company data |
| Read | Pull billing documents (invoices) for A/R aging analytics and credit insights |
| Read | Pull sales orders for credit utilization and order history reporting |
| Read | Pull accounting documents (payments) for DSO calculations and payment history analytics |
Note: Nuvo also requires the ability to fetch a CSRF token (via X-CSRF-Token: Fetch header) before performing any write operations. This is typically granted automatically when the user has write access to the Business Partner API.
Integration Steps
Step One: Choose Your Authentication Method
Nuvo supports three authentication methods for SAP S/4HANA. Choose the one that best fits your organization's setup:
Method | Best For | What You Need |
Basic Authentication | On-premise SAP systems, quick setup | SAP username & password |
OAuth2 Client Credentials | SAP BTP, cloud environments, production use | Client ID, Client Secret, Token URL |
API Key | SAP API Business Hub, sandbox/test environments | API Key |
Recommendation: For production environments, we recommend OAuth2 Client Credentials as it is the most secure option and does not require sharing user passwords.
Step Two: Get Your SAP S/4HANA Base URL
Log into your SAP S/4HANA system.
Your Base URL is the root URL of your SAP OData API endpoint. It typically looks like one of the following:
On-premise:
https://sap.yourcompany.com:44300
Copy this URL — you will need it when connecting to Nuvo.
Step Three: Activate Required OData Services
If the required OData services are not already activated:
In your SAP system, go to transaction
/IWFND/MAINT_SERVICE(Activate and Maintain Services).Search for and activate each of the following services:
API_BUSINESS_PARTNERAPI_BILLING_DOCUMENT_SRVAPI_SALES_ORDER_SRVAPI_OPLACCTGDOCITEMCUBE_SRV
Assign each service to the appropriate System Alias.
If these services were already activated for other integrations, you do not need to activate them again.
Step Four: Set Up Credentials
Follow the instructions for your chosen authentication method:
Option A: Basic Authentication
Go to transaction
SU01(User Maintenance) in your SAP system.Either use an existing technical user or create a new one:
To create a new user: Enter a User ID (e.g.,
NUVO_API) and click Create.Set the User Type to System or Communication.
On the Roles tab, assign a role that includes read/write access to the OData services listed above. At minimum, the role should include:
Business Partner — Read & Write
Billing Documents — Read
Sales Orders — Read
Accounting Documents — Read
Set a password for the user.
Save the user. Note down the Username and Password for the next step.
Option B: OAuth2 Client Credentials
In SAP BTP or your SAP authorization server, register a new OAuth2 client.
Configure the client with the Client Credentials grant type.
Define the required scopes for the OData services:
Business Partner API access
Billing Document API access
Sales Order API access
Accounting Document API access
Once registered, note down the following:
Client ID
Client Secret
Token URL (e.g.,
https://your-auth-server.com/oauth/token)
Option C: API Key
Go to the SAP API Business Hub.
Log in with your SAP credentials.
Navigate to Settings and generate a new API Key.
Note down the API Key for the next step.
Note: API Key authentication is typically used for sandbox and testing environments. For production use, we recommend OAuth2 or Basic Authentication.
Step Five: Enter Your Credentials into Nuvo
Under ERP, click Connect a New Account and select SAP S/4HANA.
Enter the following information:
Base URL: Your SAP S/4HANA OData API endpoint from Step Two.
Authentication Type: Select the method you set up in Step Four.
Fill in the corresponding credential fields based on your selected authentication type:
Basic: Username and Password
OAuth2: Client ID, Client Secret, and Token URL
API Key: Your API Key
Click Connect. Nuvo will verify your credentials in real-time.
Once verified, click Save Connection.
Your first data sync may take a few hours depending on the volume of data in your SAP system. Check back soon!
Troubleshooting
"Failed to verify credentials": Double-check your Base URL and ensure the OData services are activated. Verify that your user/client has the required permissions.
"Connection timeout": Ensure your SAP system's firewall allows inbound connections from Nuvo's IP addresses. Contact Nuvo support for the current IP allowlist.
"403 Forbidden": The user or OAuth client does not have sufficient permissions. Review the role assignments in Step Four.