Lire un calcul et décrire le dommage

Un calcul de réparation est un document dense : postes, temps de main-d’œuvre, références, équipement. En PDF, il est lisible par un humain et sans valeur pour un système. Le ressaisir transfère des erreurs ; l’ignorer, c’est perdre la description la plus fiable du dommage.

Deux appels lisent le document, deux évaluent les photos. Le dossier distingue les deux origines.

La chaîne sépare volontairement deux sources : le document dit ce qui a été calculé, les photos ce qui est visible. Les deux vont dans le même dossier, mais pas dans le même champ — sinon on ne distingue plus le mesuré du décrit.

Surface	Rôles
Hub	Experts et assureurs, Atelier, Commerce automobile

Ce que ce cas suppose

Le calcul comme document accessible. Un tirage photographié convient aussi — le taux de réussite baisse simplement avec la résolution.
Des photos du dommage si une description est souhaitée. Sans image, pas de description ; rien n’est estimé.
L’habilitation à transmettre. Les calculs contiennent régulièrement noms, plaques et données d’assurance.
Une décision sur l’usage du dossier. L’estimation de la valeur résiduelle ne mobilise pas les mêmes champs que la planification du démontage.
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.

La chaîne d’appels de ce cas d’usage
Étape	Appel	Ce qui existe ensuite
Lire le calcul	`POST /scanner/document/calculation`	Postes, temps de main-d’œuvre et équipement structurés au lieu d’un PDF
Extraire les données véhicule	`POST /scanner/document/vehicle`	Véhicule et équipement du même document, sans ressaisie
Décrire le dommage	`POST /vision/damage/describe`	Description de ce que montrent les photos — rien de plus
Classer le composant	`POST /vision/part/quality`	Niveau de qualité par composant, base de la réutilisation ou du remplacement

Pourquoi chaque étape est nécessaire

Lire le calcul. POST /scanner/document/calculation prend le document indiqué par fileUrl au seul niveau prévu, standard, et renvoie postes, temps et équipement structurés. C’est l’étape au plus fort levier : elle remplace le travail manuel que personne ne fait autrement.
Extraire les données véhicule. POST /scanner/document/vehicle tire véhicule et équipement du même document. Appel distinct, car tout dossier n’a pas besoin de la profondeur du calcul — certains n’ont besoin que du véhicule.
Décrire le dommage. POST /vision/damage/describe décrit ce que montrent les photos. Cette étape complète le calcul, elle ne le corrige pas : un remplacement calculé et une rayure visible sont deux affirmations.
Classer le composant. POST /vision/part/quality renvoie un niveau de qualité par composant. C’est seulement là qu’on décide du réemploi ou du remplacement — le calcul seul n’y répond pas.

Lire un calcul de réparation en structure

curl -X POST \
  -H 'X-Api-Key: <API_KEY>' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: schaden-2026-0871-kalkulation' \
  -d '{"fileUrl":"https://example.com/kalkulation.pdf","quality":"standard"}' \
  'https://api.tapinomahub.com/scanner/document/calculation'

Ce que l’on obtient

Il reste un dossier où postes calculés, données véhicule et état visible sont traçables séparément. Pour l’expert, c’est la base de l’évaluation ; pour le recycleur, celle de la planification du démontage.

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

tapinomahub API-Dokumentation

Questions fréquentes

Puis-je soumettre un calcul de plusieurs pages ?

Les indications contractuelles sur le format et la taille figurent dans le contrat OpenAPI. La résolution compte dans tous les cas : ce qui n’est pas lisible n’est pas dans la réponse.

Pourquoi deux appels pour le même document ?

Parce que tout dossier n’a pas besoin de la même profondeur. Si vous ne voulez que le véhicule et son équipement, vous utilisez POST /scanner/document/vehicle au lieu de l’appel de calcul.

Puis-je reprendre la description du dommage dans une annonce ?

Vous pouvez l’utiliser comme base. La responsabilité des mentions de l’annonce reste la vôtre — la description décrit le visible et ne garantit aucun état.