# Colonial Acres Coins connector (`colonial-acres`)

- Source: https://www.colonialacres.com · dealer · CA · CAD · Shopify storefront
- Acquisition: public `/collections/<handle>/products.json?limit=250&page=N` (shared `ShopifyStoreConnector` adapter wrapped by `MarketPinnedShopifyConnector`, which adds a `localization=CA` cookie so Shopify Markets never geo-converts prices; no store-specific code)
- Records: `listing` (asking prices, one per variant; out-of-stock variants → `ended`)
- Refresh: every 12 h (ACTIVE→NORMAL boundary, large catalogue) · history: none (listings only)

Kitchener numismatic dealer (Canadian decimal coins, ICCS-certified coins, Bank of Canada / Dominion notes, tokens). Shopify storefront; product_type distinguishes coins, ICCS slabs and paper money.

## Collections → taxonomy
| collection handle | category | brand / franchise / series |
|---|---|---|
| `1-cent` | `coins` | — |
| `5-cents` | `coins` | — |
| `10-cents` | `coins` | — |
| `25-cents` | `coins` | — |
| `50-cents` | `coins` | — |
| `dollar` | `coins` | — |
| `canada-deals-on-decimal` | `coins` | — |
| `usa-deals-on-decimal` | `coins` | — |
| `world-deals-on-decimal` | `coins` | — |
| `canada-proof-silver-dollars-1971-date` | `coins` | — |
| `bank-tokens` | `coins` | — |
| `province-of-canada` | `coins` | — |
| `lower-canada` | `coins` | — |
| `canada-tokens-medallions` | `medals` | — |
| `deals-on-paper-money` | `banknotes` | — |
| `1-notes-1935-1937` | `banknotes` | — |
| `1-notes-1973` | `banknotes` | — |
| `2-notes-1935-1954` | `banknotes` | — |
| `2-notes-1974` | `banknotes` | — |
| `2-notes-1986` | `banknotes` | — |
| `5-notes-1935-1954` | `banknotes` | — |
| `5-notes-2001-date` | `banknotes` | — |
| `10-notes-1935-1954` | `banknotes` | — |
| `10-notes-1971-1989` | `banknotes` | — |
| `20-notes-1935-1979` | `banknotes` | — |
| `20-notes-1991` | `banknotes` | — |
| `50-notes-1935-date` | `banknotes` | — |
| `100-notes-1935-date` | `banknotes` | — |
| `bc-37` | `banknotes` | — |
| `bc-56a` | `banknotes` | — |
| `bc-56b` | `banknotes` | — |
| `bc-56c` | `banknotes` | — |

Rules (first match wins, applied to "title | product_type | tags | collection"):
- `\| (Paper Money|Deals on Paper|Certified Paper Money|Paper Money Sets) \||\bBC-\d|\$\d+ Notes? \d{4}|\bbanknotes?\b|\bpaper money\b` → `banknotes`
- `\bmedal(lion)?s?\b` → `medals`
- `\btokens?\b` → `coins`

Excluded (regex): `gift card|supplies|\balbums?\b|\bholders?\b|\bcapsules?\b|catalogue|catalog|magnifier|cleaning|\bflips?\b|\bpages?\b|\brolls?\b|\bbooks?\b|\btubes?\b|\bcases?\b|storage|\bbinder|\bloupe\b|\bgloves?\b|\bscale\b|\bmaps?\b|\bframe`

## Access & compliance
See `accessNotes` in meta.json: robots.txt verified 2026-09-08 (standard Shopify rules, products.json paths allowed), honest UA, 1 req / 1.5 s, listings only, no personal data. Not fetched: bullion (silver/copper rounds, bars, bank rolls), RCM year/complete sets and gift sets, coin supplies, catalogues.

## Fixtures & tests
`data/fixtures/colonial-acres/` — live captures (`pnpm tsx connectors/api/_g3-shops-na-lib/capture.ts colonial-acres`), trimmed single-product payloads incl. a sold-out variant and a graded item.
`pnpm vitest run connectors/api/colonial-acres` · live probe: `pnpm tsx connectors/api/_g3-shops-na-lib/probe.ts colonial-acres`.