Connect your JooCart store to EcomCentral using Bearer token authentication with your API key.
JooCart is a Joomla-based e-commerce platform popular in Central and Eastern Europe, particularly the Czech Republic and Slovakia. Built as a Joomla component, it integrates tightly with the Joomla CMS and offers a REST API for programmatic access to orders, products, and inventory.
{store_url}/api/v1. The API must be enabled and an API key generated in the
JooCart administration panel before credentials will work.
https://your-shop.com/api/v1/orders?per_page=1
in a browser — a 401 response confirms the endpoint is activehttps://shop.example.com| Key | Required | Description | Example |
|---|---|---|---|
url |
Required | Full root URL of your JooCart store. EcomCentral appends /api/v1 automatically. |
https://shop.example.com |
api_key |
Required | API key from the JooCart admin panel. Sent as a Bearer token on every request. | abc123xyz… |
store_url for the store URL;
apiKey or token for the API key.
| Operation | Method | Endpoint |
|---|---|---|
| Test connection | GET | /orders?page=1&per_page=1 |
| List orders | GET | /orders?page=P&per_page=N |
| Order detail | GET | /orders/{id} |
| Add tracking | PUT | /orders/{id} with { "tracking_number":"…", "carrier":"…", "status":"shipped" } |
| List products | GET | /products?page=P&per_page=N |
| Product detail | GET | /products/{id} |
| Update stock | PUT | /products/{id} with { "stock": N } |
Authorization: Bearer {api_key} on every call. List endpoints return
{ data:[…], total:N, page:N, per_page:N }. Single-item endpoints return
the object directly without an envelope wrapper.
JooCart uses lowercase status strings. EcomCentral displays them with colour-coded badges.
| Status | Badge colour | Meaning |
|---|---|---|
| completed | Green | Order fully processed and complete |
| shipped | Green | Order dispatched to carrier |
| delivered | Green | Order received by customer |
| pending | Blue | Awaiting payment or processing |
| processing / new / confirmed | Blue | Order received and being prepared |
| on_hold / waiting | Amber | Order paused, awaiting action |
| cancelled | Red | Order cancelled |
| refunded | Red | Order refunded |
| failed | Red | Payment or processing failed |
| Feature | Supported | Notes |
|---|---|---|
| View orders (paginated) | ✅ | Order ID, reference number, date, status, total + currency |
| View order detail | ✅ | Customer info, billing & shipping addresses, line items, current tracking |
| Add tracking number | ✅ | Sets tracking_number, carrier, and status via PUT /orders/{id} |
| View products (paginated) | ✅ | Product ID, SKU, name, price, stock quantity |
| View product detail | ✅ | Full product with description (HTML stripped), weight, status, first image |
| Update stock quantity | ✅ | By product_id via PUT /products/{id} with stock |
| Test connection | ✅ | Hits GET /orders?per_page=1 — success confirms API key is valid |
The API key is wrong or has been revoked. Go to JooCart admin → Settings → API, regenerate the key, and update your EcomCentral connection credentials. Make sure you copy the full key without any leading or trailing whitespace.
The JooCart REST API endpoint is not enabled or the store URL is incorrect. Go to
Components → JooCart → Settings → API and ensure the REST API is enabled.
Also verify the store URL is correct and does not include a trailing path like
/api/v1 — EcomCentral appends that automatically.
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.
https://your-shop.com/api/v1/orders?per_page=1 in a browser.
A 401 response means the API is active (check your key).
A 404 means the API is not enabled or the URL is wrong.