Data Exchange API (4)

Download OpenAPI specification:Download

This API provides services to upload, manipulate and download businesspartner data in the CDL Cloud.

Analytics

Build Business Partner Reports

Validation of the request can be found in description of BusinessPartnerReportsRequest below.

SecurityapiKey
Request
Request Body schema: application/json
required

BusinessPartnerReportsRequest

description
string (JobDescription)

Detailed description of a Job.

Example: "I started this job to improve quality of our data."
name
string (JobName)

Name of a Job.

Example: "Process vendor data."
object (BusinessPartnerReportsConfiguration)

Configures if and how business partner reports are generated.

storageId
string (BusinessPartnerStorageId)

Unique identifier of the Storage.

Example: "72d6900fce6b326088f5d9d91049e3e6"
Responses
200

OK

401

Unauthorized

403

Forbidden

404

Not Found

post/businesspartnerreports
Request samples
application/json
{
  • "storageId": "string",
  • "reportsConfiguration": {
    }
}
Response samples
application/json
{
  • "summary": {
    },
  • "id": "35f23c03-1c22-45fe-9484-3ffe769325de",
  • "name": "Process vendor data.",
  • "description": "I started this job to improve quality of our data.",
  • "status": "RUNNING",
  • "statusMessage": "The job failed because storage is empty.",
  • "createdAt": "2024-06-20T07:02:28Z",
  • "user": "742429-234242-4343-232323",
  • "progress": "77",
  • "attachments": [
    ],
  • "storageId": "72d6900fce6b326088f5d9d91049e3e6",
  • "reportsConfiguration": {
    }
}

Build Technical Reports

Validation of the request can be found in description of TechnicalReportsRequest below.

SecurityapiKey
Request
Request Body schema: application/json
required

TechnicalReportsRequest

description
string (JobDescription)

Detailed description of a Job.

Example: "I started this job to improve quality of our data."
name
string (JobName)

Name of a Job.

Example: "Process vendor data."
object (TechnicalReportsConfiguration)

Configures if and how technical reports are generated.

Responses
200

OK

401

Unauthorized

403

Forbidden

404

Not Found

post/technicalreports
Request samples
application/json
{
  • "name": "Process vendor data.",
  • "description": "I started this job to improve quality of our data.",
  • "reportsConfiguration": {
    }
}
Response samples
application/json
{
  • "id": "35f23c03-1c22-45fe-9484-3ffe769325de",
  • "name": "Process vendor data.",
  • "description": "I started this job to improve quality of our data.",
  • "status": "RUNNING",
  • "statusMessage": "The job failed because storage is empty.",
  • "createdAt": "2024-06-20T07:02:28Z",
  • "user": "742429-234242-4343-232323",
  • "progress": "77",
  • "attachments": [
    ],
  • "reportsConfiguration": {
    }
}

Poll Business Partner Reports

Poll Business Partner Reports by id. The id is returned by the build Business Partner Reports request.

SecurityapiKey
Request
path Parameters
id
required
string (JobId)

ID of the Business Partner reports job.

Example: 35f23c03-1c22-45fe-9484-3ffe769325de
Responses
200

OK

401

Unauthorized

403

Forbidden

404

Not Found

get/businesspartnerreports/{id}
Request samples
Response samples
application/json
{
  • "summary": {
    },
  • "id": "35f23c03-1c22-45fe-9484-3ffe769325de",
  • "name": "Process vendor data.",
  • "description": "I started this job to improve quality of our data.",
  • "status": "RUNNING",
  • "statusMessage": "The job failed because storage is empty.",
  • "createdAt": "2024-06-20T07:02:28Z",
  • "user": "742429-234242-4343-232323",
  • "progress": "77",
  • "attachments": [
    ],
  • "storageId": "72d6900fce6b326088f5d9d91049e3e6",
  • "reportsConfiguration": {
    }
}

Poll Technical Reports

Poll Technical Reports by id. The id is returned by the build Technical Reports request.

SecurityapiKey
Request
path Parameters
id
required
string (JobId)

ID of the technical reports job.

Example: 35f23c03-1c22-45fe-9484-3ffe769325de
Responses
200

OK

401

Unauthorized

403

Forbidden

404

Not Found

get/technicalreports/{id}
Request samples
Response samples
application/json
{
  • "id": "35f23c03-1c22-45fe-9484-3ffe769325de",
  • "name": "Process vendor data.",
  • "description": "I started this job to improve quality of our data.",
  • "status": "RUNNING",
  • "statusMessage": "The job failed because storage is empty.",
  • "createdAt": "2024-06-20T07:02:28Z",
  • "user": "742429-234242-4343-232323",
  • "progress": "77",
  • "attachments": [
    ],
  • "reportsConfiguration": {
    }
}