# Create a shipment

> Create a shipment for one or more production orders from a factory, split it across destinations, and add the carrier, dates and cost.

Source: https://docs.vestislabs.com/production/production-shipping-create-shipment/

Create a shipment when goods leave a factory. One shipment can carry several production orders from the same factory and can be delivered to more than one warehouse.

**Where to find it:** Production → Shipping & Tracking → Create Shipment
**Requires:** permission `UPDATE_BRAND_PRODUCTION`

## Before you start

- You need permission to update brand production. Without it, the **Create Shipment** button is not shown.
- The production orders must already exist. See [Production orders](https://docs.vestislabs.com/production/production-orders/).
- The factory (supplier), the delivery locations (warehouses) and the carrier must already be set up in **Management**.

## Create a shipment

1. **Click "Create Shipment"**
   On **Shipping & Tracking**, click **Create Shipment** (with a plus icon) at the top right. The **Create New Shipment** dialog opens: *Create a shipment for one or more production orders with multiple destinations*.

   ![The Create New Shipment dialog as it opens, with the Origin Factory and Shipment Type sections](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/60-button.webp)

2. **Choose the factory**
   Under **Origin Factory**, select the **Factory \*** from the dropdown. Its address, city, postcode and country appear underneath, or a note such as *No address available* when they are not filled in.

   ![The factory chosen, with its address shown underneath and its production orders listed](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/61-factory.webp)

3. **Choose the shipment type**
   Under **Shipment Type**, check **Full Shipment** or **Partial Shipment**. Full is selected by default. Choose **Partial Shipment** when you want to pick styles and quantities yourself.

   ![Partial Shipment checked under Shipment Type instead of the default Full Shipment](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/62-type.webp)

4. **Select the production orders**
   Under **Select Production Orders**, check the orders from that factory you want to include. Each order shows its number, the number of items and the units available, with a **Pending** badge. All styles of an order are selected by default.

   ![The production orders of the factory, each with its item count, units and a Pending badge](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/63-orders.webp)

5. **Deselect styles you are not shipping (partial only)**
   For a partial shipment, the selected order expands with *All styles selected by default - deselect those not to be shipped*. Uncheck the styles that are not part of this shipment. Each style shows its code and the units available.

   ![A selected order expanded to its styles, all checked by default, with the units available for each](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/64-styles.webp)

6. **Add a destination**
   Under **Destinations**, click **Add Destination**. A **Destination 1** card appears with the first delivery location selected.

   ![A Destination 1 card added under Destinations with the first delivery location selected](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/65-add-destination.webp)

7. **Choose the delivery location**
   In **Delivery Location**, select the warehouse. Its address is shown below. Click the pencil icon to edit the warehouse details without leaving the form.

   ![The Delivery Location of the destination, with the warehouse address shown below it](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/66-location.webp)

8. **Allocate orders to the destination**
   Under **Allocate Orders to this Destination**, check each order that goes to this warehouse. The card shows how many units are allocated. An order that is already allocated to another destination is not offered again.

   ![The order ticked under Allocate Orders to this Destination, with the units allocated shown on the card](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/67-allocate.webp)

9. **Set the quantities (partial only)**
   For a partial shipment, **Item Allocation (defaults to total units)** lists each style. Check the styles for this destination and enter the quantity in the box. The number after the slash is the maximum available. The **Destination Summary** shows the units allocated.

   ![Item Allocation listing each style with a quantity box and the maximum available after the slash](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/68-quantities.webp)

10. **Add more destinations (optional)**
    Click **Add Destination** again for another warehouse and allocate the remaining orders to it. Click the **X** on a destination card to remove it.

    ![A second destination card added with its own X button to remove it](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/69-more-destinations.webp)

11. **Enter the shipment details**
    Once there is a destination, **Shipment Details** appears. Fill in the fields in the table below.

    ![The Shipment Details section with tracking number, carrier, dates, priority, cost, tracking URL and notes](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/70-details.webp)

12. **Check the Shipment Summary**
    **Shipment Summary** shows the **Total Items** (styles), the **Total Quantity** and the number of **Destinations**. A warning tells you how many selected units are not allocated to a destination.

    ![The Shipment Summary with total items, total quantity and the number of destinations](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/71-summary.webp)

13. **Click "Create Shipment"**
    Click **Create Shipment** at the bottom right. Click **Cancel** to close without saving.

    ![The Cancel and Create Shipment buttons at the bottom right of the dialog](https://docs.vestislabs.com/assets/production/assets/production-shipping-create-shipment/72-create.webp)

## Shipment details fields

| Field | Required | Notes |
|---|---|---|
| **Tracking Number (Optional)** | No | The carrier's tracking number. |
| **Carrier \*** | Yes | Select from your carriers. |
| **Estimated Ship Date \*** | Yes | Pick a date. |
| **Estimated Delivery Date** | Yes | Filled in for you from the ship date plus the carrier's delivery days once both are chosen. You can change it. The form asks you to select a date if it is empty. |
| **Priority** | Yes | **Standard** (default), **Express** or **Urgent**. |
| **Shipping Cost (€)** | No | Defaults to 0. |
| **Total Items** | Read only | The number of items allocated across destinations. |
| **Tracking URL (Optional)** | No | Must be a valid web address, for example `https://tracking.carrier.com/...`. |
| **Shipment Notes** | No | Special handling instructions, customs information and so on. |

## Messages you may see

- *Please select a factory*
- *Please select at least one order*
- *Please add at least one destination*
- *Please select a carrier*
- *Please select an estimated ship date*
- *Please select an estimated delivery date*
- *Please enter a valid URL*

## Result

The new shipment appears on the **Active Shipments** tab. See [Track active shipments](https://docs.vestislabs.com/production/production-shipping-active-shipments/).

## Related

- [Track active shipments](https://docs.vestislabs.com/production/production-shipping-active-shipments/)
- [Shipment documents](https://docs.vestislabs.com/production/production-shipping-documents/)