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 in 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, please contact UC at integration@uc.se.
Authentication
In order to access and use the service, a customer number and password is required. The credentials are provided in connection to signing an 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 the service is done by using ”YOUR-USERID” and ”YOUR-PASSWORD”.
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body xmlns:uc="http://www.uc.se/schemas/ucCreditReportRequest/2008-12-10">
<uc:companyReportRequest uc:htmlReply="false" uc:language="eng" uc:xmlReply="true">
<uc:customer>
<uc:userId>YOUR-USERID</uc:userId>
<uc:password>YOUR-PASSWORD</uc:password>
</uc:customer>
<uc:countryCode>
<uc:value>FI</uc:value>
</uc:countryCode>
<uc:productCompanyCode>
<uc:value>STANDARD</uc:value>
</uc:productCompanyCode>
<uc:objectId>01120389</uc:objectId>
</uc:companyReportRequest>
</soap:Body>
</soap:Envelope>
Usage
Example request on a ‘companySearch’ by name in Finland
Request
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header />
<soap:Body xmlns:uc="http://www.uc.se/schemas/ucCreditReportRequest/2008-12-10">
<uc:companySearchRequest uc:language="eng">
<uc:customer>
<uc:userId>YOUR-USERID</uc:userId>
<uc:password>YOUR-PASSWORD</uc:password>
</uc:customer>
<uc:countryCode>
<uc:value>FI</uc:value>
</uc:countryCode>
<uc:companyRequestItem>
<uc:name>nokia</uc:name>
</uc:companyRequestItem>
</uc:companySearchRequest>
</soap:Body>
</soap:Envelope>
Response
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header />
<soap:Body>
<uc:ucReply xmlns:uc="http://www.uc.se/schemas/ucCreditReportRequest/2008-12-10">
<uc:status uc:result="ok" />
<uc:ucReport>
<uc:xmlReply>
<uc:reports uc:lang="swe">
<uc:report uc:styp="INSV" uc:name=""
uc:index="0" uc:id="0000NOKIA">
<uc:group uc:name="" uc:key="01120389"
uc:index="1" uc:id="W250">
<uc:term uc:name="" uc:id="W25001">01120389</uc:term>
<uc:term uc:name="" uc:id="W25002">Nokia Oyj</uc:term>
<uc:term uc:name="" uc:id="W25003">Keilalahdentie 4</uc:term>
<uc:term uc:name="" uc:id="W25004">02150</uc:term>
<uc:term uc:name="" uc:id="W25005">Espoo</uc:term>
<uc:term uc:name="" uc:id="W25006">FI</uc:term>
<uc:term uc:name="" uc:id="W25007">+358-40-8254906</uc:term>
<uc:term uc:name="" uc:id="W25011">017</uc:term>
</uc:group>
</uc:report>
</uc:reports>
</uc:xmlReply>
</uc:ucReport>
</uc:ucReply>
</soap:Body>
</soap:Envelope>
Process Flow A regular authentication 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.
The following example showcases performing an identity check on a company.
Request
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header />
<soap:Body>
<uc:identityCheckCompanyRequest uc:language="?" xmlns:uc="http://www.uc.se/schemas/ucCreditReportRequest/2008-12-10">
<uc:customer>
<uc:userId>YOUR-USERID</uc:userId>
<uc:password>YOUR-PASSWORD</uc:password>
</uc:customer>
<uc:countryCode>
<uc:value>FI</uc:value>
</uc:countryCode>
<uc:organizationNumber>01120389</uc:organizationNumber>
</uc:identityCheckCompanyRequest>
</soap:Body>
</soap:Envelope>
Response
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header />
<soap:Body>
<uc:ucReply xmlns:uc="http://www.uc.se/schemas/ucCreditReportRequest/2008-12-10">
<uc:status uc:result="ok" />
<uc:ucReport>
<uc:xmlReply>
<uc:reports uc:lang="swe">
<uc:report uc:styp="INSV" uc:name="" uc:index="0" uc:id="0000">
<uc:group uc:name="" uc:key="01120389"
uc:index="1" uc:id="W250">
<uc:term uc:name="" uc:id="W25001">01120389</uc:term>
<uc:term uc:name="" uc:id="W25002">Nokia Oyj</uc:term>
<uc:term uc:name="" uc:id="W25003">Keilalahdentie 4</uc:term>
<uc:term uc:name="" uc:id="W25004">02150</uc:term>
<uc:term uc:name="" uc:id="W25005">Espoo</uc:term>
<uc:term uc:name="" uc:id="W25006">FI</uc:term>
<uc:term uc:name="" uc:id="W25007">+358-40-8254906</uc:term>
<uc:term uc:name="" uc:id="W25011">017</uc:term>
</uc:group>
</uc:report>
</uc:reports>
</uc:xmlReply>
</uc:ucReport>
</uc:ucReply>
</soap:Body>
</soap:Envelope>
Example request on a ‘companyReport’
Request
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header />
<soap:Body>
<uc:companyReportRequest xmlns:uc="http://www.uc.se/schemas/ucCreditReportRequest/2008-12-10"
uc:xmlReply="true" uc:htmlReply="false" uc:language="eng">
<uc:customer>
<uc:userId>YOUR-USERID</uc:userId>
<uc:password>YOUR-PASSWORD</uc:password>
</uc:customer>
<uc:countryCode>
<uc:value>FI</uc:value>
</uc:countryCode>
<uc:productCompanyCode>
<uc:value>STANDARD</uc:value>
</uc:productCompanyCode>
<uc:template>
<uc:templateId>
</uc:templateId>
</uc:template>
<uc:objectId>01120389</uc:objectId>
</uc:companyReportRequest>
</soap:Body>
</soap:Envelope>
Response
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header />
<soap:Body>
<uc:ucReply xmlns:uc="http://www.uc.se/schemas/ucCreditReportRequest/2008-12-10">
<uc:status uc:result="ok" />
<uc:ucReport>
<uc:xmlReply>
<uc:reports uc:lang="eng">
<uc:report uc:styp="140E" uc:name="Nokia Oyj" uc:index="0" uc:id="01120389">
<uc:group uc:name="ID particulars" uc:key="" uc:index="0" uc:id="W010">
<uc:term uc:name="" uc:id="W01001">01120389</uc:term>
<uc:term uc:name="" uc:id="W01003">00045</uc:term>
<uc:term uc:name="" uc:id="W01007">HELSINKI</uc:term>
<uc:term uc:name="" uc:id="W01008">Limited company quoted</uc:term>
<uc:term uc:name="" uc:id="W01009">3220</uc:term>
<uc:term uc:name="" uc:id="W01011">Manufact of tv <!-- ... --></uc:term>
<!-- ... -->
</uc:group>
</uc:report>
</uc:reports>
</uc:xmlReply>
</uc:ucReport>
</uc:ucReply>
</soap:Body>
</soap:Envelope>