Audits and Corrective Actions export API
Audit fields
The following fields are available for audits:
Name | Description | Data type |
---|---|---|
Audit id | Unique id for the audit | String |
Status | Can be | String |
Planned date | If chosen, this will show the planned date of the audit | Date |
Audit start time | The time when the first action was taken by the auditor (this could be taking a photo, writing a comment, or choosing an answer in multiple choice, etc. ). It does not reflect the time of download. | DateTime |
Audit end time | The time when the auditor submitted the audit. Qarma supports off line operations, so there can be a difference between the | DateTime |
Supplier name | The name of the supplier | String |
Supplier number | The number of the supplier | String |
Auditor name | The name of the auditor | String |
Auditor email | The auditor’s email | String |
Production unit name | The name of the production unit (if any) | String |
Production unit number | The number of the production unit (if any) | String |
Production unit address | The address of the production unit (if any) | String |
Latitude | Tracking based on the last photo taken in this inspection | Float |
Longitude | Tracking based on the last photo taken in this inspection | Float |
Accuracy | For the GPS coordinates, this is the accuracy | Number |
Auditor comment | This will show the comment given by the auditor when submitting the audit (if any) | String |
Checklist id | The id of the checklist used for the audit | String |
Checklist name | The name of the checklist used for the audit | String |
Checklist revision | The revision number of the checklist used at the point of time the audit was downloaded | Integer |
Link to report | http-link to the online audit report | String |
Audit type | The type of audit | String |
Auditor conclusion | The conclusion which the auditor selected when submitting the audit | String |
Final conclusion | The final conclusion chosen. This can differ from auditor conclusion if for example there is an approval flow or the conclusion was revised after submitting the report. In most cases this is the conclusion to use for downstream analysis. | String |
Checkpoints fields
The following fields are available for audit checkpoints:
Name | Description | Data type |
---|---|---|
Checkpoint id | The id of the audit’s checkpoint. It's unique to the audit, meaning that the same checkpoint on another audit will have a different | String |
Checkpoint type | The type of checkpoint (Multiple choice, Standard, Text, Text Table, Measurements, Production Unit Custom Fields*, Supplier Custom Fields*) | String |
Audit id | Unique id of the audit. Can be used for mapping the Checkpoints-data with the Audits-data | String |
Checkpoint header | Name of the checkpoint header | String |
Checkpoint | The checkpoint text | String |
Status | Status of the checkpoint type “Standard” if the status-buttons was enabled. Status' include the following: “Checked Not OK”, “Checked OK”, “Not Applicable”, and “Pending”. | String |
Comment | Comments written on the checkpoint by the Auditor during the audit | String |
Multiple choice | The auditor’s chosen answer on a multiple choice checkpoint. If multi-selection is allowed and the Auditor selected multiple choices, the answers will show as comma-separated strings | String |
Score | The score (if applicable) of the auditor’s chosen answer on a multiple choice checkpoint. Note that scores on multiple choice checkpoints is not mandatory and can therefore be blank. | Integer |
Max score | The maximum possible score that a multiple choice checkpoint can result in, no matter what the auditor chose. | Integer |
Raw data | The raw checkpoint data as JSON format. | JSON |
* The Checkpoint type of “Production Unit Custom Fields” and “Supplier Custom Fields” needs to be enabled by a Qarma employee.
Corrective Actions fields
The following fields are available for corrective actions:
Name | Description | Data type |
---|---|---|
Corrective action id | Unique id of the corrective action | String |
Audit id | Unique id of the audit. Can be used for mapping the Corrective Actions-data with the Audits-data | String |
Status | The status of corrective action. Can be one of the following: “Finding”, “In progress”, “Review”, and “Closed” | String |
Finding | The finding of the corrective action | String |
Requires evidence from app | Is “true” if evidence is required from the app and “false” if not. | Boolean |
Description | The description of the corrective action | String |
Approver comment | The comment made by the Approver when setting the status of the corrective action | String |
Created | Time of which the corrective action was created | DateTime |
Due | The selected due date of the corrective action | Date |
Resolved | The time of when the corrective action was resolved | String |
Checkpoint id | If the corrective action was created from a checkpoint of an audit this field will show the unique id of the checkpoint. The id is unique to the audit, meaning that the same checkpoint on another audit will have a different | String |
Supplier id | The unique id of the supplier | String |
Supplier name | The name of the supplier | String |
Supplier number | The number of the supplier | String |
Production unit id | The unique id of the production unit (if any) | String |
Production unit name | The name of the production unit (if any) | String |
Production unit number | The number of the production unit (if any) | String |
Responsible name | The name of the user responsible for resolving the corrective action | String |
Responsible email | The email of the user responsible for resolving the corrective action | String |
Approver name | The name of the user responsible for approving the corrective action | String |
Approver email | The email of the user responsible for approving the corrective action | String |