Retail Supply Network Docs

v4.2.1 Updated: Mar 2026 Public API

Welcome to the Aevum Zenth Retail Supply documentation. This network powers end-to-end inventory, fulfillment, and retail analytics across 12,000+ partner locations globally. The REST API enables real-time synchronization with ERP, POS, and e-commerce platforms.

Overview & Architecture

The Retail Supply API follows a resource-oriented design with standard HTTP semantics. All requests are routed through our global edge network, ensuring <50ms latency for read operations and eventual consistency for write-heavy inventory syncs.

Base URL: https://api.aevumzenth.com/v4/retail
Content-Type: application/json
Rate Limits: 1,000 req/min (standard), 5,000 req/min (enterprise)
Idempotency: Supported via X-Idempotency-Key header

Authentication

All API requests require a Bearer token issued via OAuth 2.0 Client Credentials flow. Tokens expire after 3600 seconds and must be refreshed using the provided refresh grant.

# POST https://auth.aevumzenth.com/oauth/token
{
  "grant_type": "client_credentials",
  "client_id": "your_client_id",
  "client_secret": "your_secret",
  "scope": "retail:read retail:write inventory:sync"
}

Include the token in subsequent requests:

Authorization: Bearer <access_token>

Product Catalog API

Manage SKUs, variants, pricing, and metadata across your retail network.

GET /catalog/products

Retrieve paginated product listings with optional filters for category, status, or warehouse.

Parameter	Type	Description
category_id*	string	Top-level retail category
status	enum	`active`, `discontinued`, `archived`
limit	integer	Max 100 items per page

POST /catalog/products

Create a new product variant. Requires valid X-Idempotency-Key for retry safety.

{
  "sku": "AZ-RSL-99204-BLK-L",
  "name": "ErgoDesk Pro X1",
  "price_cents": 34999,
  "currency": "USD",
  "warehouse_zones": ["NA-EAST", "EU-CENTRAL"]
}

Inventory Management

Real-time stock levels, reservations, and cycle count synchronization.

PUT /inventory/{sku}/stock

Adjust physical stock counts. Triggers downstream fulfillment queue updates.

Field	Type	Description
quantity*	integer	Net change (positive or negative)
reason	string	`receipt`, `adjustment`, `damage`
location_id	string	Warehouse or store identifier

Webhooks & Events

Subscribe to real-time supply chain events. All payloads are signed with HMAC-SHA256 using your webhook secret.

inventory.low_stock - Stock falls below threshold
fulfillment.shipped - Package handed to carrier
catalog.updated - Product metadata changed
compliance.audit_log - GDPR/PCI audit trigger

# Example Webhook Payload
{
  "event_id": "evt_9x82f3a1",
  "type": "inventory.low_stock",
  "timestamp": "2026-03-14T09:42:00Z",
  "data": {
    "sku": "AZ-RSL-99204-BLK-L",
    "current_qty": 12,
    "threshold": 25,
    "location": "WH-EU-04"
  }
}

Data Handling & Compliance

All retail supply data is encrypted at rest (AES-256) and in transit (TLS 1.3). Partner data is isolated via logical tenant segmentation. Audit logs are retained for 7 years per SOX & GDPR requirements.

For data deletion requests or DPIA documentation, contact privacy@aevumzenth.com or use the Data Subject Portal.