← Back to EcomCentral
MIJOSHOP (OPENCART FOR JOOMLA) API

MijoShop Setup Guide

Connect your MijoShop store to EcomCentral using your API token from the MijoShop administration panel.

About MijoShop

MijoShop is an OpenCart-based e-commerce component for Joomla CMS, developed by Mijosoft. It runs as a native Joomla extension but provides the full OpenCart storefront and API layer — giving Joomla site owners a powerful, integrated e-commerce solution without leaving the Joomla ecosystem.

Because MijoShop is built on OpenCart, it shares the same route-based API pattern: all requests go to {store_url}/index.php?route=api/... with an api_token query parameter for authentication.

🟣 MEDIUM CONFIDENCE: API endpoint paths are based on OpenCart's route pattern. Exact paths may vary between MijoShop versions. If /index.php?route=api/... does not work, check your MijoShop version's API documentation. Some versions use Joomla's RESTful API at {store_url}/api/ instead.

Prerequisites

Enabling the MijoShop API

  1. Log in to your MijoShop administration panel (usually at /administrator)
  2. Navigate to System → Settings and find the API tab or section
  3. Enable API access and save the settings
  4. Go to System → Users → API (or System → API depending on your version)
  5. Click Add to create a new API user
  6. Give the user a name and set the status to Enabled
  7. Save — the system will generate an API key / token
  8. Copy the generated token — you will need it for the EcomCentral connection
⚠️ The exact path to the API settings may differ between MijoShop versions. If you cannot find the API section, check MijoShop Admin → System → Settings or consult the MijoShop documentation.

Credentials Reference

KeyRequiredDescriptionExample
store_url Required Full root URL of your Joomla site with MijoShop. EcomCentral appends /index.php?route=api/... automatically. Do not include a trailing slash. https://mysite.com
api_token Required API token generated in MijoShop Admin → System → Users → API. Sent as ?api_token=... on every request. abc123def456…
✅ Alternative key names accepted: url for the store URL; apiToken, token, or api_key for the API token.

API Endpoints Used

🟣 All endpoint paths below are MEDIUM confidence — based on the OpenCart route pattern that MijoShop inherits. Verify against your installed MijoShop version if requests fail.
OperationMethodRoute / Endpoint
Test connectionGET?route=api/product&api_token=T&page=1&limit=1
List ordersGET?route=api/order&api_token=T&page=P&limit=N
Order detailGET?route=api/order/info&api_token=T&order_id=ID
Add trackingPOST?route=api/order/addhistory&api_token=T with body order_id, order_status_id, tracking, comment, notify
List productsGET?route=api/product&api_token=T&page=P&limit=N
Product detailGET?route=api/product/info&api_token=T&product_id=ID
Update stockPOST?route=api/product/edit&api_token=T with body product_id, quantity
ℹ️ All requests use the api_token query parameter (OpenCart-style). An Authorization: Bearer {token} header is also sent as a fallback. List endpoints return { "orders":[…], "total": N } or { "products":[…], "total": N }. Single-item endpoints return the object directly. Errors are returned as { "error": […] }.

Order Statuses

MijoShop inherits OpenCart's order status system. Status names are configurable in the admin panel. EcomCentral recognises the common defaults and displays colour-coded badges.

StatusID (default)Badge colour
Complete 5 Green
Shipped / Delivered Green
Pending 1 Blue
Processing 2 Blue
In Progress Blue
On Hold / Backordered Amber
Cancelled / Canceled 7 Red
Refunded / Returned / Denied / Fraud Red
ℹ️ Status IDs shown above are OpenCart defaults. Your MijoShop installation may use different IDs or custom status names. When EcomCentral pushes a tracking update, it sets order_status_id=5 (Complete) by default.

Supported Features

FeatureSupportedNotes
View orders (paginated)Order ID, date, status, total + currency code
View order detailCustomer info, billing & shipping addresses, line items with SKU, totals breakdown
Add tracking numberPosts to api/order/addhistory with tracking, comment, and order_status_id=5
View products (paginated)Product ID, SKU (model field), name, price, stock quantity
View product detailFull product with description (HTML stripped, 400-char limit), EAN, brand, category, image path
Update stock quantityBy product_id via api/product/edit — note: uses product_id, not SKU/model
Test connectionFetches one product — success confirms store_url and api_token are valid
ℹ️ SKU vs product_id: The product's model field is the SKU (displayed in EcomCentral). However, stock updates are keyed by product_id (the numeric ID), not the model/SKU. EcomCentral handles this automatically.

Troubleshooting

403 Forbidden / Authentication error

The api_token is invalid or the API user is disabled. Go to MijoShop Admin → System → Users → API, confirm the user is enabled, and copy the token again. Ensure you paste the full token with no extra spaces.

Empty or unexpected response

API access may not be enabled. Go to MijoShop Admin → System → Settings → API tab and confirm API access is turned on. Also verify the store_url points to the correct Joomla root (no trailing slash, no subdirectory unless your shop is in one).

Route not found / 404 on all requests

The index.php?route=api/... pattern may not match your MijoShop version. Check whether your version uses a different URL scheme. Some MijoShop releases expose the API at {store_url}/api/ (Joomla's RESTful API format) — consult your MijoShop version's documentation or the MijoShop site.

SSL / certificate errors

EcomCentral requires a valid SSL certificate on the store. Self-signed certificates will be rejected. Use a certificate from a trusted CA (e.g. Let's Encrypt) or contact your hosting provider to enable HTTPS.

Incorrect base URL

Enter only the Joomla site root URL — for example https://mysite.com or https://mysite.com/shop if MijoShop is in a subdirectory. Do not append /index.php or ?route=...; EcomCentral adds those automatically. Remove any trailing slash.

🔧 Quick sanity check — visit https://mysite.com/index.php?route=api/product&api_token=YOUR_TOKEN&limit=1 in a browser. A JSON response confirms the API is working. A 403 means the token is wrong; a 404 or HTML page means the route pattern doesn't match your MijoShop version.