Stores and Suppliers

Stores and suppliers are foundational entities in Sellfern. Orders are tied to stores, and costs are driven by supplier assignments. Configure both before importing orders to prevent mismatched records and reduce cleanup work.

​

Adding a store

Go to Settings → Stores to define the storefronts your orders belong to. For each store, provide:

• Store name — a display name for the storefront (e.g., “My Etsy Shop”).
• Store code — a short identifier used for SKU matching and reporting (e.g., ST-001).
• Platform — choose Etsy (OAuth 2.0 PKCE) or Shopify (Webhook/Custom App).
• Etsy Shop ID — numeric shop ID auto-detected from Etsy’s API during authorization or store creation.
• Active status — whether the store is currently in use.

​

Native Etsy OAuth 2.0 PKCE Integration

To enable direct, automated order ingestion (GET /receipts) and tracking push-back (POST /tracking), authorize your shop via official Etsy OAuth:

1. Trigger authorization using any of the 3 entry points:
   • Click Connect / Reconnect Etsy API on the top prompt banner (when a store is disconnected).
   • Enter store details in the Add / Edit Store form with platform Etsy and click Connect via Etsy OAuth 2.0 (or Reconnect via Etsy OAuth 2.0).
   • Click Reconnect directly under the API Status column next to any disconnected store row.
2. Grant read/write permissions (transactions_r, transactions_w, shops_r, email_r).
3. Upon returning, Sellfern stores encrypted access & refresh tokens, automatically refreshing access tokens before expiration.
4. API Connection Status: Check the status badge next to any Etsy store:
   • Connected (Green): Valid OAuth access token active.
   • Disconnected (Amber): Token missing or expired — click Reconnect to re-authorize.
   • Reconnection Banner: If any store loses its API connection, an alert banner appears at the top of Settings → Stores.
   • Disconnect Action: Use Disconnect API Integration to revoke OAuth access safely while preserving historical store order records.

Sellfern currently supports native integration with Etsy and connected storefronts, with plans to support Amazon, WooCommerce, and Faire in future updates. Once stores are configured, the sidebar store selector can filter data across the workspace, including orders, analytics, and fulfillment views.

​

Email Map

The Email Map connects sender email addresses to specific stores. Sellfern uses these mappings during Gmail Live Sync to route incoming orders to the correct storefront automatically. To add a mapping, go to Settings → Email Map, enter the sender email address, and select the target store. Add one mapping for each sender address that should route to a store.

​

Adding a supplier

Go to Settings → Suppliers to create supplier records for partners involved in production and fulfillment. Supplier records serve two purposes:

1. Cost workflows — when you assign a supplier to an order item in the Ledger, Sellfern uses the supplier record to track production costs against that partner.
2. Supplier role users — if you create a user with the Supplier role, that account must be linked to a supplier record. The linked record controls what the external partner can access.

For integrated suppliers such as Printway and BurgerPrints, connect the supplier record from COGS / Fulfillment → Sync Hub. Once connected, Sellfern can retrieve cost and tracking information through the product workflow instead of requiring every update by hand.

​

VAT/IOSS mapping

Go to Settings → VAT/IOSS to configure VAT and IOSS mappings for EU and international orders. Sellfern applies these mappings during order ingestion so orders arrive with the correct tax identifiers assigned. Set up VAT/IOSS mappings before importing orders from regions where these identifiers are required. Configuring them later means existing orders may need manual review.

​

Exchange rates

Go to Settings → Exchange Rates to configure currency mappings and conversion behavior for multi-currency orders. When orders arrive in a currency other than your base currency, Sellfern uses these settings to convert amounts consistently across reports and analytics.

​

API and automation guidance

Do not rely on internal settings or supplier routes for public integrations. Use the developer quickstart and API Reference for supported public automation.