More Shipstation integrations

README.md

@@ -125,6 +125,43 @@ that doesn't go through this shipment/label flow at all - those
 tickets just won't have tracking numbers pulled, which is expected for
 now, not a bug. Flag it when you're ready to handle it.
 
+## Emergency: Send to ShipStation
+
+For the rare case a ticket needs to skip the normal daily batch. Select
+a ticket in **Active Orders**, click **Send to ShipStation
+(Emergency)** in the toolbar, review the address/SKU summary shown,
+then pick one:
+
+- **Send via API Now** - calls ShipStation's API directly
+  (`POST /v2/shipments` with `create_sales_order: true`) to create the
+  order without leaving the app. Needs `SHIPSTATION_SIGNIFY_STORE_ID` /
+  `SHIPSTATION_OAKSTREET_STORE_ID` set in Settings.
+- **Export CSV Row...** - writes a single-ticket CSV matching your real
+  upload template exactly (verified column-for-column against a real
+  export), for manual upload if the API is down.
+
+Both exist on purpose, per "in case the API goes down we still have an
+option for CSV uploads."
+
+**Please verify your first live send, either path.** ShipStation's own
+docs say automation rules apply tags to orders "when they import based
+on any criteria you set" - meaning your 90 box-packing rules should
+fire automatically off the SKU/item data, same as a normal CSV import,
+with no manual tagging needed from this app. That's the best read of
+their documentation, but it's not something testable without your real
+account - check that ShipStation packed and priced an emergency-sent
+order the way a normal one would before relying on this in an actual
+emergency.
+
+A couple of things worth confirming once you've seen real data:
+- **Address 2**: two JIRA fields were both labeled "Address 1" when you
+  listed them (`customfield_10654` and `customfield_10655`) - this
+  assumes the second one is actually Address 2. Double-click a ticket
+  that has both filled in and check the Shipping Info section to confirm.
+- **Quantity**: always sent as `1` per line item today, since JIRA
+  doesn't currently give a per-deliverable quantity. Say the word if
+  that's ever not right.
+
 ## How company/SKU extraction works
 
 Each company has its own pair of "deliverable" custom fields in JIRA