Suplio Help Center

Getting Started

What Suplio does (and does not) do

Suplio is a pure observe-and-report layer for suppliers on Shopify Collective. It reads the order and product data Shopify already exposes (tags + webhooks) and turns it into per-retailer analytics, payout aging, and guard alerts. It requests read-only access and writes nothing back to your store.

Shopify exposes no Collective price-list, invitation, or connection APIs, so Suplio never edits Collective sharing — it makes the invisible visible so you can act, but the acting happens on your side.

Installing Suplio

1. Install from the Shopify App Store; approve the read-only scopes (read_orders, read_products, read_inventory, read_locations).
2. On first open, Suplio runs a 90-day backfill of your Shopify Collective-tagged orders.
3. When it finishes you land on the dashboard with your retailers, revenue, margin leaks, and overdue payouts already populated. No manual setup.

The first-run backfill

The backfill uses a Shopify bulk operation, so it runs in the background and scales to large order histories. You can skip the wait and go straight to the dashboard — data keeps filling in. If you have no Collective orders yet, Suplio shows a "we'll watch for your first order" state and starts tracking as soon as one arrives.

The Dashboard

The dashboard is your command center. It shows:

• KPI cards — revenue, pending payouts, and total margin leak over the current window.
• Alerts — the open guard alerts that need action, dismissable inline.
• Retailers — a comparison table of every retailer, with a status badge.
• An ambiguous-orders banner when an order's tags don't map cleanly to one retailer (see Collective Orders).

Dashboards read from pre-aggregated daily rollups, so they stay fast no matter how many orders you have.

Retailers

How retailers are discovered

A Collective order carries the tag Shopify Collective plus the retailer's name as a second tag. Suplio matches the remaining tag against your retailer registry by elimination — no manual mapping. New retailers appear automatically as their first order arrives.

Retailer detail

Open any retailer to see a revenue trend, top SKUs, recent orders, and payout aging for that retailer. You can set a display name (e.g. a friendlier label than the raw tag) and keep private notes (contact, terms) — both are yours only and never sent anywhere.

Ambiguous attribution

If an order's tags could match more than one retailer, Suplio never guesses. It parks the order in a manual-confirm queue so revenue always lands on the right retailer. Confirm the correct one from the Orders page and Suplio re-attributes it.

Collective Orders

The Orders page lists every Shopify Collective order in your window. Search by order number or retailer reference, filter by status, retailer, or flag, and page through the results. Flags surface at a glance:

• Discount stacked — the order's total came in below what the line items should have summed to; the leaked amount is recorded.
• Shipping mismatch — what you charged for shipping differs from the retailer-side cost attribute.

On the Growth plan and up you can export to CSV.

Payout Aging

Every Collective order is tracked from pending to paid. The Payouts page groups pending orders into aging buckets — 0–3, 4–7, 8–14, and 15+ days — and sorts by the amount stuck, so the biggest and oldest exposures are on top. When a payout crosses your overdue threshold, a guard alert fires so you can chase it on day seven instead of discovering it a month later.

Suplio cannot force a payment — it makes stuck money visible.

Guards & Alerts

Guards watch your Collective activity and raise an alert only when there is something to do. Types:

• Payout overdue — a payout has been pending past your threshold (default 7 days).
• Margin leak — discount-stacking or shipping mismatch on an order.
• Policy flip — a shared variant's inventory policy flipped from "deny" to "continue" selling (a critical alert).
• Oversell risk — a shared variant's stock is below recent Collective demand.
• Quiet retailer — a once-busy retailer has gone silent, which may mean they dropped your products.

Keeping alerts useful

On the Guards page you can set the payout threshold and mute any alert type. Muted types never fire — no feed entries, no digest lines. Each alert appears once per entity and won't re-fire after you dismiss it.

Shared Products

The Products page lists every variant observed flowing through Collective orders: its current inventory policy (the flip sentinel's snapshot), available stock, how many retailers sell it, and when it last sold. Search by SKU or title. A policy-flip badge marks any variant that changed from stopping at zero to overselling.

Settings & Digests

• Digest preferences — turn the daily-critical and weekly-summary emails on or off. Digests are sent only when there is something to act on, so you never get daily noise.
• Sender identity & recipients — set the sender name and reply-to; add extra recipients on the Growth plan and up.
• Danger zone — delete all of Suplio's analytics data for your shop. The app stays installed and ingest starts fresh.

Plans & Billing

Suplio uses Shopify Managed Pricing with a 14-day free trial on paid plans.

Your data always accrues in the background — a plan only changes how much is visible, so upgrading instantly reveals history you already have.

Privacy & Data

Suplio requests read-only scopes and stores no customer personal data. On uninstall, your shop's data is hard-deleted, and the mandatory GDPR webhooks (customers/data_request, customers/redact, shop/redact) are honored. Full policy: Suplio privacy policy.

Getting Help

• In the app, open any page and use the footer: "Need help? Check the documentation or contact support." The contact support link opens a form that reaches us directly — we usually reply within one business day.
• Prefer email? Write to support@veltriolabs.com.