Coupa Update

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

TypeFormatNumber of ViewsCompatible Upstream and Downstream SnapsDescription
Input Document
  • Min: 1
  • Max: 1
  • Mapper Snap
  • Copy Snap
The resource details as a JSON document.
OutputDocument
  • 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 NameField TypeDescription

Label*


Default ValueCoupa Update
Example
Update Supplier Info


StringThe 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 Valueall
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 ValueNot 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

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

  File Modified

File CoupaUpdate_UpdatingSupplier_UsesCustomFields.slp

Nov 01, 2019 by Mohammed Iqbal


Snap Pack History

 Click here to expand...
ReleaseSnap Pack VersionDateTypeUpdates
August 2024main27765 StableUpdated and certified against the current SnapLogic Platform release.
May 2024main26341 StableUpdated and certified against the current SnapLogic Platform release.
February 2024main25112 StableUpdated and certified against the current SnapLogic Platform release.
November 2023main23721 StableUpdated and certified against the current SnapLogic Platform release.

August 2023

main22460

 

Stable

Updated and certified against the current SnapLogic Platform release.

May 2023main21015 StableUpgraded with the latest SnapLogic Platform release.
February 2023main19844 StableUpgraded with the latest SnapLogic Platform release.
December 2022431patches19431 Latest

Fixed an issue with the Coupa OAuth2 account where the account intermittently failed when refreshing the access token.

November 2022main18944 Stable

Upgraded with the latest SnapLogic Platform release.

4.30 Patch430patches17137 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 2022main17386 StableUpgraded with the latest SnapLogic Platform release.
4.29main15993 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.28main14627 StableUpgraded with the latest SnapLogic Platform release.

4.27

main12833

 

Stable

Upgraded with the latest SnapLogic Platform release.
4.26main11181 StableUpgraded with the latest SnapLogic Platform release.
4.25 Patch425patches10994 Latest

Enhanced the Snap Pack to support HTTP Proxy Authentication.

4.25main9554
 
StableUpgraded with the latest SnapLogic Platform release.
4.24main8556
Stable

Enhanced the Snap Pack to support Cross-Account IAM role that allows accessing the queues residing in another AWS account.

4.23main7430
 
StableUpgraded with the latest SnapLogic Platform release.
4.22main6403
 
StableUpgraded with the latest SnapLogic Platform release.
4.21 Patch421patches5851 Latest

Fixed the Coupa Read Snap that is unable to read all the available records.

4.21snapsmrc542

 

StableUpgraded with the latest SnapLogic Platform release.
4.20snapsmrc535
 
StableUpgraded with the latest SnapLogic Platform release.
4.19snaprsmrc528
 
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 Re