“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."
        }
    ]
}