Coupa Update

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

Type

Format

Number of Views

Compatible Upstream and Downstream Snaps

Description

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

Field Name

Field Type

Description

Label*

 

Default ValueCoupa Update
ExampleUpdate 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 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.