Retrieving Supplier Data Using Supplier Data Extraction API

Use this procedure to retrieve supplier data from your procurement solution using the Supplier Data Extraction API.

Context

After you've identified the realm ID and the IDs for each supplier, you can use the Supplier Data Extraction API to retrieve the supplier data.

Procedure

  1. The client application sends a request that passes the realm ID and the supplier IDs, using the POST /jobs endpoint.
    POST {{runtime_url}}/jobs?realm=realmID
    Request body {
    	Content-Type: {
    				"mode": "raw",
    				"raw": "[\"0000003003\"]"
    	}
    }
    realmID
    The ID of the realm for your procurement solution where the supplier data exists. This is a mandatory value.
    "[\"0000003003\"]"
    Replace with the list of supplier IDs. This is a mandatory value.

    You receive a 202 or 400 message. If it's a 202 message, it also contains the job ID for the data retrieval request in the response header.

  2. The client application sends a request that passes a job ID using the GET /jobs/{jobID} endpoint.
    GET {{runtime_url}}/jobs/jobID?realm=realmID
    jobID
    The job ID received in the 202 success message in response to the POST request. This is a mandatory value.
    realmID
    The ID of the realm for your procurement solution where the supplier data exists. This is a mandatory value.

    You receive a 200, 400, or 404 message.