ACTUA pechhulp koppeling
ACTUA pechhulp koppeling
Hoe werkt de ACTUA pechhulp koppeling in Autoflex 10? Deze pagina is gebaseerd op de AA-team uitleg en aangevuld met informatie uit de TEN/API tickets voor ACTUA.
Interesse in deze koppeling? Nog geen toegang? Neem contact met ons op.
Beschikbaar voor formules: AutoVakMeester en CarProf (zie release EVO 2.39.0).
Over de koppeling
Met de ACTUA pechhulp koppeling sluit je rechtstreeks vanuit Autoflex een pechhulpabonnement af. Gegevens van relatie en voertuig worden automatisch doorgegeven aan ACTUA. Bestaande en zojuist afgesloten abonnementen zijn snel inzichtelijk vanuit het voertuig en werkorder.
Productspectrum (volgens TEN-21524): Pechhulp Nederland, Pechhulp Europa, CarProf Servicekaart
Looptijd: altijd 12 maanden; verlengen is functioneel “een nieuwe aanvraag” met een verlengingsvlag in de API
Partnerportaal: overzicht producten, aanschaffen/verlengen, dashboards (bijna verloopt/verlopen), financieel overzicht
Vereisten en datavalidatie
ACTUA valideert aan hun kant of er al actieve abonnementen bestaan en of benodigde gegevens aanwezig zijn. Vanuit Autoflex worden de volgende velden aangeleverd (vereist voor succesvolle afsluiting):
Verkoper: verkoper_naam
Subscription: ingangsdatum, accu_test_uitgevoerd, onderhoud_uitgevoerd
Voertuig: kenteken, merk, type, model, brandstof, datum_eerste_toelating
Klant: aanhef, voorletters, tussenvoegsel, achternaam, postcode, huisnummer, straat, woonplaats, telefoon, email
Belangrijk: zonder telefoon en e-mailadres van de relatie kan geen abonnement worden aangemaakt. Tevens vereist ACTUA dat accu-test uitgevoerd en onderhoud uitgevoerd correct zijn aangevinkt waar van toepassing (zie feedbackteksten onder “Fouten en meldingen”).
Instellen van de koppeling
Ga naar: Instellingen → Koppelingen → ACTUA
Laat de module door Autoflex activeren (indien nog niet zichtbaar in de lijst).
Vul de API key in die je via ACTUA ontvangt.
Controleren
Bij onjuist format/authorization verschijnt een duidelijke foutmelding.
Bij correcte token verschijnt de melding dat ACTUA gebruikt kan worden.
Gebruik ACTUA Portaal om het partnerportaal in de browser te openen.
Testflow uit TEN-21524: het scherm toont ACTUA in de lijst; “Controle” geeft eerst de ongeldige melding (zonder token), daarna “API token is correct” met geldige token; via “ACTUA Portaal” opent de ACTUA website.
Pechhulp afsluiten vanuit een werkorder of voertuig
Open het voertuig (of een bijbehorende werkorder) waarvoor je pechhulp wilt afsluiten.
Klik op het hamburgermenu of het ACTUA-icoon en kies Pechhulp.
Selecteer het gewenste abonnement (Nederland, Europa of CarProf Servicekaart).
ingangsdatum
Accutest uitgevoerd
Onderhoud uitgevoerd
Controleer de relatie- en voertuiggegevens en klik op Abonnement afsluiten.
Na succesvolle aanvraag toont Autoflex de actieve pechhulpstatus bij het voertuig. In overzichten kun je filteren op voertuigen met ACTUA-pechhulp (zie ook bugfix-tracking voor koppelingenfilters in TEN-21766).
Fouten en meldingen
“Abonnement niet aangemaakt: Voeg een telefoonnummer toe” — relatie mist telefoonnummer
“Abonnement niet aangemaakt: Voeg een e-mailadres toe” — relatie mist e-mailadres
“De aanvraag is geweigerd: de accutest is niet uitgevoerd.” — vink accu_test_uitgevoerd aan
“De aanvraag is geweigerd: het onderhoud is niet uitgevoerd.” — vink onderhoud_uitgevoerd aan
Bij al bestaand abonnement: het modaal toont dat er pechhulp actief is voor kenteken XX-XX-XX en geeft de verloopdatum weer
Verlengen
Verlengen bij ACTUA is technisch een nieuwe aanvraag met de API-flag “verlenging=true” en heeft opnieuw 12 maanden looptijd.
Volgens ticketinformatie: verlengen kan pas na 1 maand actief abonnement. Dit wordt door ACTUA gevalideerd.
In de UI voelt dit als “verlengen”, maar onder water wordt een nieuw abonnement ingeschoten met de verlengingsvlag.
Best practices
Zorg dat de relatiekaart altijd een telefoonnummer en e-mailadres bevat vóórdat je naar ACTUA gaat.
Leg in de werkorder kort vast wanneer accutest en onderhoud zijn uitgevoerd, zodat de vinkjes inhoudelijk kloppen.
Controleer het vervalmoment tijdens onderhoud; bied tijdig verlenging aan via de werkorder.
Gebruik het ACTUA-portaal voor overzicht en financiële rapportage.