← Back to EcomCentral
AMERICOMMERCE REST API v1

AmeriCommerce Setup Guide

Connect your AmeriCommerce store to EcomCentral using the REST API v1 with token-based authentication.

Prerequisites

ℹ️ The AmeriCommerce REST API uses token-based auth via the X-AC-Auth-Token HTTP header. No OAuth flow is needed — just generate a token in the admin panel.

Getting Your API Credentials

  1. Log in to your AmeriCommerce admin panel
  2. Go to Settings → API Access
  3. Click Generate Token — copy and save the token securely
  4. Note your store's base URL (shown in the browser address bar)
  5. In EcomCentral, add a new AmeriCommerce connection and enter both fields
  6. Click ⚡ Test to verify — should return your store name and ID

Credentials Reference

KeyRequiredDescriptionExample
store_url Required Your store's base URL (no trailing slash) https://mystore.americommerce.com
access_token Required API access token from Settings → API Access eyJhbGci…
✅ Alternative key names accepted: storeUrl for the URL; accessToken or token for the API token.

API Endpoints Used

OperationMethodEndpoint
Test connectionGET/api/v1/stores
List ordersGET/api/v1/orders?rows=N&page=P
Order detailGET/api/v1/orders/{id}?associations=order_items,addresses
Add trackingPOST/api/v1/order_shipments
List productsGET/api/v1/products?rows=N&page=P
Product detailGET/api/v1/products/{id}?associations=product_variants
Update stockPATCH/api/v1/products/{id}
ℹ️ List endpoints return { "documents": [...], "total_record_count": N }. EcomCentral reads the documents array for pagination.

Supported Features

FeatureSupportedNotes
View orders (paginated)✅Order number, date, status, total
View order detail✅Line items, shipping address, customer name
Add tracking / shipment✅POST to /order_shipments with tracking number + carrier
View products (paginated)✅SKU (item_number), name, price, stock
View product detail + variants✅Variant list from product_variants association
Update stock quantity✅PATCH /products/{id} with stock_quantity
Test connection✅Returns store name, ID, currency

Troubleshooting

✕ 401 Unauthorized

The access_token is invalid or has been revoked. Regenerate the token in Settings → API Access and update the connection credentials via Rotate Keys.

✕ 404 on /api/v1/stores

Verify the store_url — it must be the root URL without a trailing slash, e.g. https://mystore.americommerce.com not https://mystore.americommerce.com/.

✕ Stock update returns 404

The stock update endpoint targets the numeric product ID, not the item number (SKU). Use the product ID shown in the product detail panel.