Skip to main content
This guide explains how to configure the SAP communication objects required to connect Numeral with SAP S/4HANA Cloud Public Edition.
This guide is intended for SAP administrators and implementation users. It focuses only on the communication setup required for Numeral.

​
What you’ll do

  1. Start the connection in Numeral and generate credentials
  2. Create the SAP inbound communication user
  3. Create and configure the Communication System
  4. Create the Communication Arrangements
  5. Test the Tax Calculation connection
  6. Complete the connection in Numeral

​
1. Start in Numeral

Before configuring SAP:
  1. In Numeral, go to Connections.
  2. Click Add connection.
  3. Select SAP S/4HANA.
  4. Choose the flows you want to configure:
    • Tax Calculation
    • Product Sync
    • Customer Sync
    • Billing Sync
  5. For Tax Calculation, enter:
    • SAP System ID
    • Company Code
  6. Click Generate.
  7. Copy and securely store all values generated by Numeral.
Generating SAP connection credentials in Numeral For Tax Calculation, Numeral provides:
  • Numeral host
  • Outbound username
  • Outbound password
  • Service paths
The generated credentials may only be displayed once. Store them before closing the connection setup; they cannot be recovered after the connection is created.

​
2. Communication scenarios

The following SAP communication scenarios are used:
Customers may use different names according to their internal naming conventions.

​
4. Configure the communication users first

The communication users are configured before the arrangements. The users and arrangements are separate objects: creating a user does not create an arrangement, and creating an arrangement does not create a user. Two communication directions must be configured:

​
4.1 Create the SAP inbound communication user

In SAP Fiori, open:
Create the user: Generate or assign a secure password and store it safely. This password will be entered in Numeral later. Creating the NUMERAL_USER inbound communication user in SAP Fiori The same inbound user is used for:
  • Product Sync
  • Customer Sync
  • Billing Sync

​
4.2 Prepare the Numeral outbound user

Use the outbound username and password generated in Numeral. Example username:
This user allows SAP to authenticate when sending Tax Calculation requests to Numeral. The outbound username and password generated by Numeral

​
5. Create and configure the Communication System

In SAP Fiori, open:
Create a new Communication System: In Host Name, enter only the hostname. Correct:
Incorrect:

​
5.1 Add the inbound user

Under Users for Inbound Communication, add: This user handles Numeral requests for products, customers, and billing documents.

​
5.2 Add the outbound user

Under Users for Outbound Communication, add: This user handles Tax Calculation requests sent from SAP to Numeral.

​
5.3 Configure the Numeral host and endpoints

Use the host and service paths generated by Numeral. Typical Tax Calculation paths are: Use the exact values displayed in Numeral. Save the Communication System after both users and the connection details are configured.

​
6. Create the Communication Arrangements

After the Communication System is ready, create the arrangements. At this point, the Communication System already contains the inbound user, outbound user, Numeral host, and connection details. For each arrangement:
  1. Open Communication Arrangements in SAP Fiori.
  2. Create a new arrangement using the corresponding scenario.
  3. Assign the Communication System NUMERAL_CONNECTION.
  4. Save the arrangement.
  5. Confirm that the expected service is active.
The arrangements reuse the users and connection information already declared in NUMERAL_CONNECTION. There is no need to create new communication users for each arrangement. Creating a Communication Arrangement in SAP Fiori

​
7. Test the Tax Calculation connection

Inside the SAP_COM_0177 arrangement:
  1. Locate one of the configured outbound services.
  2. Click Check Connection.
Expected result:
A successful ping confirms that SAP can reach Numeral and authenticate using the outbound user configured in the Communication System. A successful outbound service connection test
Before testing tax calculations, SAP provides the External Tax Configuration Check application to validate that the external tax integration is correctly configured. Open:
This application performs consistency checks across the SAP tax configuration and helps identify missing or inconsistent settings before creating sales documents. Typical validations include:
  • Communication Arrangement (SAP_COM_0177)
  • External Tax Calculation activation
  • Tax jurisdiction configuration
  • Pricing procedure configuration
  • Tax procedure assignments
  • External tax mapping consistency
Any reported errors should be resolved before testing tax calculation.
A successful communication test (Check Connection) only verifies connectivity between SAP and Numeral. It does not validate the SAP pricing configuration required to create tax conditions during sales order processing.

​
9. Complete the connection in Numeral

Return to the SAP connection in Numeral. For Product, Customer, and Billing Sync, enter: The SAP API URL normally uses the SAP API host, for example:
Do not use the Fiori Launchpad URL. Save the connection. Completing the Product, Customer, and Billing Sync connection in Numeral

​
Troubleshooting

If SAP successfully calls Numeral and receives a valid response (RETCODE = 0), but sales orders still fail with Pricing error: Mandatory condition UTXJ is missing, the communication with Numeral is working correctly. The issue is typically related to SAP pricing configuration.Recommended checks:
  • Run External Tax Configuration Check and resolve any reported issues.
  • Verify that the pricing procedure used by the sales document supports external tax calculation.
  • Verify the U.S. Tax Jurisdiction configuration (0TXUSX).
  • Verify the Map Tax Results to Condition Types (Sales Pricing Procedure) SSCUI.
  • Verify the Map S/4HANA Tax Codes to External Tax Codes SSCUI if tax code mapping is required.
  • Verify that the relevant tax jurisdiction entries exist for the configured tax procedure.
Receiving tax amounts from Numeral confirms that the external tax provider is functioning correctly. The UTXJ error is generated by SAP Pricing after the external tax response has already been processed.This distinction is important because it separates two responsibilities:
  • Connectivity → SAP_COM_0177, credentials, endpoints, and communication with Numeral.
  • Functional SAP configuration → Pricing, UTXJ, jurisdictions, and mappings.
A successful Numeral response confirms provider connectivity, while SAP pricing errors must be resolved in SAP configuration.