Endepunkter og valideringsfeil

1. Hent access token

POST /oauth/token

Brukes for å hente token som kreves for videre bruk av API-et.

2. Hent distributørens innrapporterte fondskostnader

GET /distribution-fees

Returnerer fondskostnader for distributøren som er knyttet til access tokenen.

Kode	Beskrivelse
422	Validation failed: Paginerings parameterne inneholdt ugyldige verdier

3. Legge til fondskostnader for flere fond samtidig

POST /distribution-fees

Endepunktet skal primært brukes for å legge til flere fond samtidig uten å fjerne eksisterende rapporterte fond.

• Hvis man legger til fond som allerede finnes så vil den “faile” - valideringsfeil

Eksempel på payloads

{ 
      "distributionFees": [ 
   { 
      "isin": " NO0011101545", 
      "platformFeeRate": 0.43, 
      "commissionRebateRate": 0.23 
    },  

    {	 
      "isin": " SE0011311190", 
      "platformFeeRate": 0.13, 
      "commissionRebateRate": 0.93 
    } 
  ]} 

Kode	Beskrivelse
422	Ett eller flere av de oppgitte ISIN-numrene har allerede en fondskostnad knyttet til din distributør. Bruk PUT eller PATCH for å oppdatere eksisterende poster, eller slett dem først.
422	Ett eller flere av de oppgitte ISIN-numrene finnes ikke i fondsunivers. Kontroller at ISIN-nummeret er korrekt stavet og at fondet er registrert i systemet.
422	Forespørselen inneholder ugyldige eller manglende feltverdier. Kontroller at alle påkrevde felt er oppgitt og har korrekt format og verdi.

4. Full erstatning av fondskostnader med innsendt payload

PUT /distribution-fees

Brukes for å sende inn og for å erstatte hele eksisterende distribution-fees listen til en distributør

Eksempel på payloads

{ 
      "distributionFees": [ 
   { 
      "isin": " NO0011101545", 
      "platformFeeRate": 0.43, 
      "commissionRebateRate": 0.23 
    },  

    {	 
      "isin": " SE0011311190", 
      "platformFeeRate": 0.13, 
      "commissionRebateRate": 0.93 
    } 
  ] } 

Dette er det anbefalte endepunktet når distributøren skal gjøre en større synkronisering. Denne operasjonen erstattet hele fondslisten til en distributør.

Semantikk

• Hvert element i fondskostnader representerer ett fond

• ISIN brukes til oppslag i Finansportalens fondsunivers

Kode	Beskrivelse
422	Fond listen er tom
422	ISIN i en rad har ugyldig format
422	Plattformgebyrer er utenfor tillatt verdiområde (0–100)
422	Returprovisjon er utenfor tillatt verdiområde (0–100)
422	ISIN finnes ikke i finansportalens fondsunivers

5. Oppdatere eksisterende fondskostnader for et eller flere fond

PATCH /distribution-fees

Dette endepunktet brukes for å oppdatere eksisterende fondskostnader for ett eller flere fond uten å erstatte alt innhold på nytt.

Eksempel på payloads

{ 
      "distributionFees": [ 
   { 
      "isin": " SE0011311190", 
      "commissionRebateRate": 0.25 
    }, 
   { 
      "isin": "NO0011101545", 
      "platformFeeRate": 0.15 
    } 
  ]} 

Semantikk

• Endepunktet er laget for situasjoner der distributøren ønsker å gjøre endringer på spesifikke fond, mens øvrige registrerte data forblir uendret.

• Plattformgebyr = ikke obligatorisk

• Returprovisjon = ikke obligatorisk

Kode	Beskrivelse
422	Fond listen er tom
422	ISIN i en rad har ugyldig format
422	Plattformgebyr er utenfor tillatt verdiområde (0–100)
422	Returprovisjon er utenfor tillatt verdiområde (0–100)
422	ISIN finnes ikke i finansportalens fondsunivers
422	Verken Plattformgebyr eller Returprovisjon er oppgitt for en rad
422	ISIN finnes ikke i finansportalens fondsunivers
422	ISIN er ikke knyttet til distributøren

6. Slette fondskostnader for flere fond samtidig

POST /distribution-fees/bulk-delete

Dette endepunktet brukes for å slette distribution fees for flere fond samtidig, basert på ISIN.

Eksempel på payloads

{ 
   "isins": [  
   " NO0011101545", 
    “SE0011311190”, 
    "NO0014101345" 
   ] 
} 

Kode	Beskrivelse
422	Fond listen er tom
422	ISIN i en rad har ugyldig format
422	ISIN finnes ikke i finansportalens fondsunivers
422	ISIN er ikke knyttet til distributøren

7. Hente fondskostnader for et spesifikt fond

GET /distribution-fees/{isin}

Dette endepunktet skal brukes til å hente ut distribution fees for et spesifikt fond basert ISIN.

Kode	Beskrivelse
422	ISIN i en rad har ugyldig format

8. Legge til fondskostnader for spesifikt fond

POST /distribution-fees/{isin}

Dette endepunktet skal brukes til å legge til fondskostnader for et spesifikt fond basert ISIN.

Eksempel på payloads

{ 
  "platformFeeRate": 3.4, 
  "commissionRebateRate": 0.43 
} 

Kode	Beskrivelse
422	ISIN i en rad har ugyldig format
422	ISIN finnes ikke i finansportalens fondsunivers
422	Plattformgebyr er utenfor tillatt verdiområde (0–100)
422	Returprovisjon er utenfor tillatt verdiområde (0–100)

9. Erstatning av fondskostnader for ett enkelt fond

PUT /distribution-fees/{isin}

Dette endepunktet skal brukes til å erstatte et spesifikt fond basert på ISIN

Eksempel på payloads

{ 
  "platformFeeRate": 0.42, 
  "commissionRebateRate": 0.23 
} 

Kode	Beskrivelse
422	ISIN har ugyldig format
422	Plattformgebyr er utenfor tillatt verdiområde (0–100)
422	Returprovisjon er utenfor tillatt verdiområde (0–100)

10. Oppdatere fondskostnader for ett enkelt fond

PATCH /distribution-fees/{isin}

Dette endepunktet skal brukes til å oppdatere en eller flere spesifikke verdier for ett fond basert på ISIN.

Eksempel på payloads

{ 
  "platformFeeRate": 2.4, 
} 

Kode	Beskrivelse
422	ISIN har ugyldig format
422	Plattformgebyr er utenfor tillatt verdiområde (0–100)
422	Returprovisjon er utenfor tillatt verdiområde (0–100)
422	Verken Plattformgebyr eller Returprovisjon er oppgitt

11. Slette fondskostnader for spesifikt fond

DELETE /distribution-fees/{isin}

Dette endepunktet brukes for å slette distribution fees for et fond, basert på ISIN.

Kode	Beskrivelse
422	ISIN har ugyldig format