Use of the Supplier Data API with Pagination vendorContactsRequests Endpoint

The Supplier Data API with Pagination vendorContactsRequests endpoint uses the POST method to send a JSON request to your site.

Method	Endpoint	Pagination limit per page	Description
`POST`	{{runtime_URL}}/supplierdatapagination/v4/prod/vendorContactsRequests	N/A	Returns the contact details specified in request body filters for suppliers whose IDs are specified.

For example, the following URL returns the contact details of the suppliers mentioned in the request body:

POST{{runtime_URL}}/supplierdatapagination/v4/prod/vendors/vendorContactsRequests?realm=mySiteName

The following example shows a sample request:

{
  "smVendorIds": [
    "S107614566"
  ],
  "erpVendorIds": [
    "2261030"
  ],
  "acmIds": [
    "ACM_590962"
  ]
}

Enter any one value out of smVendorId, erpVendorId, or acmId for each supplier in the request body and the endpoint returns the contact information of those suppliers. The output is returned for a supplier only once even if you enter all the three IDs for the same supplier. The maximum permitted vendor limit in the request body is 100. If you exceed this limit, the system displays an error message that reads "You have entered <number> vendors. Reduce the number so as not to exceed the maximum allowed limit of 100."

The following example shows a sample response for the request above. Note that the response doesn't include contact details for smVendorId S107614566. That's because the vendor doesn't exist in the realm and is therefore ignored.

{
    "vendorDetails": [
        {
            "supplierName": "XYZSolutions",
            "erpVendorId": "2261030",
            "smVendorId": "S10761800",
            "anId": null,
            "acmId": "ACM_590937",
            "vendorContactInfos": [
                {
                    "firstName": "Ptor",
                    "lastName": "Ivanov",
                    "middleName": Igor,
                    "email": "ptor.igor@abc.com",
                    "telephone": 080 1234567890,
                    "title": "Ivanov",
                    "aodObjectId": null,
                    "categories": "All",
                    "mobilePhone": "91 9845921298",
                    "regions": "",
                    "sourceSystem": null,
                    "s4UniqueName": "ptor.igor@abc.com",
                    "type": "Sales",
                    "locale": "ar",
                    "timeZoneId": "ACT",
                    "departments": "0",
                    "mobileCountryName": "India",
                    "telephoneCountryName": "India",
                    "role": null,
                    "timeUpdate": 1690877934315,
                    "timeCreated": 1690263229214,
                    "active": true,
                    "primary": true
                }
            ]
        },
        {
            "supplierName": "PQRSolutions",
            "erpVendorId": "2273037",
            "smVendorId": "S10762100",
            "anId": null,
            "acmId": "ACM_590962",
            "vendorContactInfos": [
                {
                    "firstName": "Thomas",
                    "lastName": "Issac",
                    "middleName": Philip,
                    "email": "thomas.philip@gor.com",
                    "telephone": "080 1234562399",
                    "title": "Philip",
                    "aodObjectId": null,
                    "categories": "All",
                    "mobilePhone": "91 9848765298",
                    "regions": "",
                    "sourceSystem": null,
                    "s4UniqueName": "thomas.philip@gor.com",
                    "type": "Sales",
                    "locale": "ar",
                    "timeZoneId": "ACT",
                    "departments": "0",
                    "mobileCountryName": "India",
                    "telephoneCountryName": "India",
                    "role": null,
                    "timeUpdate": 1690350432251,
                    "timeCreated": 1690350432213,
                    "active": true,
                    "primary": true
                }
            ]
        }
    ]
}

Refer to Supplier Data API with Pagination Header Parameters for information on header parameters and Supplier Data API with Pagination Query and Filter Parameters for information on query and filter parameters.