---
title: Stock Test Result
---

## Stock Test Result

Stock items which are associated with a [testable part](../part/index.md#testable) can have associated test data - this is particularly useful for tracking unit testing / commissioning / acceptance data against a serialized stock item.

The master "Part" record for the stock item can define multiple [test templates](../part/test.md), against which test data can be uploaded. Additionally, arbitrary test information can be assigned to the stock item.

{{ image("stock/test_results.png", title="Stock Item Test Results") }}

### Test Result Fields

#### Test Template

The *template* field links to a [Part Test Template](../part/test.md#part-test-templates) object. Each test result instance must link to a test template.

#### Result

Boolean pass/fail status of the test.

#### Value

Optional value uploaded as part of the test data. For example if the test is to record the firmware version of a programmed device, the version number can be added here.

#### Notes

Optional field available for extra notes.

#### Attachment

A given test result may require an attached file which contains extra test information.

### Multiple Test Results

Multiple results can be uploaded against the same test name. In cases where multiple test results are uploaded, the most recent value is used to determine the pass/fail status of the test. It is useful to keep all test records as a given test might be required to run multiple times, if (for example) it fails the first time and then something must be fixed before running the test again.

### Reporting

For any information regarding the reporting architecture, please refer to the [Report Generation](../report/report.md) page.

### Automated Test Integration

The stock item testing framework is especially useful when integrating with an automated acceptance testing framework. Test results can be uploaded using the [InvenTree API](../api/index.md) or the [InvenTree Python Interface](../api/python/index.md).

!!! info "Example"
	You design and sell a temperature sensor which needs to be calibrated before it can be sold. An automated calibration tool sets the offset in the device, and uploads a test result to the InvenTree database.
