Skip to content
Documentation
Contact
← Back to documentation
Technical Reference

SAP Ariba

Automate procurement, contracts, and invoices with SAP Ariba.

CategoryBusiness Intelligence
Authenticationcustom
Version0.0.8
Published scopes0 published scopes
Last updatedSeptember 30, 2026

Overview

Connect SAP Ariba with Flows360

Automate procurement, contracts, and invoices with SAP Ariba.

Use the SAP Ariba connector to include its declared actions and events in Flows360 workflows without duplicating the integration logic inside each consuming system. This pinned connector version currently exposes 14 actions and no declared triggers.

Available actions

  • List Purchase Orders
  • List Purchase Order Line Items
  • Get Document Changes
  • Get Pending Approvables
  • Get Catalog Items
  • Get Active Catalogs
  • Get Facet Data
  • List Invoices
  • Plus 6 additional declared actions.

Available triggers

  • No triggers are declared in this pinned package.

The capability list above is generated from the exact reviewed connector package so the public description stays aligned with the version Flows360 operates.

Technical guide

Technical reference

Package identity

  • Connector: SAP Ariba
  • Package: @activepieces/piece-sap-ariba@0.0.8
  • Exact artifact digest: sha256:5d49cbcd7e652b03ef8f68b81791ae422e80c05e39abdc4193614f964a4b6f7c
  • Runtime: Activepieces-compatible deterministic worker
  • Source: the exact reviewed Activepieces source

Authentication

CUSTOM AUTH. Connection values are tenant-specific and remain in the consuming Studio instance; CDK stores definitions and field metadata, not customer credential values.

Action contracts

  • List Purchase Orders (list_purchase_orders), Retrieves purchase order header information for a specified buyer. Classification: read.
  • List Purchase Order Line Items (list_purchase_order_items), Retrieves line item information from purchase orders for a specified buyer. Classification: read.
  • Get Document Changes (get_document_changes), Returns the list of changes to approvable documents. Classification: read.
  • Get Pending Approvables (get_pending_approvables), List all documents/tasks that are pending approval. Classification: read.
  • Get Catalog Items (get_catalog_items), Get list of filtered catalog items for a specific supplier. Classification: read.
  • Get Active Catalogs (get_active_catalogs), Get list of active catalog data & supplier values from the specified date. Classification: read.
  • Get Facet Data (get_facet_data), Get list of Facet data against realm. Classification: read.
  • List Invoices (list_invoices), Retrieves header information of one or more invoices in Ariba Network. Classification: read.
  • Search Contract Workspaces (search_contract_workspaces), Search contract workspaces based on attributes such as title, contract ID, region, etc. Classification: read.
  • Get Contract Workspace (get_contract_workspace), Search for a contract workspace using a unique identifier. Classification: read.
  • Create Contract Workspace (create_contract_workspace), Create a new contract workspace in SAP Ariba Contracts. Classification: read.
  • Update Contract Workspace (update_contract_workspace), Update an existing contract workspace in SAP Ariba Contracts. Classification: read.
  • Update Contract Status (update_contract_status), Change the status of a contract workspace (e.g., amend, putOnHold, resume, close). Classification: read.
  • Delete Contract Workspace (delete_contract_workspace), Delete a contract workspace in SAP Ariba Contracts. Classification: read.

Trigger contracts

  • No trigger delivery contracts are declared.

Verification

Runtime execution evidence is managed separately from package metadata.

Capability summary

Authenticationcustom
Supported objects14
Supported actions14
TriggersNone published

Authentication

Authentication method: custom

Authentication profiles

connection · custom
  • Application Key (APIKey) Required · protected credential
  • API Base URL Required
  • OAuth Client ID Optional
  • OAuth Client Secret Optional · protected credential
  • OAuth Server URL Prefix Optional

Supported objects

ObjectReadWriteNotes
List Purchase Orders Yes No Retrieves purchase order header information for a specified buyer.
List Purchase Order Line Items Yes No Retrieves line item information from purchase orders for a specified buyer.
Get Document Changes Yes No Returns the list of changes to approvable documents.
Get Pending Approvables Yes No List all documents/tasks that are pending approval.
Get Catalog Items Yes No Get list of filtered catalog items for a specific supplier.
Get Active Catalogs Yes No Get list of active catalog data & supplier values from the specified date.
Get Facet Data Yes No Get list of Facet data against realm.
List Invoices Yes No Retrieves header information of one or more invoices in Ariba Network.
Search Contract Workspaces Yes No Search contract workspaces based on attributes such as title, contract ID, region, etc.
Get Contract Workspace Yes No Search for a contract workspace using a unique identifier.
Create Contract Workspace Yes No Create a new contract workspace in SAP Ariba Contracts.
Update Contract Workspace Yes No Update an existing contract workspace in SAP Ariba Contracts.
Update Contract Status Yes No Change the status of a contract workspace (e.g., amend, putOnHold, resume, close).
Delete Contract Workspace Yes No Delete a contract workspace in SAP Ariba Contracts.

Supported actions

List Purchase Orders · Read

Retrieves purchase order header information for a specified buyer.

list_purchase_orders · Risk: low · Retry: safe

Inputs

  • buyerANID · string · Required, The buyer's Ariba Network ID.
  • supplierANID · string · Optional, Filter by supplier's Ariba Network ID.
  • documentNumber · string · Optional, Filter by order ID / purchase order number.
  • orderStatus · string · Optional, Filter by order processing state.
  • routingStatus · string · Optional, Filter by routing status.
  • startDate · string · Optional, Filter orders received on or after this date. Max range: 31 days.
  • endDate · string · Optional, Filter orders received on or before this date. Max range: 31 days.
  • top · number · Optional, Number of items to return.
  • skip · number · Optional, Number of items to skip.
List Purchase Order Line Items · Read

Retrieves line item information from purchase orders for a specified buyer.

list_purchase_order_items · Risk: low · Retry: safe

Inputs

  • buyerANID · string · Required, The buyer's Ariba Network ID.
  • documentNumber · string · Optional, Filter by order ID / purchase order number.
  • orderStatus · string · Optional, Filter by order processing state.
  • routingStatus · string · Optional, Filter by routing status.
  • startDate · string · Optional, Filter orders received on or after this date. Max range: 31 days.
  • endDate · string · Optional, Filter orders received on or before this date. Max range: 31 days.
  • top · number · Optional, Number of items to return.
  • skip · number · Optional, Number of items to skip.
Get Document Changes · Read

Returns the list of changes to approvable documents.

get_document_changes · Risk: low · Retry: safe

Inputs

  • realm · string · Required, Unique identifier of the realm.
  • changeSequenceId · number · Optional, Only return changes after this sequence ID. Leave empty to get all changes.
  • count · boolean · Optional, Include total count in response.
  • top · number · Optional, Number of records to return (max 1000, default 10).
  • skip · number · Optional, Number of records to skip.
Get Pending Approvables · Read

List all documents/tasks that are pending approval.

get_pending_approvables · Risk: low · Retry: safe

Inputs

  • realm · string · Required, Unique identifier of the realm.
  • approvableType · string · Optional, Filter by document type.
  • user · string · Optional, Filter by username.
  • passwordAdapter · string · Optional, Filter by password adapter.
  • count · boolean · Optional, Include total count in response.
  • top · number · Optional, Number of records to return (max 100, default 100).
  • skip · number · Optional, Number of records to skip.
Get Catalog Items · Read

Get list of filtered catalog items for a specific supplier.

get_catalog_items · Risk: low · Retry: safe

Inputs

  • realm · string · Required, Realm name.
  • catalogName · string · Required, Name of the catalog.
  • supplierId · string · Required, Supplier ID domain value pair (e.g., buyersystemid:Supplier16).
  • select · string · Required, Output fields to return, comma-separated (e.g., SupplierPartId,SupplierId,LeadTime).
  • rsqlfilter · string · Optional, Optional RSQL filter expression (e.g., CatalogName==JCNTechnologies).
  • offset · number · Required, Starting position for results.
  • limit · number · Optional, Maximum number of items to return (default 1000).
Get Active Catalogs · Read

Get list of active catalog data & supplier values from the specified date.

get_active_catalogs · Risk: low · Retry: safe

Inputs

  • realm · string · Required, Realm name.
  • date · string · Required, Get catalogs activated from this date (ISO format).
  • supplierdomain · string · Optional, Filter by Supplier Domain ID (e.g., buyersystemid:Supplier16).
  • subscriptionName · string · Optional, Filter by Subscription Name.
  • showAll · boolean · Optional, Show all records.
  • showAdditionalFields · boolean · Optional, Include additional fields in response.
Get Facet Data · Read

Get list of Facet data against realm.

get_facet_data · Risk: low · Retry: safe

Inputs

  • realm · string · Required, Realm name.
  • select · string · Required, Facet field to select (e.g., ClassificationCode).
  • rsqlfilter · string · Required, RSQL Filter expression (e.g., CatalogName==JCNTechnologies).
List Invoices · Read

Retrieves header information of one or more invoices in Ariba Network.

list_invoices · Risk: low · Retry: safe

Inputs

  • anId · string · Required, Buyer/Supplier Ariba Network ID (ANID).
  • buyerANID · string · Optional, Filter by Buyer's ANID.
  • supplierANID · string · Optional, Filter by Supplier's ANID.
  • documentNumber · string · Optional, Filter by Invoice Document Number.
  • documentStatus · string · Optional, Filter by processing status.
  • routingStatus · string · Optional, Filter by routing status.
  • startDate · string · Optional, Filter by creation date (start).
  • endDate · string · Optional, Filter by creation date (end).
  • documentStatusUpdatedStartDate · string · Optional, Filter by status updated date (start).
  • documentStatusUpdatedEndDate · string · Optional, Filter by status updated date (end).
  • documentPurpose · string · Optional, Filter by document purpose.
  • includeInvoiceProfile · boolean · Optional, Display Invoice Profile related fields (e.g., Address, Tax Id).
  • top · number · Optional, Number of items to return (max 100).
  • skip · number · Optional, Number of items to skip.
Search Contract Workspaces · Read

Search contract workspaces based on attributes such as title, contract ID, region, etc.

search_contract_workspaces · Risk: low · Retry: safe

Inputs

  • realm · string · Required, Unique identifier of the realm.
  • user · string · Required, User ID to perform the action on behalf of.
  • passwordAdapter · string · Required, Password adapter to authenticate the user.
  • select · string · Optional, Comma-separated metadata fields to retrieve (e.g., title,contractid,region).
  • filter · string · Optional, Filter criteria (e.g., LastModified ge '2023-01-01T00:00:00Z').
  • top · number · Optional, Number of records to return (default 500, max 500).
  • skip · number · Optional, Number of records to skip.
  • count · boolean · Optional, Include total number of records in response.
  • expand · string · Optional, Additional information to fetch (e.g., relatedFactories).
Get Contract Workspace · Read

Search for a contract workspace using a unique identifier.

get_contract_workspace · Risk: low · Retry: safe

Inputs

  • realm · string · Required, Unique identifier of the realm.
  • user · string · Required, User ID to perform the action on behalf of.
  • passwordAdapter · string · Required, Password adapter to authenticate the user.
  • contractId · string · Required, Contract ID (e.g., CW0001).
  • expand · string · Optional, Additional information to fetch (e.g., relatedFactories).
Create Contract Workspace · Read

Create a new contract workspace in SAP Ariba Contracts.

create_contract_workspace · Risk: low · Retry: safe

Inputs

  • realm · string · Required, Unique identifier of the realm.
  • user · string · Required, User ID to perform the action on behalf of.
  • passwordAdapter · string · Required, Password adapter to authenticate the user.
  • title · string · Required, Contract workspace title.
  • description · string · Optional, Contract workspace description.
  • templateId · string · Optional, Template ID for the contract workspace.
  • effectiveDate · string · Optional, Contract effective date.
  • expirationDate · string · Optional, Contract expiration date.
  • contractAmount · number · Optional, Contract amount value.
  • contractCurrency · string · Optional, Currency code (e.g., USD).
  • ownerUniqueName · string · Optional, Owner user unique name.
  • ownerPasswordAdapter · string · Optional, Owner password adapter.
  • supplierName · string · Optional, Supplier organization name.
  • supplierSystemId · string · Optional, Supplier system ID.
  • isTestProject · boolean · Optional, Mark as test project.
  • additionalFields · object · Optional, Additional fields as JSON object to merge with the request body.
Update Contract Workspace · Read

Update an existing contract workspace in SAP Ariba Contracts.

update_contract_workspace · Risk: low · Retry: safe

Inputs

  • realm · string · Required, Unique identifier of the realm.
  • user · string · Required, User ID to perform the action on behalf of.
  • passwordAdapter · string · Required, Password adapter to authenticate the user.
  • contractId · string · Required, The ID of the contract workspace to update.
  • silentUpdate · string · Optional, Update without changing the last modified date.
  • title · string · Optional, New title.
  • description · string · Optional, New description.
  • effectiveDate · string · Optional, New effective date.
  • expirationDate · string · Optional, New expiration date.
  • contractAmount · number · Optional, New contract amount value.
  • contractCurrency · string · Optional, Currency code (e.g., USD).
  • amendmentReason · string · Optional, Reason for amendment.
  • additionalFields · object · Optional, Additional fields as JSON object to merge with the request body.
Update Contract Status · Read

Change the status of a contract workspace (e.g., amend, putOnHold, resume, close).

update_contract_status · Risk: low · Retry: safe

Inputs

  • realm · string · Required, Unique identifier of the realm.
  • user · string · Required, User ID to perform the action on behalf of.
  • passwordAdapter · string · Required, Password adapter to authenticate the user.
  • contractId · string · Required, The ID of the contract workspace.
  • action · string · Required, The status change action to perform.
  • amendmentType · string · Optional, Required if action is Amend.
  • amendmentReason · string · Optional, Reason for the amendment.
  • isTemplateUpgradeRequired · boolean · Optional, Whether template upgrade is required (for Amend action).
Delete Contract Workspace · Read

Delete a contract workspace in SAP Ariba Contracts.

delete_contract_workspace · Risk: low · Retry: safe

Inputs

  • realm · string · Required, Name of the SAP Ariba Contract site (e.g., testrealm).
  • user · string · Required, User ID to perform the action on behalf of (e.g., testUser).
  • passwordAdapter · string · Required, Password adapter to authenticate the user (e.g., PasswordAdapter1).
  • contractId · string · Required, The ID of the contract workspace to delete (e.g., CW0001).

Setup

Setup

  1. Add the SAP Ariba connector to the workflow in the target Flows360 Studio instance.
  2. Create or select the tenant-specific connection required by the connector. Connection secrets remain in the Studio connection boundary and are not copied into CDK documentation.
  3. Provide the connection fields declared by the pinned package:
  • Application Key (APIKey) (apiKey), required; stored as a sensitive connection value.
  • API Base URL (baseUrl), required.
  • OAuth Client ID (clientId), optional.
  • OAuth Client Secret (clientSecret), optional; stored as a sensitive connection value.
  • OAuth Server URL Prefix (oauthServerUrl), optional.
  1. Select the required action or trigger and complete its declared input fields. Required and optional inputs are defined by the exact package schema.
  2. Test the workflow in the appropriate environment before enabling production scheduling or event delivery.

Limitations

Limitations and operational notes

  • This content describes @activepieces/piece-sap-ariba@0.0.8; provider behaviour can change independently and should be revalidated when the provider or connector version changes.
  • Only the 14 actions and 0 triggers declared by this pinned package are represented here.
  • Tenant credentials and connection values are not stored in the public connector record.
  • Provider-side permissions, account entitlements, quotas and rate limits remain subject to the connected provider account and are not inferred when the package does not declare them.
  • Runtime execution evidence is managed separately from package metadata.

Troubleshooting

Why canu2019t the connector authenticate?

Check the tenant connection in Studio and confirm every required SAP Ariba connection field is present. Re-authorise OAuth-based connections if the provider token or consent has expired. Do not place credential values in CDK content or logs.

Why is an action or trigger unavailable?

Confirm that the workflow is using @activepieces/piece-sap-ariba@0.0.8 and compare the requested capability with the declared action and trigger list for this version. A capability that is not declared by the pinned package should not be presented as supported.

What should I check after a provider-side change?

Revalidate authentication, required fields, action/trigger behaviour and provider documentation before publishing refreshed connector content or moving a new package version into production.

github.com