Marking a shipment as error changes the status to Error and adds it to the error queue for review. This is used when a shipment needs manual attention — for example, if there's an issue with the shipment that requires investigation before fulfillment continues.

📘

Key Takeaways

• The shipment must not already be delivered, cancelled, or skipped
• A shipment_updated webhook event is fired with the error type
• No customer notification is sent

---

Prerequisites

The Mark as Error action is available when all of the following conditions are met:

---

How to Mark as Error

Step 1: Navigate to the Shipment

Find the shipment you want to flag. The most common methods are:

From the Customer Page:

1. Navigate to Search → Customers tab and find the customer record
2. On the customer detail page, scroll to the Sales section
3. Hover over the Shipment Status to expand and show shipment details
4. Click on the Shipment ID

From the Shipments List:

1. Navigate to Search → Shipments tab
2. Use filters or browse to find the shipment
3. Click on the Shipment to open the shipment detail page

Step 2: Open the Error Form

On the shipment detail page, click Mark as Error from the Shipment Actions.

Step 3: Complete the Error Form

1. Notes (required) — Enter the reason for marking the shipment as an error
2. Click Submit

---

What Happens After Submitting

When a shipment is marked as error:

1. Status updates to Error — The shipment status changes to Error and the notes are logged
2. Webhook event fires — A shipment_updated event with type error is sent to any connected systems

---

Other Ways to Mark as Error

• API — POST /shipments/{id}/error to mark a shipment as error programmatically

---

FAQ

Q: Will the customer receive a notification?

A: No. Marking as error does not trigger any customer-facing responders.

Q: How do I resolve an errored shipment?

A: After investigating the issue, you can use Post to Fulfillment to re-send the shipment, Cancel it, or Add Tracking if it was already fulfilled outside of Vrio.