---
sourceDocument: Australia Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/integrate-applications

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# SAP S4 HANA IDoc Spoke

# SAP S4 HANA IDoc Spoke {#sap-hana-idoc__sap-s4-hana-idoc}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of SAP S4 HANA IDoc Spoke

The SAP S4 HANA IDoc spoke, developed by Bristlecone, Inc., enables ServiceNow customers to manage finance, items, and procurement processes directly within their SAP S4 HANA IDoc account from the ServiceNow platform.
This integration facilitates automation of key SAP S4 HANA IDoc tasks triggered by ServiceNow events, streamlining business operations.
Show full answer Show less  
The spoke requires an Integration Hub subscription and is available exclusively via the ServiceNow Store starting March 1, 2022.

## Key Features

* **Supported Version:** Built specifically for SAP S4 HANA IDoc 2023, with the latest spoke version being 1.2.0.
* **Spoke Actions:** Automate creation and updates in various SAP modules including:
  * Customer Account: Create and update customer accounts.
  * Finance: Manage fixed assets, GL accounts, invoices, and journal entries.
  * Items: Create and update materials.
  * Procurement: Create goods receipts, purchase orders, vendors, and update purchase orders.
* **Connection and Credential Management:** Uses Integration Hub aliases to centrally manage connection and credential details, simplifying multi-environment setups and updates.
* **MID Server Usage:** Actions leverage SAP's Remote Function Call (RFC) protocol and run on either a ServiceNow instance or MID Server. Proper MID Server setup is essential for connectivity and execution.

## Requirements and Dependencies

* **SAP Files:** Obtain SAP proprietary JAR files (sapidoc3.jar, sapjco3.jar) and platform-specific binaries (libsapjco3.so for Linux or sapjco3.dll for Windows) from your SAP admin.
* **Custom Connector:** The spoke includes a JAR file (sapConnector-1.0.1.jar) installed in ServiceNow to interface with SAP S4 HANA IDoc.
* **Upgrade Coordination:** When using alongside other SAP spokes (ECC IDoc, ECC RFC, S4 HANA RFC), ensure all spokes are upgraded simultaneously to maintain compatibility.
* **Plugin Dependencies:** Installation requires ServiceNow IntegrationHub Runtime, Complex Object, and Flow Designer Action Step - Script on MID plugins. Some may require additional licensing.

## Practical Benefits for ServiceNow Customers

This spoke empowers ServiceNow users to seamlessly automate and synchronize SAP S4 HANA IDoc financial, procurement, and item management processes directly from their ServiceNow environment. By leveraging standardized actions and Integration Hub aliasing, customers reduce manual data entry, improve data consistency, and streamline cross-platform workflows. The MID Server integration ensures secure, reliable connectivity using SAP's standard RFC protocol.

## Next Steps

* Obtain necessary SAP proprietary files and client information from SAP administrators.
* Ensure all required ServiceNow plugins and Integration Hub subscription are in place.
* Set up and configure the MID Server according to the spoke's requirements.
* Install the spoke from the ServiceNow Store and configure connection aliases.
* Use the provided spoke actions to automate SAP S4 HANA IDoc tasks as needed.  
The SAP S4 HANA IDoc spoke is built by Bristlecone, Inc. Manage finance, items, and procurement in SAP S4 HANA IDoc account from your ServiceNow instance.

## Request apps on Store {#sap-hana-idoc__section_df1_4ng_3sb}

Visit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) to view all the available apps, and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html).
Starting on March 1st 2022, all SAP spokes will be available only on the Store.

## Integration Hub subscription {#sap-hana-idoc__section_ilc_4r5_f4b}

This spoke requires an Integration Hub subscription. For more information, see [Legal schedules - IntegrationHub overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf).

## Spoke version {#sap-hana-idoc__section_zjf_p2q_qqb}

SAP S4 HANA IDoc spoke v1.2.0 is the latest version. For version history of the spoke, see [SAP S4 HANA IDoc spoke release notes](https://www.servicenow.com/docs/r/store-release-notes/store-integrationhub-rn-sap-s4-hana-idoc.html).{#sap-hana-idoc__sap-hana-idoc-ver}

## Supported versions {#sap-hana-idoc__section_aqw_dwdc_ymb}

This spoke was built for
SAP S4 HANA IDoc
2023.

## Spoke requirements {#sap-hana-idoc__section_mlc_4r5_f4b}

* Contact the admin of your SAP S4 HANA IDoc account and obtain these SAP proprietary JAR files and other required files:
  * sapidoc3.jar and sapjco3.jar.
  * libsapjco3.so: If your MID Server is installed on a Linux machine, obtain this file.
  * sapjco3.dll: If your MID Server is installed on a Windows machine, obtain this file.

  {#sap-hana-idoc__ul_agf_vpp_xmb}

  A JAR file, sapConnector-1.0.1.jar is available along with
  the spoke to provide a custom interface between SAP S4 HANA IDoc account and ServiceNow instance. The JAR file is installed as part of the
  spoke in your ServiceNow instance.
* Copy and record the client value of the target host where the SAP S4 HANA IDoc server is installed.
* To retrieve information for authorization purposes, use the Execute RFC spoke action in the [SAP S4 HANA RFC Spoke](https://www.servicenow.com/docs/LBsBieW~bYiUfqd7mDWUPA "The SAP S4 HANA RFC spoke is built by Bristlecone, Inc. Manage procurement, records, journals, and others, in SAP S4 HANA RFC account from your ServiceNow instance.").
* If you are using this spoke along with the SAP ECC IDoc, SAP ECC RFC, SAP S4 HANA RFC spokes, during spoke upgrades, ensure that you upgrade all the spokes to their latest versions.
{#sap-hana-idoc__ul_g3f_npf4_xmb}

## Spoke dependencies {#sap-hana-idoc__section_olc_4r5_f4b}

If you're having trouble installing the app, ensure that these dependent plugins are installed:

* ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
* Complex Object (com.glide.cobject)
* Flow Designer Action Step - Script on MID (com.glide.hub.action_step.script_mid)
{#sap-hana-idoc__ul_gqw_dwfc_ymb}  
Note:  
Some of these plugins are licensable features and require appropriate licenses, if used outside the spoke implementation.

## Spoke actions {#sap-hana-idoc__section_ulc_4r5_f4b}

The SAP S/4 HANA IDoc spoke provides actions to automate SAP S4 HANA IDoc tasks when events occurs in your ServiceNow instance. Available actions include:  
{#sap-hana-idoc__table_vlc_4r5_f4b__entry__3}

| Category | Action | Description |
|-|-|-|
| Customer Account | Create Customer Account | Creates a customer account in SAP S/4HANA. |
| Customer Account | Update Customer Account | Updates details of the specified customer account in SAP S/4HANA. |
| Finance | Create Fixed Assets | Creates a fixed asset in SAP S4 HANA IDoc. |
| Finance | Create GL Account | Creates a GL account in SAP S4 HANA IDoc. |
| Finance | Create Invoice | Creates an invoice document in SAP S4 HANA IDoc. |
| Finance | Post Journal Entry | Posts a journal entry to a GL account in SAP S4 HANA IDoc. |
| Finance | Update Fixed Assets | Updates details of a fixed asset in SAP S4 HANA IDoc. |
| Finance | Update GL Account | Updates details of the specified GL account in SAP S4 HANA IDoc. |
| Items | Create Material | Creates a material (item) in SAP S4 HANA IDoc. |
| Items | Update Material | Updates details of the specified material (item) in SAP S4 HANA IDoc. |
| Procurement | Create Goods Receipt | Creates a goods receipt in SAP S4 HANA IDoc. |
| Procurement | Create Purchase Order | Creates a purchase order in SAP S4 HANA IDoc. |
| Procurement | Create Vendor | Creates a vendor in SAP S4 HANA IDoc. |
| Procurement | Update Purchase Order | Updates details of the specified purchase order in SAP S4 HANA IDoc. |
[ ]

{#sap-hana-idoc__table_vlc_4r5_f4b}

## Connection and credential alias requirements {#sap-hana-idoc__section_bmc_4r5_f4b}

Integration Hub uses aliases to manage connection
and credential information. Using an alias eliminates the need to configure multiple
credentials and connection information profiles when using multiple environments. If the
connection or credential information changes, you don't need to update any actions that
use the connection. For more information, see [Connections and Credentials](https://www.servicenow.com/docs/access?context=r-credentials&version=australia&pubname=australia-platform-security&ft:locale=en-US).

For information about setting up the spoke, see
[Set up the SAP S4 HANA IDoc spoke](https://www.servicenow.com/docs/2lnL6C65K4QDeHiNtICzbQ "Integrate the ServiceNow instance and SAP S4 HANA IDoc spoke by using the Basic Auth credentials to authenticate ServiceNow requests.").

## MID Server requirements {#sap-hana-idoc__section_cmc_4r5_f4b}

These actions use Remote Function Call (RFC) protocol (SAP Proprietary protocol -- SAP Standard Interface) leveraging Application Link Enabling (ALE) framework, which can run on an instance or MID Server. Use the connection record associated with the SAP S4 HANA IDoc alias to configure where actions run as well as set MID Server selection attributes. For more information about running actions on the MID Server, see [Integration steps](https://www.servicenow.com/docs/3HAkBEjCzmcSEOfq7SkGnQ "Enable custom actions to integrate with external systems by activating Integration Hub, which adds integration steps to the Workflow Studio interface.")

To set up the MID Server for this spoke, see [Set up MID Server for a spoke](https://www.servicenow.com/docs/OEkPOX7xORDj2GD6UZwzjg "Configure MID Server settings on your ServiceNow instance that enables it to integrate with a third-party application via MID Server after you have set up the connection record for a spoke.").