Dropi Integration

Overview

The Dropi integration allows you to browse products from the Dropi marketplace and import them directly into your Shopify store. Dropi provides access to suppliers across Latin America with support for multiple countries.

Supported Countries

Dropi supports the following countries:

Country	Code	Field ID
Colombia	CO	640597
Ecuador	EC	805359
Chile	CL	665134
Guatemala	GT	747995
Mexico	MX	641097
Panama	PA	742965
Peru	PE	142979
Paraguay	PY	240677

Each country has a unique field ID used for API configuration. The app handles this mapping automatically.

Getting Your Dropi Token

Access Dropi Account

Navigate to Integrations

Go to your account settings and find the integrations or API section

Generate Integration Key

Create a new integration key or copy your existing dropi-integration-key

Save Securely

Store this token safely - you’ll need it for configuration

Configuring Dropi

Before you can browse and import Dropi products, you need to configure the integration:

Configure Ecomdrop First

Dropi configuration is saved via Ecomdrop’s API. Ensure you have your Ecomdrop API key configured first.

Open Configuration Page

Navigate to Apps > Ecomdrop IA Connector > Configuration

Fill Dropi Details

Complete the Dropi configuration form:

Store Name: Your business name in Dropi
Country: Select your operating country
Dropi Token: Your integration key from Dropi

Save Configuration

Click “Save Dropi Configuration” to validate and store your settings

Configuration API Call

When you save configuration, the app makes this API call:

POST https://panel.ecomdrop.app/api/accounts/bot_fields/{fieldId}
Headers:
  X-ACCESS-TOKEN: your_ecomdrop_api_key
  Content-Type: application/x-www-form-urlencoded
  
Body:
  value={your_dropi_token}

The fieldId is automatically determined based on your selected country.

You must have a valid Ecomdrop API key configured before saving Dropi settings. The Dropi token is stored in Ecomdrop’s system.

Browsing Products

Once configured, you can browse Dropi products from the app:

Product Catalog Access

Navigate to Products

Go to Apps > Ecomdrop IA Connector > Products

Browse Dropi Tab

Click on the “Dropi Products” tab

Search & Filter

Use search and filters:

Search: Find products by keywords
Favorites: View your favorited products in Dropi
Private Products: Show your private product catalog

View Details

Click on any product to see full details, images, and variants

API Endpoint

The app fetches products from Dropi’s API:

POST https://api.dropi.co/integrations/products/index
Headers:
  Content-Type: application/json
  Origin: https://n8n.ecomdropsolutions.com
  Referer: https://n8n.ecomdropsolutions.com
  dropi-integration-key: your_dropi_token

Request Parameters

{
  "pageSize": 50,
  "startData": 0,
  "keywords": "",
  "userVerified": false,
  "order_by": "created_at",
  "order_type": "desc",
  "with_collection": true,
  "get_stock": true,
  "no_count": false,
  "favorite": true
}

When searching, only keywords is sent. When browsing, either favorite: true (default) or privated_product: true is sent, but never both.

Response Format

[
  {
    "objects": [
      {
        "id": 12345,
        "name": "Product Name",
        "description": "Product description",
        "price": "29.99",
        "images": [
          {
            "url": "https://cdn.dropi.co/image1.jpg",
            "position": 1
          }
        ],
        "variants": [
          {
            "id": 67890,
            "sku": "PROD-001",
            "price": "29.99",
            "stock": 100
          }
        ],
        "collections": ["Electronics", "Gadgets"],
        "stock": 100
      }
    ],
    "count": 150
  }
]

Importing Products

Import Dropi products into your Shopify store:

Select Product

Browse Dropi products and click on one to view details

Review Product Info

Check the product details, images, and variants

Click Import

Click the “Import to Shopify” button

Map Product Data

The app automatically:

Creates the product in Shopify
Uploads product images
Creates variants with SKUs
Sets pricing
Saves the association for future sync

Verify in Shopify

Navigate to Shopify Products to see your imported product

Product Association

When you import a product, the app creates an association record:

{
  shop: "yourstore.myshopify.com",
  shopifyProductId: "gid://shopify/Product/123",
  dropiProductId: "12345",
  dropiProductName: "Product Name",
  lastSyncedAt: "2024-03-04T12:00:00Z"
}

This allows the app to:

Track which products are imported
Prevent duplicate imports
Enable future synchronization
Display import status

Pagination & Performance

The product browser supports pagination for large catalogs:

pageSize

number

default:"50"

Number of products to fetch per page (max 100)

startData

number

default:"0"

Starting offset for pagination (0-based)

Example Pagination

// Page 1 (products 1-50)
{ pageSize: 50, startData: 0 }

// Page 2 (products 51-100)
{ pageSize: 50, startData: 50 }

// Page 3 (products 101-150)
{ pageSize: 50, startData: 100 }

Favorites Only

Show only products you’ve marked as favorites in Dropi:

{
  "favorite": true
}

Private Products

Show your private product catalog:

{
  "privated_product": true
}

Search by Keywords

Search across product names and descriptions:

{
  "keywords": "smartphone",
  "hasSearch": true
}

When searching, favorite and private filters are ignored to show all matching results.

Troubleshooting

Common Issues

No products showing

Possible Causes:

Invalid Dropi token
No products in your selected filter (favorites/private)
Network connectivity issues

Solutions:

Verify your Dropi token is correct
Try switching between favorites and private products
Check browser console for API errors

Configuration not saving

Possible Causes:

Missing Ecomdrop API key
Invalid country code
Invalid Dropi token format

Solutions:

Configure Ecomdrop API key first
Select a country from the dropdown
Verify token from Dropi dashboard

Products not importing

Possible Causes:

Shopify API rate limits
Missing product data (images, variants)
Duplicate product exists

Solutions:

Wait a moment and retry
Check if product already exists in Shopify
Review server logs for specific errors

API Error 401 or 403

Cause: Invalid or expired Dropi tokenSolution:

Go to Dropi dashboard
Generate a new integration key
Update in app configuration

Data Synchronization

Current Behavior

The current version supports:

✅ One-time product import from Dropi to Shopify
✅ Product association tracking
✅ Duplicate detection

Future Features

Planned features include:

Automatic inventory sync
Price updates from Dropi
Bulk product import
Product update notifications

Security & Authentication

The Dropi integration uses multiple security layers:

Dropi Integration Key - Authenticates requests to Dropi API
Ecomdrop API Key - Validates configuration saves
Shopify Session - Ensures user has access to the store
Database Validation - Verifies shop ownership

Dropi tokens are stored in both:

Your local database (encrypted)
Ecomdrop’s bot_fields system

Ensure both are kept in sync for proper operation.

API Rate Limits

Dropi API has rate limits to ensure fair usage:

Requests per minute: Varies by account tier
Concurrent requests: Limited to prevent overload

The app handles rate limiting gracefully by showing empty results on error. Check server logs if you suspect rate limiting.

Code Reference

Dropi integration code locations:

Product Browser: app/routes/api.dropi.products.tsx:5
Configuration Save: app/routes/api.integrations.dropi.save.tsx:11
Country Mapping: app/lib/ecomdrop.api.server.ts:152

Best Practices

Configure Once - Set up Dropi integration before browsing products
Use Favorites - Mark products as favorites in Dropi for easier browsing
Check Associations - Verify products aren’t already imported before clicking import
Monitor Stock - Keep an eye on Dropi stock levels before importing
Test with Few Products - Import 1-2 products first to verify setup

Support

For Dropi-specific issues:

Contact Dropi support for account and token issues
Check the app’s server logs for API errors
Verify your account has access to products in your selected country
Ensure your Dropi account is active and verified

Overview

Getting Started

Core Features

Integrations

Configuration

Deployment

Overview

Supported Countries

Getting Your Dropi Token

Configuring Dropi

Configuration API Call

Browsing Products

Product Catalog Access

API Endpoint

Request Parameters

Response Format

Importing Products

Product Association

Favorites Only

Private Products

Search by Keywords

Troubleshooting

Common Issues

Data Synchronization

Current Behavior

Future Features

Security & Authentication

API Rate Limits

Code Reference

Best Practices

Support

Build docs developers (and LLMs) love

Overview

Getting Started

Core Features

Integrations

Configuration

Deployment

Documentation Index

​Overview

​Supported Countries

​Getting Your Dropi Token

​Configuring Dropi

​Configuration API Call

​Browsing Products

​Product Catalog Access

​API Endpoint

​Request Parameters

​Response Format

​Importing Products

​Product Association

​Pagination & Performance

​Example Pagination

​Filter Options

​Favorites Only

​Private Products

​Search by Keywords

​Troubleshooting

​Common Issues

​Data Synchronization

​Current Behavior

​Future Features

​Security & Authentication

​API Rate Limits

​Code Reference

​Best Practices

​Support

Build docs developers (and LLMs) love

Overview

Supported Countries

Getting Your Dropi Token

Configuring Dropi

Configuration API Call

Browsing Products

Product Catalog Access

API Endpoint

Request Parameters

Response Format

Importing Products

Product Association

Pagination & Performance

Example Pagination

Filter Options

Favorites Only

Private Products

Search by Keywords

Troubleshooting

Common Issues

Data Synchronization

Current Behavior

Future Features

Security & Authentication

API Rate Limits

Code Reference

Best Practices

Support