# Cortex > Le back-office multi-tenant des indépendants et PME belges : devis, planning, > stock, parc installé, facturation Peppol. Une seule API, une configuration > par client. Vous êtes un agent et vous disposez d'une clé API (`ck_…`). Quatre adresses suffisent à tout découvrir — dans cet ordre : 1. **https://0.0.0.0:3000/api/v1/manifest** — ce que CE client a réellement : modules ouverts, statuts acceptés, transitions autorisées, événements émis, champs propres à sa maison. Ajoutez `?format=md` pour la version rédigée. 2. **https://0.0.0.0:3000/api/v1/guide** — comment le construire BIEN : une fiche complète par module (le problème, la frontière, le modèle, les invariants, les écrans que ça implique), l'ergonomie rangée par situation, l'interface. `?format=md` rend le guide rédigé, celui qu'on dépose à la racine d'un projet. **Lisible sans clé.** 3. **https://0.0.0.0:3000/api/v1/openapi.json** — le schéma OpenAPI 3.1. Avec votre clé, il ne décrit que les routes ouvertes pour ce client. Sans clé, toute la surface. 4. **https://0.0.0.0:3000/api/v1/recherche?q=** — retrouver une fiche, un article ou une pièce sans connaître son identifiant. Tolère la faute de frappe. ## Ce qu'il y a à faire, et avec quoi - **https://0.0.0.0:3000/api/v1/guide/plan** — les écrans qu'impliquent les modules allumés de CE client, dans un ordre qui tient, et ce que Cortex ne tiendra pas pour vous. Rien n'y est écrit à la main : allumez un module, il apparaît. - **https://0.0.0.0:3000/api/v1/guide/analyse** — les trois analyses à écrire (architecture, ergonomie, interface). `?format=md` rend le DOCUMENT à déposer dans `docs/` : sections factuelles déjà remplies, décisions marquées d'un encadré qu'on retire en répondant. - **https://0.0.0.0:3000/api/v1/guide/outils** — les besoins techniques, les critères pour juger un candidat, et des noms datés. La seule page qui se périme, et elle dit son âge. ## Déclarez ce que vous construisez `PUT https://0.0.0.0:3000/api/v1/projet` — public, surface, appareils, hors-ligne, langues. Une minute, et tout le guide s'ordonne dessus : les rubriques qui visent ce genre de projet passent devant. Rien n'est jamais retranché, seulement mis en avant. Cela n'allume aucun module et n'ouvre aucun droit : c'est une description, pas une configuration. ## Authentification `Authorization: Bearer ck_…` — la clé porte le client, il n'y a rien d'autre à transmettre. Elle reste sur un serveur : dans un navigateur, elle est publique. ## Les règles de maison Le manifeste porte aussi, sous la clé `standards`, ce que l'intégrateur exige de ce que vous CONSTRUISEZ : référencement, données personnelles, ergonomie, interface, contenu, performance, accessibilité, sécurité. Lisez-les avant d'écrire la première ligne, pas à la relecture. Elles se distinguent des règles ci-dessous : celles-ci portent sur l'usage de l'API, celles-là sur le projet lui-même. `https://0.0.0.0:3000/api/v1/guide/ux` et `https://0.0.0.0:3000/api/v1/guide/ui` les servent avec ce que Cortex en sait, chaque consigne étiquetée par sa source. ## Ce que les schémas ne disent pas - **Ne recalculez jamais** un total, une TVA ni un numéro de facture. Ils viennent de Cortex, et un écart entre votre calcul et le sien est un litige. - **N'inventez pas de transition de statut.** Celles du manifeste sont les seules acceptées ; toute autre est refusée en 409. - **Une facture émise est immuable.** On la corrige par une note de crédit, pas par une modification. L'émission n'est pas idempotente : la rejouer est une erreur, pas une répétition. - **Un module éteint répond 403 `feature_disabled`.** Lisez le manifeste d'abord plutôt que de sonder les routes. - **Les webhooks peuvent être relivrés.** Traitez-les de façon idempotente : un même identifiant d'événement peut arriver deux fois. - **En cas de 429**, l'en-tête `retry-after` donne le nombre de secondes. ## Forme des réponses Succès : `{ "data": … }`. Erreur : `{ "error": "", … }` avec `invalid_input` (422, champ fautif dans `details`), `feature_disabled` (403), `unauthorized` (401), ou un refus métier en 409. ## Les modules Chaque fiche dit ce que le module tient, ce qu'il ne tiendra pas, ses invariants, et ce qu'on se prend dans la figure en le refaisant soi-même. Elle est lisible même quand le module est éteint — c'est ce qu'on lit avant de décider — et même sans clé, si vous construisez quelque chose qui n'appellera jamais Cortex. ### Socle — L'identité et la voix du projet — presque tous en ont besoin - `courriel` — Envoi de courriel : envoyer sous le domaine du client, pas sous celui de Cortex https://0.0.0.0:3000/api/v1/guide/modules/courriel - `comptes` — Comptes : inscription, connexion et sessions des utilisateurs finaux du projet https://0.0.0.0:3000/api/v1/guide/modules/comptes ### Commerce — Vendre, chiffrer, encaisser, livrer - `orders` — Commandes : l'état d'un engagement entre l'accord et la remise : placée, préparée, livrée https://0.0.0.0:3000/api/v1/guide/modules/orders - `quotes` — Devis : l'offre chiffrée : lignes, TVA, totaux calculés par le moteur, document imprimable https://0.0.0.0:3000/api/v1/guide/modules/quotes - `catalog` — Catalogue : ce qu'on vend : référence, unité, stock, et le prix de base de l'article https://0.0.0.0:3000/api/v1/guide/modules/catalog - `entitlements` — Droits d'usage : un droit qui s'épuise : un abonnement, un carnet, et le refus quand il ne reste rien https://0.0.0.0:3000/api/v1/guide/modules/entitlements - `panier` — Panier : ce que le visiteur met de côté, chiffré par le cœur, et qui devient une commande en un geste https://0.0.0.0:3000/api/v1/guide/modules/panier - `livraison` — Livraison : retrait ou livraison, par zone et au poids : ce que ça coûte et combien de jours ça ajoute https://0.0.0.0:3000/api/v1/guide/modules/livraison - `remises` — Remises : des codes promo : un pourcentage ou un montant, une période, un plafond d'usages, appliqués au panier https://0.0.0.0:3000/api/v1/guide/modules/remises - `vitrine` — Vitrine : les fiches de ce qu'on vend : titre, accroche, description, points forts, images, référencement https://0.0.0.0:3000/api/v1/guide/modules/vitrine - `avis` — Avis clients : les avis de ceux qui ont vraiment acheté : invitation après livraison, modération, réponse publique, et la moyenne des seuls publiés https://0.0.0.0:3000/api/v1/guide/modules/avis - `payments` — Encaissements : l'argent qui entre : acompte, solde, caution ; et le lien de paiement chez le prestataire du projet (Mollie, ou simulé en attendant sa clé) https://0.0.0.0:3000/api/v1/guide/modules/payments - `invoices` — Factures : le document que la loi contraint : numérotation sans trou, immuabilité, note de crédit, Peppol https://0.0.0.0:3000/api/v1/guide/modules/invoices - `prix` — Prix : les AUTRES tarifs d'un article — étiquetés, datés, et jamais élus à votre place https://0.0.0.0:3000/api/v1/guide/modules/prix ### Planning — Le temps, les personnes et les choses qu'on immobilise - `appointments` — Rendez-vous : une promesse faite à deux : qui vient, quand, et ce qu'elle est devenue https://0.0.0.0:3000/api/v1/guide/modules/appointments - `resources` — Réservations : une chose immobilisée sur une période, et le refus du chevauchement https://0.0.0.0:3000/api/v1/guide/modules/resources - `disponibilites` — Disponibilités : règles de récurrence, absences, synchronisation iCalendar https://0.0.0.0:3000/api/v1/guide/modules/disponibilites - `rappels` — Rappels : une date, un sujet, un événement le jour venu https://0.0.0.0:3000/api/v1/guide/modules/rappels ### Terrain — Ce qui se constate sur place, et ce que ça laisse à faire - `equipements` — Parc installé : numéros de série, position, fin de garantie https://0.0.0.0:3000/api/v1/guide/modules/equipements - `signatures` — Signatures : demander une signature à valeur probante et en constater l'état. La preuve reste chez le prestataire https://0.0.0.0:3000/api/v1/guide/modules/signatures - `releves` — Relevés : modèles versionnés, passages sur le terrain, compte rendu https://0.0.0.0:3000/api/v1/guide/modules/releves - `constats` — Constats : ce qui reste à faire après, avec une gravité et une date — et quelqu'un pour vérifier https://0.0.0.0:3000/api/v1/guide/modules/constats ### Sur-mesure — Configurer, chiffrer et fabriquer une pièce qui n'existe pas encore - `matieres` — Matières : de quoi les choses ont l'air : teinte, brillance, motif, finitions d'atelier et photos https://0.0.0.0:3000/api/v1/guide/modules/matieres - `pieces` — Pièces 3D : des objets en trois dimensions, et les groupes qui les lient — une forme, jamais une pose https://0.0.0.0:3000/api/v1/guide/modules/pieces - `modeles3d` — Modèles 3D : des objets ENTIERS, importés avec leurs matériaux : ce qui se sculpte et s'achète à l'unité, quand la forme ne se calcule pas https://0.0.0.0:3000/api/v1/guide/modules/modeles3d - `configurateur` — Configurateur : les règles du sur-mesure : domaines et refus motivés. Il RÉSOUT le montant, il n'en garde aucun https://0.0.0.0:3000/api/v1/guide/modules/configurateur - `plans` — Plans : nomenclature, débit, achats, gamme, DXF https://0.0.0.0:3000/api/v1/guide/modules/plans - `comptoir` — Comptoir : ce que deviennent les configurations abandonnées — il branche ce qui existe, il ne le réinvente pas https://0.0.0.0:3000/api/v1/guide/modules/comptoir ### Utilitaires — Faire entrer, sortir et garder de la matière - `attachments` — Pièces jointes : le fichier rattaché à n'importe quoi, sa date de validité, et sa purge https://0.0.0.0:3000/api/v1/guide/modules/attachments - `contact_notes` — Notes : ce qui s'est dit au téléphone et qui n'entre dans aucun champ https://0.0.0.0:3000/api/v1/guide/modules/contact_notes - `contacts_export` — Export CSV : faire SORTIR les fiches — un outil dont on ne peut pas partir est un outil qu'on hésite à adopter https://0.0.0.0:3000/api/v1/guide/modules/contacts_export - `imports` — Import : faire ENTRER ce qui existe déjà, depuis un fichier, sans retaper trois ans https://0.0.0.0:3000/api/v1/guide/modules/imports ## Pages - https://0.0.0.0:3000/ — ce que Cortex sait faire, en français - https://0.0.0.0:3000/login — le back-office (humains)