Developer Portal

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