> For the complete documentation index, see [llms.txt](https://merchant-help.violet.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://merchant-help.violet.io/interacting-with-violet/fulfilling-an-order.md).

# Fulfilling an Order

Fulfilling a Violet Order is the same as fulfilling any other order. Add tracking in the Merchant Dashboard, or fulfill from your commerce platform.

When a shopper places an order through a Violet channel, the merchant is responsible for shipping it. Once the order ships, Violet needs to know so that the channel can show the shopper their tracking details and the order can be marked complete.

There are two ways to do this, and both are available to merchants on any commerce platform:

* **Add tracking in the Merchant Dashboard.** See [Fulfilling From the Merchant Dashboard](#fulfilling-from-the-merchant-dashboard).
* **Fulfill the order in your commerce platform**, as you would for any other order. See [Fulfilling From Your Commerce Platform](#fulfilling-from-your-commerce-platform).

{% hint style="warning" %}
Every order should end up either fulfilled or [canceled](https://merchant-help.violet.io/interacting-with-violet/canceling-an-order.md). An order that is left unfulfilled will likely result in a chargeback from the cardholder.
{% endhint %}

***

## Fulfilling From the Merchant Dashboard

Sign in to the [Merchant Dashboard](https://merchant.violet.io) with the same email you used during Violet Connect onboarding, and open the **Orders** tab.

When you open an order, its items are split into two sections:

* **Unfulfilled**: items that have not shipped yet.
* **Fulfilled**: items that have shipped, along with their tracking details.

### Adding Tracking

1. Open the order and click **+ Add Tracking** in the **Unfulfilled** section.
2. Review the order summary: order number, order date, and shipping address.
3. In the **Items** section, confirm the quantity of each item in this shipment. Lower a quantity if part of that item is shipping separately.
4. Under **Tracking**, fill in:
   * **Carrier** (required): UPS, USPS, FedEx, DHL, OnTrac, Royal Mail, Sendle, PostNord, Yun Express, or Other. Choose **Other** if your carrier is not listed.
   * **Tracking Number** (required): the tracking number from your carrier.
   * **Tracking URL** (optional): a direct link to the carrier's tracking page.
5. Click **Add Tracking**.

The items move to the **Fulfilled** section, where you and your connected channels can see the carrier, tracking number, and tracking link.

### Shipping an Order in Multiple Packages

If you are sending an order in more than one package, fulfill a subset of the items at a time. Each time you click **+ Add Tracking**, only the items that are still unfulfilled are shown. Add tracking for each package as it ships until the **Unfulfilled** section is empty.

### Correcting Tracking Details

If you entered the wrong carrier, tracking number, or link:

1. In the **Fulfilled** section, click the **pencil icon** next to the tracking number.
2. In the **Edit Tracking** window, change the carrier, tracking number, or tracking URL.
3. Click **Save Changes**.

***

## Fulfilling From Your Commerce Platform

If you would rather work from your own system, follow your platform's standard fulfillment process, including adding the carrier and tracking number if your platform supports it.

As a part of the standard Violet e-commerce integration, Violet is notified when a fulfillment is created, updated, or canceled in your platform. It reads the carrier, tracking number, and the items in each shipment, and makes them available to the channel.

{% hint style="info" %}
You do not need to also add tracking in the Merchant Dashboard for an order you have already fulfilled in your commerce platform.
{% endhint %}

### Special Platform Specific Considerations

#### Shopify

If an order needs your review before it ships (for example, suspected fraud), Violet can place a **fulfillment hold** on it. Do not ship a held order until you have reviewed it. See [Configuring Scopes](https://merchant-help.violet.io/platform-guides/shopify.md#step-2-configuring-scopes) for the permission that allows this.

#### WooCommerce

Tracking numbers are read from your shipment extension. If you use Pirate Ship, select it as your shipment extension in the Violet settings. See [Configuring the Violet Plugin](https://merchant-help.violet.io/platform-guides/woo-commerce.md#step-2-configuring-the-violet-plugin).

***

## After an Order Is Fulfilled

* **The channel is updated.** The channel can see the carrier and tracking details, so the shopper can follow their shipment.
* **The order completes.** Once every item on the order has shipped, Violet considers it complete. From there, the only things that can still happen are [refunds or returns](https://merchant-help.violet.io/interacting-with-violet/refunding-an-order.md).
* **Payouts may depend on it.** Channels can choose to hold your payout until the order has shipped. If a payout for an order is still pending, check that the order has been marked as fulfilled. See [Understanding Payouts and Distributions](https://merchant-help.violet.io/interacting-with-violet/getting-paid/understanding-payouts.md).

{% hint style="info" %}
If you can't fulfill an order, for example because an item is out of stock, [cancel it](https://merchant-help.violet.io/interacting-with-violet/canceling-an-order.md) instead of leaving it open.
{% 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 by asking a question.

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

```
GET https://merchant-help.violet.io/interacting-with-violet/fulfilling-an-order.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.
