Autorizovaná konverze do elektronické podoby – finalizace

Metoda webové služby FinalizeConvertToDigital pro Autorizovanou konverzi dokumentu z listinné podoby do elektronické – finalizace konverze. Tento požadavek je nutné volat po inicializování konverze volané metodou ConvertToDigital.

Pro úspěšné dokončení autorizované konverze z listinné podoby do elektronické je nutným předpokladem předávání HTTP headeru Cookie s ASP.NET_SessionId mezi inicializací a finalizací.

Mezi inicializací (ConvertToDigital) a finalizací (FinalizeConvertToDigital) konverze je zapotřebí elektronicky podepsat dokument, který byl vrácen ve výstupu služby (ConvertToDigitalResponse), certifikátem uživatele, který autorizovanou konverzi provedl. Pro elektronický podpis lze využít např. Signer WebAPI.

Tato metoda se nevolá v případě, že je používána Automatizovaná konverze do elektronické podoby přes nové rozhraní KzMÚ API.

Popis služby 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=FinalizeConvertToDigital.

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/FinalizeConvertToDigital"

<?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>
    <FinalizeConvertToDigital xmlns="http://software602.com/longtermdocs/">
      <Options>
        <Guid>string</Guid>
        <InputNote>string</InputNote>
        <CreationDate>string</CreationDate>
      </Options>
      <TSHash>string</TSHash>
    </FinalizeConvertToDigital>
  </soap:Body>
</soap:Envelope>

<Guid>

Vstup Popis

String

Unikátní identifikátor vrácený v odpovědi inicializace konverze.

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

</Options>

<TsHash>

Vstup Popis

string

Sha256 hash podepsaného dokumentu, pro který se má provést finalizace konverze, tedy z výstupu konverzní metody ConvertToDigital.

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>
    <FinalizeConvertToDigitalResponse xmlns="http://software602.com/longtermdocs/">
      <FinalizeConvertToDigitalResult>int</FinalizeConvertToDigitalResult>
      <TsOut>string</TsOut>
      <ErrorMessage>string</ErrorMessage>
    </FinalizeConvertToDigitalResponse>
  </soap:Body>
</soap:Envelope>

<FinalizeConvertToDigitalResult>

Návratová hodnota Popis

Int

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

<TsOut>

Návratová hodnota Popis

String

Obsahuje data časového razítka k hash podepsaného dokumentu specifikovaném v TsHash.

<ErrorMessage>

Návratová hodnota Popis

String

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