Sök koder och kontaktpersoner

Bakgrund

En fullmakt kan innehålla en eller flera koder och upp till två kontaktuppgifter med förnamn, efternamn och mailadress.

På en fullmakt går det att ange en kod för varje BKP (mottagare av fullmakten, ofta ett försäkringsbolag) som är ansluten till Fullmaktskollen. Vissa BKPer kräver att det ska finnas en kod angiven på fullmakten medan andra saknar det kravet. Fullmaktskollen känner inte till respektive BKPs regelverk för koder eller hur en kod ska skrivas. Fullmaktskollen skickar därför bara vidare den information som fullmaktshavaren anger på fullmakten utan vidare kontroll.

Samma sak gäller för kontaktuppgifter – vissa BKPer kan ha som krav att minst en kontaktuppgift ska framgå på fullmakten medan andra saknar krav på kontaktuppgifter. Det finns inga kontroller i systemet gällande kontaktuppgifter annat än att en ifylld mailadress måste vara formaterad som en mailadress, annars går fullmakten inte att registrera, lagra eller skicka om.

För att få en bättre kontroll på vilka koder och kontaktuppgifter som finns på fullmakterna så finns det ett antal nya metoder som stöd för att söka och hämta fullmakter utifrån på kod och/eller kontaktuppgifter.

Det går att söka och lista följande:

Vilka fullmakter innehåller en viss kod?
Vilka fullmakter innehåller en viss kombination av kontaktuppgifter?
Vilka koder förekommer på de fullmakter som är skickade till en viss BKP?
Vilka unika kombinationer av kontaktuppgifter förekommer på våra fullmakter?

Därigenom går det att ta reda på vilka fullmakter som saknar eller innehåller en felaktig kod, eller vilka fullmakter som saknar eller innehåller felaktiga kontaktuppgifter.

Det är också användbart att använda metoderna vid byte av kontaktpersoner och/eller kod på en eller flera fullmakter. Byte av kod och/eller kontaktperson kan göras när som helst på en fullmakt utan att fullmaktsgivaren behöver godkänna ändringen. Metoderna kan kombineras med metoden Resend för att genomföra och meddela BKPer om bytet av koder/kontaktpersoner.

De nya metoderna är

api/v1/Agent/SearchCode
api/v1/Agent/SearchCode2 (ny sedan version 2025.1)
api/v1/Agent/ListUniqueCodes
api/v1/Agent/ListUniqueContacts
api/v1/Agent/SearchContact

och beskrivs nedan.

1. SearchCode

POST api/v1/Agent/SearchCode

Metoden listar de gällande fullmakter som innehåller en angiven kod för en angiven mottagare.

1.1 Request Information

1.2 URI Parameters

None

1.3 Body Parameters

Name	Description	Type	Notes
Code	Kod	string
PresenteePartyNumber	Identitet för en BKP	string	Valfritt
Skip	Antal fullmakter som ska uteslutas	integer
Take	Antal fullmakter som ska returneras	integer

1.4 Request Formats

text/xml, application/xml

1.5 Sample request

<CodeSearchRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.fullmaktskollen.se/">
  <Code>12345</Code>
  <PresenteePartyNumber>161122334459</PresenteePartyNumber>
  <Skip>0</Skip>
  <Take>10000</Take>
</CodeSearchRequest>

1.6 Response Information

Resource Description

HTTP 200 OK – The request has succeeded.

1.7 Response content

Name	Description	Type
Code	Kod	string
PresenteePartyName	Namnet på BKP	string
PresenteePartyNumber	Identitet för BKP	string
PoaId	Fullmaktens unika identitet	globally unique identifier
GrantorName	Fullmaktsgivarens namn	string
GrantorNumber	Fullmaktsgivarens person/organisationsnummer	string
ResponseCount	Antalet fullmakter i svaret	integer
Throttled	Svaret är begränsat	boolean
TotalCount	Antalet fullmakter mot motsvarar sökkriterierna	integer

1.8 Sample response

<CodeSearchResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.fullmaktskollen.se/">
  <CodeDetail>
    <PoaCodeDetail>
      <Code>12345</Code>
      <PresenteePartyName>BKP1</PresenteePartyName>
      <PresenteePartyNumber>161122334459</PresenteePartyNumber>
      <PoaDetails>
        <PoaId>51ca2e5b-f39a-4a33-92e8-c04a61aebbbf</PoaId>
        <GrantorName>Test Person</GrantorName>
        <GrantorNumber>197907099282</GrantorNumber>
      </PoaDetails>
    </PoaCodeDetail>
  </CodeDetail>
  <ResponseCount>1</ResponseCount>
  <Throttled>false</Throttled>
  <TotalCount>6</TotalCount>
</CodeSearchResponse>

2. SearchCode2

POST api/v1/Agent/SearchCode2

Metoden listar de gällande fullmakter som innehåller en angiven kod för en angiven mottagare..

Metoden är en förbättrad version av SearchCode och introducerades i version 2025.1. Det nya är att metoden listar mer data för varje fullmakt (kontaktuppgifter) vilket innebär att ett SearchCode2-anrop ger en respons som innehåller alla de informationsdelar som Resend-metoden behöver för att ändra koder/kontaktuppgifter på en fullmakt.

2.1 Request Information

2.2 URI Parameters

None

2.3 Body Parameters

Name	Description	Type	Notes
Code	Kod	string
PresenteePartyNumber	Identitet för en BKP	string	Valfritt
Skip	Antal fullmakter som ska uteslutas	integer
Take	Antal fullmakter som ska returneras	integer

2.4 Request Formats

text/xml, application/xml

2.5 Sample request

<CodeSearchRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.fullmaktskollen.se/">
  <Code>12345</Code>
  <PresenteePartyNumber>161122334459</PresenteePartyNumber>
  <Skip>0</Skip>
  <Take>10000</Take>
</CodeSearchRequest>

2.6 Response Information

Resource Description

HTTP 200 OK – The request has succeeded.

2.7 Response content

Name	Description	Type
Code	Kod	string
PresenteePartyName	Namnet på BKP	string
PresenteePartyNumber	Identitet för BKP	string
PoaId	Fullmaktens unika identitet	globally unique identifier
GrantorName	Fullmaktsgivarens namn	string
GrantorNumber	Fullmaktsgivarens person/organisationsnummer	string
FirstName	Förnamn i kontaktuppgiften	string
LastName	Efternamn i kontaktuppgiften	string
Email	Mailadress i kontaktuppgiften	string
ResponseCount	Antalet fullmakter i svaret	integer
Throttled	Svaret är begränsat	boolean
TotalCount	Antalet fullmakter mot motsvarar sökkriterierna	integer

2.8. Sample response

<CodeSearchResponse2 xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.fullmaktskollen.se/">
  <CodeDetail>
    <PoaCodeDetail2>
      <Code>11111</Code>
      <PresenteePartyName>BKP1</PresenteePartyName>
      <PresenteePartyNumber>161122334459</PresenteePartyNumber>
      <PoaDetails2>
        <PoaId>c2279f5b-dfb2-40c4-ad9b-bc7df88392a2</PoaId>
        <Type>InformationPrivate</Type>
        <GrantorName>Jan Långben</GrantorName>
        <GrantorNumber>196211262834</GrantorNumber>
        <Contact1>
          <Email>johan@testkonto.net</Email>
          <FirstName>Johan</FirstName>
          <LastName>Nilsson</LastName>
        </Contact1>
        <Contact2>
          <Email i:nil="true"/>
          <FirstName i:nil="true"/>
          <LastName i:nil="true"/>
        </Contact2>
      </PoaDetails2>
    </PoaCodeDetail2>
</CodeDetail>
  <ResponseCount>88</ResponseCount>
  <Throttled>false</Throttled>
  <TotalCount>88</TotalCount>
</CodeSearchResponse2>

3. ListUniqueCodes

POST api/v1/Agent/ListUniqueCodes

Metoden listar alla koder som förekommer på fullmaktshavarens alla gällande fullmakter för en angiven mottagare.

3.1 Request Information

3.2 URI Parameters

None

3.3 Body Parameters

Name	Description	Type	Notes
PresenteePartyNumber	Identitet för en BKP	string

3.4 Request Formats

text/xml, application/xml

3.5 Sample request

<ListUniqueCodesRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.fullmaktskollen.se/">
  <PresenteePartyNumber>161122334459</PresenteePartyNumber>
</ListUniqueCodesRequest>

3.6 Response Information

Resource Description

HTTP 200 OK – The request has succeeded.

3.7 Response content

Name	Description	Type	Notes
Code	Kod	string
TotalCount	Antal unika koder	integer

3.8 Sample response

<ListUniqueCodesResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.fullmaktskollen.se/">
  <UniqueCodes>
    <UniqueCodeDetails>
      <Code i:nil="true"/>
    </UniqueCodeDetails>
    <UniqueCodeDetails>
      <Code>kod_123</Code>
    </UniqueCodeDetails>
    <UniqueCodeDetails>
      <Code>11239</Code>
    </UniqueCodeDetails>
    <UniqueCodeDetails>
      <Code>123</Code>
    </UniqueCodeDetails>
 </UniqueCodes>
  <TotalCount>30</TotalCount>
</ListUniqueCodesResponse>

4. SearchContact

POST api/v1/Agent/SearchContact

Metoden söker efter fullmakter som innehåller angivna uppgifter.

4.1 Request Information

4.2 URI Parameters

None

4.3 Body Parameters

Name	Description	Type	Notes
Email	Mailadress i kontaktuppgiften	string	Kan utelämnas. Då sker sökning enbart på övriga parametrar. Om värdet saknar innehåll så söker metoden efter kontaktuppgifter som saknar mailadress.
FirstName	Förnamn i kontaktuppgiften	string	Kan utelämnas. Då sker sökning enbart på övriga parametrar. Om värdet saknar innehåll så söker metoden efter kontaktuppgifter som saknar förnamn .
LastName	Efternamn i kontaktuppgiften	string	Kan utelämnas. Då sker sökning enbart på övriga parametrar. Om värdet saknar innehåll så söker metoden efter kontaktuppgifter som saknar efternamn.
Skip	Antalet fullmakter som ska uteslutas	integer
Take	Antalet fullmakter som ska returneras	integer

4.4 Request Formats

text/xml, application/xml

4.5 Sample request

<ContactSearchRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.fullmaktskollen.se/">
  <Email>test@testkonto.net</Email>
  <FirstName>Test</FirstName>
  <LastName>Person</LastName>
  <Skip>0</Skip>
  <Take>1000</Take>
</ContactSearchRequest>

4.6 Response Information

Resource Description

HTTP 200 OK – The request has succeeded.

4.7 Response content

Name	Description	Type
FirstName	Förnamn i kontaktuppgiften	string
LastName	Efternamn i kontaktuppgiften	string
Email	Mailadress i kontaktuppgiften	string
ContactRole	Angiven som Kontakt1 eller Kontakt2	string
PoaId	Fullmaktens unika identitet	globally unique identifier
GrantorName	Fullmaktsgivarens namn	string
GrantorNumber	Fullmaktshavarens person/organisationsnummer	string
ResponseCount	Antal i svaret	integer
Throttled	Svaret är begränsat	boolean
TotalCount	Totalt antal	integer

4.8 Sample response

<ContactSearchResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.fullmaktskollen.se/">
  <Contacts>
    <ContactDetails>
      <FirstName/>
      <LastName/>
      <Email>test@testkonto.net</Email>
      <ContactRole>Contact1</ContactRole>
      <PoaDetails>
        <PoaId>0fc2587d-d23d-40b5-b58b-41dd2f114bd5</PoaId>
        <GrantorName>Jan Långben</GrantorName>
        <GrantorNumber>196211262834</GrantorNumber>
      </PoaDetails>
    </ContactDetails>
 </Contacts>
 <ResponseCount>4</ResponseCount>
 <Throttled>false</Throttled>
 <TotalCount>4</TotalCount>
</ContactSearchResponse>

5. ListUniqueContacts

POST api/v1/Agent/ListUniqueContacts

Metoden söker efter alla unika kombinationer av angivna kontaktuppgifter på gällande fullmakter.

5.1 Request Information

5.2 URI Parameters

None

5.3 Body Parameters

Name	Description	Type	Notes
Skip	Antalet fullmakter som ska uteslutas	integer
Take	Antalet fullmakter som ska returneras	integer

4.4 Request Formats

text/xml, application/xml

5.5 Sample request

<ListUniqueContactsRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.fullmaktskollen.se/">
  <Skip>0</Skip>
  <Take>10000</Take>
</ListUniqueContactsRequest>

5.6 Response Information

Resource Description

HTTP 200 OK – The request has succeeded.

5.7 Response content

Name	Description	Type
FirstName	Förnamn i kontaktuppgiften	string
LastName	Efternamn i kontaktuppgiften	string
Email	Mailadress i kontaktuppgiften	string
ResponseCount	Antal svar	integer
Throttled	Svaret är begränsat	boolean
TotalCount	Totalt antal	integer

5.8 Sample response

<ListUniqueContactsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://api.fullmaktskollen.se/">
  <Contacts>
    <UniqueContactDetailsCombination>
      <FirstName i:nil="true"/>
      <LastName i:nil="true"/>
      <Email i:nil="true"/>
    </UniqueContactDetailsCombination>
    <UniqueContactDetailsCombination>
      <FirstName i:nil="true"/>
      <LastName i:nil="true"/>
      <Email>test@test.se</Email>
    </UniqueContactDetailsCombination>
  </Contacts>
  <ResponseCount>67</ResponseCount>
  <Throttled>true</Throttled>
  <TotalCount>67</TotalCount>
</ListUniqueContactsResponse>