Philosophie NEXUS

Chaque logiciel maîtrise son domaine.

NEXUS les relie pour aider les dirigeants à prendre de meilleures décisions.

Développeurs & intégrations

Connectez vos données. NEXUS les transforme en décisions.

En construction — spécification technique prête
Connecteur caisse : lecture seule

Une vente, racontée jusqu'à la décision

NEXUS n'ajoute pas un tableau de bord de plus à consulter. Il transforme une donnée qui existe déjà — une ligne de vente dans votre caisse — en une recommandation concrète pour le dirigeant. Voici, étape par étape, ce qui se passe entre le moment où un client paie et le moment où une décision est prise.

1
Une vente est réalisée

Un client achète un produit, à un instant précis, encaissé par un employé donné.

2
Le logiciel de caisse l'enregistre

La transaction est stockée dans votre système, avec vos propres identifiants et votre propre format.

3
NEXUS comprend

La ligne de vente est lue en lecture seule, puis normalisée : produit, quantité, prix, marge réelle, employé, quart.

4
NEXUS la remet en contexte

Cette vente est comparée à l'historique du produit, du quart, de l'employé — pas regardée isolément.

5
Le dirigeant reçoit une recommandation

Pas un chiffre de plus à interpréter : une action concrète, avec le fait qui la justifie.

Chaque logiciel maîtrise son domaine — la caisse encaisse, le stock compte, le planning organise. NEXUS ne remplace aucun d'entre eux : il les relie pour que le dirigeant n'ait plus à faire la synthèse lui-même.

Ce que reçoit le dirigeantExemple illustratif
{
  "type": "recommandation",
  "site": "vito-sainte-marie",
  "generee_le": "2026-07-29T18:00:00-04:00",
  "origine": {
    "vente_id": "sl_987654",
    "produit": "Boissons — prod_00871",
    "quart": "shift_20260729_01"
  },
  "constat": "Le volume de ce produit chute de 18% les soirs de semaine depuis 3 semaines, sans changement de prix.",
  "recommandation": "Vérifier une rupture de stock en fin de service ou repositionner le produit avant 18h.",
  "confiance": "élevée"
}
Cet objet est la sortie du moteur, pas un endpoint que vous consommez directement — il illustre ce que devient une simple ligne de vente une fois passée par NEXUS.

Pourquoi un éditeur devrait connecter son logiciel à NEXUS ?

Parce que NEXUS —

Augmente la valeur de vos données

Chaque vente que vous enregistrez déjà devient une recommandation concrète pour votre client, sans qu'il ait besoin d'un outil de plus.

Ne remplace pas votre logiciel

NEXUS lit vos données en lecture seule. Il ne s'installe jamais à la place de votre caisse, ni de votre gestion de stock.

Respecte votre architecture

Une clé API à portée strictement définie, aucune écriture vers votre système — votre produit reste le vôtre.

Limite les développements

Un connecteur simple à exposer côté lecture, pas une refonte de votre produit ni un partenariat lourd à maintenir.

Crée davantage de valeur pour vos clients

Ils gagnent un conseiller décisionnel sans changer d'outil de caisse — et vous restez leur logiciel de référence.

Un moteur aussi bon que les données qu'il reçoit

NEXUS analyse aujourd'hui les ventes, le stock et la caisse. Mais certaines questions restent sans réponse mesurée — pas par manque d'intelligence, par manque de données.

Aujourd'hui

Le panier moyen, la performance par employé ou par heure, le détail des contrôles de stock, l'impact réel d'une promotion produit par produit et les raisons d'une marge atypique n'existent nulle part dans NEXUS — ces informations restent dans la caisse, dans d'autres outils, ou dans la tête du manager.

Avec l'API

NEXUS lit directement les ventes de la caisse (sans jamais y écrire), et reçoit en plus les déclarations terrain que seul un humain peut fournir. Les recommandations du Conseiller NEXUS s'appuient alors sur des faits mesurés, ligne de vente par ligne de vente, plutôt que sur des approximations.

Deux mécaniques, pas une API généraliste

Un connecteur qui lit les ventes de la caisse, et trois points d'entrée pour des déclarations que seul le terrain peut fournir.

Connecteur caisse — lecture seule
Ventes en ligne de caisse
NEXUS interroge directement votre logiciel de caisse (via une clé API à portée lecture seule) pour récupérer chaque ligne de vente : produit, quantité, prix, remise, employé, quart, horodatage.
  • Chiffre d'affaires et quantités, par produit, catégorie ou période
  • Marge réelle, calculée ligne par ligne
  • Variation de prix et évolution des volumes dans le temps
  • Performance par employé, par quart, par heure et par catégorie
  • Panier moyen et nombre de tickets, recalculés à la demande
Débloque — le panier moyen réel, la disponibilité produit mesurée, et la vérification des stratégies « produit d'appel ».
Déclarations terrain — écriture vers NEXUS
Contrôles de stock
Résultat d'un comptage terrain : quantité théorique vs. quantité réellement comptée pour un article donné.
Débloque — une distinction fiable entre rupture réelle et rupture supposée.
Campagnes commerciales
Déclaration d'une promotion (période, produits concernés, nature) et des imports avant/pendant qui permettent de mesurer son effet.
Débloque — la mesure d'impact d'une promotion produit par produit, pas seulement sur le CA global.
Exceptions de marge
Déclaration qu'un article a une marge volontairement atypique, avec la raison (ex : levier de prix, contrainte fournisseur).
Débloque — moins de fausses alertes de marge sur des choix commerciaux assumés.

Comment NEXUS se connecte à votre écosystème

Une seule porte d'entrée entre votre système d'information et NEXUS : la clé API. Lecture seule dans un sens, écriture stricte dans l'autre — jamais les deux sur le même flux.

Votre système d'information NEXUS — plateforme hébergée Vous, le dirigeant 🧾 Logiciel de caisse Ventes en ligne de caisse Équipe terrain — déclare à NEXUS 📦 Contrôles de stock 📣 Campagnes commerciales ⚖️ Exceptions de marge 🔌 NEXUS API Clé API par établissement 🔒 Bearer — portée définie 🗄️ Données source Donnée conservée telle quelle 🧩 Modèle de données NEXUS Format harmonisé NEXUS ⚙️ Moteurs d'analyse Calculs, tendances, corrélations 🧠 Conseiller NEXUS Traduit l'analyse en recommandation 💡 Vous Décision GET — lecture seule POST — écriture stricte Décision
Lecture seule — caisse → NEXUS Écriture stricte — terrain → NEXUS Décision — NEXUS → dirigeant

Lecture seule vers la caisse, écriture stricte vers NEXUS

🔒

Jamais d'écriture vers votre caisse. Le connecteur ne fait que lire les ventes — aucune opération de NEXUS ne peut modifier, créer ou supprimer une donnée côté logiciel de caisse.

🔑

Une clé API par établissement. Chaque intégration n'agit que pour le site auquel sa clé est rattachée — jamais pour un autre.

📦

La donnée d'origine n'est jamais perdue. Chaque ligne reçue de la caisse est conservée telle quelle, séparément des calculs NEXUS — une évolution du moteur ne peut jamais altérer la source.

🎯

Portée précise par clé. Une clé dédiée aux déclarations de contrôle stock ne peut pas écrire dans les campagnes commerciales, ni ailleurs.

🚫

Tout ou rien. Une donnée incomplète ou incohérente est rejetée en entier — jamais enregistrée à moitié, jamais remplacée par une valeur par défaut qui fausserait un calcul.

De la caisse au Conseiller NEXUS

1
NEXUS interroge la caisse — lecture seule

Avec la clé API fournie par votre logiciel de caisse, jamais l'inverse : aucune écriture ne part de NEXUS vers la caisse.

2
La donnée brute est conservée telle quelle

Chaque ligne reçue est archivée sans transformation, avant tout calcul — la source ne disparaît jamais derrière le résultat.

3
NEXUS normalise

Les identifiants et champs propres à votre logiciel de caisse sont harmonisés vers le format interne de NEXUS.

4
Le Conseiller NEXUS recalcule

CA, marge, volumes et performance par employé, quart, heure et catégorie s'appuient sur la donnée normalisée.

Les déclarations terrain (contrôles stock, campagnes, exceptions de marge) suivent le sens inverse : c'est vous qui envoyez la donnée à NEXUS, via une clé API propre à votre établissement.

À quoi ressemble une ligne de vente lue

Illustration de ce que NEXUS reçoit en lecture depuis la caisse — le connecteur n'est pas encore actif, cet exemple montre la structure cible. Le format réel dépendra de l'API que votre logiciel de caisse expose.

Lu depuis la caisse — lecture seuleExemple illustratif
{
  "id": "sl_987654",
  "created_at": "2026-07-29T14:32:20-04:00",
  "updated_at": "2026-07-29T14:32:20-04:00",
  "status": "completed",
  "ticket_id": "tk_123456",
  "employee_id": "emp_045",
  "shift_id": "shift_20260729_01",
  "sold_at": "2026-07-29T14:32:18-04:00",
  "product_id": "prod_00871",
  "barcode": "3290000000000",
  "category": "Boissons",
  "quantity": 2,
  "unit_sale_price_ht": 2.30,
  "unit_sale_price_ttc": 2.50,
  "unit_purchase_price_ht": 1.15,
  "cost_method": "cmp",
  "currency": "EUR",
  "total_ttc": 5.00
}
Authentification prévue via en-tête « Authorization: Bearer <clé fournie par votre logiciel de caisse, à portée lecture seule> ». Tant que le connecteur n'est pas en service, l'export manuel actuel reste valide.
Le rapprochement produit s'appuie sur product_id/barcode, jamais sur le libellé. NEXUS calcule lui-même la marge à partir des prix HT et de cost_method — aucune marge déjà calculée ne doit être transmise.

Ce que la documentation technique couvrira

Structure prévue de la documentation destinée aux équipes techniques des logiciels de caisse, à publier au moment de l'ouverture du connecteur. Le détail complet existe déjà sous forme de spécification interne et de guide d'intégration ; cette section en résume la structure publique.

URL de baseProduction
https://uzhjpqpctpvxytxpxoqz.supabase.co/functions/v1/api-v1
Cette adresse peut être publiée sans risque : l'accès est protégé par la clé API (Bearer), jamais par la confidentialité de l'URL elle-même — même principe que la plupart des API de production.
Authentification
Clé Bearer strictement lecture seule, compte de service dédié, rotation et révocation sans interruption de service.
Spécifiée
Endpoints
GET /api/v1/sales en lecture, endpoints d'écriture pour les déclarations terrain (contrôles stock, campagnes, exceptions de marge).
Spécifiée
Erreurs
Format d'erreur structuré (code, message, field, request_id, timestamp) commun à tous les endpoints.
Spécifiée
Limites de débit
429 avec en-tête Retry-After ; fréquence d'appel convenue conjointement avec l'éditeur de caisse.
Spécifiée
Webhooks
Alternative au sondage périodique pour les intégrations à plus fort volume — à l'étude, non requise pour la première mise en service.
À l'étude
Changelog
Journal public des évolutions de contrat (champs ajoutés, dépréciés) publié dès l'ouverture du connecteur.
À venir
Sandbox
Environnement de test avec données fictives, pour valider une intégration avant tout accès à des données réelles.
Prévu avant généralisation
Le contrat des endpoints d'écriture (déclarations terrain) est aussi disponible au format OpenAPI : NEXUS-API-openapi-v1.yaml.
Vous voulez connecter votre outil ?

L'implémentation se fait établissement par établissement, en commençant par le connecteur caisse en lecture seule — le flux qui débloque le plus de valeur.

Parlez-nous de votre logiciel de caisse et de ce que vous aimeriez voir remonter automatiquement dans NEXUS.