Skip to main content

Flaviar WMS Shopify Integration & Fulfillment Manual

Introduction


This manual outlines the operational guidelines for retailers using our Shopify order integration. Adhering to these protocols ensures accurate tracking, inventory updates, depletion, and synchronization with our Warehouse Management System (WMS).

WMS is our proprietary product and centralized order management system that also initiates consolidated daily payouts to retailers, customer communications about order status, etc., and it’s important that Shopify information is correctly reflected in it.

Integration Ground Rules


To keep our systems synced and prevent orders from getting stuck, please follow these strict operational rules:

Stick to one shipping location: Your Shopify store must only have one configured shipping location.

Ship everything together: Do not split orders into multiple shipments. Every order must be submitted, tracked, and fulfilled as a single, complete unit. If you still need the order to be split, please reach out to [email protected] with the order number and details on how you’d like it split. The split items will then be reassigned under separate order number(s).

No partial returns or cancellations: Our system operates on an all-or-nothing basis. You cannot cancel or return individual items from an order. If a customer needs a change, cancel the entire transaction and have them place a new one.

Use a single tracking number: Attach exactly one tracking number to each fulfillment.

Keep return reasons uniform: If an order is sent back, every single item in that return must use the exact same return reason code.

Always close returns in Shopify: Once you process a return, make sure to officially close it in Shopify so the status syncs correctly with our WMS.

Shopify Fulfillment & Tracking Protocol

To keep Shopify and our Warehouse Management System (WMS) in sync, please follow these steps whenever you process a shipment.

1. Initial Fulfillment

When marking an order as fulfilled, always include the following:

  • Tracking Number

  • Shipping Carrier (e.g., FedEx, UPS, DHL)

Our WMS requires these two data points to move a parcel to "SENT" status. If they are missing, the order may get stuck in "Processing" even if Shopify shows it as complete.

2. Correcting tracking number errors (The "Edit" Rule)

If you make a mistake or forget to add a tracking number, do not cancel the fulfillment. Our system cannot process fulfillment cancellations.

Instead, fix it directly in Shopify using these steps:

  1. Open the order in Shopify.

  2. Find the Fulfillment section.

  3. Click "Edit Tracking."

  4. Enter the correct details and save.

Using the "Edit Tracking" function is the only way to ensure the WMS updates an existing record. Following this flow prevents manual sync errors and ensures customers receive the correct tracking notifications.

Order Cancellation Flow

If you cannot fulfill an order due to out-of-stock items or damaged inventory, you have two options:

  1. Check for a different vintage or quantity available, and email our customer care team at [email protected] with details on the quantity or vintage you have in stock. If the customer accepts the swap, we will assign a new order.

  2. Cancel the transaction in Shopify so the order status updates correctly in WMS.

How to cancel an Order in Shopify:

Go to Orders in your Shopify Admin dashboard and click on the order.

  1. Click the More Actions dropdown menu at the top.

  2. Select Cancel Order and choose the appropriate reason.

  3. Leave a staff comment (Required): Our operations team relies on these details to track inventory issues. Before confirming the cancellation, type a quick explanation of exactly why the order couldn't be fulfilled into the Staff Comments section.

  4. Click Cancel Order to finalize the changes.

Canceling the order once it has already been marked as shipped

Once the order status has been updated to SENT, the WMS doesn’t allow order cancellations.
Instead, process the order as Returned.

If the parcel has not physically shipped yet, set the Return Reason to Other → CLEAR ALL.

Managing Returns

To process a return correctly, follow these steps:

  1. Open the order in Shopify.

  2. Click the Return button at the top right of the screen.

  3. Select all items and quantities. Our integration does not support partial returns; the entire order must be selected.

  4. In the Return Reason field, following guidance from our Customer Care, mark the order as:
    - Other → RETURN DOUBLE or
    - All other reasons → CLEAR ALL.

  5. Click Create Return.

  6. Once the physical package arrives back at your facility, open the order in Shopify again and click Close Return to sync the status with the WMS.

ShipStation Setup (Optional)

If you are using Shopify and ShipStation, the connection must be configured on your end as a Custom Store. To prevent sync errors, follow the instructions outlined in the official ShipStation Shopify Integration Guide.

Processing in-store pickup orders

Mark Order Ready for Pickup

Select an order from the list to view its specific details. This action allows you to gather all necessary information, including products ordered and customer details, to prepare the order for pickup.

From the order details page, select 'Mark as ready for pickup'. This action updates the order status and notifies the customer that their order is available for collection.

Mark Order as Picked Up

Once the customer has collected the order in store, select ‘Mark as picked up’ on the order details page. For in-store pickup orders, being picked up counts as delivered, so this updates the order status in Shopify<>WMS to Sent and releases the payout for the order.

Only mark the order as picked up once the customer has the item in hand.


​
​​


​


​


​
​
​
​


​

Did this answer your question?