DawsonyWeb Catalog Bridge for WooCommerce and Shopify · 1.3.3
Wholesaler setup and everyday use
Install DawsonyWeb Catalog Bridge for WooCommerce and Shopify on the WooCommerce supplier. Prepare products, connect retailers and manage reviewed imports or Pro price updates.
Before you start
Use WordPress 6.6+, WooCommerce 9.2+, PHP 8.0+ with OpenSSL, HTTPS and a working scheduled-event runner. Keep backups and start with a staging retailer. Supplier and retailer currencies must match; the bridge does not convert currencies or calculate tax. Check tax-inclusive/exclusive price conventions and decimal precision.
Free connects one retailer and requires review. Pro supports multiple retailer connections, category selection, automatic mapped-product updates, price rules, optional stock quantities and white-label console branding. A licence site means one supplier WordPress installation; retailers do not consume licence activation slots. Hosted Shopify invitations remain a controlled pilot pending Shopify App Store approval. Pro does not remove that restriction.
Install Free and activate Pro
Download Free from the product page. On the supplier, open Plugins → Add New Plugin → Upload Plugin, upload the ZIP and activate it with WooCommerce active. Open WooCommerce → Catalog Bridge. No retailer WordPress companion is required.
For Pro, select an annual plan on Dawsony.com, review purchase terms and complete Stripe Checkout. After confirmed payment, find the licence and private Pro ZIP in your account. Install Free 1.3.2 or newer first, then Pro 1.3.2. Open Pro & branding, enter the licence and choose Activate / check licence. The licence covers downloads, updates and support; installed Pro features continue working after licence expiry or licensing outages.
Connect a Shopify retailer
The retailer first installs and opens DawsonyWeb Catalog Bridge for WooCommerce and Shopify through Shopify. In the app, they create a supplier connection code (rc_) and share it privately with you. In Connected stores, choose Shopify, choose DawsonyWeb retailer invitation and paste that code instead of a shop domain. For an approved hosted pilot, register the exact supplier URL at dawsony.com/account/catalog-bridge, copy its one-time pairing key into the WordPress pairing form, choose DawsonyWeb retailer invitation and save the retailer. Create an invitation and send that private link to the retailer through your agreed channel. Invitations expire after 24 hours.
After Shopify authentication, the retailer pastes your invitation into DawsonyWeb Catalog Bridge for WooCommerce and Shopify inside Shopify, reviews the named supplier and approves the connection. Choose Check invitation and Test connection in WordPress before preparing a sync. Credentials are encrypted locally; product requests go straight from the supplier to Shopify. Dawsony handles invitation setup and credential renewal only.
For stores outside the pilot, arrange a Shopify app and permitted installation/distribution first. Direct OAuth uses the exact callback in Help & setup. Save the app client ID and secret, choose Authorize Shopify, then test. Existing Admin API tokens are also supported. Client credentials are only for an app and store in the same Shopify organization, not unrelated merchants. Do not send retailers your app secret.
Connect a WooCommerce retailer
Ask the retailer for a dedicated WooCommerce Read/Write REST API key belonging to a user who can manage products and WooCommerce settings. They should use WooCommerce → Settings → Advanced → REST API. In Connected stores, choose WooCommerce, enter the final HTTPS store root including any WordPress subdirectory, and enter the key and secret. Omit wp-admin and wp-json.
Save and Test connection. The retailer must allow HTTPS REST requests and public supplier images. No retailer companion plugin is needed. WooCommerce REST keys can authorize more than product operations; use a dedicated user, keep credentials private and only connect a supplier the retailer trusts. DawsonyWeb Catalog Bridge for WooCommerce and Shopify itself syncs products and prices, not orders or customers.
Prepare SKUs and retail prices
Opt published simple or variable products into DawsonyWeb Catalog Bridge for WooCommerce and Shopify. Give each product or exported variation a unique, non-empty SKU. Set a separate RRP on every exported item when using the RRP price source; ordinary WooCommerce prices remain the wholesale checkout prices. Up to 100 supplier variations and three options per product are supported. Use explicit option values; wildcard Any values and duplicate option combinations are rejected.
Alternatively choose WooCommerce regular price, or Pro percentage/fixed markup and .99/.95 rounding. The bridge sends numerical retail prices; it does not enforce a minimum resale price. Agree field ownership with each retailer, who remains responsible for its selling prices and publication. Existing retailer sale prices and schedules remain retailer-managed on WooCommerce.
First full sync and existing products
Start with a simple product and a variable product. For existing retailer goods, use Products & mapping → Link an existing retailer product. Supply the parent WooCommerce supplier ID and the retailer numeric WooCommerce product ID or Shopify gid://shopify/Product/123. The bridge verifies exact SKUs; titles alone are not used for matching. Resolve duplicate SKUs or changed options first.
Choose Prepare full sync. A background scan prepares individual product jobs. Open Activity & approvals and Review snapshot, compare current and proposed values, then approve the exact snapshots you reviewed. New products start as drafts with initial supplier content and images. The retailer checks and publishes them. Repeated full scans retain mappings and avoid importing a second copy.
Existing images and publication settings are preserved. Existing titles/descriptions change only if you enable content updates. Changed supplier data, price rules or retailer values after approval require a new review.
Ongoing changes and Pro automation
Free queues changes for review. Inspect and approve the latest price snapshot when ready. Pro automatic updates are enabled separately for each connection after a reviewed first sync. Mapped products with known variants can then update automatically; new products, new variants and conflicts may still require review.
Use per-retailer category selection to limit an offered catalogue, and Pro & branding to set the console name, accent and secure Media Library logo. Branding changes this WordPress console; it does not replace Shopify permission notices, Dawsony account pages or legal disclosures.
Do not remove a mapped variation or change its SKU/options without reconciling the mapping. Pro optionally mirrors stock quantities; shared reservations, order routing, supplier payments, fulfilment, reverse sync and automatic publication are not included.
White labelling is included in Pro. Open Pro & branding, set a console name, accent colour and secure logo, then save branding. This brands the WordPress console; Shopify permission notices and Dawsony licensing/legal pages keep their required identities.
For optional stock, enable individual stock management on every exported supplier SKU or variation. In Connected stores enable Supplier stock and set a whole-number per-SKU buffer. Available quantity is max(0, supplier quantity minus buffer), or zero when supplier status is out of stock. For Shopify enter the numeric ID of an active location fulfilling online orders and have the retailer approve write_inventory/read_locations. Open DawsonyWeb Catalog Bridge for WooCommerce and Shopify in Shopify admin to review and grant these optional inventory permissions. Other Shopify locations remain untouched.
Prepare and approve a preview for each product before stock becomes automatic. Stock and price changes are shown separately; changes to buffer/location require review again. Disable Supplier stock to keep future quantity edits retailer-managed. Unlimited supplier stock, fractional quantities and shared parent variation pools are rejected. Retailer backorder policies are retained.
Stock mirroring treats the supplier as the source of truth and overwrites retailer quantities on subsequent syncs. It does not route retailer orders to the supplier or reserve a shared pool across retailers. Agree timely order reporting separately; a buffer reduces displayed availability but does not prevent overselling. Shopify uses atomic quantity comparisons for concurrent sales. WooCommerce REST has no equivalent atomic stock comparison; use one agreed inventory writer and monitor failed jobs.
Scheduling, errors and recovery
Use WooCommerce Scheduled Actions or WordPress cron to inspect background work. The queue processes bounded batches. Low-traffic suppliers should configure a server cron with their host. An inactive worker warning means approvals alone will not execute changes. Avoid continually starting full scans to try to make a stalled worker run.
Read failed-job messages before retrying. Fix credentials, duplicate SKUs, currency/tax mismatch, invalid prices or options first. Temporary API availability/rate-limit failures retry with backoff. For migrated sites or changed WordPress salts, reconnect credentials and reactivate the licence for the new supplier address. Do not export keys or unredacted database snapshots in support requests.
Pause, disconnect and cancel
Pause a connection to stop new work; disabling an individual supplier product also stops future eligible jobs for it. Products already imported remain at the retailer. A pause does not revoke credentials. For Shopify hosted access, the retailer disconnects in the app or uninstalls it; suppliers may revoke the paired site in their account. For WooCommerce, the retailer revokes the dedicated REST key.
Use Deactivate this site in the Pro licence panel before moving an activation. Licence deactivation does not disconnect retailers. Cancel annual renewal using Manage Billing in your Dawsony account; this does not automatically request a refund or remove retailer products. Contact info@dawsony.com for support or a refund request.