Getting Started
Test Environment
In order to quickly get started there is a test environment for the purpose of verifying the technical aspect of the service. Information on how to access the environment is found within the reference guide for the particular service. Furthermore, there is a list of general test objects within a separate document. In addition to this there are specific test objects that can be ordered with the purpose of executing specific tests. For more details and ordering of a test account contact UC at integration@uc.se.
What follows below is a short list consisting of test objects.
| Personnummer | Namn |
|---|---|
| 490701-1813 | Zerykier, “Kjell” Börje Håkan |
| 400612-8989 | Larsson, Birgitta, “Margareta” |
| 651223-3666 | Bergman,”Marika” |
| 330319-0718 | Bäckstedt, Hans “Olof”’ |
| 520719-9398 | Dahllöf, Paul “Lennart” Werner |
Authentication
In order to access and use the service, a customer number and password is required. The credentials are provided in connection to signing the agreement with UC.
Access to the service is done by stating the provided credentials within every request.
Example of accessing the service
In the following example, accessing is done by using ”MY_USERID” and ”MY_PASSWORD”.
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Header /> <soapenv:Body xmlns:ucor="http://www.uc.se/schemas/ucOrderRequest/"> <ucor:identityCheck ucor:version="2.2" ucor:identifier="330319-0718"> <ucor:customer> <ucor:userId>MY_USERID</ucor:userId> <ucor:password>MY_PASSWORD</ucor:password> </ucor:customer> </ucor:identityCheck> </soapenv:Body> </soapenv:Envelope> |
Process Flow
A regular process flow begins with an identity check, confirming that the person is the one whom you want to make a credit assessment on.
After that, you retrieve a credit report by requesting the ‘individualReport’ service.
The report can be received in various formats, namely PDF, HTML and XML. For the XML report there is a document describing the different W-posts that can occur.
Example
Example request identity check for 330319-0718
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Header /> <soapenv:Body xmlns:ucor="http://www.uc.se/schemas/ucOrderRequest/"> <ucor:identityCheck ucor:version="2.2" ucor:identifier="330319-0718"> <ucor:customer> <ucor:userId>MY_USERID</ucor:userId> <ucor:password>MY_PASSWORD</ucor:password> </ucor:customer> </ucor:identityCheck> </soapenv:Body> </soapenv:Envelope> |
Response
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <uc:ucReply xmlns:uc="http://www.uc.se/schemas/ucOrderReply/"> <uc:status uc:result="ok" /> <uc:ucReport> <uc:xmlReply> <uc:reports uc:lang="swe"> <uc:report uc:index="0" uc:styp="KTRL" uc:name="'Hans' Olof Backstedt" uc:id="3303190718"> <uc:group uc:name="ID-uppgifter, fysiker" uc:key="" uc:index="0" uc:id="W080"> <uc:term uc:id="W08001">9330319071</uc:term> <uc:term uc:id="W08002">3303190718</uc:term> <uc:term uc:id="W08003">'Hans' Olof Backstedt</uc:term> <uc:term uc:id="W08004">Skogsvagen 29 Lgh 1105</uc:term> <uc:term uc:id="W08005">87114</uc:term> <uc:term uc:id="W08006">Harnosand</uc:term> <!-- ... --> </uc:group> </uc:report> </uc:reports> </uc:xmlReply> </uc:ucReport> </uc:ucReply> </soap:Body> </soap:Envelope> |
Example request individual report for 330319-0718
Request
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"> <soapenv:Header /> <soapenv:Body xmlns:ucor="http://www.uc.se/schemas/ucOrderRequest/"> <ucor:individualReport ucor:product="3" ucor:version="2.2"> <ucor:customer> <ucor:userId>YOUR_USERID</ucor:userId> <ucor:password>YOUR_PASSWORD</ucor:password> </ucor:customer> <ucor:individualReportQuery ucor:xmlReply="1" ucor:htmlReply="0" ucor:reviewReply="0" ucor:pdfReply="0" ucor:extendedDetails="1" ucor:lang="SE"> <ucor:object>330319-0718</ucor:object> <ucor:override /> </ucor:individualReportQuery> </ucor:individualReport> </soapenv:Body> </soapenv:Envelope> |
Response
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <uc:ucReply xmlns:uc="http://www.uc.se/schemas/ucOrderReply/"> <uc:status uc:result="ok" /> <uc:ucReport> <uc:xmlReply> <uc:reports uc:lang="swe"> <uc:report uc:index="0" uc:styp="3" uc:name="'Hans' Olof Backstedt" uc:id="3303190718"> <uc:group uc:name="ID-uppgifter, fysiker" uc:key="" uc:index="0" uc:id="W080"> <uc:term uc:id="W08001">9330319071</uc:term> <uc:term uc:id="W08002">3303190718</uc:term> <uc:term uc:id="W08003">'Hans' Olof Backstedt</uc:term> <uc:term uc:id="W08004">Skogsvagen 29 Lgh 1105</uc:term> <uc:term uc:id="W08005">87114</uc:term> <uc:term uc:id="W08006">Harnosand</uc:term> <!-- ... --> </uc:group> <uc:group uc:name="Handelser kreditengagemang" uc:key="193303190718" uc:index="0" uc:id="W46A"> <uc:term uc:id="W46A01">20180401</uc:term> <uc:term uc:id="W46A02">0</uc:term> </uc:group> <uc:group uc:name="Summering handelser kreditengagemang" uc:key="193303190718" uc:index="0" uc:id="W46B"> <uc:term uc:id="W46B01">20180401</uc:term> <uc:term uc:id="W46B02">0</uc:term> </uc:group> <uc:group uc:name="Inkomstuppgifter" uc:key="2016" uc:index="0" uc:id="W491"> <uc:term uc:id="W49101">2016</uc:term> <uc:term uc:id="W49117">219</uc:term> </uc:group> <!-- ... --> </uc:report> </uc:reports> </uc:xmlReply> </uc:ucReport> </uc:ucReply> </soap:Body> </soap:Envelope> |