Install Hometown Aisle: Catalog Sync
Short answer
Install the app from the Shopify App Store, answer the setup steps, then connect your EJD logins so your catalog appears. Nothing changes in your store until you turn writes on.
Install the app, answer seven short setup steps, and connect your EJD logins. Nothing changes in your store until you turn writes on.
- In the Shopify App Store, open Hometown Aisle: Catalog Sync and select Install.
- Review the permissions Shopify shows and approve them. See Technical details for why each is needed.
- Answer the Set up Hometown Aisle: Catalog Sync steps. Each saves when you select Continue, so you can stop and come back. Until the Stock step is saved, setup reopens at the catalog step, with every answer you gave kept: select Continue to go through them.
- Welcome: Your EJD store number. See Connect your EJD logins and EDI.
- Your catalog: the Catalog warehouse (IL01 is recommended) and which departments, classes and brands you sell.
- Pricing and safety: your Margin floor (%), Items EJD only sells to stores, and how case items are handled.
- Stock: the Shopify location for EJD warehouse stock, Where stock comes from, Minimum to show in stock and Hold back (optional). Don't pick the location that holds your store's own shelf stock. If you have only one location, select Create it for me to add one, or tick This location doesn't hold my store's own stock.
- Orders: whether the app sends your orders to EJD. Most stores start with Off: I place orders with EJD myself or Review each order, then send it. Automatic sending needs your EJD order login (EDI) switched from testing to real orders first.
- Plan: select Choose a plan, or Decide later. See Plans, the free trial and billing.
- Done: a table of your answers, each with an Edit link back to its step. Select Go to Home.
- Connect your EJD logins: on the last step or on Waiting for approval, select Connect my EJD logins, or open Settings > EJD feed. Your catalog and costs come only from these logins. See Your EJD logins.
- Wait for approval. When the first catalog file named with your store number arrives from your ECOM login, your store is approved. See Store approval.
- In Shopify, go to Settings > Shipping and delivery and create two shipping profiles, named exactly Brick (store-only items) and Freight (freight items). The app moves items into them but doesn't create them. See Shipping profiles and freight.
- Your first run starts in compare mode once you're approved. It shows what the app would change and writes nothing. See Your first run in compare mode.
Good to know
- No EJD login, no catalog. The store number alone doesn't bring in EJD's items or costs. Each store's catalog comes from its own EJD accounts.
- No EJD account handy? On the Welcome step select Explore with sample data to look around first. See Explore with sample data.
- Orders are separate. You only need an EDI login if you want the app to send your orders to EJD.
- Plans. Until you choose one, the app only compares. During the free trial, once you turn writes on, it writes a sample of up to 250 products.
- Missing shipping profiles. Until Brick and Freight exist, each run holds the changes that need them, and you get the
HOLD_PROFILE_MISSINGalert. - Change your answers later:
- catalog warehouse, margin floor, store-only items and case items in Settings > Pricing and safety
- departments, classes and brands on What you sell (from Rules or Settings > Pricing and safety, select Change)
- stock settings on Stock
- order sending in Settings > Orders
Technical details
Show the exact rules, for the technically minded
The app asks Shopify for:
- products, inventory and locations: to keep your catalog and stock in step with EJD, and to create a location for EJD's stock if you ask
- shipping: to put each item in the right shipping profile
- markets: to read your shipping rates when your store uses Shopify's market-driven shipping, so store-only and freight items can't be bought at the wrong rate
- publications: so hidden items can be taken off your sales channels
- online store navigation and files: for collections, the suggested menu and images
- orders and merchant-managed fulfillment orders: to send orders to EJD, tag each order with its EJD status, and add tracking
Setup steps 2 to 4 save in order. Opening setup again on a live store and changing the catalog warehouse puts the store back in compare mode. Finishing setup never turns writes off on a live store.