Getting started

This section walks you through everything you need to start building a shop or marketplace integration for VARIO Cloud.

Prerequisites

Before you begin, make sure you have the following:

Technical Requirements

• Node.js >= 20.0.0

• npm >= 10.0.0

• Git for cloning the demo repository

VARIO Cloud Requirements

• A VARIO Cloud tenant with access to the Developer section in the Admin Center

• A registered app with valid credentials:

  • appIdentifier — Your app's unique identifier

  • clientId — OAuth client ID

  • clientSecret — OAuth client secret

  • appJWK — JSON Web Key for token signing

App credentials are shown only once during app creation. Make sure to copy and store them securely. See the Create an App guide for details.

Knowledge Requirements

• Basic understanding of Node.js and Express.js

• Familiarity with REST APIs and webhooks

• Understanding of the external platform's API (Shopify, Amazon, Shopware, etc.)

• Completion of the general Apps Quickstart

What You Will Learn

Page	Description
Project Structure	How to organize your shop app's codebase
Your First Shop App	Step-by-step tutorial to build a minimal integration
Local Development	Setting up your dev environment and debugging

Quick Overview

Building a shop integration follows these high-level steps:

1. Set up the project — Clone the demo app and install dependencies

2. Configure credentials — Add your app credentials and manifest

3. Create a sales channel — Register your app as a sales channel provider during installation

4. Register webhooks — Subscribe to ERP events (article updates, stock changes, etc.)

5. Implement data flows — Build the inbound and outbound sync logic

6. Deploy — Make your app publicly reachable and install it in VARIO Cloud

The following pages guide you through each step in detail.