> For the complete documentation index, see [llms.txt](https://docs.tracr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tracr.com/tracr-articles/lab-eligibility-1.md). # Lab Eligibility {% hint style="warning" %} Lab Eligibility has been updated from Release 1.32. **This is the correct documentation.** {% endhint %} ## Overview Tracr has been working on integrations with trusted grading labs which will allow you to submit a diamond to a grading lab with a Tracr ID to link your grading report to the Tracr digital record. There is also the option with some labs (GIA, IoD) to add your Tracr provenance to the grading report. A diamond needs to have a few requirements met to be eligible for grading through one of our integrations. These include: being a polished diamond and having a supported scan report that Tracr can process. The Portal and Tracr API includes the `LAB ELIGIBLE` status and the breakdown of the eligibility requirements. ## How do I work out if my diamond is eligible for grading? ### Inventory Tracr has provided a column with a `LAB ELIGIBLE` status in the inventory. You are also able to filter on the status and export the result. #### Column There is a column within the inventory, labelled `LAB ELIGIBLE`. Within the column, each polished diamond will have a parent status icon. The parent status icons have been designed to quickly identify diamonds that are either Eligible, or require user input. The options are: 1. Eligible 2. Missing report 3. Missing data 4. Invalid report 5. Not processable
**How will I know what I need to add to the diamond to make it eligible?** If a diamond has a badge with a green checkmark and the word `Eligible` your diamond is eligible for grading. If a diamond has a Error icon or a Warning icon, you will be required to add a scan report that is processable. The badges are hoverable and will give you a popover with more information into what you need to do to fix the diamond record for grading. Below shows an example of the popover for each status. {% tabs %} {% tab title="Eligible" %}
{% endtab %} {% tab title="Missing report" %}
{% endtab %} {% tab title="Missing data" %}
{% endtab %} {% tab title="Invalid report" %}
{% endtab %} {% tab title="Not processable" %}
{% endtab %} {% endtabs %} #### Filtering You will be able to filter your inventory by the `LAB ELIGIBLE` status.
#### How will the Lab eligible column show on the Export Report? There will be a column `Lab Eligible`, with status options: 1. Eligible 2. Missing report 3. Missing data 4. Invalid report 5. Not processable ### Diamond Details The `LAB ELIGIBLE` status is available on the diamond details. ## Lab Eligible Requirements ### Polished Diamond A diamond needs to be polished in your Tracr inventory to be eligible for grading. #### How to upload a polished diamond? Please follow the guidelines detailed [here](https://docs.tracr.com/docs/user-documentation/hm71l585o5ed3-integration#prepare-a-polished-diamond-dataset) to correctly upload a polished diamond. ### Supported Scan Report A diamond needs a supported scan report to be eligible for grading. Tracr currently supports Sarine XML scan reports and Helium HTM and HTML scan reports. > We support Helium Carbon versions that generate a .Ox2z file extension, beginning with Carbon version 1.0.\ > For the latest version, please visit the [official Helium Website](https://lexusindia.in/#software). Example scan reports: * [Sarine XML](https://jcpackages.tracr.network/integration/demo_polished_1.xml) * [Helium HTML](https://jcpackages.tracr.network/integration/example_helium.html) #### Prepare a polished diamond dataset Follow these steps to prepare polished diamond data for upload to Tracr. **Sarine Instructor** If you are using **Sarine Instructor** to provide a scan for polished diamonds, you need to generate an XML report and an STL export. Use the template provided by Tracr to export the report for each diamond. In the CSV file, Tracr needs the STL file in the column **scan**, and the XML report in the column **scan\_report**. [Download Sarine export templates](https://jcpackages.tracr.network/integration/Polished_Diamond_Sarine_Instructor_Export_Template.zip) **Sarine Instructor: Extracting data for polished diamonds** Extracting the required traceability data for polished diamonds using Sarine Instructor software is compatible with the following hardware: * DiaMension * DiaMension HD * DiaMark HD * DiaMark™ HD Once a polished diamond is scanned and the file loaded onto the Instructor software, you can extract the following data points: * Diamond Measurements (using a provided template) * Diamond 3D Model The following instructions describe how to extract the required data. **1. Install the Tracr templates for polished diamonds** * Place the Tracr template file, e.g. ‘TracrPolishedTemplate.txt’, within the Sarine Instructor Export folder:\ Sarine Technologies/Instructor/Export/ **2. Export diamond measurements** 1. Open the stone .srn file in Sarine Instructor. 2. Point to the **Export** icon, and select the corresponding Tracr template, for example, ‘TracrPolishedTemplate.txt’. 3. In the **Save As** dialog box, save the measurements as ‘YourStoneName.xml’. **3. Export the mesh** 1. Open the stone .srn file. 2. Point to the **Save** icon, and select **Save as**. 3. In the **Save As** dialog box, select ‘\*.stl’ as the file type and save the mesh with the stone's name. **Helium software** If you are using **Helium software** to provide a scan for polished diamonds, you need to generate an HTM/HTML report and an STL export. Use the template provided by Tracr to export the report for each diamond. There are two types of Helium template: * Specific shape, only for a handful of shapes with additional information. * Generic, less information but you can use this template for all shapes. | Shape | Recommended template | | -------- | --------------------------------- | | Princess | HTML\_REPORT\_FOR\_PRINCESS | | Radiant | HTML\_REPORT\_FOR\_RADIANT | | Heart | HTML\_REPORT\_FOR\_Any\_Cut | | Pear | HTML\_REPORT\_FOR\_Any\_Cut | | Oval | HTML\_REPORT\_FOR\_OVAL\_MARQUISE | | Marquise | HTML\_REPORT\_FOR\_OVAL\_MARQUISE | | Cushion | HTML\_REPORT\_FOR\_CUSHION | | Emerald | HTML\_REPORT\_FOR\_STEP\_CUT | In the CSV file, Tracr needs the STL file in the column **scan**, and the HTM/HTML report in the column **scan\_report**. For more information about exporting using a Helium Polish Scanner, please refer to the [Helium Polish Scanner - Settings for Export (PDF)](https://www.lexusindia.in/download/download-files/HELIUMPOLISH_SETTINGS_FOR_EXPORTS.pdf). [Download Helium templates](https://jcpackages.tracr.network/integration/helium_templates.zip) {% hint style="warning" %} **Please note:** * Before uploading polished diamond data, please make sure that you register the parent diamond on Tracr. * To verify the polished diamond, a 3D scan and the report of the scan of the diamond are crucial. * Providing the images and videos is optional, however, this will greatly improve the Diamond Experience. * Add the grading document to complete the polished digital asset. {% endhint %} To populate a polished diamond CSV file: 1. Download the polished CSV file template (**Integration Tool > Integration toolkit > CSV Templates**). 2. Populate the CSV file - one row per diamond. 3. It is recommended that you download and use the Data Dictionary (**Integration Tool > Integration toolkit > Data dictionary**) to help you to populate the CSV file. Filter the Data Dictionary by "Stone State = Polished". Ensure that you populate fields with the column "Required = true". ### Processing Scan Report A diamond needs a supported scan report that Tracr can **process** for the shape submitted to be eligible for grading. > What the process checks:\ > \ > **Shape:** It verifies that the declared shape is a supported shape.\ > \ > **Scan Report:** It confirms that the uploaded scan report is valid for the shape submitted. We need specific fields from the scan report to compare to the measurements the grading lab submits. If a diamond's scan report is processable, it **does not** ensure a diamond will be successfully graded. ## FAQs
How can I tell if my diamond is eligible for grading? You will be able to know if your diamond is eligible for grading if it has a checkmark.
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.tracr.com/tracr-articles/lab-eligibility-1.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.