Maestro

Bienvenue 👋 Connectons vos données

Maestro unifie vos ventes et vos stocks, quel que soit votre équipement — boutique en ligne, caisse, ERP, ou simple carnet de commandes. Suivez le guide : dans 20 minutes, votre tableau de bord vit en temps réel.

Étape 1 — à faire en premier, toujours

Importez votre catalogue produits

Les ventes qui arrivent dans Maestro sont rattachées à vos produits par référence (SKU) puis par nom. Importez donc votre catalogue avant de brancher les ventes : soit automatiquement en connectant Shopify, soit en 2 clics avec un export CSV de votre caisse (la colonne des noms est détectée automatiquement). Astuce : si votre export contient l'historique et le stock, importez 6 mois d'historique — vos prévisions seront fiables dès le premier jour.

→ Importer mon catalogue (CSV) → Connecter Shopify (auto)

Étape 1 bis — 1 minute, personnalise tout le reste

Votre façon de gérer les stocks

Trois questions pour calibrer les propositions de commande à votre commerce (profondeur de stock, cadence, délais). Modifiable à tout moment dans Stocks → Réappro & priorités.

En moyenne, combien d'unités d'un même produit gardez-vous en rayon ?

À quelle fréquence passez-vous commande chez vos fournisseurs ?

Combien de temps met une commande à arriver ?

Budget de réappro hebdomadaire (optionnel)

€ / semaine — vide = illimité

Étape 2 — branchez vos ventes (choisissez votre situation)

J'ai une boutique Shopify

Connexion officielle en 3 clics — produits, stocks et ventes en temps réel

3 min

Allez dans Paramètres → Canaux connectés → carte Shopify → Connecter.
Saisissez l'adresse de votre boutique (ma-boutique.myshopify.com) — visible dans votre admin Shopify, menu Paramètres → Domaines.
Shopify vous demande d'autoriser Maestro → cliquez Installer. C'est tout.
De retour dans Maestro, cliquez Synchroniser : vos produits, stocks et 6 mois de ventes sont importés. Ensuite, chaque nouvelle commande arrive automatiquement en quelques secondes.

→ Connecter ma boutique Shopify

J'encaisse avec SumUp

Clé API personnelle — vos transactions TPE remontent dans Maestro

5 min

Dans votre espace SumUp : Compte → Intégrations → Mes apps → Créer une app → copiez la clé (sup_sk_...).
Dans Maestro : Paramètres → Canaux connectés → carte SumUp → Configurer → collez la clé (elle est chiffrée dans votre navigateur, personne d'autre ne peut la lire).
Cliquez Synchroniser les ventes : les 6 derniers mois de transactions sont importés.

💡 Pour que chaque vente soit rattachée au bon produit, utilisez le catalogue d'articles de SumUp en caisse (plutôt que la saisie d'un montant libre).

→ Configurer SumUp

⚡

J'ai une autre caisse ou un autre site (Square, Zettle, L'Addition, Tiller…)

Dites-nous laquelle — on la branche pour vous

2 min

Vous n'avez rien à faire de technique. Indiquez simplement le nom de votre caisse ou de votre site : notre équipe configure la connexion pour vous et vous prévient dès que vos ventes remontent automatiquement (généralement sous 48 h).

⚙️ Option avancée — le faire vous-même via Make / Zapier (utilisateurs techniques)

Dans Maestro : Paramètres → API entrante universelle → Générer ma clé.
Dans Make : déclencheur « nouvelle vente » de votre caisse → module HTTP Make a request.
URL : https://matthieu-62898--maestro-backend-api.modal.run/api/ingest · POST · header X-Maestro-Key = votre clé.
Body JSON : {"type":"sale","ref":"{{ticket}}","lines":[{"sku":"{{ref}}","name":"{{nom}}","quantity":{{qté}},"unit_price":{{prix}}}]}

{ }

J'ai un développeur / un ERP avec API

Appel direct de l'API Maestro — ventes, stocks et catalogue

30 min

Générez votre clé (Paramètres → API entrante universelle), puis envoyez vos données :

curl -X POST https://matthieu-62898--maestro-backend-api.modal.run/api/ingest \
  -H "X-Maestro-Key: mk_VOTRE_CLE" \
  -H "Content-Type: application/json" \
  -d '{"type":"sale","ref":"ticket-1042","channel":"caisse",
       "lines":[{"sku":"ABC-123","quantity":2,"unit_price":12.99}]}'

Trois types de payload : sale (vente + sortie de stock automatique), stock (réceptions / ajustements), products (création et mise à jour du catalogue). La réponse liste les lignes non rattachées (unmatched) pour contrôle. Idempotence par ref : renvoyer deux fois le même ticket ne crée pas de doublon.

CSV

Ma caisse n'a pas d'API (ou je gère sur papier/Excel)

Import CSV + scan de factures — fonctionnel dès le premier jour

10 min

Votre catalogue et vos stocks : exportez un CSV depuis votre caisse ou votre Excel → page Produits → Importer un CSV. Maestro détecte automatiquement vos colonnes (nom, référence, prix, stock…) — vous vérifiez le mapping et validez.
Vos réceptions fournisseurs : photographiez la facture ou le bon de livraison → page Stocks → Scanner une réception. L'IA lit les lignes, les quantités et les prix ; vous validez, le stock entre tout seul.
Répétez l'export CSV chaque semaine (2 minutes) pour tenir vos ventes à jour — ou passez au pont Make/Zapier quand vous serez prêt.

→ Importer mon CSV → Scanner une facture

Étape 3 — vérifiez que tout vit

Passez une vente test (ou re-synchronisez) puis ouvrez votre Tableau de bord : le point vert en haut indique la connexion temps réel — les chiffres bougent sans recharger la page. Après quelques jours de données, la page Prévisions vous donnera des prévisions de ventes fiables (avec leur niveau de confiance mesuré) et votre plan de rachat automatique.