Extraire un chiffrage automobile PDF par API : décider plus vite

Dossier sinistre, ordre d’atelier et circuit de valeur résiduelle utilisent les mêmes données, mais les reçoivent souvent en PDF : véhicule en tête, équipement sur plusieurs pages, puis pièces, main-d’œuvre, peinture et totaux. Une reprise manuelle paie plusieurs fois la même saisie et introduit des chiffres inversés dans le contrôle suivant.

Trois documents, trois questions différentes

Un scanner n’est pas meilleur parce qu’il renvoie le plus de champs possible. Il l’est lorsque son contrat correspond à la source. Envoyer un chiffrage au scanner de document véhicule peut produire des détails, mais pas la fiche de chiffrage convenue. Le choix du bon endpoint est donc le premier contrôle.

Ce qui est structuré depuis un chiffrage

• Document : type, sous-type et métadonnées reconnus lorsqu’ils sont imprimés dans la source.
• Source : langue reconnue du document.
• Véhicule : champs effectivement lus dans la source.
• Équipement : lignes avec codes, nature, source et prix lorsqu’il est indiqué.
• Finances : totaux pièces, main-d’œuvre et peinture, plus les autres valeurs imprimées.
• Appréciation de réparation : uniquement les affirmations contenues dans le document.
• Lignes : pièces, main-d’œuvre et peinture dans des listes séparées.
• Notes : éléments qui n’ont pu être attribués sûrement à un champ structuré.

`null`, liste vide et absence de résultat ne se confondent pas

Cas d’exploitation : valoriser un véhicule accidenté depuis son PDF

Sur une plateforme de valeur résiduelle, le délai entre la réception de l’expertise et une décision d’achat étayée compte. Un export PDF lisible, par exemple issu d’un chiffrage DAT ou Audatex, peut entrer directement dans le processus via POST /scanner/document/calculation. L’API renvoie sous forme structurée les données véhicule, pièces, main-d’œuvre, peinture et totaux attestées par le document, sans imposer à un collaborateur de recopier chaque page dans un second écran.

1. Reprendre l’expertise. Le PDF passe automatiquement du dossier sinistre, de la messagerie ou du circuit de valeur résiduelle à l’analyse documentaire.
2. Contrôler les lignes. L’ERP reçoit séparément pièces, main-d’œuvre et peinture avec leurs emplacements source ; les champs incertains ou vides restent visibles.
3. Ajouter le potentiel de recette. Si le VIN et la liste des pièces sont disponibles, l’endpoint distinct GET /vin/{vin}/economic-evaluation peut ajouter offres de marché et recettes attendues comme autre base de décision.
4. Valider l’achat. L’acheteur contrôle les écarts et fixe le prix. La machine prépare le dossier, la décision commerciale reste à l’entreprise.

Cas d’exploitation : le besoin en pièces directement dans l’ERP atelier

L’approvisionnement bénéficie du même flux : les lignes de pièces reconnues passent dans la gestion des stocks ou des commandes sans nouvelle copie du rapport. Si la source indique une référence OE, GET /parts/oe/normalize peut la normaliser et GET /parts/oe/{oeNumber} la recouper. L’ERP maître compare ensuite stock interne, offres neuves et d’occasion ou fournisseurs. Ce que le PDF ne dit pas reste à contrôler et n’est jamais deviné dans une commande.

Quatre détails qui cassent les intégrations

1. Stocker les codes comme texte. Un code d’équipement peut commencer par zéro. Une colonne numérique transforme 01202 en une autre valeur, 1202.
2. Ne pas transformer les montants en centimes. Les lignes portent des décimales dans la devise reconnue du document ; le système cible doit modéliser explicitement cette unité.
3. Conserver la page source. Dans un long document, elle permet de retrouver la ligne d’origine.
4. Ne pas interpréter les vides. Un montant absent n’est pas zéro et une liste de pièces vide ne prouve pas qu’aucune pièce n’est requise.

Un circuit d’import robuste

1. Fournir le PDF inchangé et dans une qualité lisible.
2. Employer un Idempotency-Key propre à chaque import métier.
3. Valider le schéma de réponse et le type de document avant d’écrire les champs.
4. Mapper véhicule, équipement, finances et lignes dans des zones cibles séparées.
5. Reporter visiblement null, listes vides et notes dans l’interface de contrôle.
6. Relier document original et valeurs structurées pour permettre le retour à la source.

Le scan ne remplace ni le chiffrage professionnel ni l’expertise. Il transfère ce que contient le document existant. Évaluation, validation et modifications ultérieures restent dans le système maître. Voir Véhicules accidentés : épave, valeur résiduelle et intérêt pour le centre pour le contexte du véhicule accidenté et Connecter une API : quand cela devient rentable pour l’intégration.