...
Systemleverandør vil motta fra oss en masterbruker, som har tilgang til en spesifikk metode som tillater partneren å generere en tilgang på et sett med metoder for eksport, for en spesifikk organisasjon. Med masterbrukeren kan man som systemleverandør opprette tilgang til sin kunde selv, uten å kontakte NIF support. Organisasjonsbrukeren vil dermed få tilgang til de predefinerte metodene som trengs for å utføre det integrasjonsavtalen regulerer.
Oppbygningen av brukernavnet for å spørre i metodene:
Brukernavn og passord legges inn i soap header objektet i din request. Brukernavnet er bygget opp som du ser i eksempelet.
| Code Block | ||
|---|---|---|
| ||
<aut:Username>AppID/FunctionID/UserName</aut:Username>
<aut:Password>PassordSomErOpprettet</aut:Password> |
AppID: Denne får du av NIF Digital
FunctionID: Dette får du når du oppretter OrgBrukeren
UserName: Dette oppretter du selv når du kjører CreateIntegratorUser
Hele brukernavnet består derfor av tre komponenter, og skilles med /
Arkitektur og dataflyt
...
Tegningen viser et eksempel på dataflyt og systemsamspill, som kan være et ideelt integrasjonsoppsett for en systemleverandør av f.eks regnskapssystemer.
...
Tegningen er å anse som et high level arkitekturforslag.
Kodeeksempler
GetChangesPayment (på orgid)
| Code Block | ||
|---|---|---|
| ||
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:syn="http://www.idrett.no/Services/SynchronizationService/">
<soap:Header xmlns:aut="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<aut:Security mustUnderstand="true">
<aut:UsernameToken>
<aut:Username>AppID/FunctionID/UserName</aut:Username>
<aut:Password>PassordSomErOpprettet</aut:Password>
</aut:UsernameToken>
</aut:Security></soap:Header>
<soap:Body>
<syn:SynchronizationSimpleRequest>
<syn:FromDate>2021-04-05T00:00:00</syn:FromDate>
<syn:ToDate>2021-04-30T00:00:00</syn:ToDate>
</syn:SynchronizationSimpleRequest>
</soap:Body>
</soap:Envelope> |
Eksempelet viser hvordan man henter ut alle fakturaobjekter innenfor en gitt tidsperiode
GetPaymentDetailsByIds (på orgid, og ider fra resultatet fra spørringen over )
| Code Block | ||
|---|---|---|
| ||
<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:pay="http://www.idrett.no/Services/PaymentService/" xmlns:arr="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
<soap:Header xmlns:aut="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
<aut:Security mustUnderstand="true">
<aut:UsernameToken>
<aut:Username>AppID/FunctionID/UserName</aut:Username>
<aut:Password>PassordSomErOpprettet</aut:Password>
</aut:UsernameToken>
</aut:Security></soap:Header>
<soap:Body>
<pay:PaymentIdsRequest>
<pay:PaymentsIds>
<arr:int>100428401</arr:int>
<arr:int>100429340</arr:int>
<arr:int>100429497</arr:int>
</pay:PaymentsIds>
</pay:PaymentIdsRequest>
</soap:Body>
</soap:Envelope> |
Eksempelet viser hvordan man henter ut tre stk fakturaobjekter fra Klubbadmin basert på ID.
Endepunkter
Oversikt over metoder som trends for å eksportere betalingsobjekter fra klubbadmin via SOAP
...