Request Filter and Output Values for the vendorContactsRequests Endpoint

The JSON request that the vendorContactsRequests endpoint of the Supplier Data API with Pagination sends to your site uses name/value pairs or arrays to specify the data you want to return in output.

The following table describes the valid values for name/value pairs and arrays in request body. Any one of these values is mandatory in the request body.

Name/Value Pair or Array

Description

Valid Values

smVendorIds

A unique ID that SAP Ariba assigns automatically to suppliers in SAP Ariba Supplier Lifecycle and Performance or SAP Ariba Supplier Information and Performance Management (new architecture).

One or more valid SM vendor IDs for suppliers in your site, separated by commas.

erpVendorIds

A mandatory ID for the supplier, which must be unique in combination with the supplier's source system. For more information, see Supplier IDs in SAP Ariba Supplier Lifecycle and Performance

One or more valid ERP vendor IDs for suppliers in your site, separated by commas.

acmIds

A unique ID assigned by SAP Ariba that identifies suppliers internally within SAP Ariba applications. Suppliers created in SAP Ariba Strategic Sourcing Suite and SAP Ariba Supplier Management solutions typically have ACM IDs that start with ACM_

One or more valid ACM IDs for suppliers in your site, separated by commas.

Output Fields

JSON responses include the following fields:

Field

Notes

supplierName

The name of the supplier. In general, erpVendorId associates a contact with a supplier.

erpVendorId

The ID of the supplier in the integrated ERP system.

smVendorId

The ID that SAP Ariba assigns to the supplier.

anId

An ID that SAP Business Network automatically assigns to suppliers when they create accounts.

acmId

A unique ID assigned by SAP Ariba that identifies suppliers internally within SAP Ariba applications.

firstName

The first name of the supplier contact.

lastName

The last name of the supplier contact.

middleName

The middle name of the supplier contact.

email

The supplier contact's email address.

telephone

The supplier contact's land line telephone number.

title

The supplier contact's title.

aodObjectId

Indicates whether a supplier is private or public.

categories

The commodities for which the supplier contact is responsible.

mobilePhone

The supplier contact's mobile telephone number.

regions

The regions for which the supplier contact is responsible.

s4UniqueName

The unique name of the supplier contact in SAP Ariba Strategic Sourcing Suite

type

The type of the supplier contact that matches one of the types defined for your site.

locale

The ISO code for the supplier contact's language.

timeZoneId

The ID of the timezone where the supplier contact is located.

departments

The departments associated with the contact, if any.

mobileCountryName

The country/region of the supplier contact's mobile telephone number. SAP Ariba Supplier Management solutions automatically insert a plus sign (+) before of the country/region code in user interface display and JSON responses.

telephoneCountryName

The country/region of the supplier contact's land line telephone number.

role

role

timeUpdated

The date and time when the contact was last updated.

timeCreated

The date and time when the contact was created.

Is Primary

A Boolean value that specifies whether or not the supplier contact is the primary contact for the supplier. Valid values are TRUE and FALSE.

isActive

A Boolean value that specifies whether the contact is active (TRUE) or deactivated (FALSE). If this field is empty, the contact is active.