---
sourceDocument: Yokohama Data and Automation
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/integrate-applications

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Data and Automation

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: Yokohama
* 
* Updated March 6, 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 within their SAP S4 HANA IDoc account directly from their ServiceNow instance.
This spoke is available exclusively through the ServiceNow Store, and an Integration Hub subscription is required for its use.
Show full answer Show less  

## Key Features

* **Spoke Version:** The latest version is SAP S4 HANA IDoc Spoke v 1.2.0, built for SAP S4 HANA IDoc 2023.
* **Requirements:** Customers must obtain specific SAP proprietary JAR files like sapidoc3.jar and sapjco3.jar. Additional files are required based on the operating system of the MID Server.
* **Dependencies:** Ensure the installation of dependent plugins such as ServiceNow IntegrationHub Runtime and Complex Object for successful app installation.
* **Spoke Actions:** Automate tasks such as creating and updating customer accounts, fixed assets, GL accounts, invoices, materials, goods receipts, purchase orders, and vendors.
* **Connection Management:** Use aliases to streamline connection and credential management across multiple environments.

## Key Outcomes

By utilizing the SAP S4 HANA IDoc Spoke, ServiceNow customers can expect improved efficiency in managing SAP S4 HANA operations. The integration allows for seamless automation of critical financial and procurement processes, reducing manual effort and minimizing errors. Customers will benefit from a more cohesive workflow between ServiceNow and SAP S4 HANA, enhancing overall productivity.  
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) website 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.{#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/xRAFdR_RLQfu_Oxzw53xOw "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=yokohama&pubname=yokohama-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/pFHb5idNTrwAP2PvzbpYKg "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/zRNWgGx87HM8cGch4MZNsg "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/7UvzwoYZypnKC5tNoxHk4Q "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.").

