Shipment Modifications
All available actions for managing shipments — cancelling, tracking, returns, reships, and more.
Shipment modifications are actions you can take on scheduled or completed shipments. Access these from the Shipment Actions button or dropdown on the shipment detail page.
Permission RequiredAll shipment actions require the user to have shipment edit permission. User Permissions determine which actions are visible to each user.
({*}) denotes a configurable action — it will only appear if enabled on the offer.
Shipment Statuses
Every shipment moves through a lifecycle of statuses. The status determines which actions are available.
| Status | Description |
|---|---|
| Pending Transaction | Waiting for a successful transaction before fulfillment can begin |
| Pending Post | Transaction complete — awaiting posting to the fulfillment connection |
| Pending Tracking | Posted to fulfillment — awaiting a tracking number |
| Shipped | Tracking number received from the fulfillment connection |
| Delivered | Package has been delivered to the customer |
| Cancelled | Shipment has been cancelled |
| Declined | Associated transaction was declined |
| Error | Shipment encountered an error |
| Skipped | Shipment was skipped for this cycle |
Available Actions
Scheduling & Status
| Action | Description |
|---|---|
| Cancel a Shipment | Stop delivery. Vrio will attempt to cancel at the fulfillment connection if already posted. |
| Skip a Shipment* | Skip the next upcoming shipment for a subscription. Must be enabled on the offer. |
| Unskip a Shipment | Reverse a skip on the most recently skipped shipment. |
| Reschedule a Shipment | Change the scheduled date for a pending shipment. |
Returns & Replacements
| Action | Description |
|---|---|
| Reship an Item | Create a child shipment to re-send items. Supports alternate items and shipping addresses. |
| Swap Item* | Replace the item on an upcoming single-item shipment with a variant or swap item. |
| Generate an RMA | Assign an RMA number to the shipment to begin the return process. |
| Check in a Return | Mark items as returned to trigger return profile logic (refunds, cancellations). |
Address & Fulfillment
| Action | Description |
|---|---|
| Change Shipment Address | Update the shipping address before a shipment is posted to fulfillment. |
| Post to Fulfillment | Manually send a pending shipment to the fulfillment connection. |
| Re-Post to Fulfillment | Clear previous fulfillment data and re-send the shipment. Use when the original post needs to be retried. |
| Edit Items | Add or remove items on a shipment before it is posted to fulfillment. |
Tracking & Delivery
| Action | Description |
|---|---|
| Add/Edit Tracking | Manually enter or update a tracking number and carrier on a shipment. |
| Fetch Tracking Number | Pull the tracking number from the fulfillment connection (if the connection supports it). |
| Mark as Delivered | Manually mark a shipped item as delivered and record the delivery date. |
| Mark as Error | Flag a shipment with an error status for review. |
Notifications & Webhooks
Some shipment actions trigger responders (customer email notifications) and push events (webhook notifications to connected systems). Each action's doc page describes which notifications it triggers.
When a responder is triggered, the system checks for a matching notification template using the responder hierarchy — offer cycle → offer → campaign. If no responder is configured at any level, no notification is sent.
Key Date Fields
Each shipment tracks important dates that reflect its lifecycle:
| Field | Meaning |
|---|---|
| Date Scheduled | When the shipment is scheduled to process |
| Date Posted | When the shipment was sent to the fulfillment connection |
| Date Complete | When tracking was received (shipment marked as shipped) |
| Date Delivered | When the shipment was delivered |
| Date Cancelled | When the shipment was cancelled |
| Date Skipped | When the shipment was skipped |
| Date Returned | When the shipment was returned |
A blank or empty date means the event has not occurred.
Updated about 4 hours ago
