Signing

Specifying the document in DocumentService

695 views June 20, 2017 October 9, 2017 2

General

The DocumentService requires you to specify one or more documents. The Document data type is a general data type with several extentions. To specify a document, you must choose one of the extentions. You can not specify the general Document data type directly. See the DocumentService  API specification for a list of the extentions.

SOAP example

In the SOAP example below, the document is specified as a “sds-document” on line 8. Note the xsi:type=”doc:sds-document” element.

SOAP XML Example
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:doc="https://id.signicat.com/definitions/wsdl/Document-v1">
<soapenv:Header></soapenv:Header>
  <soapenv:Body>
    <doc:create-request-request>
    <doc:service>signicat</doc:service>
    <doc:password>Bond007</doc:password>
    <doc:request>
       <doc:document xsi:type="doc:sds-document" ref-sds-id="100620132nja2kyj5 ... ppe3lsr5mufwnt2rnept" id="SIGNICAT_000602" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
           <doc:external-reference>SIGNICAT_000602</doc:external-reference>
           <doc:description>Lending agreement</doc:description>
       </doc:document>
       <doc:task id="task01017">
           <doc:document-action send-result-to-archive="false" optional="false" type="SIGN">
               <doc:document-ref>SIGNICAT_000602</doc:document-ref>
           </doc:document-action>
           <doc:authentication artifact="true"></doc:authentication>
           <doc:signature>
               <doc:method>nemid-sign</doc:method>
           </doc:signature>
           <doc:notification type="EMAIL" notification-id="taskNotification">
              <doc:recipient>customer@signicat.com</doc:recipient>
              <doc:sender>noreply@signicat.com</doc:sender>
              <doc:header>Signature request</doc:header>
              <doc:message>Sign here please: $${taskUrl}</doc:message>
           </doc:notification>
       </doc:task>
        </doc:request>
     </doc:create-request-request>
  </soapenv:Body>
</soapenv:Envelope>

Was this helpful?