In this article

Overview

You can use this Snap to update Coupa resource records such as addresses, by using the relevant resource APIs. You can only use this Snap to select the resource whose records are to be updated; all record-related data must be passed through an upstream Snap such as the Mapper Snap.

Allowable Values

Some resource elements have a specific set of allowable values. An error is displayed if you provide any other value for such elements. Allowable values are mentioned in the Elements section in the resource's API documentation.

For example, the change-type element in the Purchase Order resource accepts only change and revision.

If the change-type element's value is changed from change to revision, it cannot be reverted.

Prerequisites

Valid Coupa account with appropriate permissions.
Resource parameters compliant with the resource schema.

Limitations

None.

Snap Views

Type

Format

Number of Views

Compatible Upstream and Downstream Snaps

Description

Input

Document

Min: 1
Max: 1

Mapper Snap
Copy Snap

The resource details as a JSON document.

Output

Document

Min: 0
Max: 1

Document to Binary + File Writer

Details of the updated resource record. Level of detail varies according to the configuration of the Response Type field.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter while running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab. The available options are:

Stop Pipeline Execution: Stops the current pipeline execution when the Snap encounters an error.
Discard Error Data and Continue: Ignores the error, discards that record, and continues with the rest of the records.
Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.

Snap Settings

Asterisk (*): Indicates a mandatory field.
Suggestion icon (): Indicates a list that is dynamically populated based on the configuration.
Expression icon (): Indicates whether the value is an expression (if enabled) or static (if disabled). Learn more about Using Expressions in SnapLogic.
Add icon (): Indicates that you can add fields in the fieldset.
Remove icon (): Indicates that you can remove fields from the fieldset.

Field Name	Field Type	Description
Label* Default Value: Coupa Update Example: Update Supplier Info	String	The name for the Snap. We recommend you update the Snap name, if there is more than one of the same Snap in your Pipeline.
Response Type Default Value: all Example: shallow	Dropdown list	Specify the level of detail required in the Snap's output. You can configure this keeping in mind the available memory and likely processing time that it would take to execute this Snap. Available options are: all: Output contains all details of the updated records. none: No output. limited: Output contains only the records' ID. shallow: Output contains ID as well as the direct child attributes of each record. See API Return Formats for more details
API Path* Default Value: N/A Example: suppliers	String/Expression	The API name associated with the target resource. Select the target resource from the suggestions in the field. Suggestions vary based on the account. When updating specific resources, select the corresponding ID API and pass the resource ID as an upstream parameter.
Mark Exported Default Value: Not selected Example: Selected	Checkbox	Select this checkbox to export the resource record after the update. This is only applicable to transactional resources such as contracts. Updating a resource record and marking a record as exported must not be done in the same request. If this field is selected, the record updates may be ignored.
Snap execution Default Value: Execute only Example: Validate & Execute	Dropdown list	Select one of the three modes in which the Snap executes. Available options are: Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime. Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data. Disabled: Disables the Snap and all Snaps that are downstream from it.

Example

Fetching and Updating Inactive Records

This example demonstrates how to fetch one inactive Coupa supplier record and update one of its custom fields.

Download the example Pipeline.

The Coupa Read Snaps is configured as shown below:

Use Query Parameters field-set to filter the records. The Snap fetches all the supplier records, if this filter is not applied.

Based on this configuration, the Snap fetches the topmost inactive record for the supplier named Dell (USA).

In this example, we want to update one of the custom fields in the fetched record. To update a resource record, pass the record ID to the Coupa Update Snap. To do so, use the Mapper Snap connected to both Coupa Read and Coupa Update Snap. Additionally, provide the values to be updated. For example, custom-field-5 and John Doe in this case.

This Mapper Snap is configured as shown below:

Output from the Mapper Snap:

This data is passed into the Coupa Update Snap which is configured as shown below:

The response type is limited; therefore, only the updated data is shown in the output:

Downloads

Important steps to successfully reuse Pipelines

Download and import the pipeline into the SnapLogic application.
Configure Snap accounts as applicable.
Provide pipeline parameters as applicable.

	File	Modified
Labels No labels Preview View	File CoupaUpdate_UpdatingSupplier_UsesCustomFields.slp	Nov 01, 2019 by Mohammed Iqbal

Snap Pack History

Click here to expand...

Release	Snap Pack Version	Date	Type	Updates
February 2025	main29887	12 Feb 2025	Stable	Updated and certified against the current SnapLogic Platform release.
November 2024	main29029	13 Nov 2024	Stable	Updated and certified against the current SnapLogic Platform release.
August 2024	main27765	21 Aug 2024	Stable	Updated and certified against the current SnapLogic Platform release.
May 2024	main26341	08 May 2024	Stable	Updated and certified against the current SnapLogic Platform release.
February 2024	main25112	14 Feb 2024	Stable	Updated and certified against the current SnapLogic Platform release.
November 2023	main23721	08 Nov 2023	Stable	Updated and certified against the current SnapLogic Platform release.
August 2023	main22460	16 Aug 2023	Stable	Updated and certified against the current SnapLogic Platform release.
May 2023	main21015	10 May 2023	Stable	Upgraded with the latest SnapLogic Platform release.
February 2023	main19844	09 Feb 2023	Stable	Upgraded with the latest SnapLogic Platform release.
December 2022	431patches19431	05 Jan 2023	Latest	Fixed an issue with the Coupa OAuth2 account where the account intermittently failed when refreshing the access token.
November 2022	main18944	10 Nov 2022	Stable	Upgraded with the latest SnapLogic Platform release.
4.30 Patch	430patches17137	19 Aug 2022	Latest	The Coupa Read Snap now reads all the records (using the Next Request) even when the page has fewer records, until the zero record count.
August 2022	main17386	11 Aug 2022	Stable	Upgraded with the latest SnapLogic Platform release.
4.29	main15993	14 May 2022	Stable	Added a new account type Coupa OAuth2 that enables OAuth2 authentication for all Coupa Snaps. Enhanced the Coupa Create and Coupa Update Snaps with the minimum number of output views to zero. The Coupa Account will be deprecated after 4.29 GA, as Coupa will discontinue the support of the API-based authentication in their upcoming September 2022 Release (R34). We recommend that you migrate your existing Pipelines configured with Coupa Account to Coupa OAuth2 Account immediately. Learn more: Coupa API Keys Deprecation.
4.28	main14627	12 Feb 2022	Stable	Upgraded with the latest SnapLogic Platform release.
4.27	main12833	13 Nov 2021	Stable	Upgraded with the latest SnapLogic Platform release.
4.26	main11181	14 Aug 2021	Stable	Upgraded with the latest SnapLogic Platform release.
4.25 Patch	425patches10994	04 Aug 2021	Latest	Enhanced the Snap Pack to support HTTP Proxy Authentication.
4.25	main9554	08 May 2021	Stable	Upgraded with the latest SnapLogic Platform release.
4.24	main8556	13 Feb 2021	Stable	Enhanced the Snap Pack to support Cross-Account IAM role that allows accessing the queues residing in another AWS account.
4.23	main7430	14 Nov 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.22	main6403	12 Sep 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.21 Patch	421patches5851	02 Jun 2020	Latest	Fixed the Coupa Read Snap that is unable to read all the available records.
4.21	snapsmrc542	09 May 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.20	snapsmrc535	08 Feb 2020	Stable	Upgraded with the latest SnapLogic Platform release.
4.19	snaprsmrc528	14 Nov 2019	Stable	Introduced Coupa Snap Pack. Create, update, and fetch Coupa resource records. This Snap Pack includes the following Snaps: Coupa Create: Create Coupa resource records. Coupa Read: Fetch Coupa resource records. Coupa Update: Update Coupa resource records. You can also deactivate Coupa resources using this Snap.

Related Links