Vérifier les rappels avant que véhicule ou pièce ne reparte

Un véhicule doit être vendu, une pièce expédiée — et personne ne sait si une mesure de sécurité est en cours. En pratique, cela n’apparaît que lorsqu’un client demande ou qu’un atelier refuse de libérer le véhicule. L’opération est alors avancée, et la faire marche arrière coûte plus que le contrôle.

Le rapprochement s’effectue par série contre les mesures de rappel et de sécurité des registres officiels. L’essentiel est moins la correspondance isolée que l’état des données déclaré : une réponse sans état n’est pas une réponse mais un instantané sans date de péremption.

Ce que ce cas suppose

• Un numéro de châssis pour le rapprochement véhicule. Il détermine série et période de production — les repères du rapprochement.
• Une liste de références pour le rapprochement du stock. L’appel en lot est destiné aux stocks, non aux cas isolés en boucle.
• Un endroit pour stocker l’état des données. Sans lui, impossible de dire ensuite l’ancienneté d’une réponse.
• Une décision sur ce qu’un résultat déclenche. Blocage de vente, information au client ou ordre de contrôle — la requête ne tranche pas à votre place.
• 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.

Pourquoi chaque étape est nécessaire

1. Déterminer le véhicule. GET /vin/{vin}/vehicle renvoie série et période de production. Cette étape vient d’abord car un rappel se rattache presque toujours à une série et une période, non à un véhicule isolé.
2. Rapprocher le véhicule. GET /recalls/vehicles/{vin} renvoie les correspondances des registres officiels, avec l’état des données par registre. Aucune correspondance est un résultat valide, non une erreur — rien n’était consigné à l’état indiqué.
3. Rapprocher le stock. POST /recalls/parts contrôle jusqu’à cent entrées de positions en un appel — chacune avec un oeNumber et, en option, votre propre reference ainsi que le véhicule. Pour un stock, c’est la seule voie praticable : qui interroge ligne par ligne ne contrôle jamais tout le stock en pratique.

curl -X POST \
  -H 'X-Api-Key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{"positions":[{"oeNumber":"4H0907801","reference":"lager-A12"},{"oeNumber":"8K0959455K","reference":"lager-B07"}]}' \
  'https://api.tapinomahub.com/recalls/parts'

Ce que l’on obtient

Il reste une décision documentée : vendre, faire contrôler ou bloquer — avec l’état des données sur lequel elle repose. C’est la différence entre « nous ne savions rien » et « nous avons contrôlé à cet état ».

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.