Avtal om systemintegration

Vad dokumentet används till

Ett integrationsavtal beskriver hur information ska överföras mellan system och vem som ansvarar när kedjan inte fungerar. Det är särskilt användbart när flera leverantörer bidrar med olika delar. Avtalet bör hjälpa en projektledare att avgöra om ett fel ligger i källsystemet, överföringen eller mottagningen.

Förbered underlaget

Gå igenom följande med den som ska använda och godkänna dokumentet. Beskriv det som gäller i just ert ärende så att villkoren går att kontrollera även efter överlämningen.

• Identifiera system, gränssnitt och versioner som ska stödjas.
• Definiera datafält, format, överföringsintervall och vilket system som är källa.
• Bestäm felhantering, återförsök och hur dubbla poster förhindras.
• Ange testdata, acceptanskriterier och ansvar för godkännande.
• Beskriv ändringsavisering, förvaltning och hantering av ändrade API-villkor.

Avgränsningar och vanliga misstag

En lyckad anslutning visar inte att informationen har tolkats rätt i mottagarsystemet. Testa även saknade fält, fördröjningar och avbrutna överföringar. Håll isär utvecklingsleveransen från den löpande driften av integrationen och bestäm vem som följer upp fel efter start.

Inför digital signering

Lägg överenskommen fältmappning och testkriterier i den signerade specifikationen. Ange dokumentversioner så att en senare API-förändring inte förväxlas med den ursprungliga beställningen. Ett godkännande av avtalet ska inte samtidigt beskrivas som ett genomfört produktionstest.

Så hjälper Resly

Systemägarna kan granska fältmappning och testkriterier i samma Resly-försändelse före underskrift. Då får gränsen mellan systemens ansvar en gemensam kontrollpunkt. Samla grundavtal och ändrade integrationsspecifikationer via en avtalspost. Använd separata försändelser för tillägg så att varje beslut har sitt eget slutdokument.