Getting Started

Testmiljö

För att snabbt komma igång finns det en testmiljö där man kan göra anrop för att verifiera en teknisk lösning. Information om vart du hittar den finner du i referensguiden som finns till tjänsten. Det går även att beställa speciella testobjekt för att utföra specifika tester (för mer detaljer kontakta UC) och det finns även en lista över testobjekt i ett separat dokument.

Nedan följer en kort lista med testobjekt.

 Organisationsnummer Namn
 916679-7325  PEARLOV TJÄNST KB
 969790-0000  JURISTFIRMAN MARGIT BOREN KB
 916187-4301  NYA SUNDSVALLS HOTELL HB
 916036-0104  BILLS SNICKERIFABRIK KB
 916863-3064   LÄRDBERGA KB

Inloggning

I samband med att du tecknar ditt avtal med UC får du ett kundnummer och lösenord som du kan använda för att logga in till tjänsten.

Inloggning sker genom att man i frågan specificerar sitt användarnamn och lösenord.

Exempel på inloggning

I följande exempel gör vi en inloggning med MY_USERID samt 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>

Flöde

För företagsupplysning kan man göra sökningar, kontroller och ta kreditupplysningar med hjälp av APIet.

En kreditrapport beställs med hjälp av companyReport operationen och kan fås i  olika format: pdf, html samt XML. För XML rapporten finns en beskrivning av de fältposter som kan förkomma i referens dokumentet.

En företagsupplysning (businessReport) innehåller till skillnad från en företagsrapport information om delägare.

 Operation Beskrivning
 IdentitySeekJur  Id-nummersökning juridiska personer.
 identityCheck  Kontroll av namn och adress.
 companyReport   Företagsupplysning för svenska, med eller utan kreditregelverk.
 businessReport  Företagaresupplysning, med eller utan kreditregelverk

Tilläggstjänst kreditmall

Kreditmallen hjälper dig att på ett effektivt, objektivt och snabbt sätt avgöra om och hur du ska göra affärer med kunder och leverantörer. 

Tilläggstjänst Detekt

Tilläggstjänsten detekt hjälper dig undvika kreditförluster orsakade av bedrägligt beteende. Verktyget informerar om det omfrågade företaget bör undersökas närmare och varför.

Exempel

Exempel anrop för företagsfråga

Här följer ett exempel på en företagsfråga för: 556168-2518

Fråga

<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>

Svar

<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>

Exempel anrop kreditupplysning

Här följer ett exempel på en kreditupplysning för: 556168-2518

Fråga

<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>

Svar

<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>