Kramp propose plusieurs façons de « brancher » ses données et ses commandes sur les systèmes d'un revendeur. Le vocabulaire (OCI, EDI) prête à confusion. Cette page explique chaque outil simplement, dit lequel il nous faut pour le site Genin, comment le demander, et surtout ce que les conditions de Kramp nous autorisent ou non à faire.
Sommaire
1. Les 3 façons de se connecter à Kramp (API / OCI / EDI)
2. De quoi a-t-on besoin pour Genin ? → l'API
3. La piste CARFAC (un raccourci possible)
4. Comment demander l'accès (le fameux formulaire)
5. Ce qu'on a le droit de faire… ou pas (conditions Kramp)
6. En résumé — la checklist
1. Les 3 façons de se connecter à Kramp (API / OCI / EDI)
2. De quoi a-t-on besoin pour Genin ? → l'API
3. La piste CARFAC (un raccourci possible)
4. Comment demander l'accès (le fameux formulaire)
5. Ce qu'on a le droit de faire… ou pas (conditions Kramp)
6. En résumé — la checklist
1. Les 3 façons de se connecter à Kramp
Kramp regroupe ça sous le nom « Kramp Connect ». Ce sont des modules qu'on active selon les besoins. Les trois qui reviennent :
| Outil | À quoi ça sert, en clair | Pour quoi c'est fait |
|---|---|---|
| API Application Programming Interface |
Notre système demande à Kramp, en temps réel : « donne-moi la fiche, le stock et le prix de la pièce X » et reçoit une réponse structurée (du JSON). On stocke ces données et on les affiche chez nous, comme on veut. | Alimenter un catalogue / un site web avec les produits, stocks et prix Kramp. |
| OCI Open Catalog Interface |
C'est du « punchout » : depuis notre système, l'utilisateur est envoyé sur la boutique Kramp pour remplir un panier, puis le panier revient dans notre logiciel pour passer la commande. On n'obtient pas le catalogue : on utilise la boutique Kramp comme catalogue. | Faciliter les achats/commandes d'un revendeur qui utilise déjà un logiciel de gestion (DMS). |
| EDI Electronic Data Interchange |
Échange automatique de documents commerciaux (bons de commande, confirmations, factures, bons de livraison) entre le système de Kramp et celui du revendeur, dans un format standardisé. | Automatiser la paperasse de commande/facturation entre deux entreprises. |
Analogie CFML — Pour un développeur ColdFusion :
- API = un
cfhttpvers un web-service Kramp qui te renvoie du JSON produit ; tu ranges ça dans ta base et tu l'affiches dans tes propres.cfm. - OCI = tu rediriges l'utilisateur vers un site externe (comme une page de paiement), il compose son panier là-bas, et tu récupères le résultat au retour.
- EDI = un échange automatisé de fichiers structurés de commandes/factures entre deux ERP (l'ancêtre des web-services, encore très utilisé dans l'industrie).
Le mot « DMS » qui revient partout
DMS = Dealer Management System, le logiciel de gestion d'un concessionnaire
(ventes, stock, factures). Kramp conçoit ces modules d'abord pour des revendeurs qui
ont déjà un DMS et veulent y injecter les données Kramp. Chez Genin, le « DMS »,
c'est CARFAC (voir section 3). Pour notre site, notre pipeline Python peut aussi
jouer ce rôle et consommer l'API directement.
2. De quoi a-t-on besoin pour Genin ? → l'API
Notre objectif : récupérer les produits Kramp (fiches, stock, prix) pour les présenter sur le site Genin, joliment et bien référencés. Un seul outil répond à ça :
👉 C'est l'API qu'il faut demander.
Elle est faite exactement pour « aller chercher les données produits/stock/prix et
les afficher dans son propre système ». C'est le module central du projet côté Kramp.
Pourquoi pas les deux autres (pour l'instant) :
- OCI = non pour construire le catalogue : il ne nous donne pas les données, il renvoie l'utilisateur acheter sur la boutique Kramp. Utile plus tard si on veut automatiser l'acte d'achat, pas pour afficher un catalogue.
- EDI = non pour le catalogue : ça gère les commandes/factures entre systèmes, pas l'affichage produits. Intéressant en phase « back-office » quand les commandes seront automatisées entre CARFAC et Kramp.
Ce que l'API Kramp fournit (côté technique)
- Un portail développeur :
developer.kramp.com(hébergé sur Apigee, la plateforme d'API de Google → API REST qui renvoie du JSON, standard et propre). - Une authentification OAuth : on reçoit un
client_id+ unclient_secret, on obtient un jeton, puis on interroge les données. - Des APIs pour les prix (prix bruts et prix nets revendeur), les produits et le stock, en temps réel.
En CFML : exactement le même schéma que nos web-services — un premier
cfhttp pour s'authentifier (récupérer le token), puis des
cfhttp avec ce token pour lire produits/stock/prix. Rien d'exotique.
3. La piste CARFAC — un raccourci possible 🔎
Point important repéré sur la page Kramp Connect : dans la liste des partenaires DMS déjà intégrés à Kramp, on trouve Bever, Blox, Carfac, C.O.S., Irium (Isagri) et Vary RMS. CARFAC — l'ERP de Genin — fait donc déjà partie des systèmes intégrés à Kramp.
Ça ouvre deux routes pour obtenir les données Kramp :
| Route | Principe | Avantage / inconvénient |
|---|---|---|
| A — API directe | Site Genin ⟵ API Kramp (notre pipeline interroge Kramp directement). | On maîtrise tout ; une intégration à faire nous-mêmes. |
| B — via CARFAC | Kramp ⟷ CARFAC (intégration déjà prévue par Kramp), puis site Genin ⟵ CARFAC. | Un seul point d'intégration (CARFAC) si CARFAC expose déjà les données Kramp via son API. Peut être plus simple. |
Question à poser au contact CARFAC
« Est-ce que CARFAC récupère déjà les données Kramp (stock/prix/produits), et
peut-on les obtenir via l'API CARFAC ? » Si oui → la route B nous évite une
intégration Kramp séparée. Si non → on part sur la route A (API Kramp directe).
C'est la même question que celle qu'on attend déjà pour la doc API CARFAC.
4. Comment demander l'accès (le formulaire)
Tu m'as envoyé deux liens, et j'ai pu ouvrir le vrai formulaire (le navigateur était déjà connecté au compte Kramp de Genin — rien soumis, lecture seule) :
- La page d'explication :
…/business-solutions/connect— décrit API / EDI / OCI, chacun renvoyant à « consulter un représentant Kramp ». - Le formulaire :
…/business-solutions/formulaire— c'est en réalité un simple formulaire de demande d'informations, PAS un formulaire technique d'accès à l'API.
À quoi ressemble vraiment le formulaire
Titre : « Votre entreprise encore plus intelligente et plus efficace ». On coche la (ou les) solution(s) qui nous intéressent, on laisse nos coordonnées, et un « Business Solutions Consultant » nous recontacte. Trois cases possibles :
| Case à cocher | Ce que c'est | Pour nous ? |
|---|---|---|
| Atelier | Powered by Kramp | Rayonnages modulaires, étiquetage, gestion de stock physique d'atelier. | non |
| L'entrepôt | Powered by Kramp | Aménagement et optimisation physique d'entrepôt. | non |
| Connect | Powered by Kramp | « Solution numérique qui relie directement votre logiciel d'entreprise à nos serveurs » — c'est le parapluie qui couvre API / EDI / OCI. | ✅ OUI |
Puis des champs de contact : Nom* et Adresse e-mail* (l'email du compte est déjà pré-rempli). Le lien « Ajouter des informations supplémentaires » ajoute seulement d'autres personnes de contact (Nom + email) — il n'y a aucun champ de message libre. Puis un bouton Soumettre (qui vaut acceptation des termes et conditions).
👉 Sur ce formulaire : coche « Connect | Powered by Kramp », mets ton nom, soumets.
C'est la seule case « numérique ». Mais attention : le formulaire ne distingue pas
API / EDI / OCI — ce choix technique se règle ensuite, avec le consultant qui
rappelle.
Le formulaire seul ne suffit pas à demander « l'API »
Comme il n'y a pas de champ pour le préciser, deux options :
- Soumettre avec Connect coché, puis dire au consultant qu'on veut le module API (temps réel produits/stock/prix) et que le DMS est CARFAC.
- Ou plus direct : écrire à votre Account Manager Kramp (celui du partenariat) avec le texte ci-dessous — c'est de toute façon là que tout aboutit.
Ce qu'il faut dire au consultant / à l'Account Manager (à copier)
« Bonjour, dans le cadre de notre activité de revendeur, nous souhaitons
activer le module API de Kramp Connect (accès temps réel aux
produits, stocks et prix) pour alimenter notre système de vente. Notre
logiciel de gestion (DMS) est CARFAC. Pourriez-vous nous ouvrir l'accès API et
nous fournir les identifiants développeur (
client_id /
client_secret) ? »
À avoir sous la main
- Le numéro de client Kramp de Genin.
- Le nom du DMS = CARFAC (déjà dans leur liste de partenaires → ça facilite).
- Le module visé : API (on garde OCI/EDI pour plus tard, côté commandes/factures).
Bon à savoir — le portail développeur
Sur
developer.kramp.com, la connectivité « For Customers » liste
APIs, EDI, OCI et aussi PRICAT (réception du catalogue de prix sous
forme de fichier). Le détail des APIs est derrière un « Sign In » qu'on obtient une fois
l'accès accordé.
5. Ce qu'on a le droit de faire… ou pas
Lecture des Conditions Générales de Vente Kramp (Kramp SA, Lummen). Les articles qui nous concernent :
| Article | Ce que ça dit | Impact pour nous |
|---|---|---|
| Art. 11 — Propriété intellectuelle | Kramp conserve tous les droits d'auteur et de PI sur ses offres, images, dessins, modèles, descriptions. | Les images et textes Kramp lui appartiennent. |
| Art. 11.2 — Reproduction ⚠️ | Ces contenus « ne peuvent être reproduits, utilisés ou mis à disposition de tiers sans consentement explicite, écrit et préalable de Kramp ». | Le point clé. Republier le catalogue Kramp sur le site Genin nécessite un accord écrit de Kramp. |
| Art. 2.4 — Données techniques | Les specs sont « aussi précises que possible » mais non contraignantes ; Kramp décline la responsabilité sur leur exactitude. | Ne pas garantir aveuglément les specs Kramp → notre couche de vérification/nettoyage prend tout son sens. |
| Art. 3.1 — Prix | Prix indiqués hors TVA. Pas de clause de confidentialité explicite, mais les prix nets sont de fait cachés derrière le login. | Afficher nos prix de vente au public, pas les prix nets revendeur Kramp. |
| Art. 10 — Revente | Aucune clause n'interdit la revente (l'art. 10 ne porte que sur la réserve de propriété jusqu'au paiement). | Revendre les pièces Kramp est OK. |
En pratique : ✅ / ⛔
- Revendre les produits Kramp — aucun obstacle.
- Utiliser l'API comme revendeur pour récupérer stock/prix/produits dans nos systèmes — c'est son usage prévu.
- Re-présenter les infos à notre façon (nos propres descriptions, notre design, nos photos) — c'est notre stratégie « faire mieux que Monfort », et c'est aussi plus sûr juridiquement que du copier-coller.
- Republier tel quel les images et textes Kramp sur le site public sans accord écrit de Kramp (Art. 11.2).
- Le partenariat évoqué vaut probablement accord de principe — il faut le rendre explicite et écrit pour cocher la case de l'Art. 11.2.
À sécuriser avant la mise en ligne publique
Obtenir de Kramp un accord écrit autorisant la reproduction/ré-exploitation de
leur catalogue sur le site Genin (Art. 11.2). L'accès API ne remplace pas cet accord :
l'API donne les données, l'accord donne le droit de les republier.
Le plus propre = préciser ce point dans la convention de partenariat, et privilégier
des fiches enrichies/réécrites plutôt qu'une copie brute.
6. En résumé — la checklist
- Demander à Kramp : le module API (Kramp Connect), pas OCI ni EDI.
- Mentionner CARFAC comme DMS (il est déjà partenaire intégré Kramp).
- Demander à CARFAC s'il fournit déjà les données Kramp via son API (route B) — ça pourrait éviter une intégration Kramp séparée.
- Formaliser par écrit l'accord de Kramp pour republier leur catalogue (Art. 11.2).
- Récupérer les identifiants API (
client_id/client_secret) → dès qu'on les a, on code le connecteur Kramp.
Note : cette page est une lecture pédagogique des documents publics de Kramp (page Connect, conditions générales de vente) au 29/07/2026, pas un avis juridique. Les champs exacts du formulaire n'ont pas pu être vérifiés car il est protégé par le login revendeur. Pour toute clause contractuelle importante, faire valider le texte final de l'accord par la personne compétente.