Data Model

This page describes the key entities in Vantemo and how they relate to each other. Understanding the data model helps you build effective integrations.

Core Entities

Shop

The top-level tenant entity. Every resource belongs to a shop.

Shop
├── Products
│   └── Variants (with Options)
├── Orders
│   └── Line Items
├── Customers
│   └── Addresses
├── Categories
├── Collections
├── Coupons
├── Blog Posts
├── Pages
├── Webhooks
├── API Keys
└── Settings

Product

A sellable item. Products have a title, description, price, images, and status.

Variant

A specific purchasable configuration of a product (e.g., "Black / Medium"). Each variant has its own SKU, price, and inventory count.

Products can have up to 3 options (e.g., Color, Size, Material) and up to 100 variants. Variants are auto-generated from option value combinations.

Order

A completed or in-progress purchase. Orders progress through statuses:

PENDING → CONFIRMED → PROCESSING → SHIPPED → DELIVERED
                                            → RETURNED
         → CANCELLED

Customer

A shopper who has created an account or checked out. Customers can have multiple addresses and order history.

Cart

A temporary collection of items before checkout. Carts are created automatically when items are added and converted to orders during checkout.

Pricing

All monetary values are stored as integers in the smallest currency unit (e.g., cents for EUR/USD). A product priced at €70.00 has a price of 7000.

This avoids floating-point precision issues and is consistent with Stripe's pricing model.

Timestamps

All entities include createdAt and updatedAt timestamps in ISO 8601 format (UTC timezone). Some entities also have deletedAt for soft deletion.

Next Steps

• API Reference — See the full schema for each entity
• Multi-Tenancy — How data isolation works