Un négociant se voit proposer un véhicule de France, un recycleur un de Pologne. Les documents suivent des modèles étrangers, les champs portent d’autres noms, et le numéro de châssis n’est pas là où on l’attend. Ressaisir, c’est se tromper ; faire traduire, c’est perdre des jours.
La lecture internationale fournit les deux : les champs canoniques dans une structure uniforme et, à côté, la valeur d’origine avec son code source. Le numéro de châssis lu devient alors la clé des données véhicule, des rappels et de l’estimation — sans aucune traduction.
| Surface | Rôles |
|---|---|
| Hub | Commerce automobile, Recycleurs automobiles, Flotte et leasing |
Ce que ce cas suppose
- Le certificat comme fichier accessible. L’appel prend
fileUrlouimageUrl; pour les documents personnels, seul le niveaustandardest prévu. - L’habilitation à traiter. Certificats et plaques sont des données personnelles et exigent une base légale.
- Des photos du véhicule avec la plaque. La lecture de plaque prend jusqu’à trois images.
- Un cadre pour l’estimation. Pays, état et type de véhicule déterminent le marché de référence.
- Le droit d’interroger le véhicule. Par l’appel, vous confirmez être détenteur, propriétaire ou mandaté de façon prouvée, ou autrement habilité en droit, et utiliser le numéro de châssis exclusivement pour la finalité licite indiquée.
Le déroulement
Le tableau indique pour chaque étape l’appel compétent et ce qui existe ensuite. La justification de l’étape figure en dessous.
| Étape | Appel | Ce qui existe ensuite |
|---|---|---|
| Lire le document | POST /scanner/document/registration/international | document.countryCode, vehicle.vin, inspection.validUntil — et fields avec la sourceValue d’origine |
| Lire la plaque | POST /vision/license-plate | text, country et confidence par plaque — sans interrogation de détenteur ni de registre |
| Identifier le véhicule | GET /vin/{vin}/vehicle | Série et caractéristiques techniques du numéro de châssis lu |
| Contrôler les rappels | GET /recalls/vehicles/{vin} | Correspondances des registres officiels, avec l’état des données |
| Estimer le revenu | GET /vin/{vin}/economic-evaluation | Recommandation d’achat sur le minimum, avant de négocier |
Pourquoi chaque étape est nécessaire
- Lire le document.
POST /scanner/document/registration/internationalrenvoiedocumentaveccountryCodeetdocumentType,registration,holder,inspectionavecvalidUntil, etvehicleavecvin,makeetfuelType. Dansfields, chaque champ figure aussi avecsourceCodeetsourceValue— ce que disait l’original reste vérifiable. - Lire la plaque.
POST /vision/license-platelit par plaquetext,normalized,country,confidence,positionetobstructions. Seul ce qui figure sur l’image est restitué : ni interrogation de détenteur, ni rapprochement de registre, ni avis sur l’authenticité. Le rapprochement avec le document est votre contrôle de vraisemblance. - Identifier le véhicule.
GET /vin/{vin}/vehiclerenvoie série et caractéristiques techniques du numéro lu. Les données viennent de données de référence, non du document étranger — elles ne dépendent donc pas de sa présentation. - Contrôler les rappels.
GET /recalls/vehicles/{vin}renvoie les correspondances des registres officiels avec leur état. Un rappel ouvert change le prix d’achat, et il se négocie plus facilement avant qu’après. - Estimer le revenu.
GET /vin/{vin}/economic-evaluationprendcountry,conditionetvehicleTypeet renvoie une recommandation d’achat sur le minimum des prix. Cette recommandation est ainsi disponible avant de négocier et doit être vérifiée de façon autonome avant usage.
curl -X POST \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: ankauf-import-fr-0412' \
-d '{"fileUrl":"https://example.com/zulassung-frankreich.pdf","quality":"standard"}' \
'https://api.tapinomahub.com/scanner/document/registration/international'Ce que l’on obtient
Il reste un achat dont les données viennent du document original et de données de référence, non d’une traduction — avec une plaque lue, un état des rappels connu et une recommandation d’achat avant la première négociation.
Où cela figure dans la documentation
Les listes de champs contractuelles, les codes d’erreur et les réponses d’exemple se trouvent dans le contrat OpenAPI de cette surface, à l’adresse docs.tapinomahub.com (tapinoma-hub). Tous les cas d’usage classés par surface et par rôle : aperçu des cas d’usage.
Sources et références juridiques
Questions fréquentes
Quels pays sont lus ?
La liste contractuelle des profils de documents figure dans le contrat OpenAPI. La réponse indique dans document le pays, le profil et le type reconnus.
Pourquoi les valeurs d’origine figurent-elles à côté des champs canoniques ?
Pour que le contenu du document reste vérifiable. sourceCode et sourceValue montrent l’original, code et value la forme unifiée.
La lecture de plaque vérifie-t-elle l’immatriculation ?
Non. Elle ne lit que ce qui figure sur l’image. Aucune interrogation de détenteur ni de registre.
