Sync Engine

Sync Engine is the third stage of the pipeline (Collect → Enrich → Deliver). Once products have been collected and enriched, it creates or updates each one in your Shopify store and runs a post-processing pass for SKU, tags, and price.

What Sync Engine does

For each product, it:

1. Looks in the store for a product whose variant barcode matches the EAN.
2. Updates it if found; creates it if not.
3. Takes a pre-action snapshot of the catalog (with the Backup add-on active) before writing.
4. Records which products were touched, for the job's revert button.
5. Triggers post-processing: SKU → tags → price.

Writes are limited to ~2 per second to respect Shopify's rate limit.

The module

Connect your store

Under Stores → Connect a new store, enter your .myshopify.com domain and complete the OAuth authorization on Shopify. When you return:

• The store appears as active.
• If the authorization expires, or if you remove the app on Shopify, a reconnection warning appears — redo the OAuth flow using the store's button. Jobs stop until you reconnect.
• Disconnecting a store stops all of its syncs.

Your plan defines how many stores you can connect: Trial 1 · Flex/Advantage 5 · Enterprise no practical limit.

How products are published

The EAN is the key: it's what Trinis uses to decide between creating and updating, and it's what prevents duplicate products across re-syncs. Products without a valid EAN never make it to this stage (they're discarded in Collect).

Keeping your store up to date

When Sync Engine finds a product that already exists (same EAN), it updates it — without duplicating. What changes and what doesn't change on a re-sync:

Suppliers on other platforms (public Shopify sites, sites read by AI) and products coming from Import don't carry an inventory quantity — for these, the field stays as it is in the store.

Pricing rules

Price goes through two stages:

At publishing

• Sale price = the supplier's cost price × the supplier's price multiplier.
• "Compare-at" price = sale price × 1.2.

In post-processing (pricing step)

The pricing step recalculates from the inventory cost registered in Shopify (the variant's cost per item field):

• Sale price = cost × multiplier × a random factor between 0.65 and 0.95 (this is where the "was/now" discount comes from).
• "Compare-at" price = cost × multiplier (full price, no discount).
• Variants without a registered cost in Shopify are skipped — they keep the price set at publishing.

SKU and tags

These run automatically after publishing.

SKU

Generates an SKU for every variant that doesn't already have one — it never overwrites. The SKU comes from the title: Tramontina 5-Piece Knife Set → TRA-5-PIE-KNI-SET (first 3 letters of each word, whole numbers kept as-is).

Tags

Generates SEO tags from the words and word pairs in the title, the supplier, and the product type (plus seed keywords, when available). They're normalized to Title Case and capped at 50 per product.

Approval before publishing

Under Settings → Schedule, the "Approval before applying" toggle holds back every write to Shopify. With it on:

• Every step that writes — publishing, SKU, tags, and price — stops at pending_approval status with the list of changes already calculated.
• You review it on the job page and choose Approve or Reject.
• It applies to every supplier on the account and to bulk price, tag, and SKU actions.

Scheduling and reverting

Scheduled publishing

Each supplier can have a Sync schedule (a cron expression). The scheduler checks every 5 minutes and triggers the full pipeline — collection, enrichment, and publishing. If a scheduled run hits the plan's product limit, that supplier's sync is paused and resumes once you have quota again. Cron details are in Configuring Collect.

Reverting

Every job records the products it changed and takes a snapshot before writing. The job page has a revert button that undoes only the products from that job. History and point-in-time restore depend on the Backup add-on.

Next steps