Composer un texte d’annonce prêt à publier

Ce que vous recevez

Vous recevez un titre, une description et des équipements clés en allemand, anglais ou français, avec des indicateurs transparents sur la couverture et une éventuelle troncature.

Un cas d’usage concret au quotidien

Après l’évaluation, le collaborateur remarketing choisit « Créer l’annonce ». Les données vérifiées deviennent un texte complet qu’il ne reste qu’à valider.

La valeur concrète pour l’entreprise

Les images, documents ou identifiants deviennent une base de travail concrète. L’équipe gagne du temps de saisie, travaille de façon homogène et se concentre sur la décision métier.

Réduit le temps de recherche, de saisie ou d’attente puisque la tâche démarre et se termine dans le système habituel.
Améliore l’exploitation commerciale des données en rendant les offres plus vite complètes, trouvables et compréhensibles.

À qui cela profite le plus

Domaine d’utilisation	L’avantage concret
Commerce automobile	Accélère la réception, le contrôle des données et la commercialisation sans créer un second dossier véhicule.
Recycleurs automobiles	Relie la réception du véhicule, le démontage, la saisie des pièces et la commercialisation du stock dans un flux cohérent.
Ateliers	Réduit les ressaisies et les erreurs de correspondance entre le véhicule, l'ordre de travail et la pièce requise.
Flottes, leasing et remarketing	Standardise le contrôle, la documentation et la remise des véhicules entre sites et prestataires.
Éditeurs ERP, DMS, e-commerce et logiciels	Intègre la fonction par API dans le système de référence et poursuit le traitement sans rupture manuelle.

Comment l’endpoint s’intègre au processus

L’endpoint prend en charge une tâche claire et transmet directement son résultat à l’étape suivante.

Une image, un document autorisé ou un identifiant existant est transmis depuis le système habituel.
tapinomahub reconnaît, rapproche ou prépare le contenu nécessaire.
Un collaborateur contrôle le résultat puis le valide pour le dossier, le stock, l’offre ou la vente.

Ce que renvoie réellement le moteur d'annonce

L'appel commence par un tapiId stable issu d'un parcours VIN terminé avec succès, et non par un VIN libre. tapinomahub transforme les données documentées pour cette référence en brouillon adapté aux marketplaces. Votre DMS, ERP ou portail ajoute ensuite prix, kilométrage, état actuel, dommages, photos, informations vendeur et champs obligatoires du canal cible.

Réponse	Valeur opérationnelle
`title`	Un titre compact fondé sur des caractéristiques justifiées, point de départ pour un site, une marketplace ou un dossier B2B.
`description`	Une description lisible sans équipement inventé et sans promesse de prix, d'état ou de valeur.
`highlights`	Les équipements documentés sont fournis comme avantages réutilisables séparément dans des cartes, listes ou champs de plateforme.
`documentedEquipmentCount`	Indique combien d'équipements sont justifiés dans le dossier véhicule. C'est une valeur de contrôle, pas l'affirmation que la configuration usine est complète.
`truncated`	Indique si le brouillon a été raccourci. Si la valeur est `true`, la rédaction décide quels détails justifiés doivent être ajoutés séparément.
`format`, `tapiId` et `language`	Conservent la référence véhicule, le format et la langue sous forme exploitable afin que brouillon et validation restent liés au bon véhicule en stock.

Trois cas opérationnels réalistes

User story	Déroulement	Valeur concrète
Commerce automobile : en tant que gestionnaire de stock, je veux obtenir un premier brouillon complet peu après la réception afin qu'un véhicule ne reste pas hors marché à cause de la seule rédaction.	Saisir le document, terminer le parcours VIN, conserver le `tapiId`, transmettre langue et notes vendeur justifiées, contrôler le brouillon puis l'envoyer via le connecteur interne vers mobile.de, le site ou d'autres canaux.	Un délai plus court entre dossier complet et annonce validée, moins de copier-coller et moins d'équipements documentés oubliés. Pas zéro seconde, mais un processus d'approbation mesurablement plus rapide.
Véhicule accidenté et marketplace de sauvetage : en tant que responsable remarketing, je veux associer une base neutre de véhicule et d'équipement à un dossier de dommages séparément justifié afin que les enchérisseurs évaluent plus vite opportunités et risques.	Compose Vehicle Listing fournit le texte véhicule justifié. Dommages, état et photos sont ajoutés séparément depuis le protocole de restitution, l'expertise ou `POST /vision/condition-report`, puis validés avant publication.	Un dossier B2B plus cohérent, moins de questions sur l'équipement et une meilleure comparabilité. Des enchères supérieures restent un résultat possible, jamais garanti.
Flotte et leasing : en tant que gestionnaire de flotte, je veux préparer de nombreux retours selon la même logique afin que la qualité ne dépende pas de chaque rédacteur.	Utiliser le même parcours, la langue choisie et un `Idempotency-Key` distinct pour chaque `tapiId`. Ton de marque, champs de plateforme, prix et état de restitution sont ensuite ajoutés par modèles et règles d'approbation.	Plus de débit sans hausse proportionnelle de la rédaction, des brouillons plus cohérents et moins d'erreurs de transfert. La conformité à la marque vient du modèle aval, pas automatiquement du point d'accès.

Du véhicule à l'annonce publiée

Identifier le véhicule via le parcours VIN documenté. Si le fournisseur choisi exige une validation dans le navigateur, terminer d'abord la redirection et rattacher sûrement le tapiId reçu au dossier interne.
Contrôler au besoin les données documentées via GET /vehicles/{tapiId}. Les données opérationnelles actuelles, comme kilométrage ou prix, restent dans leur système source responsable.
Choisir language, le niveau de qualité et au maximum 500 caractères de notes factuelles. Un Idempotency-Key propre empêche une double exécution involontaire ; une réponse réussie peut être rejouée pendant 24 heures.
Appeler POST /vehicles/{tapiId}/listing et reprendre titre, description, highlights, documentedEquipmentCount et truncated.
Contrôler les contenus absents ou raccourcis. Aucun équipement non justifié n'est ajouté ; une référence inconnue ou étrangère renvoie 404 vehicle_not_found au lieu d'un texte supposé.
Ajouter prix, kilométrage, état actuel, dommages, images, informations de garantie et autres champs obligatoires depuis des systèmes validés. Le point d'accès ne crée volontairement pas ces affirmations.
Valider le dossier complet selon le schéma du canal cible. La Seller API de mobile.de peut créer et gérer les annonces, mais exige un connecteur séparé et ses propres identifiants.
Publier uniquement après validation éditoriale et métier, puis consigner horodatage, version, canal et corrections ultérieures dans le dossier véhicule.

Mesurer de façon fiable le gain de temps et la qualité

Indicateurs utiles : médiane du dossier complet à la publication, temps de traitement par annonce, validation au premier passage, nombre de highlights documentés, part de truncated=true, corrections manuelles, refus de plateforme, champs obligatoires absents et délai jusqu'à la première demande qualifiée. N'évaluez prix de vente et jours de stock que sur des groupes comparables et avec les autres facteurs d'influence.

Le droit et les règles des plateformes restent dans la validation

Pour les offres en Allemagne, le § 5 UWG interdit les indications trompeuses notamment sur les caractéristiques essentielles, la disponibilité et le prix. Pour les offres aux consommateurs, la réglementation allemande sur l'affichage des prix exige un prix total clair et attribuable. Compose Vehicle Listing ne produisant ni prix ni état, le processus de vente aval doit les ajouter et les contrôler depuis des sources responsables. La plateforme peut aussi imposer ses propres champs et validations.

Au moment de la mise en œuvre

Les champs, exemples, réponses possibles et prix figurent dans la documentation API de POST /vehicles/{tapiId}/listing.

Sources et références juridiques

Questions fréquentes

Que vais-je recevoir de cet endpoint ?