Getting started is quick and easy! Follow these steps:

Step 1: Install the App
- Install the Stanley/Stella Importer app from the Shopify App Store
- The app will automatically create a Free plan subscription for you
- You can upgrade to Standard or Premium plans anytime

Step 2: Set Up Your Stanley/Stella Credentials
- Navigate to "Credentials" in the app navigation menu
- Enter your Stanley/Stella API username and password
- These credentials are required to access the Stanley/Stella product API
- Your credentials are securely stored and encrypted
- Click "Save Credentials" to store them

Step 3: Understand Your Plan
- Basic Plan $29/month): Import products, color swatches, and set up metafields
- Standard Plan ($49/month): Adds product image imports
- Premium Plan ($69/month): Adds automatic stock and price updates
- All plans include a 7-day free trial when you upgrade

Step 4: Refresh Product Cache
- On the app home page, click "Refresh Cache"
- This loads all available Stanley/Stella products from their API
- The process takes 1-2 minutes depending on product count
- You only need to do this once, or when you want to see new products

Step 5: Import Your First Product
- Go to "Products API" in the navigation
- Browse or search for products you want to import
- Select products and click "Import Selected Products"
- The app handles all variants, metafields, and product grouping automatically

Make sure you are using the right credentials. Your credentials must be for the Production-API. Merchant Portal has different credentials do not use Merchant Portal credentials here.

The product import process is fully automated and handles all product data:

What Gets Imported:

Product Information:
- Product title, description, and vendor (Stanley/Stella)
- Product type, category, and gender
- Style code, color code, and size information
- All product variants (colors and sizes)

Product Data (Metafields):
- Long descriptions and care instructions
- Product specifications (fit, neckline, sleeve type, etc.)
- Composition and construction details
- Country of origin and certifications
- Product lifecycle and publication status
- All Stanley/Stella-specific product attributes

Variant Data:
- Color names and codes
- Size codes and measurements
- SKU information
- Weight and dimensions
- Pricing information (if Premium plan)
- Stock levels (if Premium plan with stock updates enabled)

Product Images:
- Main product image (all plans)
- Color swatch images (all plans)
- Variant images (Standard and Premium plans only)

Import Process:

1. Select Products
- Go to **"Products API"** page
- Use search or filters to find products
- Select individual products or use bulk selection
- Products are shown with their style codes and descriptions

2. Configure Import Settings
- Choose language code (default: EN)
- Set import delay (default: 50ms - prevents timeouts)
- Option to remove orphaned variants
- Option to activate products in online store

3. Start Import
- Click "Import Selected Products"
- The app processes products one by one
- Progress is shown in real-time
- You'll see a summary when complete

4. Verify Import
- Check your Shopify products page
- Verify all variants are created correctly
- Confirm metafields are populated
- Check that images are attached

After Import:
- Products are ready to use in your store
- All metafields are properly configured
- Products are organized and grouped correctly
- You can start selling immediately

Stock updates keep your inventory synchronized with Stanley/Stella's warehouse:

Manual Stock Updates (All Plans):
- Available on all subscription plans
- Go to "Update Stock" page
- Select your warehouse location:
- DSVDE-OK1 - Primary warehouse
- DSVDE-OK2 - Secondary warehouse
- DSVDE-OK3 - Tertiary warehouse
- Click "Update Stock" to run immediately
- Updates all Stanley/Stella products in your store
- Shows progress and results in real-time

Automatic Stock Updates (Premium Plan Only):
- Available with Premium plan ($69/month)
- Stock syncs automatically every day at 5:00 AM Eastern European Time (EET)
- No manual intervention required
- Updates run in the background
- You can see last run time and next scheduled run

Setting Up Automatic Updates:

1. Navigate to "Update Stock" page
2. Configure Settings:
- Select warehouse location (DSVDE-OK1, OK2, or OK3)
- Set API call delay (default: 500ms recommended)
- This delay prevents rate limiting issues
3. Enable Scheduled Updates:
- Check the box: "Enable daily stock updates at 05:00 EET"
- Click "Save Settings"
- Scheduled updates will start the next day
4. Test First:
- Run a manual update to verify it works
- Check that stock levels are updating correctly
- Verify only Stanley/Stella products are affected

How Stock Updates Work:

Data Source:
- Fetches real-time inventory from Stanley/Stella's production API
- Uses your Stanley/Stella API credentials
- Queries warehouse inventory by SKU
- Updates Shopify inventory levels accordingly

What Gets Updated:
- Only products from Stanley/Stella (identified by vendor)
- Inventory quantities at your selected warehouse
- Available quantity vs total quantity
- Updates all variants for each product

Troubleshooting Stock Updates:

If stock shows 0:
- Check warehouse location is correct
- Verify SKU format matches Stanley/Stella format
- Use Debug page inventory checker to verify API data
- Check that credentials are valid

If updates aren't running:
- Verify Premium plan is active
- Check scheduled task is enabled
- Review last run time in Update Stock page
- Try running manual update first

If some colors don't update:
- Some new colors may need time to appear in API
- Use Debug page to check specific SKUs
- Verify color codes match between Shopify and API
- Check warehouse location has inventory for that color

Note: If you downgrade from Premium to Standard or Basic, scheduled tasks are automatically disabled, but manual updates remain available.

We offer three subscription plans, each designed for different needs:

Basic Plan (€29/month)
- Perfect for: Getting started and testing the app
- Includes:
- Product import - all data and main image
- Import color swatch png images to media
- Theme app extension (dynamic size charts)
- Limitations:
- No variant image imports
- No automatic stock updates
- No price updates
- Best for: Stores that want to import products and handle images manually

Standard Plan (€49/month)
- Perfect for: Stores wanting complete product visuals
- Includes everything in Basic, plus:
- Import all or selected variant images
- Intelligent variant image assignment by color
- Advanced image management with duplicate detection
- Bulk image upload capabilities
- Limitations:
- No automatic stock updates
- No price updates
- Best for: Stores that want full product imagery but handle inventory manually

Premium Plan ($69/month)
- Perfect for: Complete automation and hands-free operation
- Includes everything in Standard, plus:
- Automatic stock updates from Stanley/Stella inventory
- Scheduled daily stock sync (5 AM EET)
- Price updates from Stanley/Stella pricing API
- Scheduled tasks for automation
- Complete set-it-and-forget-it solution
- Best for: Stores wanting full automation and minimal manual work

7-Day Free Trial:
- Basic plan includes a 7-day free trial
- Use the app fully for 7 days with no charges
- Cancel anytime during the trial period at no cost
- After 7 days, billing begins automatically if you continue

Upgrading and Downgrading:

To Upgrade:
- Go to "Subscription" page in the app
- Click "Upgrade" on the plan you want
- Confirm the billing change
- New features are available immediately

To Downgrade:
- Go to "Subscription" page
- Click "Downgrade" to a lower plan
- Confirm the change
- Premium features (stock/price automation) are disabled
- Scheduled tasks are automatically turned off
- You keep access to features in your new plan

What Happens When You Change Plans:
- Upgrading: New features unlock immediately
- Downgrading: Premium features lock, but your data remains
- Canceling: App stops working
- Re-subscribing: All your data and settings are preserved

All Plans Include:
- Setup of custom metafields and metaobjects
- Product import with full data
- Color swatch image imports
- Main product images

Here are solutions to the most common issues:

"Credentials Not Found" Error

Problem: App says Stanley/Stella credentials are not configured.

Solution:
1. Go to "Credentials" page in the app navigation
2. Enter your Stanley/Stella API username and password
3. Click "Save Credentials"
4. Verify credentials are saved (you'll see a confirmation)
5. Try your operation again

If credentials still don't work:
- Verify your username and password are correct
- Check for extra spaces before/after credentials
- Ensure you're using the correct Stanley/Stella API credentials
- Try refreshing the page after saving

Products Not Importing Correctly

Problem: Products import but data is missing or incorrect.

Solution:
1. Check Product Cache:
- Go to app home page
- Click "Refresh Cache"
- Wait for cache to refresh (1-2 minutes)
- Try importing again

2. Verify Product Selection:
- Ensure you selected the correct products
- Check style codes match what you expect
- Verify products are available in Stanley/Stella API

3. Check Import Settings:
- Verify language code is correct (default: EN)
- Check import delay isn't too low (causes timeouts)
- Ensure "Activate Product" is checked if you want products live

4. Review Import Results:
- Check the import summary for errors
- Look for specific product errors in the results
- Verify metafields are being created

Images Not Uploading

Problem: Images fail to upload or don't appear.

Solution:
1. Check Your Plan:
- Variant images require Standard or Premium plan
- Color swatches work on all plans
- Verify your subscription is active

2. Verify Image URLs:
- Stanley/Stella images are hosted on Cloudinary
- Check that image URLs are accessible
- Some images may not exist for all colors

3. Check Image Selection:
- Ensure you selected images to import
- Verify products have images available
- Check that color codes match

4. Review Upload Process:
- Images upload one at a time
- Large batches may take time
- Check for upload errors in results

If images are duplicates:
- The app detects and skips duplicate images
- This is normal behavior
- Check that images are assigned to correct variants

Stock Updates Showing 0 or Incorrect Values

Problem: Stock updates show 0 or wrong inventory levels.

Solution:
1. Use Debug Tool:
- Go to "Debug" page
- Use the **"Inventory Checker" section
- Enter a SKU to check API inventory
- Compare with Shopify inventory

2. Verify Warehouse Location:
- Check you selected correct warehouse (DSVDE-OK1, OK2, or OK3)
- Different warehouses have different inventory
- Verify your products are in that warehouse

3. Check SKU Format:
- SKUs must match Stanley/Stella format exactly
- Verify SKU format in product metafields
- Check that color codes are correct

4. Verify API Connection:
- Check your credentials are valid
- Ensure API is accessible
- Review Debug page for API errors

If some colors don't update:
- New colors may take time to appear in API
- Use Debug inventory checker for specific SKUs
- Verify color codes match between systems
- Check warehouse has inventory for that color

General Troubleshooting Tips:

Verify Settings:
- Check subscription plan is active
- Verify credentials are saved
- Ensure warehouse location is correct
- Review import/update settings

Common Solutions:
- Refresh cache if products seem outdated
- Re-save credentials if API calls fail
- Check plan status if features are locked
- Verify warehouse if stock is wrong