Coupa Create

In this article

Overview

You can use this Snap to create a record in the selected Coupa resource, for example accounts, suppliers, approvals, and contracts by using the relevant resource APIs. You can use this Snap only to select the resource in which the record is to be created; all record-related parameters must be passed through an upstream Snap such as the Mapper Snap. 

Prerequisites

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

Limitations

None.

Snap Views

TypeFormatNumber of ViewsCompatible Upstream and Downstream SnapsDescription
Input Document
  • Min: 1
  • Max: 1
  • Mapper Snap
  • Copy Snap
The record details as a JSON document.
OutputDocument
  • Min: 0
  • Max: 1
  • Coupa Read
  • Document to Binary + File Writer

Details of the record along with the record ID. Level of detail varies according to the configuration of the Response Type field. Each record is assigned a unique ID.

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 Create
Example
Coupa Create Users

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 Value: all
Example
shallow

String

Specifies 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 record created.
  • none: No output.
  • limited: Output contains only the ID.
  • shallow: Output contains ID and the direct child attributes of the record.

See API Return Formats for more details.

API Path*


Default Value: N/A
Example
suppliers

String/ExpressionThe API name associated with the target resource. Select the target resource from the suggestions in the field. Suggestions vary based on the account.

Snap Execution


Default ValueExecute only
Example
Validate & Execute

Dropdown list

Specifies the execution type:

  • Validate & Execute: Performs limited execution of the Snap (up to 50 records) during Pipeline validation; performs full execution of the Snap (unlimited records) during Pipeline execution.
  • Execute only: Performs full execution of the Snap during Pipeline execution; does not execute the Snap during Pipeline validation.
  • Disabled: Disables the Snap and, by extension, its downstream Snaps.

Example

Creating an Account Type Record

This example demonstrates how to create a record for a specific Coupa account type.

Download the example Pipeline

Parameters for the resource record to be created must be supplied through an upstream Snap. You can use Snaps such as JSON Generator, Mapper, or even File Reader if the parameters are present in the SLDB. In this example, we pass the parameters directly using the Mapper Snap. When you connect a Mapper Snap to the Coupa Create Snap, the selected Coupa resource's schema is not readily available in the Mapper Snap. Validate the Pipeline once to get the target resource schema in the Mapper Snap. After the schema is available, you can map the input data to the corresponding fields. 

The Mapper Snap is configured as follows:

Each resource category has its own mandatory parameters. If they are not provided, the Snap shows a Bad Request error. See Resources for details.  

Output from the Mapper Snap:

This data goes into the Coupa Create Snap configured as shown below:

On execution, the Coupa Create Snap creates an account and assigns an ID to it in the Coupa instance.

You can add more Snaps downstream of the Coupa Create Snap for further processing as needed.

Downloads

Important steps to successfully reuse Pipelines

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

  File Modified

File CoupaCreate_CreatingAccount.slp

Nov 01, 2019 by Mohammed Iqbal

Snap Pack History

 Click here to expand...
ReleaseSnap Pack VersionDateTypeUpdates
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 Read: Fetch Coupa resource records.
    • Coupa Update: Update Coupa resource records. You can also deactivate Coupa resources using this Snap.


Related Links


 Click here to expand...
ReleaseSnap Pack VersionDateTypeUpdates
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 Read: Fetch Coupa resource records.
    • Coupa Update: Update Coupa resource records. You can also deactivate Coupa resources using this Snap.