Coupa Spoke

Request apps on the Store

Visit the ServiceNow Store 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.

Integration Hub subscription

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

Spoke version

Coupa spoke v4.11 is the latest version.

Supported versions

This spoke was built for Coupa version stable_v4.2.0, but may be compatible with later versions.

Spoke requirements

Create an API key in your Coupa instance and record the API key for later use. See Coupa documentation for information about creating API key.

Spoke user roles

The following user roles are available with the spoke:

Coupa Admin (sn_coupa_spoke.Coupa Admin): Users with this role have access to both, My Current Approvals and Contracts modules.
Coupa Approval User (sn_coupa_spoke.Coupa Approval User): Users with this role have access only to the My Current Approvals module
Coupa Contract User (sn_coupa_spoke.Coupa Contract User): Users with this role have access only to the Contracts module.

Spoke module

The Coupa spoke adds a Coupa application to your ServiceNow instance. The Coupa application supports Coupa Approval User and Coupa Contract User roles. You can access the Coupa application from the ServiceNow instance on your Now Mobile app.

Note:

Make sure that Coupa Login attribute and the user ID of ServiceNow instance match before using the My Current Approvals module.

The Coupa application has the following modules.


Module	Description
My Current Approvals	Displays the list of approvals in Coupa for a user.
Contracts	Displays a list of contracts in Coupa.

Spoke actions

The Coupa spoke provides actions to automate approval, contract, inventory, invoice, catalog item, purchase order, requisition, supplier, and user management when events occur in ServiceNow. Available actions include:


Category	Action	Description
Approval Management	Approve Approval Request	Approves the required approval request in Coupa.
	Look up Approval Details by Approval ID	Retrieves the details of the required approval in Coupa.
	Look up Approval	Looks up an approval record in Coupa using the Coupa query.
	Look up Approval By Requisition ID	Looks up the required approval record in Coupa using its Requisition ID.
	Look up Approvals Stream	Retrieves details of approvals in Coupa.
	Reject Approval Request	Rejects the required approval request in Coupa.
Catalog Management	Create Item	Creates an item in Coupa.
Contract Management	Create Contract	Creates contract with the provided details in Coupa.
Contract Management	Look up Contracts Stream	Looks up the required contract records in Coupa using the Coupa query.
Primary Data Management	Look up Conversion Rates Stream	Retrieves details of the conversion rates in Coupa.
	Look up Currencies Stream	Retrieves details of currencies in Coupa.
	Look up Legal Entities Stream	Retrieves details of the legal entities in Coupa.
	Lookup Cost Centers Stream	Retrieves details of the cost centers in Coupa.
	Look up Advanced Shipment Notices Stream After Updated Date	Retrieves details of advance shipment notices after filtering by the specified updated at field in Coupa.
	Look up Advance Shipment Notice by Purchase Order Line ID	Retrieves details of the advance shipment notice for the specified purchase order line ID.
	Look up Advanced Shipment Notices by Purchase Order Line ID Stream	Retrieves details of all advance shipment notices for the specified purchase order line ID. Note: This is a data stream action.
Inventory Management	Create Goods Receipt	Creates a goods receipt record in Coupa.
	Create Receipt	Creates a receipt in Coupa. Note: Ensure that description has the exact item name. When you want to access the item name in a flow, use the description data pill.
	Get Receipt Fields	Retrieves the list of fields in the Coupa Receipts table. Note: This is a metadata action and doesn't make an API call to Coupa.
	Look up Advanced Shipment Notices After Updated Date	Retrieves the details of the advance shipment notices after the updated date in Coupa.
	Look up Advance Shipment Notice By Purchase Order Line ID	Look up an advance shipment notice by purchase order line ID in Coupa.
	Look up Receipt	Looks up the required receipt in Coupa using the Coupa query.
	Look up Receipt Details by Receipt ID	Retrieves details of the required receipt.
	Look up Receipts Stream	Looks up the required receipts in Coupa using the Coupa query.
	Void Receipt	Makes the required receipt void.
Invoice Management	Create Invoice	Creates an invoice with the provided details in Coupa.
	Update Invoice	Updates the details of the specified invoice in Coupa.
	Void Invoice	Makes the required invoice void.
	Look up Invoices Stream	Retrieves details of the required invoices in Coupa.
	Look up Invoice Payments Details Stream	Retrieves information about the required invoice payment details in Coupa.
Item Management	Look up Items Stream	Looks up the required items in Coupa using the Coupa query.
Item Management	Look up Item	Looks up the required item in Coupa using the Coupa query.
Purchase Order Management	Cancel Purchase Order	Cancels the required purchase order in Coupa.
	Close Purchase Order	Closes the required purchase order in Coupa.
	Create Fixed Assets	Creates fixed assets with the specified details in Coupa.
	Create Purchase Order	Creates a purchase order in Coupa.
	Look up PO Line by Line ID	Retrieves details of a purchase order line in Coupa.
	Look up Purchase Order	Looks up the required purchase order in Coupa using the Coupa query.
	Look up Purchase Orders Stream	Looks up the details of the purchase orders in Coupa that you specify using the Coupa query.
	Revise Purchase Order	Revises or updates the purchase order in Coupa.
Requisition Management	Create Draft Requisition	Creates a requisition in Coupa with its status as Draft.
	Create Requisition	Creates a requisition with the status as Pending Approval or Pending Buyer Action.
	Get Requisition Fields	Retrieves the list of fields in the Coupa Requisitions table. Note: This is a metadata action and doesn't make an API call to Coupa.
	Look up Requisition	Looks up the required requisition in Coupa using the Coupa query.
	Look up Requisitions Stream	Looks up the required requisitions in Coupa using the Coupa query.
	Update Requisition	Updates an existing requisition in Coupa.
Sourcing Management	Award Purchase	Awards a purchase in Coupa. To award a purchase, you can specify the quote request ID and the quote supplier ID as inputs.
	Create Sourcing Event	Creates a sourcing event in Coupa.
	Look up Sourcing Quote Response Stream	Looks up the quote response in Coupa based on the quote request ID that you specify. You can also specify other criteria such as the limit of records that the response returns, and the offset.
	Look up Sourcing Events Stream	Retrieves details of the required sourcing event in Coupa.
Supplier Management	Look up Supplier	Looks up the required supplier in Coupa using the Coupa query.
	Create Supplier	Creates a supplier in Coupa.
	Deactivate Supplier	Deactivates the specified supplier in Coupa.
	Update Supplier	Updates details of the specified supplier in Coupa.
	Look up Product Catalogs Stream	Retrieves the product catalogs in Coupa.
	Look up Suppliers Stream	Retrieves list of suppliers in Coupa using the query.
User Management	Look up User	Looks up the required user in Coupa using the Coupa query.
	Look up Users Stream	Looks up the required users in Coupa using the Coupa query.
	Reset User Password	Resets password of the required user in Coupa.

Note:

Remote tables are created when the Coupa spoke is activated. Users are cautioned against directly modifying schema or inserting data in these tables.

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.