Skip to content

“archivedAuditLine” Resource Type#

Represents an archived audit line as part of Vendor Rating Management in Business Central.

Note

For information about enabling APIs for Business Central, please refer to Enabling APIs for Dynamics 365 Business Central.

Methods#

Method Return Type Description
GET archivedAuditLine archivedAuditLine Gets an archivedAuditLine object.
Navigation Return Type Description
archivedAudit archivedAudit Gets the archived audit associated with the current line.

Properties#

Property Type Description
id Guid The unique ID of the archived audit line. Non-editable.
auditNo String Specifies the number of the associated archived audit.
lineNo Int32 Specifies the number of the current line.
auditQuestionCode String Specifies the code of the question used for this audit line.
description String Specifies the description of the question used for this audit line.
assessmentNumber Decimal Specifies the audit result of the current line.
comment String Specifies a short comment with a maximum length of 100 characters for the current line.
handlingInstructions String Specifies the instructions used for the current line.
auditNote String Specifies the notes on the current audit line that were entered by the auditor.

JSON Representation#

The following code shows a JSON representation of the archivedAuditLine resource.

{
    "id": "GUID",
    "auditNo": "string",
    "lineNo": "int",
    "auditQuestionCode": "string",
    "description": "string",
    "assessmentNumber": "decimal",
    "comment": "string",
    "handlingInstructions": "string",
    "auditNote": "string"
}

HTTP Requests#

Get archivedAuditLines#

Retrieves the properties and relationships of an archivedAuditLine object for Business Central.

HTTP Request#

Replace the URL prefix for Business Central depending on your environment, following the guideline.

GET businesscentralPrefix/kumavision/kvsvrm/v1.0/companies({id})/archivedAuditLines({id})

Request Headers#

Header Value
Authorization Bearer {token}. Required.

Request Body#

For this method, no request body is required.

Response#

If successful, this method returns the 200 OK response code and an archivedAuditLine object in the response body.

Example#

Request

The following code shows an example of the request.

GET https://{businesscentralPrefix}/api/kumavision/kvsvrm/v1.0/companies({id})/archivedAuditLines({id})

Response The following code shows an example of the response.

{
    "@odata.context": "https://{businesscentralPrefix}/api/kumavision/kvsvrm/v1.0/companies({id})/archivedAuditLines",
    "value": [
        {
            "@odata.etag": "W/\"JzIwOzExMjQ2MDYyMjU3MTUwMTgxODI1MTswMDsn\"",
            "id": "3c6e0363-1b39-4cbe-bfa6-e38215dd2bb6",
            "auditNo": "AA554123",
            "lineNo": 10000,
            "auditQuestionCode": "QST1",
            "description": "Is the sustainability strategy in line with that of our company?",
            "assessmentNumber": 35,
            "comment": "Not congruent",
            "handlingInstructions": "1.1 Criteria for ecological responsibility\r\nReduce emissions (greenhouse gases, air pollutants, noise)\r\nImprove waste management (avoid, recycle, dispose of waste properly)\r\n
Treat and discharge wastewater in an environmentally friendly manner\r\nReduce resource consumption (including energy and water) and strengthen energy efficiency\r\nProtect natural ecosystems and biodiversity\r\n\r\n1.2 Social responsibility and human rights criteria\r\nReject forced labor and exploitative child labor\r\nComply with legal requirements regarding wages and working hours\r\nApplication of occupational health and safety measures\r\nAdhere to a general ban on discrimination (gender, origin and religion)\r\nEstablishment of grievance mechanisms and procedures for employees.\r\n\r\n1.3 Criteria for ethical business conduct\r\nCounteract corruption\r\nRecognize property rights of companies\r\nResponsible political participation\r\nPromote fair competition\r\nMaintaining integrity\r\n\r\n1.4 Dealing with conflict minerals (where relevant)\r\nRefrain from using minerals (especially tin, tantalum, tungsten, gold) from conflict areas\r\nVerify origin of minerals\r\nComply with documentation obligations (such as in the EU Conflict Minerals Regulation)\r\nUse initiatives and standards to source conflict-free minerals (e.g., EICC Conflict-Free Sourcing Initiative; OECD Due Diligence Guidelines).",
            "auditNote": "1.1 Criteria for ecological responsibility\r\nReduction of emissions is planned but not yet implemented.\r\nProper disposal is ensured and also certified.\r\nWastewater is treated and ultimately transferred to the municipal sewage system via safe pipes.\r\nEnergy efficiency is very prominent and 100% implemented.\r\nOther areas remain unconsidered for the time being."
        }
    ]
}