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 various test objects.
| Corporate Identity Number | Name |
|---|---|
| 559853-6018 | SWEDISH BESTOVA AB |
| 559794-1797 | TUREC AB |
| 916187-4301 | NYA SUNDSVALLS HOTELL HB |
| 916036-0104 | BILLS SNICKERIFABRIK KB |
| 970816-2228 | NÅBERGA LUFTTRANSPORT |
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 on accessing the service
In the following example, accessing the service 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.0" ucor:identifier="556168-2518"> <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 company is active and is the actual company you want to make a credit assessment on.
A credit report is retrieved by requesting a ’CompanyReport’ and the response 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 may occur.
A ‘BusinessReport’ includes, contrary to the ‘CompanyReport’, information on sole traders.
| Operation | Description |
|---|---|
| IdentitySeekJur | Social security number search, legal persons. |
| identityCheck | Verification of name and address. |
| companyReport | CompanyReport for swedish companies, with or without credit regulations. |
| businessReport | BusinessReport for swedish sole traders with or without credit regulations. |
Examples
Example request on an identityCheck with 556168-2518
Request
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header /> <soap:Body xmlns:uc="http://www.uc.se/schemas/ucOrderRequest/"> <uc:identityCheck uc:identifier="556168-2518" uc:version="2.0"> <uc:customer> <uc:userId>MY_USERID</uc:userId> <uc:password>MY_PASSWORD</uc:password> </uc:customer> </uc:identityCheck> </soap:Body> </soap: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="Gorberga Bokhandel AB" uc:id="5561682518"> <uc:group uc:name="ID-uppgifter, juridiker" uc:key="" uc:index="0" uc:id="W010"> <uc:term uc:id="W01001">6556168251</uc:term> <uc:term uc:id="W01002">5561682518</uc:term> <uc:term uc:id="W01003">14650</uc:term> <uc:term uc:id="W01006">Stockholms</uc:term> <uc:term uc:id="W01007">Botkyrka</uc:term> <uc:term uc:id="W01008">Aktiebolag, privat</uc:term> <uc:term uc:id="W01016">08-656 62 44</uc:term> <uc:term uc:id="W01017">Gorberga Bokhandel AB</uc:term> <!-- ... --> </uc:group> </uc:report> </uc:reports> </uc:xmlReply> </uc:ucReport> </uc:ucReply> </soap:Body> </soap:Envelope> |
Example request credit report with 556168-2518 using businessReport
Request
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Header /> <soap:Body xmlns:uc="http://www.uc.se/schemas/ucOrderRequest/"> <uc:businessReport uc:product="410" uc:version="2.0"> <uc:customer> <uc:userId>MY_USERID</uc:userId> <uc:password>MY_PASSWORD</uc:password> </uc:customer> <uc:businessReportQuery uc:xmlReply="1" uc:htmlReply="1" uc:reviewReply="0" uc:pdfReply="1" uc:extendedDetails="1" uc:lang="swe"> <uc:object>556168-2518</uc:object> </uc:businessReportQuery> </uc:businessReport> </soap:Body> </soap: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="410" uc:name="Gorberga Bokhandel AB" uc:id="5561682518"> <uc:group uc:name="Allmanna foretagsuppgifter" uc:key="" uc:index="0" uc:id="W030"> <uc:term uc:id="W03002">200410</uc:term> <uc:term uc:id="W03004">0</uc:term> <uc:term uc:id="W03005">19600823</uc:term> <!-- ... --> </uc:group> <!-- ... --> </uc:report> </uc:reports> </uc:xmlReply> <uc:pdfReply>JVB...PRgo=</uc:pdfReply> </uc:ucReport> </uc:ucReply> </soap:Body> </soap:Envelope> |