> 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-new-shipment.md).

# Shipments Outbound - New Shipment

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

{% hint style="info" %}
Only producers can create rough shipments. Only manufacturers can create polished shipments.
{% endhint %}

## Create a new shipment

{% hint style="info" %}
Before you start: Prepare a CSV file with the Tracr IDs of the diamonds you want to transfer. To avoid errors when you upload the file, name the column containing the Tracr IDs, **tracr\_id**. [Download transfer CSV template](https://jcpackages.tracr.network/integration/transfer_out_template.csv)
{% endhint %}

{% stepper %}
{% step %}

### Select New shipment

From the Shipments Outbound page, select **New shipment** to begin.
{% endstep %}

{% step %}

### Choose integration type and upload CSV

In the **New Shipment** dialog box:

* Select the **Integration type**, either *Rough* or *Polished*.
* Either drag and drop your prepared CSV file onto the page or choose **Select from device** to browse for and select the file that you want to upload.
* Select **Upload**. Look for ‘CSV uploaded successfully' to confirm that Tracr has accepted the file.
  {% endstep %}

{% step %}

### Review the diamonds in the shipment

Review the list of diamonds imported from your CSV. Note that you cannot proceed with the shipment if it contains unavailable diamonds.
{% endstep %}

{% step %}

### Remove unavailable diamonds

If any of the diamonds in the shipment are unavailable:

* Select **Remove** next to the unavailable diamond, or
* Select **Remove all unavailable diamonds**, then select **Confirm**.
  {% endstep %}

{% step %}

### Remove any available diamonds you don't want to ship

To exclude available diamonds from the shipment:

* Select **Remove** next to the diamond, or
* Select the diamonds to remove and then select **Remove** at the bottom of the page.

Then select **Confirm**.
{% endstep %}

{% step %}

### Continue

Select **Continue** to proceed.
{% endstep %}

{% step %}

### Name the shipment

Enter a name to identify the shipment.
{% endstep %}

{% step %}

### Enter recipient API URL

Enter the recipient's Tracr API URL.\
For example: <https://api.\\>\<tracr\_instance\_url>
{% endstep %}

{% step %}

### Send shipment

Select **Send shipment**.
{% endstep %}

{% step %}

### Confirm or cancel

Review the displayed shipment information.

* To confirm the shipment, select **Confirm**.
* To cancel the shipment, select **Cancel**.
  {% endstep %}
  {% endstepper %}

{% hint style="info" %}
You can cancel the shipment after sending until your recipient accepts the shipment.
{% 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-new-shipment.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.