Updated the ship-to-store document

Author: AjinkyaM1

documents/store-operations/bopis/ship-to-store.md

@@ -4,21 +4,75 @@ description: >-
   orders for products not immediately available at their preferred location.
 ---
 
-# Ship to Store
+## Overview
 
-The `Ship to Store` feature helps customers in placing pickup orders for products that are not immediately available for same-day fulfillment at their preferred location. Users of the BOPIS app can find the `Shipping to store` page by clicking on the `trail` icon on the top right corner of the `Orders` page.
+**Ship to Store** enables you to request inventory from another location when an item is out of stock at your store. Instead of canceling a customer's Buy Online, Pick Up In Store (BOPIS) order, you can transfer the item from a warehouse or another store, modifying the fulfillment path to save the sale.
 
-Shopify retailers can install the HotWax Commerce BOPIS PDP App within their Shopify stores enabling their customers to select a specific future timeframe for their pickup. Customers will see an estimated pickup timeframe directly on the product detail page, displayed as "Pick up in x days”.
+---
+
+## 1. Setup and Configuration
+
+**Note:** Only users with the **Admin** role and **Common Admin Permission** can view and modify these settings.
+
+To enable the Ship to Store feature:
+
+1.  Open the **Settings** menu in the BOPIS App.
+2.  Locate the **Show Request Transfer** toggle.
+3.  Turn the toggle **ON**.
+
+Once enabled, the **Request Transfer** button will replace the standard "Reject" action on your order screens.
+
+---
+
+## 2. Requesting a Transfer
+
+If you cannot fulfill a BOPIS order from your own inventory, you can initiate a transfer request.
+
+**Steps:**
+
+1.  **Locate the Order:** Navigate to the order you need to transfer. The **Request Transfer** button is available on both the **Order Card** (list view) and the **Order Detail** view.
+2.  **Click Request Transfer:** Select the button to begin the process.
+    *   *Important:* This button replaces the standard "Reject" button when the feature is enabled.
+3.  **Confirm the Action:** A confirmation dialog will appear. Confirm that you want to move this order to Ship to Store.
+
+**Post-Request Workflow:**
+
+*   The order moves to the **Store Pickup Rejected** queue.
+*   The system includes an automated brokering logic to route the order to a fulfillment store or warehouse.
+*   You can track the status of these requested orders by clicking the **History/Trail icon** in the top right corner of the page.
+
+---
+
+## 3. Fulfilling the Request (Fulfillment App)
+
+*This section applies to the warehouse or store fulfilling the transfer request.*
+
+When you receive a Ship to Store order in your fulfillment queue:
+
+1.  **Pick and Pack:** Process the order items as per standard operating procedures.
+2.  **Select Carrier:** When generating the shipping label, the carrier list is automatically filtered.
+    *   You will only see carriers that support the `SHIP_TO_STORE` shipment method.
+    *   This prevents shipping errors and ensures the package is routed correctly.
+3.  **Ship:** Complete the shipment steps. The package is now en route to the requesting store.
+
+---
+
+## 4. Receiving and Customer Handover
+
+The **Ship to Store** page in the BOPIS App is organized into three tabs to help you track orders through their lifecycle:
+
+### Incoming
+This tab displays inventory that has been shipped and is currently in transit to your store.
 
-Once the order is downloaded, HotWax Commerce categorizes it as a "Ship to Store" order and brokers it to a facility from where the inventory will be shipped to the pickup location. After a fulfillment location has been designated, store employees can use the following steps to monitor and fulfill `Ship to Store` orders:
+When the physical shipment arrives, locate the order in this tab and label it **Arrived**. A notification is sent to the customer informing them that their order is now available for pickup, and the order moves to the **Ready for Pickup** tab.
 
-1. Click on the `trail` icon on the top right corner of the `Orders` page, this will redirect the user to the `Shipping to store` page.
-2. Users can use the `Search` bar on the top left of the page to find orders using customer name or order ID.
+### Ready for Pickup
+This tab displays orders that have physically arrived and are waiting for the customer.
 
-The **Shipping to store** page is segmented into three tabs:
+When the customer comes to collect their order, verify their identity and mark it as **Handover**. The system marks the order as fulfilled and moves it to the **Completed** tab.
 
-* _**Incoming:**_ This tab displays the incoming inventory that has been received. Store staff can label an order `Arrived` upon receiving it. A notification will then be sent to the customer, informing them that their order is now available for pickup.
-* _**Ready for Pickup:**_ This tab displays the orders that are ready for pickup. Once the customer arrives at the store for pickup and receives the order, the store associate marks `Handover`, moving the order to the completed orders tab.
-* _**Completed:**_ This tab displays all the completed BOPIS ship to store orders handed over to the customers in the past 24 hours.
+### Completed
+This tab displays a history of all completed Ship to Store orders that have been successfully handed over to customers within the past 24 hoursir identity and mark it as **Handover**. The system marks the order as fulfilled and moves it to the **Completed** tab.
 
-<figure><img src="https://github.com/user-attachments/assets/1ce90a47-c320-4d12-8747-cd356667bdcd" alt=""><figcaption></figcaption></figure>
+### Completed
+This tab displays a history of all completed Ship to Store orders that have been successfully handed over to customers within the past 24 hours