Platform Overview
HappyColis is a full API Event-Based logistics platform designed for e-commerce fulfillment. It provides a unified GraphQL API backed by an event-driven microservice architecture, enabling real-time inventory management, order processing, shipment tracking, and more.
Multi-Tenant Architecture
HappyColis is a multi-tenant platform. Each tenant is called an Organization, identified by a unique OrganizationId (UUID). All resources — products, stock, orders, shipments — belong to a specific organization.
You interact with HappyColis by creating Applications that authenticate via OAuth 2.0 and acquire access tokens scoped to your organization. See Applications and Authentication for details.
Environments
| Environment | Base URL | Description |
|---|---|---|
| Production | https://api.happycolis.com | Live environment |
| Pre-production | https://api-pprod.happycolis.com | Testing and staging environment |
WARNING
Both environments are only accessible with an active HappyColis contract. Contact contact@happycolis.com to get started.
Platform Architecture
The platform is composed of several domain microservices exposed through a single Front API gateway using Apollo Federation v2. Events flow through Kafka and can be delivered to your systems via webhooks.
Key Domains
| Domain | Description |
|---|---|
| Catalog | Products, variants, vendors, and preparation profiles |
| Stock | Inventory levels, stock references, storage profiles, and stock movements per location |
| Orders | Customer orders with line items, lifecycle management, and fulfillment requests |
| Delivery Orders | Per-location fulfillment assignments derived from orders |
| Shipments | Physical packages, carrier tracking, and delivery events |
| Transfer Orders | Inter-location stock transfers between warehouses |
| Locations | Warehouses, fulfillment centers, and their configurations |
| Applications & Webhooks | OAuth applications, access tokens, and real-time event subscriptions |
Next Steps
- Authentication — OAuth 2.0 flows, scopes, and token management
- Applications — Creating and managing API applications
- API Overview — Making your first GraphQL request