> 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.tracr.com/tracr-help-pages/shipments/shipments-inbound.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
