Import a Shopify catalogue into GoCommerce

What it does

Configuration

Two settings, both required, both typed on the Plugins screen. The module takes no Config at all — examples/store/main.go explains that a migrating merchant fills them in once on a screen rather than being handed an environment variable for a server they may not have.

The module reads its Config struct, not the environment. The variable names are the ones the package’s own example or the reference binary uses; in your own main() you choose where each value comes from. Where a setting has a panel label, the admin’s settings drawer can hold it too, and a value typed there wins over Config.

Setting it up

1. Create a custom appIn the Shopify admin, a custom app with the read_products scope. Copy its Admin API access token.
2. Install the modulePass shopify.New() to gocommerce.New in your own main(), as below. The reference binary has no flag for it; examples/store/main.go installs it.
3. Enter the credentialsShop domain and token on the Plugins screen, under Import from Shopify. POST /api/admin/x/import-shopify/check confirms them — shop name, currency, product count — before anything is written.
4. ImportPress Import on the products page, or POST /api/admin/x/import-shopify/jobs. The job runs in the background, and GET …/jobs/{id} reports created, updated, failed and warnings.

import (
	"github.com/itswadesh/gocommerce/core"
	shopify "github.com/itswadesh/gocommerce/ext/import-shopify"
)

// No Config: the shop domain and the access token are plugin
// settings, typed in once on the Plugins screen.
app, err := gocommerce.New(cfg, shopify.New())

How it works

• Matched on Shopify’s id

  Each product records metadata.shopify.id. A second run finds the row by that id — not by handle, which changes when a product is renamed — and updates it. The handle is a fallback only for rows that predate the module.

• Every page, politely

  The walk follows Shopify’s Link-header cursors to the end rather than counting pages, waits out a 429 for its Retry-After, and slows down when the call-limit header says the bucket is nearly full.

• One product at a time

  Each product commits on its own, so an import that dies halfway has half the catalogue in, and re-running finishes the job. One bad product is a warning on the job, not a stopped import.

• Money read exactly

  Shopify sends prices as decimal strings. They are read as two integers, never as a float, with the store currency’s own number of decimals — a yen store is not divided by a hundred.

• Stock that means what it said

  A variant Shopify does not track arrives untracked rather than as zero stock, a negative count arrives as zero, and continue-selling is kept. Shopify’s placeholder “Default Title” option is dropped.

• Pictures linked, not downloaded

  Images go into the media library by their Shopify URL, with their alt text, in the product’s own order; a picture the library already holds by that URL is reused.

What it does not do

Read these before an order depends on it. No store is known to run GoCommerce in production yet, so these come from the code, not from anyone’s experience.

• Products onlyCollections, customers, orders, discounts and pages are not read. Past orders come through the core’s Shopify-format CSV import, which moves no stock and fires no events unless asked.
• A re-run updates the copy, not the variantsA second run updates title, description, status, vendor, type and tags. Variants, prices, stock and pictures are not reconciled, so a price changed in Shopify after the first import stays as it was.
• Prices at face valueAmounts are taken in the store’s own currency. A shop priced in another currency is imported digit for digit, unconverted — the credential check shows the shop’s currency, so look first.
• Pictures stay on Shopify’s serversThey are linked by URL, not copied, so they are only as lasting as those URLs. Variant-specific pictures are not attached to their variants.
• One stock figure per variantEach variant’s inventory quantity arrives as a single on-hand number. Stock per Shopify location is not carried over.
• API version pinned to 2024-10The package pins Shopify’s Admin API version rather than tracking the latest, and by its own note Shopify retires each version after a year. Moving the pin is a deliberate edit to shopify.go.
• An interrupted job still says runningImports run in the background. A restart mid-import leaves that job marked running; starting another updates what arrived and adds the rest.