Gå til hovedinnhold

API v2

I versjon 2 av API'et for utbetalingsanmodninger har vi lagt til metoder for korrigering av rentevilkår og beløp. Vi har lagt til mulighet for å angi flere betalingsmottakere og for å skille mellom hva det er som utbetales til hvem. Denne versjonen av API'et implementerer i tillegg kontroll av at man ikke får utbetalt mer enn registrert beløp for hvert virkemiddel.

Feilkoder​

Vi bruker følgende feilkoder:

  • 400: input har feil
  • 403: låneforvalter har ikke tilgang til dataene som man adresserer
  • 404: data finnes ikke
  • 406: forsøk ulovlig endring av data
  • 500: intern feil på vår side

Feilmeldinger kommer med status og body der body inneholder beskrivelse.

Mottak​

Låneforvalter skal selv hentee nye utbetalingsanmodninger fra Husbankens systemer. Prosessen som henter utbetalingsanmodninger må kontrollere at formalia er korrekte og at data er komplette, og til slutt verifisere at utbetalingsanmodningen er OK.

Dette gjøres som skissert under:

Godkjenning​

Godjenning av utbetalingsanmodinger kan muligens - helt eller delvis - utføres automatisk. Vi har skissert en prosess som involverer saksbehandler.

Prosessforløpet for godkjenning av utbetalingsanmodning er skissert under:

Utbetaling​

Dersom mottatt utbetalingsanmodning er OK på alle måter vil saksbehandling hos låneforvalter ende opp med en eller flere utbetalinger. Det er viktig at disse registreres i Startlån slik at alle parter har rett og komplett informasjon.

Dersom man ønsker, eller ender opp med å utbetale mer eller mindre for ett eller flere av virkemidlene i vedtaket fra kommunen, så må totalbeløpet for dette virkemidlet korrigeres. Det er ikke mulig å korrigere til mer enn 10% over beløpet som er vedtatt. Det er heller ikke mulig å registrere utbetalinger over det vedtatte, eller korrigerte beløpet for et virkemiddel.

Prosessen for å registrerer utbetalinger vil være som skissert under:

Endre beløp​

Dersom låneforvalter trenger å korrigere beløpet som skal utbetales må dette gjøres ved bruk av ny metode i API v2. Regulering av beløp kan gjøres for alle utbetalingstypene og både oppover og nedover, men er begresnset til 10% oppover i forhold til vedtatt beløp for samme utbetalingstype.

Prosessforløpet for korrigering av beløp er skissert under:

Endre rentevilkår​

Låneforvalter kan endre rentevilkår for en utbetalingsanmodning, men dette må gjøres i hht bestemte regler. Man kan endre til:

  • FAST_3
  • FAST_5
  • FAST_10
  • FAST_20
  • EGENDEFINERT
  • FLYTENDE

Egendefinert rente er i dette tilfellet en egendefinert fastrente. Dersom denne renten benyttes skal det angi en rentebindingsperiode og en rentesats.

Prosessforløp for korrigering av rentevilkår er som følger: