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>