> 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-help-pages/shipments/shipments-inbound.md).

# Shipments Inbound

You can use Tracr to send and receive shipments of diamonds. Use the **Inbound** option to manage shipments of diamonds that you receive from another Tracr account.

The shipments that you receive initially appear on the **Active** tab and then move to the **Archived** tab when you accept or reject the diamonds in the shipment, or if the sender cancels the shipment.

## Active

The **Active** tab lists the active shipments sent from a producer or manufacturer.

* For a shipment of rough diamonds from a producer, you must either accept or reject the shipment; if accepted, you can then upload diamonds against the shipment (up to the bounds of the shipment's count, total carats, carat range).
* For a shipment of polished diamonds from a manufacturer, you must either accept or reject each diamond in the shipment. When you receive and accept ownership of a polished diamond in a shipment, you become the owner and the diamond is transferred to your inventory.

Each active shipment has a status:

* **Action required** — You need to accept or reject a rough shipment or select **View** to accept or reject diamonds in a polished shipment.
* **Incomplete** — You have accepted a rough shipment but not yet uploaded diamonds using the **Integration Tool**.
* **Processing** — Tracr is processing one or more diamonds within a polished shipment.

{% stepper %}
{% step %}

### Accept or reject a shipment of polished diamonds

To transfer polished diamonds to your inventory, you must first accept ownership of an active shipment. Next to a shipment with the status **Action required**, select **View**.

You can then either **Accept** or **Reject** each diamond in the shipment on the **Accept Ownership of Diamonds** page.

If you do not want to accept a shipment, next to a shipment with the status **Action required**, select **Reject**, and then select **Confirm**. Doing this ends the registration process. Tracr notifies the sender that you have rejected the shipment. This process is irreversible.
{% endstep %}

{% step %}

### Accept or reject a shipment of rough diamonds

To accept or reject rough diamonds sent by a producer, next to a rough shipment with the status **Action required**, select **Accept** or **Reject**, and then select **Confirm**.

If you accept the shipment, you then need to upload diamond data using the **Integration Tool**. To start this process, select **Upload diamonds**. You can also upload diamonds using the Tracr API.

If you reject the shipment, Tracr ends the registration process and notifies the sender that you have rejected the shipment.
{% endstep %}

{% step %}

### Accept a shipment of rough diamonds from a non-De Beers producer

If you are a manufacturer and want to confirm and upload the diamonds from a shipment sent by a non-De Beers producer, next to a rough shipment with the status **Action required**, select **Accept**, and then select **Confirm**.

Once accepted, you will need to upload the diamonds associated with that shipment. To do this, either upload the shipment data using a CSV file and the **Integration Tool** or upload the shipment data via the API, following the same procedure used for De Beers diamonds.

{% hint style="info" %}
Important: When uploading diamonds, instead of providing the box details from De Beers (such as sight, year, and box ID), you will need to provide the **Shipment ID** in the `box_id` column. The **Shipment ID** appears on the **Active** tab, next to the **Sender**.
{% endhint %}
{% endstep %}
{% endstepper %}

## Archived shipments

The **Archived** tab lists the shipments that you have accepted or rejected, and the shipments cancelled by the sender.

* Accept ownership of a shipment or reject diamonds in a polished shipment on the **Accept Ownership of Diamonds** page.
* Accept or reject a rough shipment from the **Active** tab.

Each complete shipment has a status:

* **Complete** — The transfer is complete. All diamonds in the shipment have either been transferred, rejected, or cancelled.
* **Rejected** — The recipient rejected the shipment.
* **Cancelled** — The sender cancelled the shipment.

<details>

<summary>View complete transfer details</summary>

To view complete transfer details for a polished shipment and check whether a diamond was transferred or rejected, next to a shipment, select **View**.

</details>


---

# 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-help-pages/shipments/shipments-inbound.md?ask=<question>&goal=<endgoal>
```

`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.