> 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-outbound.md).

# Shipments Outbound

You can use Tracr to send and receive shipments of diamonds. Use the Outbound option to create and manage shipments that you want to send from your inventory to another Tracr account.

{% hint style="info" %}
If you are a producer, you can only create a shipment of rough diamonds that you have registered on Tracr to send to a manufacturer. If you are a manufacturer, you can only create a shipment of polished diamonds to send to a retailer.
{% endhint %}

## Create a new shipment

To transfer diamonds to a new recipient, you must create a shipment which specifies the diamonds that you want to transfer from your inventory.

{% hint style="info" %}
Before you start: Prepare a CSV file with the Tracr IDs of the diamonds you want to transfer. To avoid syntax errors, name the column tracr\_id.

[Download transfer CSV template](https://jcpackages.tracr.network/integration/transfer_out_template.csv)
{% endhint %}

{% stepper %}
{% step %}

### Prepare CSV

Create a CSV containing the Tracr IDs of the diamonds to transfer. Ensure the column name is exactly:

{% code title="transfer.csv" %}

```csv
tracr_id
```

{% endcode %}
{% endstep %}

{% step %}

### Start a new shipment

Select the **New shipment** button at the top of the page.
{% endstep %}

{% step %}

### Upload and specify recipient

Upload your CSV file, enter the recipient's Tracr API URL, and provide a shipment ID.
{% endstep %}

{% step %}

### Track the shipment

The shipment you create initially appears on the **Active** tab and then moves to the **Archived** tab when all diamonds in the shipment have either been transferred, rejected, or cancelled.
{% endstep %}
{% endstepper %}

## Active outbound shipments

The **Active** tab lists the collections of diamonds (shipments) that you want to transfer to a selected recipient. To make a diamond eligible for transfer to another Tracr account, select the **New shipment** button and complete the New Shipment process.

{% hint style="info" %}
When you transfer a diamond out of your inventory, you make it eligible for transfer into the recipient’s Tracr inventory. Tracr sends notifications to the recipient and the diamond appears on the list of eligible diamonds for transfer in.
{% endhint %}

Each active shipment has a status:

* Sent — The recipient has been notified of all the diamonds in the shipment.
* In progress — Some, but not all of the diamonds in the shipment have been accepted, cancelled, or rejected. Applies only to polished shipments.
* Accepting, Cancelling, or Rejecting — Tracr is processing the shipment. Applies only to rough shipments.

### View active shipment details

To view active shipment details and the status of each diamond in the selected shipment, next to a shipment, select **View**.

{% hint style="info" %}
When viewing active shipment details, you can cancel the shipment of a selected diamond or cancel a complete shipment. Tracr only shows the status of a diamond for polished shipments.
{% endhint %}

## Archived outbound shipments

The **Archived** tab lists the collections of diamonds (shipments) that have completed — the recipient has either confirmed or rejected the shipment, or the sender has cancelled the shipment.

Each completed shipment has a status:

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

### View archived shipment details

To view archived shipment details and the status of each diamond in the selected shipment, next to a shipment, select **View**.

{% hint style="info" %}
Tracr only shows the status of a diamond for polished shipments.
{% endhint %}


---

# 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-outbound.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.