Hur statusuppdateringsslutpunkterna fungerar
Alla fem delar samma förfrågan-form (en servicebesöksnyttolast) och ett avgörande beteende: Delade förfrågningsfält:workOrderId och numberOfTechs krävs alltid. id riktar in sig på ett befintligt servicebesök (utelämna det vid första skapandet, återanvänd sedan id:t för varje senare uppdatering av samma besök). leadTechnicianEmail, additionalTechnicianEmails, serviceScheduledAt, checkIn*/checkOut*-grupperna, partsWithQuantity, stockLocationIds och equipmentPerStockLocationIds fylls i allteftersom besöket fortskrider.
supplierFacilityId krävs för nycklar tillhörande interna serviceteam; för tredjeparts leverantörsnycklar skrivs det över med ditt eget anläggnings-id oavsett vad du skickar.
Alla sökvägar ligger under
/v1/supplier/work_order/. Det finns inga motsvarigheter på köparsidan: incheckning och utcheckning kan inte styras från Buyer API.
1. Schemalägg besöket
serviceScheduledAt måste vara en ISO 8601 datum-tid med en T-separator och en explicit offset (till exempel 2026-08-22T09:00:00.000-07:00, eller ...Z för UTC). Ett mellanslagsseparerat värde som 2026-08-22 09:00:00+00:00 avvisas som ogiltig indata. Se Datumformat.
leadTechnicianEmail är huvudteknikerns e-post för besöket och är typad som en vanlig sträng i schemat. Om en tech_scheduled-förfrågan misslyckas med ett generiskt ohanterat undantag, bekräfta först att arbetsordern har passerat acceptans. Bekräfta sedan att serviceScheduledAt följer ISO 8601-formatet ovan. Båda är vanliga orsaker till ett föga beskrivande tech_scheduled-fel.
För att flytta bokningen senare, anropa tech_rescheduled med servicebesökets id och det nya serviceScheduledAt.
2. Checka in
checkInTime sätts som standard till serverns aktuella tid när du sätter en checkInStatus utan tid, så du kan utelämna det i liveintegrationer. Skicka det explicit när du fyller i historiska data. checkInImages tar fotoreferenser och geokoordinater ger köparen bevis på plats.
3. Checka ut och sätt utfallet
Utcheckning är där arbetsorderns nästa status bestäms.checkOutStatus krävs och måste vara ett giltigt namn på arbetsorderstatus; det blir arbetsorderns nya status.
checkOutStatus:
En köpare kan stänga av
allowToPlaceWorkOrdersOnHold för sitt interna serviceteam. Teamets nycklar kan då inte checka ut med en On Hold-checkOutStatus, till exempel PartsRequested eller PartsOnOrder, om inte arbetsordern redan är i vänteläge. Anropet returnerar 403 ForbiddenException med "Placing work orders on hold is not enabled for this internal team", och servicebesöket sparas inte. Nycklar för tredjepartsleverantörer begränsas aldrig. Se när interna team inte kan sätta arbetsordrar i vänteläge.WaitingForReview. WorkReviewedAndCompleted är en status som ägs av köparen. Köparen sätter den efter att ha granskat ditt arbete, eller så sätter OpenWrench den automatiskt när automatiskt godkännande gäller (se nedan). Köparen kan också avvisa arbetet med WorkUnsatisfactory. Du får veta köparens beslut via webhooken workorder.status_update.
Registrera delar och lager som förbrukas vid besöket via partsWithQuantity, stockLocationIds och equipmentPerStockLocationIds i samma nyttolast. Id:na kommer från din lagerkatalog.
Två automationsbeteenden utlöses vid denna punkt:
- Auto-godkännande. För tredjepartsleverantörer vars köparföretag har
autoApproveWorkOrdersCompletedByThirdPartyaktiverat uppgraderas ettWaitingForReview-utfall automatiskt tillWorkReviewedAndCompleted. - Auto-publicering av fakturor. När den resulterande statusen är
WorkReviewedAndCompletedkan regler för auto-publicering av fakturor köras och publicera ditt fakturautkast. Se Offerter och fakturering.
remote_check_in och remote_check_out beter sig identiskt för fjärrarbete.
Läsa tillbaka ett servicebesök
Tre utökningar påGET /v1/supplier/work_order/service_calls/{id}:
Jobb med flera besök
En arbetsorder kan bära många servicebesök (diagnos, reparation, uppföljning). Skapa varje besök med sitt egettech_scheduled-anrop (utan id), och håll varje besöks efterföljande uppdateringar nycklade till dess servicebesöks-id. Checka ut mellanliggande besök med en fortsättningsstatus såsom PartsRequested eller TechScheduled, och bara det slutliga besöket med WaitingForReview.