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 Required

All 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.

StatusDescription
Pending TransactionWaiting for a successful transaction before fulfillment can begin
Pending PostTransaction complete — awaiting posting to the fulfillment connection
Pending TrackingPosted to fulfillment — awaiting a tracking number
ShippedTracking number received from the fulfillment connection
DeliveredPackage has been delivered to the customer
CancelledShipment has been cancelled
DeclinedAssociated transaction was declined
ErrorShipment encountered an error
SkippedShipment was skipped for this cycle

Available Actions

Scheduling & Status

ActionDescription
Cancel a ShipmentStop 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 ShipmentReverse a skip on the most recently skipped shipment.
Reschedule a ShipmentChange the scheduled date for a pending shipment.

Returns & Replacements

ActionDescription
Reship an ItemCreate 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 RMAAssign an RMA number to the shipment to begin the return process.
Check in a ReturnMark items as returned to trigger return profile logic (refunds, cancellations).

Address & Fulfillment

ActionDescription
Change Shipment AddressUpdate the shipping address before a shipment is posted to fulfillment.
Post to FulfillmentManually send a pending shipment to the fulfillment connection.
Re-Post to FulfillmentClear previous fulfillment data and re-send the shipment. Use when the original post needs to be retried.
Edit ItemsAdd or remove items on a shipment before it is posted to fulfillment.

Tracking & Delivery

ActionDescription
Add/Edit TrackingManually enter or update a tracking number and carrier on a shipment.
Fetch Tracking NumberPull the tracking number from the fulfillment connection (if the connection supports it).
Mark as DeliveredManually mark a shipped item as delivered and record the delivery date.
Mark as ErrorFlag 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:

FieldMeaning
Date ScheduledWhen the shipment is scheduled to process
Date PostedWhen the shipment was sent to the fulfillment connection
Date CompleteWhen tracking was received (shipment marked as shipped)
Date DeliveredWhen the shipment was delivered
Date CancelledWhen the shipment was cancelled
Date SkippedWhen the shipment was skipped
Date ReturnedWhen the shipment was returned

A blank or empty date means the event has not occurred.