Gå til hovedinnhold

Introduksjon

En utbetalingsanmodning beskriver hva som skal utbetales til hvem, når dette skal skje, for hvilket formål og med hvilke betingelser.

Utbetalingsanmodningen lages av kommunen i Husbankens saksbehandlingssystem. Den ferdige utbetalingsanmodningen blir sendt til kommunens låneforvalter, enten manuelt, eller automatisk. Hvis kommunen forvalter lånene selv, vil mottaker være til kommunens låneforvaltningssystem.

Teknisk Info​

Endepunktsadresser​

Autentisering av klient​

Forespørsler til vårt API må autentiseres med klientsertifikat som inneholder låneforvalters organisasjonsnummer. Det kan f.eks være i p12 format.

curl --cert-type P12 --cert testcert.p12:'<passord>' "https://api.demo.husbanken.no/startlan/utbetalingsanmodninger/v2"

Klientens IP adresse må i tillegg være lagt inn i vår whitelist.

API versjoner​

  • v1: /startlan/utbetalingsanmodninger/v1/utbetalingsanmodninger
  • v2: /startlan/utbetalingsanmodninger/v2

v2 skiller seg fra v1 på flere områder, og detaljer fremgår av vår swagger, men følgende endringer bør nevnes spesielt

  1. flere betalingsmottakere
  2. hver betalingsmottaker kan motta midler fra ett eller flere av virkemidlene fra vedtaket
  3. det er ikke mulig å registrere utbetalinger som i sum overstiger totalbeløpet for hvert virkemiddel
  4. metode for endring av totalbeløp
  5. metode for endring av rentevilkår

Endring av totalbeløp​

Ett vedtak kan omfatte opp til 3 virkemidler - STARTLAN, ETABLERING og TILPASSING, og det blir vedtatt ett beløp for hvert enkelt virkemiddel som inkluderes.

  1. totalbeløp i utbetalingsanmodningen for ett virkemiddel er initielt det fra vedtaket
  2. totalbeløpet for ett virkemiddel kan justeres opp med inntill 10%
  3. totalbeløpet for ett virkemiddel kan justeres ned etter behov (ingen nedre grense)
  4. endring av totalbeløp kan gjøres både av saksbehandler før utbetalingsanmoding sendes
  5. endring av totalbeløp kan gjøres via API'et av låneforvalter etter at utbetalingsanmodningen er sendt
  6. det er ikke være mulig å endre totalbeløp for ett virkemiddel opp med mer enn 10% over det vedtatte beløpet
  7. det er ikke være mulig å utbetale mer en totalbeløpet for virkemiddelet
  8. det er ikke være mulig å endre beløp for et virkemiddel som det ikke er fattet vedtak om

Det kan f.eks være at det er et vedtak om NOK 1.000.000 i startlån og at låneforvalter endrer dette via API'et til NOK 1.100.000. Summen av utbetalinger av startlån midler vil i dette tilfellet ikke kunne gå over NOK 1.100.000