associatedServiceCalls (avec lastServiceCall comme raccourci), et l’API Acheteur ajoute trois endpoints de lecture qui étendent un appel unique avec des preuves plus riches.
Tous les exemples supposent :
Ce que contient un appel de service
À partir des objets embarqués dans un bon de travail, vous obtenez, par appel :leadTechnicianEmail et additionalTechnicianEmails, numberOfTechs, serviceScheduledAt, ainsi que les paires arrivée/départ (checkInTime, checkInNotes, checkInImages, checkInGeoLocation et leurs équivalents checkOut*). Les coordonnées géographiques et les photos vous permettent de vérifier que le technicien était bel et bien sur place.
Les endpoints d’expansion
Chaque segment de chemin/with_* ajoute une section supplémentaire dans la réponse. Combinez-les en enchaînant les segments :
{id} est l’id de l’appel de service, que vous lisez sur les associatedServiceCalls du bon de travail.
Journaux de travail et temps de travail réel
with_work_logs retourne la trace d’événements WrenchMode enregistrée pendant la visite (travail commencé, en pause, repris, terminé) avec trueWorkTimeMillis : la durée de travail sur place, pauses exclues. C’est le nombre à utiliser pour la vérification de la main-d’œuvre, puisque les intervalles bruts entre arrivée et départ incluent les pauses et interruptions.
Détails des techniciens et visibilité des tarifs
with_tech_details retourne les techniciens de l’appel sous forme de fiches de contact. OpenWrench ne renseigne hourlyRate que lorsque votre propre équipe de service interne a effectué l’appel. OpenWrench n’expose jamais les tarifs des fournisseurs tiers aux acheteurs, donc attendez-vous à ce que hourlyRate soit absent des visites de sous-traitants.
Modèle de vérification
Avant d’approuver un bon de travail terminé ou sa facture :- Récupérez le bon de travail et lisez
associatedServiceCalls. - Pour chaque appel, demandez
/with_work_logs/with_tech_details. - Vérifiez
checkInGeoLocationpar rapport à l’emplacement, compareztrueWorkTimeMillisaux heures de main-d’œuvre facturées et révisez les notes et images de départ. - Approuvez via les actions de statut de bon de travail ou contestez via
work_unsatisfactory, en citant ce que vous avez constaté dans la note.
404 pour un appel inconnu, 400 pour un appel hors de votre portée.