{"revision":"c10276e953456835cdbb1f3a60d58ae1980be353","document":{"id":21396,"path":"integrate-applications/integration-hub/sap-s4-odata-spoke.md","title":"SAP S4 HANA OData spoke","bundle":null,"doc_type":null,"release":"australia","body":"\n# SAP S4 HANA OData spoke\n\nThe SAP S4 HANA OData spoke is built by Bristlecone, Inc. Manage items, journals, procurements, and transactions in the SAP S4 HANA OData account from your ServiceNow® instance.\n\n## Request apps on Store\n\nVisit 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.\n\n## Integration Hub subscription\n\nThis 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).\n\n## Spoke version\n\nSAP S4 HANA OData spoke v1.13.0 is the latest version. For version history of the spoke, see [SAP S4 HANA OData Spoke release notes](https://www.servicenow.com/docs/r/store-release-notes/store-integrationhub-rn-sap-s4-hana-odata-spoke.html).\n\n## Supported versions\n\nThis spoke was tested with SAP S/4HANA version 2023.\n\n## Spoke requirements\n\n- SAP S4 HANA OData account\n- Configure the value of this system property:\n\n **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](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/build-workflows/flow-designer-system-properties.md).\n\n\n## Spoke dependencies\n\nIf you’re having trouble installing the app, ensure that these dependent plugins are installed:\n\n- Complex Object \\(com.glide.cobject\\)\n- ServiceNow Workflow Studio - Dynamic Inputs \\(com.glide.hub.dynamic\\_inputs\\)\n- ServiceNow Integration Hub Action Step - REST \\(com.glide.hub.action\\_step.rest\\)\n- ServiceNow Integration Hub Runtime \\(com.glide.hub.integration.runtime\\)\n- ServiceNow Integration Hub Action Template - Data Stream \\(com.glide.hub.action\\_type.datastream\\)\n\n**Note:** Some of these plugins are licensable features and require appropriate licenses, if used outside the spoke implementation.\n\n## Scheduled jobs\n\nThe SAP S4 HANA OData spoke is shipped with the **Generate Token and Cookie** scheduled job.\n\n**Generate Token and Cookie**: This scheduled job is run every 26 minutes, which creates a token and cookie.\n\n**Note:** The Fetch Token action depends on this scheduled job.\n\n## Spoke actions\n\nThe SAP S4 HANA OData spoke provides actions to automate SAP S4 HANA OData tasks when events occurs in your ServiceNow instance. Available actions include:\n\n\n
\n\nCategory\n\n\n\nAction\n\n\n\nDescription\n\n
\n\nContract Management\n\n\n\nCreate Contract\n\n\n\nCreates a new purchase contract in SAP S4 HANA with one or more items. Validates the payload before submission.\n\n
\n\nLook up Contracts Stream\n\n\n\nRetrieves details of all items across purchase contracts from SAP S4 HANA.\n\n
\n\nSourcing Management\n\n\n\nCreate Sourcing Request\n\n\n\nCreates a request for quotation in SAP S4 HANA by setting header details.\n\n
\n\nLook up Sourcing Requests Stream\n\n\n\nRetrieves the header details of all the requests for quotations from SAP S4 HANA.\n\n
\n\nCatalog Management\n\n\n\nCreate Material\n\n\n\nCreates a material record in SAP S4 HANA by setting the required header details.\n\n
\n\nDelete Material\n\n\n\nDeletes the material record for the specified product number from SAP S4 HANA.\n\n
\n\nPrimary Data Management\n\n\n\nLook up Company Codes Stream​\n\n\n\nRetrieves details of all the available company codes.​\n\n
\n\nLook up Currencies Stream​\n\n\n\nRetrieves details of all the available currencies.\n\n
\n\nLook up Business Partners Stream\n\n\n\nRetrieves business partner's data fields of all the available records in the system.\n\n
\n\nLook up FX Rates Stream​\n\n\n\nRetrieves details of all the currency foreign exchange rates.​\n\n
\n\nLook up Cost Centers Stream​\n\n\n\nRetrieve details of all the cost centers.​\n\n
\n\nLook up GL Accounts in Chart of Accounts Stream​\n\n\n\nRetrieves the details of all general ledger accounts available in your system.​\n\n
\n\nLook up Chart of Accounts Stream​\n\n\n\nRetrieves details of the available charts of accounts.\n\n
\n\nLook Up Plant Addresses Stream​\n\n\n\nRetrieves details of the specified plant address master.​\n\n
\n\nLook up Purchasing Organizations Stream​\n\n\n\nRetrieves details of all the purchasing organizations.​\n\n
\n\nLook up Payment Terms Stream​\n\n\n\nRetrieves all the details of the payment terms.​\n\n
\n\nLook up Purchase Group Stream​\n\n\n\nRetrieves details of the specified purchasing group master.\n\n
\n\nLook up Material Groups Stream\n\n\n\nRetrieves the materials groups stream synchronously.\n\n
\n\nLook up Base Unit of Measure Stream\n\n\n\nRetrieves the list of entries from unit of measure text.\n\n
\n\nLook up Business Partner Addresses Stream​\n\n\n\nRetrieves business partner address data fields of all the available records in your SAP S4 HANA OData account.\n\n
\n\nLook up Materials Stream​\n\n\n\nRetrieves details of all general data of product master.\n\n
\n\nUtility Management\n\n\n\nLook up Last Run Date\n\n\n\nRetrieves the last run date and time of the flow.\n\n
\n\nFetch Token​\n\n\n\nRetrieves 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.\n\n
\n\nPurchase Order Management\n\n\n\nUpdate Purchase Order Line\n\n\n\nUpdates the item details of an item in a purchase order using the Purchase Order Number and Purchase Order Item.\n\n
\n\nUpdate Purchase Order for ASN\n\n\n\nUpdates the item details in a purchase order.\n\n
\n\nUpdate Purchase Order\n\n\n\nUpdates the header details for the specified purchase order number.\n\n
\n\nLook up Purchase Orders Stream\n\n\n\nRetrieves general details of the specified product master.\n\n
\n\nCreate Non Purchase Order Invoice\n\n\n\nCreates a supplier invoice using, for example, the company code, the invoice gross amount, and the invoicing party.\n\n
\n\nCancel Purchase Order Line\n\n\n\nDeletes an item in a purchase order for the specified purchase order number and item number.\n\n
\n\nCreate Purchase Order\n\n\n\nCreates a purchase order with the specified details.\n\n
\n\nCreate Line Item on Existing Purchase Order\n\n\n\nCreates a line item in the existing purchase order with the header and item details passed in the request body.\n\n
\n\nLook up Purchase orders Stream\n\n\n\nRetrieves details of all purchase orders and the related items.\n\n
\n\nLook up Purchase order Line Items Stream\n\n\n\nRetrieves details of all purchase order line items.\n\n
\n\nPayment Management\n\n\n\nAuthorize Payment\n\n\n\nRemoves payment blocks that are set at the time of document creation.\n\n
\n\nLook up Payment Term\n\n\n\nRetrieves details of the payment terms.\n\n
\n\nLook up Payments and Payment Status Stream\n\n\n\nRetrieves payment information such as transaction currency, customer, payment status, accounting document and posting date.\n\n
\n\nReceipt Management\n\n\n\nCreate Service Goods Receipt\n\n\n\nCreates service goods receipt in SAP S4 HANA OData.\n\n
\n\nCancel Goods Receipt\n\n\n\nCancels the material document for the specified material document number and material document year.\n\n
\n\nCreate Goods Receipt\n\n\n\nCreates a material document compost by header and item for a specific business process.\n\n
\n\nCreate Receipt for Advance Shipment Notification\n\n\n\nCreates a material document with a header and item for a business process.\n\n
\n\nLook up Receipt\n\n\n\nRetrieves the receipt details for the specified material document and other material document details.\n\n
\n\nInvoice Management\n\n\n\nCreate Invoice\n\n\n\nCreates a supplier invoice based on the specified details, such as, company code, invoice gross amount, and invoicing party\n\n
\n\nCancel Invoice\n\n\n\nDelete a supplier invoice that hasn't been posted using the supplier invoice and the fiscal year.\n\n
\n\nLook up Invoices Stream\n\n\n\nRetrieves general data of supplier master.\n\n
\n\nShipment Management\n\n\n\nCreate Advance Shipment Notification\n\n\n\nCreates an inbound delivery based on the specified purchase order.\n\n
\n\nLook up Advance Shipment Notification\n\n\n\nRetrieves the advance shipment notification details for the specified delivery document number.\n\n
\n\nLook up Ship-to-Plant Addresses Stream\n\n\n\nRetrieves the plant address details.\n\n
\n\nSupplier Management\n\n\n\nCreate Supplier\n\n\n\nCreates a supplier.\n\n
\n\nDelete Supplier Bank Account\n\n\n\nDeletes the bank data for the specified business partner number and bank identification number.\n\n
\n\nLook up Suppliers Stream​\n\n\n\nRetrieves details of the specified supplier master.\n\n
\n\nUpdate Business Partner Address\n\n\n\nUpdates business partner address data of the record identified by address ID and business partner number.\n\n
\n\nUpdate Supplier Company\n\n\n\nUpdates the supplier company data by using the Supplier and Company Code fields.\n\n
\n\nUpdate Business Partner Bank\n\n\n\nUpdates bank data of the business partner record identified by business partner number and bank identification.\n\n
\n\nUpdate Supplier​\n\n\n\nUpdates the details of the specified supplier.\n\n
\n\nUpdate Supplier Fax Number\n\n\n\nUpdates the fax number by using Address ID.\n\n
\n\nUpdate Supplier Email Address\n\n\n\nUpdates email address by using Address ID.\n\n
\n\nUpdate Supplier Phone Number\n\n\n\nUpdates business partner mobile or telephone address data of the record identified by Address ID.\n\n
\n\nCreate Company Code for Existing Supplier\n\n\n\nCreates a company code for an existing supplier.\n\n
\n\nCreate Bank Details for Existing Supplier\n\n\n\nCreates new business partner bank data linked to business partner.\n\n
## Spoke module\n\nThe SAP S4 HANA OData spoke adds a SAP S4 HANA OData module to your ServiceNow instance.\n\n|Module|Description|\n|------|-----------|\n|**Remote Table** > **Purchase Orders**|Retrieves all the existing purchase orders in SAP S4 HANA OData.|\n|**Inbound flow** > **Purchase Orders**|Lists the most recent changes in purchase order status between the most recent successful runtime and the present runtime.|\n|**Inbound flow** > **Last Successful Execution**|Lists the last successful execution details of the flows.|\n\n## Spoke flow\n\nThe SAP S4 HANA OData spoke adds the following flow.\n\n|Flow|Description|\n|----|-----------|\n|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.|\n\n## Spoke subflow\n\nThe SAP S4 HANA OData spoke adds the following subflow.\n\n|Subflow|Description|\n|-------|-----------|\n|Sample Create Purchase Order Subflow|Searches if a purchase order exists and creates a purchase order when no results are found.|\n\n## Connection and credential alias requirements\n\nIntegration 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.\n\n"}}