Autorizovaná konverze do listinné podoby

Metoda webové služby ConvertFromDigital pro autorizovanou konverzi elektronického dokumentu do listinné podoby vyžaduje autentizaci uživatele, který je autorizován pro použití systému CzechPOINT, na základě uživatelského jména a autentizačního certifikátu v konfiguraci LTD.

Popis služby ConvertFromDigital včetně WSDL schématu a příklad požadavku a odpovědi pro SOAP 1.1 a SOAP 1.2 je umístěn na http://localhost/ltd/ltd.asmx?op=ConvertFromDigital.

localhost je název používaný pro lokální počítač; namísto něj zvolte jméno/IP adresu LTD serveru (dle nastavení v IIS).

SOAP 1.1

Požadavek

POST /ltd/ltd.asmx HTTP/1.1
Host: localhost
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://software602.com/longtermdocs/ConvertFromDigital"

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ConvertFromDigital xmlns="http://software602.com/longtermdocs/">
      <Options>
        <InputName>string</InputName>
        <InputData>Base64Binary</param>
        <JipUsername>string</param>
        <GetHtmlSummary>boolean</param>
        <GetPdfSummary>boolean</param>
        <InputNote>string</InputNote>
        <CreationDate>string</CreationDate>
      </Options>
    </ConvertFromDigital>
  </soap:Body>
</soap:Envelope>

<InputName>

Vstup Popis

String

Název konvertovaného souboru. Z přípony souboru v názvu je odvozený typ vstupu. Na vstupu jsou povolené pouze PDF soubory.

<InputData>

Vstup Popis

Base64Binary

Base64Binary data konvertovaného PDF dokumentu.

<JipUsername>

Vstup Popis

String

Jméno uživatele, pod kterým se webová služba přihlašuje do rozhraní KZMU pro získání unikátního ID konverze.

<GetHtmlSummary>

Vstup Popis

Boolean

V případě úspěšné konverze bude odpověď obsahovat data doložky ve formátu HTML.

Nastavení tohoto parametru na true je povinné pro úspěšnou finalizaci autorizované konverze.

<GetPdfSummary>

Vstup Popis

Boolean

V případě úspěšné konverze bude odpověď obsahovat Base64Binary data doložky ve formátu PDF.

<InputNote>

Vstup Popis

String

Doplňkové informace potřebné k uložení doložky do KZMU úložiště. Jedná se o „Označení vstupu“ (dle §26 písmene c zákona 300/2008 Sb.), který slouží pouze pro uložení informace do Evidence provedených konverzí, která je součástí systému Czech POINT. Do doložky se nevkládá.

<CreationDate>

Vstup Popis

String

Doplňkový datum potřebný k uložení doložky do KZMU úložiště.

Formát: dd.MM.yyyy

Pro aktuální lze použít [DateTime], případně parametr nenastavit.

Odpověď

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <ConvertFromDigitalResponse xmlns="http://software602.com/longtermdocs/">
      <ConvertFromDigitalResult>int</ConvertFromDigitalResult>
      <Results>
        <Guid>string</Guid>
        <ErrorMessage>string</ErrorMessage>
        <HtmlSummary>string</HtmlSummary>
        <PdfSummary>string</PdfSummary>
        <OutputData>string</OutputData>
      </Results>
    </ConvertFromDigitalResponse>
  </soap:Body>
</soap:Envelope>

<ConvertFromDigitalResult>

Návratová hodnota Popis

Int

Kód chyby. 0 = v pořádku. Jinak viz kapitola Návratové kódy.

<Guid>

Návratová hodnota Popis

String

Unikátní identifikátor konverze.

<ErrorMessage>

Návratová hodnota Popis

String

V případě problému obsahuje detail chyby.

Aktuálně již vrací:

„Guid wasn’t included in response, ErrorMessage: Error 01-001-31 (KzMU API 1 bylo ukončeno k 30.6.2022, prosíme přejděte na automatizované KzMU.“

<HtmlSummary>

Návratová hodnota Popis

String

Obsahuje HTML data doložky, pokud bylo zvoleno v požadavku.

<PdfSummary>

Návratová hodnota Popis

Base64Binary

Obsahuje Base64Binary data PDF doložky, pokud bylo zvoleno v požadavku.

<OutputData>

Návratová hodnota Popis

Base64Binary

Base64Binary data výstupního souboru s připojenou doložku ve formátu PDF/A-2b na konci dokumentu.