> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MHG User Guide

> Getting started with the StateSet API

### StateSet One User Documentation for Morrison Hotel Gallery

#### Table of Contents

1. [Overview](#overview)
2. [Logging In](#logging-in)
3. [Navigation](#navigation)
4. [Order Management](#order-management)
   * [Pending Orders](#pending-orders)
   * [Active Orders](#active-orders)
   * [Archived Orders](#archived-orders)
   * [Sales View](#sales-view)
   * [Ready to Pay](#ready-to-pay)
5. [Search Functionality](#search-functionality)
6. [Filters and Sorting](#filters-and-sorting)
7. [Order Details and Editing](#order-details-and-editing)
8. [Automation Features](#automation-features)
9. [Shopify Integration](#shopify-integration)
10. [Troubleshooting](#troubleshooting)

## Overview

StateSet One is a platform integrated with Shopify to automate more of the order process, reduce manual work, and provide real-time, essential data in a customizable platform for MHG. This documentation will guide you through using StateSet One for order management.

## Logging In

1. Go to [https://StateSet.com/main-view](https://StateSet.com/main-view)
2. Enter your username and password
3. Click "Log In"

Note: The system is transitioning from passwordless login to direct login. If you encounter issues, please contact [dom@StateSet.com](mailto:dom@StateSet.com)

## Navigation

The top navigation bar includes the following sections:

1. Pending
2. Active
3. Archived
4. Sales View
5. Ready to Pay

## Post-Purchase Order Management and Automation

<Steps>
  <Step title="Order Created in Shopify">
    An order is created in Shopify, creating a webhook which is then used to create the Order and Order Line Items in StateSet.
  </Step>

  <Step title="Order Line Items Details Updated in StateSet">
    The order line items are updated in StateSet. This tracks photographer acknowledgement, need by date, print status, and more.
  </Step>

  <Step title="Order Fulfilled in Shopify">
    The order is marked as fulfilled in Shopify. This moves the order to the archived view.
  </Step>
</Steps>

### Print Object Fields

| Field Name                            | Type                     | Description                                                     |
| ------------------------------------- | ------------------------ | --------------------------------------------------------------- |
| id                                    | uuid                     | Primary key, unique, default: gen\_random\_uuid()               |
| outstanding\_order\_id                | uuid                     | Unique identifier for the outstanding order                     |
| print\_name                           | text                     | Name of the print (nullable)                                    |
| edition\_number                       | text                     | Edition number of the print (nullable)                          |
| photographer                          | text                     | Name of the photographer (nullable)                             |
| print\_size                           | text                     | Size of the print (nullable)                                    |
| notification\_sent                    | boolean                  | Whether a notification has been sent (nullable)                 |
| notification\_created                 | timestamp with time zone | When the notification was created (nullable)                    |
| framed                                | boolean                  | Whether the print is framed (nullable)                          |
| unframed                              | boolean                  | Whether the print is unframed (nullable)                        |
| damaged\_print                        | text                     | Details about any damage to the print (nullable)                |
| photographer\_to\_framer              | text                     | Information about photographer to framer shipment (nullable)    |
| mhg\_to\_framer                       | text                     | Information about MHG to framer shipment (nullable)             |
| notes                                 | text                     | Additional notes about the order (nullable)                     |
| date\_sent\_to\_framer                | date                     | Date the print was sent to the framer (nullable)                |
| date\_back\_from\_framer              | date                     | Date the print returned from the framer (nullable)              |
| date\_shipped\_pu\_complete           | date                     | Date the order was shipped or picked up (nullable)              |
| date\_received\_at\_fulfill\_location | date                     | Date received at fulfillment location (nullable)                |
| sku                                   | text                     | Stock Keeping Unit (nullable)                                   |
| framer\_location                      | text                     | Location of the framer (nullable)                               |
| created\_at                           | timestamp with time zone | Creation date of the record (nullable, default: now())          |
| date\_ordered                         | date                     | Date the order was placed (nullable)                            |
| fulfillment\_location                 | text                     | Location for order fulfillment (nullable)                       |
| framer                                | text                     | Name or details of the framer (nullable)                        |
| sales\_person                         | text                     | Name of the sales person (nullable)                             |
| print\_status                         | text                     | Current status of the print (nullable)                          |
| invoice\_number                       | text                     | Invoice number for the order (nullable)                         |
| issues                                | text                     | Any issues with the order (nullable)                            |
| balance\_due                          | text                     | Remaining balance on the order (nullable)                       |
| back\_from\_framer                    | boolean                  | Whether the print is back from the framer (nullable)            |
| date\_of\_sale                        | date                     | Date of the sale (nullable)                                     |
| need\_by\_date                        | date                     | Required delivery date (nullable)                               |
| tracking\_number                      | text                     | Shipping tracking number (nullable)                             |
| view\_status                          | text                     | Current view status of the order (nullable, default: 'pending') |
| photographer\_acknowledged            | boolean                  | Whether the photographer has acknowledged the order (nullable)  |
| client\_name                          | text                     | Name of the client (nullable)                                   |
| en\_route                             | boolean                  | Whether the order is en route (nullable)                        |

### Fulfillment Locations

* Soho
* West LA
* Sunset Marquis

### Print Statuses

* En Route
* At Framer
* Received
* Ready

### Pending Orders

`StateSet.com/pending-main-view`

* This view shows orders that have not yet been paid for or are partially paid.
* Orders with the "Partial OOI" Shopify tag will appear here with a checkbox to alert that not every print needs to be ordered.

### Active Orders

`StateSet.com/main-view`

* This view displays orders that are currently being processed.
* Orders tagged with "OOI" (Out of Inventory) in Shopify will automatically appear in this view.

### Archived Orders

`StateSet.com/archived`

* This view shows completed orders.
* Orders are automatically moved here when fulfilled in Shopify.

### Sales View

`StateSet.com/sales-view`

* This view includes a Client Name column and will show active orders.

### Ready to Pay

`StateSet.com/ready-to-pay`

* This page populates with a duplication of a print when tagged "OOI" in Shopify and marked "received" in StateSet.

## Search Functionality

* Use the search bar to find orders by various criteria including Print, Photographer and Invoice Number

### Filters and Sorting

* Use filters to narrow down orders based on specific criteria.
* Sorting is available for most columns.
* Filters and sorting preferences are retained when navigating between pages.

<Tip>Filters can be cleared by setting the picklist to "All print, locations etc."</Tip>

### Order Details and Editing

* Click on an order to view its details in the side panel.
* Inline editing is available for most fields, including the "Acknowledged" checkbox in the Active view.
* The "Instructions" column can be expanded to view full text.

### Automation Features

* "OOI" Shopify tag moves orders directly to Active view.
* Setting the Sales Order Date moves an order from Pending to Active.
* Fulfillment in Shopify automatically moves an order to Archived in StateSet.
* Setting "En Route Date" moves an order status to "En Route".
* Setting the "To Framer Date" updates the print status to "At Framer".

### Color Coding for Orders

* Orders that are ready to print are green
* Orders that are at framer are blue
* Orders that are received are orange
* Orders that are alert are red

### Shopify Integration

* StateSet pulls in relevant order data from Shopify, including custom tags.
* Changes in StateSet can be written back to Shopify via API.
* The Invoice Number in StateSet links back to the corresponding Shopify order page.

### StateSet Value Props

* **Automated Order Management:** StateSet One integrates seamlessly with Shopify to automate various aspects of order management, reducing manual work and ensuring that orders are processed efficiently and accurately. This includes automatic updates to order statuses and the movement of orders between different stages (e.g., from Pending to Active, or Active to Archived) based on predefined triggers.

* **Real-Time Data and Customization:** The platform provides real-time access to essential data through customizable views, allowing users to manage orders, track statuses, and update details with minimal effort. Custom filters, sorting, and inline editing enhance the user experience by making it easy to find and manage specific orders.

* **Comprehensive Order Tracking:** StateSet One offers detailed tracking for each order, including various print statuses, fulfillment locations, and shipment details. This ensures that every aspect of an order—from creation to fulfillment—is closely monitored, providing transparency and reducing the risk of errors.

* **Seamless Shopify Integration:** The integration with Shopify allows StateSet to pull in relevant order data and custom tags, ensuring that both platforms remain synchronized. Updates made in StateSet can also be written back to Shopify, maintaining consistency and accuracy across systems.

* **Automation of Complex Workflows:** StateSet simplifies complex workflows through automation, such as automatically moving orders to different views based on tags or status updates, and color-coding orders based on their readiness or alert status. This automation helps users focus on critical tasks and reduces the need for manual intervention.

## Troubleshooting

If you encounter any issues:

* Ensure you're using the latest version of your web browser.
* Clear your browser cache and cookies.
* If problems persist, contact your system administrator or StateSet support.

This is a living document and will be updated as new features are implemented and workflows are refined.
