← Back to EcomCentral
ACESHOP REST API v1

ACEShop Setup Guide

Connect your ACEShop store to EcomCentral using the REST API with API key authentication.

Prerequisites

ℹ️ ACEShop uses API key authentication sent as Authorization: Bearer {api_key} and X-Api-Key: {api_key} headers on every request. No OAuth flow is required.

Getting Your API Credentials

  1. Log in to your ACEShop admin panel
  2. Navigate to Settings → API (or Nastavení → API in Czech)
  3. Generate or copy your API key
  4. Note your store's base URL — this is the root domain/subdomain of your shop
  5. In EcomCentral, add a new ACEShop connection and enter both fields
  6. Click ⚡ Test to verify — should return your store name and domain
⚠️ API access may require enabling it in the ACEShop admin panel first. Contact your ACEShop provider if the API section is not visible.

Credentials Reference

KeyRequiredDescriptionExample
shop_url Required Your shop's root URL (no trailing slash) https://myshop.example.com
api_key Required API key from ACEShop admin Settings → API ace_live_abc123…
✅ Alternative key names accepted: shopUrl or base_url for the URL; apiKey or key for the API key.

API Endpoints Used

OperationMethodEndpoint
Test connectionGET/api/v1/store
List ordersGET/api/v1/orders?page=P&per_page=N
Order detailGET/api/v1/orders/{id}
Add trackingPUT/api/v1/orders/{id}/tracking
List productsGET/api/v1/products?page=P&per_page=N
Product detailGET/api/v1/products/{id}
Update stockPATCH/api/v1/products/{id} with { stock: N }
ℹ️ List endpoints return { "data": [...], "meta": { "total": N, "page": P } }. EcomCentral reads the data array and meta.total for pagination.

Supported Features

FeatureSupportedNotes
View orders (paginated)✅Order number, date, status, total
View order detail✅Line items, shipping address, existing tracking
Add tracking number✅PUT to order tracking endpoint; carrier + URL optional
View products (paginated)✅SKU, name, price, stock quantity
View product detail + variants✅Variant list from variants field
Update stock quantity✅PATCH product with { stock: N }
Test connection✅Returns store name, domain, currency

Troubleshooting

✕ 401 Unauthorized / 403 Forbidden

The API key is incorrect or API access is disabled. Verify the key in ACEShop admin → Settings → API. Ensure API access is enabled for your account.

✕ Connection error / could not resolve host

Check the shop_url — it must include the protocol (https://) and match your store's domain exactly. Self-signed SSL certificates on test installs may need to be trusted on the EcomCentral server.

✕ Order or product fields show "—"

ACEShop field names may vary between versions. EcomCentral renders fields defensively with multiple fallback paths. If a field is consistently blank, the API response may use a non-standard field name — contact ACEShop support for the field documentation specific to your version.