Shopify orders and sales
Hermoso reads your Shopify store's orders so you can see what sold, which discount codes and campaigns brought the sales, and which of those came from the codes and campaigns Hermoso made. It can also add past buyers who agreed to marketing email to your email lead list, so a sequence can win them back. It works for a store that installed Hermoso from the Shopify App Store, and it costs no credits.
List orders
list_shopify_orders lists orders newest first: the order number, date, total, payment and fulfilment status, the discount codes used, where the buyer came from (Shopify's last visit before the order, with its UTM tags) and the buyer's name and email.
| Field | What it is |
|---|---|
days or from, to | The period. The last 30 days unless you say otherwise. Shopify lets apps read the last 60 days of orders, so an older start is refused with that rule. |
status, financialStatus, discountCode | Optional filters: open, closed or cancelled orders; paid, refunded and the other payment states; orders that used one code. |
id | One order in full: its items, the first and last visit, the landing page and how many days the buyer took. Give the order number the way your store shows it (#1001 or 1001), or the id from a list. |
Sales report
shopify_sales_report adds up a period: orders and sales after returns, with cancelled and test orders counted apart. Then it breaks the sales down by discount code, by UTM source, medium and campaign, and by Shopify's own traffic source, using the last visit before each order. Recent orders Shopify has not attributed yet are counted and named.
It also shows the part that came from Hermoso: orders that used a discount code Hermoso created on your store, or that arrived through a campaign Hermoso recorded in Shopify > Marketing. Pass codes or campaigns to count others you know are yours. In the app, open Automations > Email and choose Shopify sales.
Past buyers to email leads
import_shopify_buyers_to_email_leads adds past buyers to the brand's email lead list with their name, email, number of orders, total spent and last order date, which a sequence can use as {{orders_count}}, {{total_spent}} and {{last_order_date}}. Only buyers who agreed to marketing email in Shopify are added. The answer says how many were skipped and why: never agreed, unsubscribed, not confirmed yet, or no email. Someone already on your list who unsubscribed stays unsubscribed. dryRun: true shows the counts and adds nobody, and nothing is ever emailed until you enrol the leads in a sequence. In the app, open Automations > Email and choose Add past Shopify buyers.
The routes are GET /api/shopify/orders, GET /api/shopify/sales-report and POST /api/shopify/buyers/import.
The permission
Orders and customers need two more Shopify permissions, and Shopify reviews every app that reads customer names and emails. A store that installed Hermoso before they were added is asked to approve them the next time the app is opened from the Shopify admin. While Shopify has not approved access to customer names and emails for Hermoso, the orders still list and the answers say plainly that names and emails are not shown, so a missing email is never read as no email.
When Shopify asks Hermoso to erase a customer's data, every lead imported for that customer is deleted and their address is removed from the email history.