etsy-finance-tracker/server/.env.example
dlawler489 715562c96a Add Etsy API integration: OAuth connect and receipt-to-order sync
- OAuth 2.0 authorization code flow with PKCE; /api/etsy/connect returns the
  consent URL, /api/etsy/callback exchanges the code (validated via one-time
  state, no JWT) and stores tokens per user with automatic refresh
- /api/etsy/sync pulls all shop receipts and upserts orders by receipt id:
  items with SKU/variations, totals, shipping address, tracking, and status,
  with catalog costs snapshotted at sync time
- Product matching by exact title/alias first, then etsyListingId
  (size-disambiguated); listing ids are learned onto products on first match
- Packing-slip items with cost data are preserved when synced items can't all
  be matched
- Settings page: Connect Etsy Shop, Sync Orders Now, Disconnect, and a list
  of unmatched item titles after each sync
- Requires ETSY_API_KEY and ETSY_REDIRECT_URI env vars (see .env.example)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-13 07:54:41 +10:00

19 lines
No EOL
641 B
Text

# Environment Variables
NODE_ENV=development
PORT=3001
CLIENT_URL=http://localhost:3000
# Database
MONGODB_URI=mongodb://localhost:27017/etsy-tracker
# JWT Secret (change in production)
JWT_SECRET=your-super-secret-jwt-key-change-this-in-production
# Session Secret (change in production)
SESSION_SECRET=your-super-secret-session-key-change-this-in-production
# Etsy API (personal-use app from etsy.com/developers)
# ETSY_API_KEY is the app keystring; ETSY_REDIRECT_URI must exactly match a
# callback URL registered in the Etsy app settings
ETSY_API_KEY=your-etsy-keystring
ETSY_REDIRECT_URI=https://etsy.plexultra.com/api/etsy/callback