← 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. Picks a warehouse for each order automatically, from where the stock is, and can split an order across warehouses
  3. Tracks fulfillment through a 16-state order lifecycle with package-level visibility
  4. Syncs fulfillment back to your store with tracking numbers

Core Concepts

Orders

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

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

Plus exception states: on_hold, partially_shipped, delivery_exception, 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 packages shipped, others still in progress)

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

Inventory

Real-time inventory tracking across all warehouse locations with:

  • Stock allocation — There is no separate Allocate step: Vectis allocates stock to an order’s packages when they’re generated
  • Location-level detail — Warehouse → Zone → Aisle → Rack → Shelf → Bin
  • Reasons on adjustments — The Adjust dialog asks why stock changed (damaged, lost or missing, found during a count, cycle count correction, new stock received, customer return, or other)

Warehouses

Each warehouse has its own:

  • Inventory pool
  • Carrier accounts and shipping rules
  • WMS integration settings

Box sizes for StoaPack are set up once, as packing-container products, and are shared by all warehouses.

Channels

Sales channel integrations pull orders automatically:

Direct integrations:

  • Shopify — OAuth 2.0, webhooks, inventory sync, and product export from Vectis to the store (Sync Products on the channel’s page)
  • WooCommerce — REST API keys: order import, stock and tracking push, product export from Vectis to the store
  • TikTok Shop — OAuth: order import only

Many platforms via API2Cart: Other carts and marketplaces connect through your own API2Cart account.

Any system via API: Our REST API (orders, products, inventory, and webhook subscriptions) lets you connect any e-commerce platform, marketplace, ERP, or WMS. Push orders from any source, sync inventory, receive webhooks. API-client tokens are read-only on orders, products, and inventory today.

Roadmap: Additional first-party channel connectors as we ship them.

Architecture

Vectis is built on:

  • True multi-tenancy — Database-per-tenant with complete data isolation
  • REST API — documented in OpenAPI 3.1, with HMAC-signed webhooks
  • StoaPack integration — 3D bin packing that picks the box for each package

Next Steps