SAP S4 HANA OData spoke

Request apps on Store

Visit the ServiceNow Store 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. Starting on March 1st 2022, all SAP spokes will be available only on the Store.

Integration Hub subscription

This spoke requires an Integration Hub subscription. For more information, see Legal schedules - IntegrationHub overview.

Spoke version

SAP S4 HANA OData spoke v1.12.0 is the latest version.

Supported versions

This spoke was tested with SAP S/4HANA version 2023.

Spoke requirements

SAP S4 HANA OData account
Configure the value of this system property:
com.snc.process_flow.reporting.serialized.val_size_limit: This property serializes JSON objects and ensures that the data is in the required format. Specify the number of bytes as per your requirement. For more information, see Workflow Studio system properties.

Spoke dependencies

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

Complex Object (com.glide.cobject)
ServiceNow Workflow Studio - Dynamic Inputs (com.glide.hub.dynamic_inputs)
ServiceNow Integration Hub Action Step - REST (com.glide.hub.action_step.rest)
ServiceNow Integration Hub Runtime (com.glide.hub.integration.runtime)
ServiceNow Integration Hub Action Template - Data Stream (com.glide.hub.action_type.datastream)

Note:

Some of these plugins are licensable features and require appropriate licenses, if used outside the spoke implementation.

Scheduled jobs

The SAP S4 HANA OData spoke is shipped with the Generate Token and Cookie scheduled job.

Generate Token and Cookie: This scheduled job is run every 26 minutes, which creates a token and cookie.

Note:

The Fetch Token action depends on this scheduled job.

Spoke actions

The SAP S4 HANA OData spoke provides actions to automate SAP S4 HANA OData tasks when events occurs in your ServiceNow instance. Available actions include:


Category	Action	Description
Contract Management	Create Contract	Creates a new purchase contract in SAP S4 HANA with one or more items. Validates the payload before submission.
Contract Management	Look up Contracts Stream	Retrieves details of all items across purchase contracts from SAP S4 HANA.
Sourcing Management	Create Sourcing Request	Creates a request for quotation in SAP S4 HANA by setting header details.
Sourcing Management	Look up Sourcing Requests Stream	Retrieves the header details of all the requests for quotations from SAP S4 HANA.
Catalog Management	Create Material	Creates a material record in SAP S4 HANA by setting the required header details.
Catalog Management	Delete Material	Deletes the material record for the specified product number from SAP S4 HANA.
Primary Data Management	Look up Company Codes Stream	Retrieves details of all the available company codes.
	Look up Currencies Stream	Retrieves details of all the available currencies.
	Look up Business Partners Stream	Retrieves business partner's data fields of all the available records in the system.
	Look up FX Rates Stream	Retrieves details of all the currency foreign exchange rates.
	Look up Cost Centers Stream	Retrieve details of all the cost centers.
	Look up GL Accounts in Chart of Accounts Stream	Retrieves the details of all general ledger accounts available in your system.
	Look up Chart of Accounts Stream	Retrieves details of the available charts of accounts.
	Look Up Plant Addresses Stream	Retrieves details of the specified plant address master.
	Look up Purchasing Organizations Stream	Retrieves details of all the purchasing organizations.
	Look up Payment Terms Stream	Retrieves all the details of the payment terms.
	Look up Purchase Group Stream	Retrieves details of the specified purchasing group master.
	Look up Material Groups Stream	Retrieves the materials groups stream synchronously.
	Look up Base Unit of Measure Stream	Retrieves the list of entries from unit of measure text.
	Look up Business Partner Addresses Stream	Retrieves business partner address data fields of all the available records in your SAP S4 HANA OData account.
	Look up Materials Stream	Retrieves details of all general data of product master.
Utility Management	Look up Last Run Date	Retrieves the last run date and time of the flow.
Utility Management	Fetch Token	Retrieves the CSRF (Cross-Site Request Forgery) token and cookie for other spoke actions. Note: This action is run every 6 hours through the Generate Token and Cookie scheduled job and update the system properties.
Purchase Order Management	Update Purchase Order Line	Updates the item details of an item in a purchase order using the Purchase Order Number and Purchase Order Item.
	Update Purchase Order for ASN	Updates the item details in a purchase order.
	Update Purchase Order	Updates the header details for the specified purchase order number.
	Look up Purchase Orders Stream	Retrieves general details of the specified product master.
	Create Non Purchase Order Invoice	Creates a supplier invoice using, for example, the company code, the invoice gross amount, and the invoicing party.
	Cancel Purchase Order Line	Deletes an item in a purchase order for the specified purchase order number and item number.
	Create Purchase Order	Creates a purchase order with the specified details.
	Create Line Item on Existing Purchase Order	Creates a line item in the existing purchase order with the header and item details passed in the request body.
	Look up Purchase orders Stream	Retrieves details of all purchase orders and the related items.
	Look up Purchase order Line Items Stream	Retrieves details of all purchase order line items.
Payment Management	Authorize Payment	Removes payment blocks that are set at the time of document creation.
	Look up Payment Term	Retrieves details of the payment terms.
	Look up Payments and Payment Status Stream	Retrieves payment information such as transaction currency, customer, payment status, accounting document and posting date.
Receipt Management	Create Service Goods Receipt	Creates service goods receipt in SAP S4 HANA OData.
	Cancel Goods Receipt	Cancels the material document for the specified material document number and material document year.
	Create Goods Receipt	Creates a material document compost by header and item for a specific business process.
	Create Receipt for Advance Shipment Notification	Creates a material document with a header and item for a business process.
	Look up Receipt	Retrieves the receipt details for the specified material document and other material document details.
Invoice Management	Create Invoice	Creates a supplier invoice based on the specified details, such as, company code, invoice gross amount, and invoicing party
	Cancel Invoice	Delete a supplier invoice that hasn't been posted using the supplier invoice and the fiscal year.
	Look up Invoices Stream	Retrieves general data of supplier master.
Shipment Management	Create Advance Shipment Notification	Creates an inbound delivery based on the specified purchase order.
	Look up Advance Shipment Notification	Retrieves the advance shipment notification details for the specified delivery document number.
	Look up Ship-to-Plant Addresses Stream	Retrieves the plant address details.
Supplier Management	Create Supplier	Creates a supplier.
	Delete Supplier Bank Account	Deletes the bank data for the specified business partner number and bank identification number.
	Look up Suppliers Stream	Retrieves details of the specified supplier master.
	Update Business Partner Address	Updates business partner address data of the record identified by address ID and business partner number.
	Update Supplier Company	Updates the supplier company data by using the Supplier and Company Code fields.
	Update Business Partner Bank	Updates bank data of the business partner record identified by business partner number and bank identification.
	Update Supplier	Updates the details of the specified supplier.
	Update Supplier Fax Number	Updates the fax number by using Address ID.
	Update Supplier Email Address	Updates email address by using Address ID.
	Update Supplier Phone Number	Updates business partner mobile or telephone address data of the record identified by Address ID.
	Create Company Code for Existing Supplier	Creates a company code for an existing supplier.
	Create Bank Details for Existing Supplier	Creates new business partner bank data linked to business partner.

Spoke module

The SAP S4 HANA OData spoke adds a SAP S4 HANA OData module to your ServiceNow instance.


Module	Description
Remote Table > Purchase Orders	Retrieves all the existing purchase orders in SAP S4 HANA OData.
Inbound flow > Purchase Orders	Lists the most recent changes in purchase order status between the most recent successful runtime and the present runtime.
Inbound flow > Last Successful Execution	Lists the last successful execution details of the flows.

Spoke flow

The SAP S4 HANA OData spoke adds the following flow.


Flow	Description
Sample Look up Purchase Orders Flow	Retrieves the list of most recent changes in purchase order status between the most recent successful runtime and the present runtime.

Spoke subflow

The SAP S4 HANA OData spoke adds the following subflow.


Subflow	Description
Sample Create Purchase Order Subflow	Searches if a purchase order exists and creates a purchase order when no results are found.

Connection and credential alias requirements

Integration Hub uses aliases to manage connection and credential information, and OAuth credentials. 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.