GetCreditCheckIc - CZ

Tato webová metoda Webové služby CreditCheckAktualizace je poskytována zdarma.

Tato webová metoda vrací seznam hodnocení vybraného subjektu. Jsou vybrány pouze záznamy, které splňují podmínku hodnocení CreditChecku vyšší než 1. Webová metoda vrací datový string, který je však reprezentací jednoduchého Xml formátu. Webová metoda vyžaduje použít SOAP header, který obsahuje parametry přihlášení k webové metodě

SOAP header

<soap:Header>
   <CreditCheckHeader xmlns="http://creditcheck.cz/">
      <Login>string</Login>
      <Password>string</Password>
   </CreditCheckHeader>
</soap:Header>

Popis elementů

Název	Popis
Login	uživatelské jméno
Password	uživatelské heslo

Tyto údaje jsou stejné pro všechny uživatele jednoho partnerského systému a standardně budou neměnné. Proto doporučujeme je nastavit pro všechny napevno.

Vstupní parametry

Název parametru	Datový typ	Poznámka
ic	string	Ic subjektu, jehož stavy požadujeme.

Omezení

Tato metoda povoluje jednomu unikátnímu uživateli maximálně 200 dotazů za 24 hodin.

Výstupní data

<creditCheck>
  <webMethod>GetCreditCheckIc</webMethod>
  <time>28.7.2010 6:12:38</time>
  <count>1</count>
  <data>
    <![CDATA[23585;25865366;3]]>
  </data>
</creditCheck>

Popis elementů

Název	Popis
webMethod	název webové metody, která vrátila data
version	verze webové služby
time	serverový čas vygenerování souboru
count	počet záznamů subjektů, které obsahuje sekce data
data	data subjektů zabalená do CDATA

Popis formátu dat v elementu

Element obsahuje blok dat oddělených oddělovači, která jsou obalena do CDATA. Jeden záznam reprezentuje jeden řádek. Záznamy jsou odděleny znakem newLine – nová řádka. Jeden záznam obsahuje data, která jsou oddělená středníkem.

první pozice: id záznamu z databáze
druhá pozice: identifikátor subjektu, zde ičo subjektu
třetí pozice: hodnocení – CreditCheck

Příklad: 23585;25865366;3 kde 23585 = id záznamu, 25865366 = ičo subjektu, 3 = hodnocení - CreditCheck

Poznámky:

Formát a oddělovače dat můžou být na základě klientského požadavku změněné. Záznamy jsou unikátní podle identifikátoru subjektu a jeden subjekt nemůže mít více záznamů s různým hodnocením.

Tato metoda vrací kromě statusů 2,3 i status 4. Tomuto statusu odpovídá v grafické sekci dokumentace semafor „Žádné nebo chybné IČ“. Tato odpověď bude vrácena v případě chybně zadaného IČ, nebo IČ, které nemá Creditcheck v DB (tento případ by ale teoreticky neměl nastat).

Ukázkový požadavek a odpověď

Odkaz na ukázkové příklady generované naší webovou službou

Pokud zajistíte, aby z Vašeho klienta odcházel request podle uvedených příkladů, nebudete mít problém s dotazováním se na první pokus.

Níže je zkopírovaný POST z výše uvedeného odkazu.

Kompletní POST request

Tento request by měl být na výstupu klientské aplikace.

Kompletní POST request

POST /CreditCheckAktualizace.asmx HTTP/1.1
Host: creditwebservices.creditcheck.cz
Content-Type: text/xml;charset=UTF-8
Content-Length: length
SOAPAction: "https://creditwebservices.creditcheck.cz/GetCreditCheckIc"


<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
        <CreditCheckHeader xmlns="https://creditwebservices.creditcheck.cz/">
            <Login>{login}</Login>
            <Password>{password}</Password>
        </CreditCheckHeader>
    </soap:Header>
    <soap:Body>
      <GetCreditCheckIc xmlns="https://creditwebservices.creditcheck.cz/">
         <ic>{string}</ic>
    </GetCreditCheckIc>
    </soap:Body>
</soap:Envelope>

Vybrané ukázkové příklady připojení k naší webové službě:

Vybrané ukázkové příklady slouží pouze k otestování komunikace s naší webovou službou.

c#

Nechte si automaticky vygenerovat contract přidáním naší webové služby do ServiceReference.

Pokud potřebujete použít jiný způsob připojení než pomocí vygenerovaných tříd přidáním ServiceReference, zde je zjednodušený ideový příklad jiného dotazování:

Příklad

var requestData = @"<s:Envelope xmlns:s=""http://schemas.xmlsoap.org/soap/envelope/"">
  <s:Header>
    <h:CreditCheckHeader xmlns:h=""https://creditwebservices.creditcheck.cz/"" xmlns=""https://creditwebservices.creditcheck.cz/"" xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance"" xmlns:xsd=""http://www.w3.org/2001/XMLSchema"">
      <Login>sem zadejte login</Login>
      <Password>sem zadejte heslo</Password>
    </h:CreditCheckHeader>
  </s:Header>
  <s:Body xmlns:xsi=""http://www.w3.org/2001/XMLSchema-instance"" xmlns:xsd=""http://www.w3.org/2001/XMLSchema"">
    <GetCreditCheckIc xmlns=""https://creditwebservices.creditcheck.cz/"">
      <ic>sem zadejte ico</ic>
    </GetCreditCheckIc>
  </s:Body>
</s:Envelope>";
 
 HttpWebRequest req = (HttpWebRequest)WebRequest.Create("https://creditwebservices.creditcheck.cz/CreditCheckAktualizace.asmx");
req.Headers.Add("SOAPAction", "https://creditwebservices.creditcheck.cz/GetCreditCheckIc");
req.ContentType = "text/xml;charset=\"utf-8\"";
req.Accept = "text/xml";
req.Method = "POST";

using (Stream stm = req.GetRequestStream())
{
	using (StreamWriter stmw = new StreamWriter(stm))
        {
         	stmw.Write(requestData);
         }
}
string responseData = string.Empty;
using (WebResponse response = req.GetResponse())
{
	using (StreamReader responseReader = new StreamReader(response.GetResponseStream()))
        {
        	responseData = responseReader.ReadToEnd();
         }
}

php

Php

$wsdl = 'https://creditwebservices.creditcheck.cz/CreditCheckAktualizace.asmx?wsdl';
    $cc = new SoapClient($wsdl,  array('location' => "https://creditwebservices.creditcheck.cz/CreditCheckAktualizace.asmx",
                                     'uri'      => "https://creditwebservices.creditcheck.cz/"));
try {
    $ch = array(
        "Login" => "sem zadejte login",
        "Password" => "sem zadejte heslo",
    );

    $cc->__setSoapHeaders(new SoapHeader("https://creditwebservices.creditcheck.cz/", "CreditCheckHeader", $ch));
    $ret = $cc->GetCreditCheckIc(
       array("ic" => "sem zadejte ičo")
    );
  } catch (SoapFault $e) {
 print_r($e);
 $ret = $e->faultstring;
 echo($ret);
  }

echo $ret;