← Back to EcomCentral
GAMBIO REST API v2

Gambio Setup Guide

Connect your Gambio store to EcomCentral using HTTP Basic authentication with your admin username and password.

About Gambio

Gambio is one of Germany's most popular e-commerce platforms, formerly known as modified eCommerce Shopsoftware (modified_shop). It is widely used by small and medium-sized businesses across the DACH region (Germany, Austria, Switzerland) and ships with an optional REST API module that exposes orders, products, and customers via a versioned JSON API.

ℹ️ EcomCentral connects to Gambio's REST API v2 at {store_url}/api.php/v2. The REST API module must be installed and activated in the Gambio back-end before credentials will work.

Prerequisites

Activating the REST API Module

  1. Log in to your Gambio administration panel
  2. Navigate to Modules → Modules & Elements
  3. Find REST API in the list and click Install
  4. Once installed the module status shows Active
  5. Verify the API is reachable by visiting https://your-shop.com/api.php/v2/ in a browser — you should see a JSON response (or a 401 Unauthorized, which confirms the endpoint exists)
⚠️ If the REST API module is not installed, all EcomCentral requests will return 404 Not Found. Install the module first, then add the connection.

Connection Credentials

  1. Note the full URL of your Gambio store, e.g. https://shop.example.com
  2. Use your Gambio administrator username (the login name, not the email)
  3. Use your Gambio administrator password — or an API-specific password if your version supports it
  4. In EcomCentral, add a new Gambio connection and fill in all three fields
  5. Click ⚡ Test to verify the connection

Credentials Reference

KeyRequiredDescriptionExample
url Required Full root URL of your Gambio store. EcomCentral appends /api.php/v2 automatically. https://shop.example.com
username Required Gambio administrator username (login name) admin
password Required Gambio administrator password ••••••••
✅ Alternative key names accepted: store_url for the store URL; user for the username; api_key or key for the password.

API Endpoints Used

OperationMethodEndpoint
Test connectionGET/orders?page=1&per_page=1
List ordersGET/orders?page=P&per_page=N
Order detailGET/orders/{id}
Add trackingPUT/orders/{id} with { "tracking_number":"…", "comments":"…", "orders_status":"Shipped" }
List productsGET/products?page=P&per_page=N
Product detailGET/products/{id}
Update stockPUT/products/{id} with { "products_quantity": N }
ℹ️ All requests use HTTP Basic authentication — the username and password are sent with every call. List endpoints return { orders:[…], total_count:N } or { products:[…], total_count:N }. Single-item endpoints return the object directly without an envelope wrapper.

Order Statuses

Gambio uses both German and English status strings depending on the store's locale setting. EcomCentral recognises both and displays them with colour-coded badges.

EnglishGermanBadge colour
Shipped Versandt Green
Completed Abgeschlossen Green
Delivered — Green
Pending Ausstehend Blue
Processing / New In Bearbeitung Blue
On Hold Wartend Amber
Cancelled Storniert Red
Refunded — Red

Supported Features

FeatureSupportedNotes
View orders (paginated)✅Order ID, date, status, total + currency
View order detail✅Customer info, billing & delivery addresses, line items, current tracking
Add tracking number✅Sets tracking_number, comment, and orders_status via PUT /orders/{id}
View products (paginated)✅Product ID, SKU (products_model), name, price, stock quantity
View product detail✅Full product with description (HTML stripped), weight, status
Update stock quantity✅By product_id via PUT /products/{id} with products_quantity
Test connection✅Hits GET /orders?per_page=1 — success confirms credentials are valid

Troubleshooting

401 Unauthorized

The username or password is wrong, or the admin account does not have API access rights. Double-check both values. Some Gambio versions require the administrator account to have the REST API permission enabled under Admin → Access Profiles.

404 Not Found on all requests

The REST API module is not installed or not active. Go to Modules → Modules & Elements → REST API and click Install. Also verify the store URL is correct and does not include a trailing path.

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 store root URL — for example https://shop.example.com. Do not append /api.php or /api.php/v2; EcomCentral adds that path automatically. A trailing slash is also harmless and will be stripped.

🔧 Quick sanity check — visit https://your-shop.com/api.php/v2/orders?per_page=1 in a browser. A 401 response means the API module is active (enter credentials). A 404 means the module is not installed.