HoursUdviklere
VejledningerIkke frigivet

Godkendelser & automatisering

Automatisering skal gøre en kendt proces gentagelig, ikke gøre uklare rettigheder permanente. Partner-API'et skelner derfor mellem at forberede, oprette en kladde og gennemføre en endelig bogføring.

Beskriv en konkret trigger

En trigger skal identificere, hvornår noget må ske: en ordre er afsluttet, en kildepost er låst, eller en bestemt godkendelse er gennemført. "Når der kommer nye data" er for upræcist til en finansiel automation.

Beskriv også, hvad der må gentages, og hvad der kun må ske én gang. En webhook kan leveres igen. En worker kan genstarte. En bruger kan klikke to gange. Den økonomiske handling skal have en stabil forretningsidentitet og idempotens uafhængigt af disse tekniske gentagelser.

Forberedelse og commit

Brug prepare til tidlig inputkontrol og en separat commit-operation til den endelige handling. Et prepare-resultat er ikke en reservation af en periode eller en rettighed, og det må ikke bruges som et ubetinget bevis flere timer senere.

En grant med endelig bogføring er et særskilt mandat. Den bør kun søges, når appens formål og fejlforløb faktisk kræver det. En integration til kladdeoprettelse kan ofte holde den endelige beslutning i kundens eksisterende proces.

Menneskelig behandling ved undtagelser

Ved ændrede beløb, referencefejl, lukket periode eller tilbagekaldt adgang skal automationen stoppe kontrolleret. Den må ikke "reparere" kontering eller datoer ved at vælge andre værdier, som tilfældigvis accepteres af serveren.

En driftsoversigt skal skelne mellem afvist, afventer afklaring, gennemført og ukendt udfald. Ellers risikerer en operatør at genoprette en allerede bogført operation. Fejlguiden beskriver, hvilke oplysninger en sådan afklaring kræver.

Godkendelsesgrundlaget

En faglig godkendelse skal referere til det indhold, der blev godkendt. Hvis indholdet ændres væsentligt, skal processen vurdere, om godkendelsen fortsat gælder. Det er ikke nok at bevare et grønt felt med en gammel dato.

App Console-review og kundegrant er ikke et generelt API til faglige approval requests. Hours' eksisterende godkendelsesmodel bruges gennem en konkret, verificeret operation, når et sådant partnerflow publiceres.

Stop og genoptagelse

Automationen skal kunne stoppes ved udløb eller revocation uden at blive genskabt af en genstartet worker. Brug aktuel serveradgang for hver operation. En cachet "connected=true" i partnerens system er ikke en autoritativ grant.

Ved genoptagelse skal appen først afklare de tidligere operationers udfald. Nye tokens og en ny grant gør ikke gamle ukendte resultater til "ikke udført". Den rækkefølge er en del af driftssikkerheden, ikke en valgfri forbedring.

Test processen, ikke kun happy path

Test to samtidige triggere, en afbrudt worker efter commit, et udløbet token, en tilbagekaldelse før retry og en ændret apprevision. Test også, at ingen e-mail, betaling eller opsigelse bliver sendt som en skjult sideeffekt af et rent regnskabskald.

Godkendelser & automatisering · Hours Udviklere