ShipStation tracking pull, status tracking, dashboard rework

.env.example

@@ -21,12 +21,28 @@ JIRA_SIGNIFY_SKU_FIELDS=customfield_10573,customfield_10570
 JIRA_OAKSTREET_SKU_FIELDS=customfield_12790,customfield_13021
 
 # --- ShipStation (API V2) ---
+# Used only to pull tracking numbers for JIRA tickets - order/shipment
+# numbers there are the same as the JIRA ticket number, so no store
+# mapping is needed here.
 SHIPSTATION_API_KEY=
-# Map each store to the company it belongs to (each has its own UPS account)
-SHIPSTATION_STORE_MAP=se-221889:Signify Health,se-367672:Oak Street Health
 
 # --- Companies ---
 # SKU prefix -> company. Add more "PREFIX:Company" pairs as you add companies.
 COMPANY_SKU_MAP=SH:Signify Health,OK:Oak Street Health
-# Pattern used to recognize the AR-###### ticket number inside ShipStation payloads
+# Fallback pattern for recognizing the AR-###### ticket number if it's ever
+# not found in ShipStation's usual shipment_number/external_shipment_id fields.
 TICKET_NUMBER_REGEX=\b[A-Z]{2,6}-\d{3,}\b
+
+# --- Status Tracking ---
+# Statuses where we stop re-checking a ticket on future imports (comma-separated).
+# Defaults to Cancelled + both fulfilled statuses below, since none of those
+# need to be re-checked once reached. Add more if your workflow gets other
+# terminal statuses later.
+JIRA_TERMINAL_STATUSES=Cancelled,Waiting For Return,Device Return Not Needed
+# Statuses that get highlighted red in the table and trigger a popup when a
+# ticket newly transitions into one (comma-separated).
+CANCELLED_STATUSES=Cancelled
+# The two statuses your team uses at end-of-day close-out, depending on
+# whether ShipStation's automation also generated a return label.
+FULFILLED_STATUS_WITH_RETURN=Waiting For Return
+FULFILLED_STATUS_WITHOUT_RETURN=Device Return Not Needed