← Back to docs

Introduction to Vectis

Vectis is an Order Management System (OMS). It sits between your sales channels and your warehouse operations. Orders flow in, Vectis routes them to the right warehouse, tracks fulfillment, and syncs status back to your store.

What Vectis Does

  1. Pulls orders from your connected sales channels automatically
  2. Routes orders to the optimal warehouse based on inventory, location, and rules you define
  3. Tracks fulfillment through a 17-state order lifecycle with package-level visibility
  4. Syncs status back to your store with tracking numbers and delivery updates

Core Concepts

Orders

An order represents a customer purchase. In Vectis, orders have a 17-state lifecycle:

pending → confirmed → allocated → sent_to_wms → picking → picked → packing → packed → shipped → in_transit → out_for_delivery → delivered

Plus exception states: on_hold, backordered, partially_shipped, failed_delivery, cancelled

Packages

Vectis uses package-first architecture. Order status is derived from package status, not the other way around. This means accurate tracking for:

  • Multi-package orders (one order, multiple boxes)
  • Split shipments (items from different warehouses)
  • Partial fulfillment (some items shipped, others backordered)

Packages have their own 14-state lifecycle from pending to delivered.

Inventory

Real-time inventory tracking across all warehouse locations with:

  • Atomic reservations — No overselling, transactional safety
  • Location-level detail — Warehouse → Zone → Aisle → Rack → Shelf → Bin
  • Reason codes — Every adjustment requires a reason (recount, damage, sale, return, shrinkage)

Warehouses

Each warehouse has its own:

  • Inventory pool
  • Box inventory (for StoaPack integration)
  • Carrier accounts and shipping rules
  • WMS integration settings

Channels

Sales channel integrations pull orders automatically:

Direct integrations:

  • Shopify — OAuth 2.0, webhooks, inventory sync
  • WooCommerce — REST API v3, real-time sync

Any system via API: Our REST API (70+ endpoints) lets you connect any e-commerce platform, marketplace, ERP, or WMS. Push orders from any source, sync inventory, receive webhooks.

Coming soon (direct integrations): Amazon, eBay, TikTok Shop, Etsy, Walmart

Architecture

Vectis is built on:

  • True multi-tenancy — Database-per-tenant via Neon serverless PostgreSQL
  • 150+ API endpoints — OpenAPI documented, HMAC-signed webhooks
  • StoaPack integration — AI-powered 3D bin packing

Next Steps