Registrering og analyse
En kontrakt kan først registreres med leverandør, kategori, prisgrundlag og gyldighed. Dokumentanalyse kan hjælpe med at finde opsigelsesvarsel, bindingsperiode eller tilbagevendende betaling, men udtrækket er ikke selve aftalen.
En brugbar integration skal kunne pege på den relevante dokumentversion og fortælle, hvilke felter der er manuelt bekræftet. En dato, der mangler i kilden, må ikke udfyldes med en overbevisende antagelse uden at være markeret som usikker.
Økonomisk periode og forpligtelse
Månedlig pris, årlig omkostning og næste betalingsdato er forskellige oplysninger. En integrationsmapping skal beskrive, hvilken periode et beløb gælder for, og om afgifter, prisregulering eller engangsudgifter indgår. Partner-API'et har ikke et kontrakt-API, hvor disse betydninger kan efterlades implicitte.
Et ændret prisvilkår kan påvirke rapporter og godkendelsesprocesser. Et system bør derfor ikke blot overskrive et historisk kontraktbeløb uden at kunne forklare, hvilken version der gjaldt på et givet tidspunkt.
Forhandling, opsigelse og underskrift
At udarbejde et forslag til en leverandørbesked er ikke at sende det. At identificere en opsigelsesdato er ikke et mandat til at opsige. At et dokument kan læses i Hours er ikke en signaturfuldmagt.
Disse handlinger kræver egne autorisationer og klare tilstande. Partner-API'et udsteder ingen sådan generel handlekompetence. En fremtidig operation skal angive, hvem der accepterer indholdet, hvad der sendes, og hvordan resultatet dokumenteres.
Ekstern adgang
Kontraktdata beskriver den nuværende grænse: modellen findes i Hours, men et kontrakt-CRUD- eller eksport-API er ikke en del af partner-gatewayen. Partneren må ikke bruge interne dokument- eller databaseruter som alternativ.
Når en app har behov for en bestemt kontraktfunktion, skal behovet beskrives i App Console med formål, datakilde, felter og sideeffekt. Det gør det muligt at afgøre, om funktionen kan tilbydes uden bredere dataadgang end nødvendigt.
En brugbar accepttest
Test versionsskift, ukendt opsigelsesdato, ændrede prisvilkår, dubletdokumenter og en forældet analyse. Kontrollér også, at et godkendt forslag ikke bliver sendt automatisk gennem en anden kanal, og at en ændret kontraktversion kan invalidere et tidligere beslutningsgrundlag.
Den faglige dokumentation skal forklare disse hændelser med konkrete tilstande. Et enkelt "aktiv"-felt er ikke en komplet model for en aftales økonomiske og juridiske livscyklus.