Kheoos valorise des pièces de maintenance industrielle qui dorment dans les stocks. Pour élargir leur diffusion, il fallait transformer un fichier de pièces en offres eBay complètes, rattachées aux bonnes règles de vente.
Dawap a développé dans l’application Kheoos un gestionnaire eBay capable de lire les lignes importées, préparer les stocks et les offres, résoudre les politiques du compte puis publier sur la marketplace.
Cette réalisation relie le site Kheoos à eBay et constitue un cas concret d’intégration eBay API.
1. Présentation du client
Comprendre le contexte business avant la solution
Le catalogue Kheoos porte des références techniques : fabricant, numéro de pièce, description, état, quantité, prix et informations logistiques. Une erreur de mapping peut rendre l’offre inutilisable.
eBay ajoute ses propres objets : inventaire, entrepôt, marketplace, catégories et politiques de livraison, de paiement et de retour.
Le projet devait relier ces deux mondes dans un parcours que l’équipe pouvait lancer et contrôler depuis son back-office.
2. Méthode projet Dawap
Analyse, priorisation, delivery agile et sécurisation du run
Le flux part d’un fichier CSV, vérifie les colonnes attendues puis traite chaque ligne comme une offre distincte. Les appels eBay sont centralisés dans un gestionnaire dédié.
L’intégration associe API Inventory et Trading API. Elle récupère les identifiants de politiques à partir de leurs noms avant de construire l’offre et sa publication.
Chaque import produit un rapport horodaté, donnant à l’équipe un résultat exploitable après le traitement du lot.
3. Le défi catalogue
Faire entrer une pièce industrielle dans le modèle eBay
Une référence Kheoos possède un vocabulaire industriel ; eBay attend un SKU, une catégorie, un stock, un prix et des politiques de compte valides.
Le rôle du connecteur est de traduire ces données sans perdre les informations qui rendent la pièce identifiable.
La publication devient ainsi un processus reproductible plutôt qu’une ressaisie offre par offre.
4. Le fichier comme point de départ
Donner à l’équipe un format d’import maîtrisable
Le back-office reçoit un CSV et en extrait les lignes de pièces. Il contrôle le format avant de confier les données au gestionnaire eBay.
Les colonnes alimentent notamment le SKU, le titre, la quantité, le prix, la catégorie et les paramètres logistiques.
Ce choix permet de préparer un lot hors ligne tout en automatisant la partie la plus risquée : sa traduction vers les API.
5. Le gestionnaire eBay
Centraliser authentification, endpoints et réponses
Le service construit les URL de l’environnement eBay choisi et utilise les jetons configurés pour Inventory API et Trading API.
Il regroupe la récupération des objets du compte et la création des ressources nécessaires à une offre.
Cette frontière évite de disperser les particularités eBay dans les contrôleurs et les modèles du site.
6. Entrepôt et inventaire
Rendre le stock publiable
Des commandes dédiées ajoutent et interrogent les entrepôts eBay. Le gestionnaire peut ensuite rattacher l’offre à la disponibilité prévue.
L’inventaire est construit autour du SKU, identifiant opérationnel qui relie la ligne importée à l’offre distante.
Le stock reste ainsi compréhensible des deux côtés du connecteur.
7. Politiques de vente
Résoudre livraison, paiement et retour
Avant la publication, le service recherche les politiques de livraison, paiement et retour par leur nom et pour la marketplace concernée.
Les identifiants obtenus sont injectés dans l’offre eBay. Une règle commerciale configurée dans le compte devient donc une référence explicite du flux.
Cette étape évite de fabriquer des identifiants ou d’embarquer des valeurs propres à un seul compte dans les données catalogue.
8. Créer et publier les offres
Associer données produit et règles du canal
Le connecteur prépare l’objet inventaire puis construit l’offre avec marketplace, prix, quantité, catégorie et politiques.
Des commandes dédiées prennent en charge la création via Inventory API et via Trading API, les deux voies traitées par l’équipe.
Le résultat est une publication pilotée par les données d’entrée et le compte eBay.
9. Scénario d’import
Publier un lot de pièces de maintenance
L’équipe exporte un lot de pièces au format attendu puis le charge dans le back-office Kheoos. L’application lit chaque ligne et prépare son SKU.
Le gestionnaire vérifie les politiques eBay, construit inventaire et offre, puis appelle l’API de publication.
À la fin du lot, un rapport daté permet de retrouver le résultat du traitement et d’isoler les lignes à reprendre.
10. Contrôle du traitement
Des commandes et rapports pour l’exploitation
Le projet fournit des commandes de connexion, de gestion d’entrepôt et de création d’offres, utiles pour exercer séparément chaque étape.
Le back-office conserve les fichiers et génère des rapports horodatés. L’équipe n’est donc pas limitée à un message générique affiché après l’import.
Le site Kheoos et cette brique eBay ont évolué conjointement pour garder un parcours cohérent entre collecte, qualification et diffusion.
11. Ce que Kheoos prouve
Une intégration marketplace jusque dans les détails de vente
Kheoos prouve la capacité de Dawap à prendre en charge le vrai contrat d’une marketplace : jetons, environnements, inventaire, politiques, catégories et publication.
La fiche Kheoos côté marketplace raconte le produit industriel qui donne son sens à ce connecteur.
Découvrez également nos projets d’intégration API.
12. Conclusion
Pourquoi ce projet donne envie de travailler avec Dawap
Kheoos démontre comment une intégration marketplace transforme un stock technique en catalogue diffusable sans effacer les contraintes du canal.
La solution couvre l’entrepôt, l’inventaire, les politiques du compte, la construction des offres, leur publication et le rapport d’import.
Dawap applique cette expérience à l’intégration API marketplace et à l’industrialisation des flux catalogue et PIM.
