DONNÉES MARCHÉ · IMPORT V1

Du stock à
l’intelligence marché.

Envoyez-nous par e-mail les données de véhicules, pièces, annonces et ventes dans un format JSON clair. Nous contrôlons et importons le fichier en interne. Les analyses OE et la rentabilité de chaque véhicule donneur reposent ainsi sur la même base fiable.

Envoyer le fichier par e-mail Télécharger le format

LE MODÈLE DE DONNÉES

Chaque pièce reste traçable.

5 OBJETS / 1 CHAÎNE

Un numéro OE, une pièce physique et une annonce ne sont pas des identités interchangeables. Le format cible les sépare et les relie par des identifiants source stables.

Véhicule donneur

Le véhicule concret avec VIN, entrée, kilométrage, état et statut de démontage.

VINID VÉHICULECOÛT

Pièce physique

L’unité vendable réelle issue d’un véhicule, avec affectation OE, état et statut de stock.

OEID PIÈCEÉTAT

Annonce

Une offre sur un canal précis. Plusieurs annonces peuvent référencer la même pièce physique.

PRIX AFFICHÉCANALSTATUT

Événement

Les changements de prix et de statut restent disponibles dans le temps sans écraser l’état précédent.

DATEPRIXHISTORIQUE

Vente

Prix de vente, lignes, livraison, annulation et retour sont reliés sans ambiguïté à la pièce.

REVENURETOURROTATION

CE QU’IL NOUS FAUT

La base pour des analyses propres.

MINIMUM + VALEUR

Plus les statuts, horodatages et liens sont complets, plus la demande, le délai de vente et le revenu peuvent être expliqués précisément.

Domaine	Base obligatoire	Valeur analytique supplémentaire
Export	ID export, ID partenaire, mode, date d’export	Couverture et périmètre des sites et canaux
Véhicule	ID véhicule, VIN, site, statut	Entrée, démontage, kilométrage, dommages et coûts
Pièce	ID pièce, ID véhicule, OE primaire, état	Catégorie, position, références et statut de test
Annonce	ID annonce, pièce, canal, premier et dernier prix	Historique, livraison, vues et favoris
Vente	ID vente, pièce, date de vente, prix de vente	Remise, frais, livraison, annulation et retour

NIVEAUX D’ANALYSE

Trois vues, une chaîne de données.

OE × VÉHICULE × MARCHÉ

NIVEAU OE

Marché OE

Offre, prix affiché, prix de vente, rotation et délai de vente par numéro OE exact ou normalisé.

NIVEAU VÉHICULE

Rendement du véhicule

Rendement des pièces, revenus, durée de stockage et coûts de recyclage par VIN et véhicule donneur concret.

NIVEAU CANAL

Performance des canaux

Écarts de prix et de rotation entre places de marché, boutiques, sites et périodes, sans compter le stock deux fois.

CONTRAT JSON

Lisible par machine et vérifiable.

SCHÉMA 1.0.0

Le schéma JSON définit les champs obligatoires, types, plages de valeurs et statuts autorisés. Le guide complète ces règles par des règles métier et des exemples.

EXTRAIT DE STRUCTURE ABRÉGÉ

{
  "schema_version": "1.0.0",
  "export": {
    "export_id": "exp-20260908-0001",
    "mode": "delta",
    "exported_at": "2026-09-08T08:00:00Z",
    "source": { "partner_id": "verwerter-001" }
  },
  "vehicles": [{ "source_vehicle_id": "veh-1042", "vin": "WVWZZZ1JZXW000001" }],
  "parts": [{
    "source_part_id": "part-9182",
    "source_vehicle_id": "veh-1042",
    "oe_numbers": [{ "raw": "5Q0 919 275 C", "relation": "primary" }]
  }],
  "listings": [],
  "listing_events": [],
  "listing_metrics": [],
  "sales": [],
  "tombstones": []
}

Règles essentielles

✓Des source_*_id stables pour les mises à jour plutôt que des libellés variables
✓Les montants sont des entiers dans la plus petite unité monétaire, par exemple 5990 = 59,90 EUR
✓Horodatages RFC 3339 ; les valeurs optionnelles inconnues sont omises
✓Exactement un numéro OE primaire pour chaque pièce physique

TÉLÉCHARGEMENTS

Tout le nécessaire pour l’implémentation.

PRÊT À TRANSMETTRE

Transmettez directement le guide, le schéma et l’exemple à l’éditeur du logiciel ou au responsable des exports.

MD · 40 KO

Contrat de données

Règles métier, modèle d’objets, valeurs de statut et liste de contrôle.

Télécharger le guide SCHÉMA JSON · 49 KO

Schéma de validation

Structure machine contraignante selon JSON Schema Draft 2020-12.

Télécharger le schéma JSON · 15 KO

Exemple complet

Fichier d’exemple avec véhicule, pièces, annonces, événements et vente.

Télécharger l’exemple ZIP · 23 KO

Pack complet

Guide, schéma et exemple réunis dans un pack prêt à transmettre.

Télécharger le pack

DE L’EXPORT À L’ANALYSE

Un flux de données maîtrisé.

4 ÉTAPES

Mapper

Mapper les champs source vers les identifiants, horodatages, statuts et montants du contrat.

Valider

Valider localement l’export par rapport au schéma et aux règles de référence métier.

Transmettre

Envoyer le JSON par e-mail à [email protected] ; tapinomahub confirme sa réception.

Traiter en interne

Nous contrôlons, importons et combinons les données acceptées aux niveaux OE, véhicule, site et canal.

PRÊT POUR LE PREMIER EXPORT ?

Valider le JSON.
Relier les données marché.

Téléchargez le pack de transmission, créez un fichier JSON conforme et envoyez-le à [email protected]. Nous contrôlons et traitons la livraison en interne.

Envoyer le fichier par e-mail Télécharger le pack complet