🛍️

Shopify Integration

Step-by-step guide to connect Shopify with Organiko.ai

Prerequisites

Before you begin, make sure you have:

  • An active Shopify store (any plan)
  • Store Owner or Staff account with full permissions
  • Products marked with "Organic" in the title or tags
  • Inventory tracking enabled for organic products

What Gets Synced

📤Outgoing (Sales)

  • • Orders (fulfilled and unfulfilled)
  • • Customer information (name, email, shipping address)
  • • Product details (SKU, title, quantity, price)
  • • Order status and fulfillment status

Note: Shopify is typically used as an OUTPUT integration (sales orders). For purchases, use QuickBooks, ERPNext, or another system.

Connection Steps

1

Navigate to Integrations Page

  1. 1. Log in to your Organiko.ai account
  2. 2. Click Integrations in the top menu
  3. 3. Find Shopify under "E-Commerce" section
2

Get Your Shopify Store Name

You'll need your Shopify store name (also called "myshopify domain").

Your store name is:

your-store-name.myshopify.com

You can find this in your Shopify admin under Settings → Domains

3

Click "Connect with OAuth"

Click the green "Connect with OAuth" button. A popup window will appear asking for your store name.

  1. 1. Enter your store name (without ".myshopify.com")
  2. 2. Click "Connect to Shopify"
  3. 3. You'll be redirected to Shopify's authorization page
4

Authorize in Shopify

  1. 1. Log in to your Shopify store if prompted
  2. 2. Review the permissions Organiko.ai is requesting:
    • • Read orders
    • • Read products and inventory
    • • Read customer information
  3. 3. Click "Install app" or "Authorize"
5

Verify Connection

After authorization, you'll be redirected back to Organiko.ai and see:

  • Green "Connected" badge on the Shopify card
  • Your store name displayed
  • "Connected on [date]" timestamp
6

Create a Flow

Now that Shopify is connected, create a flow to start syncing orders:

  1. 1. Go to Flows in the main menu
  2. 2. Click "Create New Flow"
  3. 3. Select an INPUT integration (e.g., QuickBooks for purchases)
  4. 4. Select Shopify as OUTPUT (for sales)
  5. 5. Click "Create Flow"
  6. 6. Toggle the flow to Enabled

Example Flow: QuickBooks (INPUT) → Shopify (OUTPUT) = Track organic purchases from QuickBooks and allocate to Shopify sales orders

How Syncing Works

Automatic Sync Schedule

Organiko.ai checks Shopify for new orders every 15 minutes.

First Sync (Historical Data)

When you first connect, Organiko.ai syncs the last 90 days of orders.

Organic Product Detection

Organiko.ai automatically detects organic products by scanning product titles and tags for keywords:

organic, USDA organic, certified organic

💡 Tip: Add "organic" as a product tag in Shopify for reliable detection

What Happens After Sync

When a new Shopify order with organic items is synced, Organiko.ai automatically allocates inventory using FEFO (First-Expired-First-Out). If there's insufficient inventory or ambiguous allocation, you'll be notified in the Reconciliation page.

Order Status Tracking

Organiko.ai tracks order fulfillment status. When you allocate inventory to an order, you can see whether the order has been fulfilled in Shopify.

Best Practices for Shopify

🏷️Use Consistent Product Tags

Add "organic" as a product tag to all certified organic products. This ensures reliable detection by Organiko.ai.

📦Enable Inventory Tracking

Make sure "Track quantity" is enabled for organic products in Shopify. This allows proper SKU matching with your purchase orders.

🔢Use SKUs Consistently

Use the same SKU for a product across all systems (Shopify, QuickBooks, etc.). This enables automatic matching between purchase orders and sales orders.

Review Allocations Daily

Check the Reconciliation page daily to handle any orders that need manual allocation (e.g., when multiple lots are available).

Troubleshooting

Problem: Can't find my store name

Solution:

  1. 1. Log in to your Shopify admin
  2. 2. Go to Settings → Domains
  3. 3. Look for your "myshopify.com" domain (e.g., "my-organic-store.myshopify.com")
  4. 4. The store name is the part before ".myshopify.com"

Problem: "This app couldn't be installed" error

Solution:

  1. 1. Make sure you're logged in as the Store Owner or have full permissions
  2. 2. Try disconnecting and reconnecting
  3. 3. Check if you have any browser extensions blocking the OAuth flow

Problem: Orders not showing up in Organiko.ai

Solution:

  1. 1. Make sure you created a Flow with Shopify as OUTPUT
  2. 2. Verify the flow is Enabled (green toggle)
  3. 3. Wait 15 minutes for the next sync cycle
  4. 4. Check that your orders contain products tagged as "organic"

Problem: SKU mismatch errors

Solution:

  1. 1. Make sure the SKU in Shopify matches the SKU in your purchase system (QuickBooks, etc.)
  2. 2. SKUs are case-sensitive
  3. 3. Update SKUs in Shopify to match your purchase orders

What's Next?

Need help with Shopify integration?

Contact Support: support@organiko.ai