El Servidor Centralizado de Firma se encuentra publicado en:

• endpoint: https://efirma.ecosignature.biz/ecosignatureWebService.asmx
• wsdl: https://efirma.ecosignature.biz/ecosignatureWebService.asmx?wsdl

Solicite un token de acceso para poder realizar peticiones con él.

En todas las peticiones hay que informar el token de acceso

<edat:AuthToken>
   <edat:Token>token de acceso</edat:Token>
</edat:AuthToken>

Recuerde solicitar el suyo

Este método permite consultar las tabletas conectadas y su estado antes de enviar un documento.

La estructura de la petición tiene el siguiente formato:

<getUsers xmlns="http://www.edatalia.com/">
  <nivel1>Obligatorio. Se corresponde con el nivel1 informado en los ficheros de configuración de SIGNPly o LaunchPC</nivel1>
  <nivel2>Opcional.</nivel2>
  <nivel3>Opcional</nivel3>
  <product>Admite los valores SIGNply,LaunchPC</product>
</getUsers>

Respuesta:

<getUsersResponse xmlns="http://www.edatalia.com/">
   <getUsersResult>
      <code>0 si no hay error en la petición, código de error en otro caso</code>
      <users>
         <!-- por cada una de las tabletas conectadas -->
         <user>
            <id>Identificador de la tableta</id>
            <alias>Alias informado en el fichero de configuración</alias>
            <nivel1>nivel1</nivel1>
            <nivel2>si está informado el nivel 2 en el fichero de configuración se obtiene el valor informado</nivel2>
            <nivel3>si está informado el nivel 3 en el fichero de configuración se obtiene el valor informado</nivel2>
            <product>LaunchPC o SIGNPly</product>
            <ip>IP de la tablea conectada</ip>
            <username>Nombre de usuario (puesto PC, tableta o smartphone)</username>
            <free>1 si está libre la tableta, otro valor si la tableta está ocupada</free>
         </user>
      </users>
   </getUsersResult>
</getUsersResponse>

Permite enviar un documento a una tableta para ser firmado.

El formato de la llamada es el siguiente:

<signedPDFFromApplication xmlns="http://www.edatalia.com/">
  <receiver>identificador de la tableta. Se obtiene del nodo ID de la llamada getUsers</receiver>
  <idApplication>tipo de tableta: 0 si es SIGNPly, 10 si es Wacom</idApplication>
  <pdfContent>documento PDF a firmar codificado en base64</pdfContent>
  <pdfPassword>Si el documento tiene una contraseña, se debe informar en base64</pdfPassword>
  <iniB64>Opcional. Archivo de configuración .ini en base 64.</iniB64>
  <widgetAncho>Obligatorio.Ancho en pixels del widget de firma.</widgetAncho>
  <widgetAlto>Obligatorio. Alto en pixels del widget de firma.</widgetAlto>

  <!-- Opcional. Incio posicionamiento fijo -->
       <widgetPage>Número de página donde mostrar el grafo de la firma.</widgetPage>
       <widgetX>Posición horizontal </widgetX>
       <widgetY>Posición vertical</widgetY>
  <!-- Opcional. Fin posicionamiento fijo -->

  <!-- Opcional. Incio posicionamiento automático -->
       <widgetAutoPosActivate>1 si se activa el posicionamiento automático</widgetAutoPosActivate>
       <widgetAutoPosText>Texto a buscar para realizar el posicionamiento</widgetAutoPosText>
       <widgetAutoPosDesfaseX>Desplazamiento relativo en horizontal respecto del texto a buscar</widgetAutoPosDesfaseX>
       <widgetAutoPosDesfaseY>Desplazamiento relativo en verticalrespecto del texto a buscar</widgetAutoPosDesfaseY>
  <!-- Opcional. Fin posicionamiento automático -->

  <!-- Opcional. Inicio otras propiedades del widget -->
       <widgetTextCustom>Texto personalizado del widget en base 64.</widgetTextCustom>
       <widgetTransparentActivate>1 Widget transparente o no. Por defecto si.</widgetTransparentActivate>
  <!-- Opcional. Fin Otras propiedades del widget -->

  <!-- Opcional. Inicio añadir firma con certificado -->
       <pfxB64>Certificado de firma en base 64</pfxB64>
       <pfxPw>Contraseña en base64 del certificado</pfxPw>
       <encKeyB64>string</encKeyB64>
  <!-- Fin añadir firma con certificado -->      

  <!-- Opcional. Inicio añadir marca TSP al documento-->
       <tspActivate>1 para activar la marca TSP</tspActivate>
       <tspURL>url del servicio TSP</tspURL>
       <tspUser>Usuario</tspUser>
       <tspPw>Contraseña</tspPw>
  <!-- Opcional. Fin añadir marca TSP al documento-->

  <!-- Opcional. Inicio datos validación OCSP-->
       <ocspActivate>1 si se quiere realizar la validación OCSP de los certificados de firma.</ocspActivate>
       <ocspURL>dirección del servicio OCSP</ocspURL>
       <ocspUser>Usuario</ocspUser>
       <ocspPw>Contraseña</ocspPw>
  <!-- Fin validación OCSP de certificados de firma-->

  <!-- Opcional. Inicio propiedades de firma que se visualizan con Adobe Reader-->
       <author>Autor de la firma</author>
       <reason>Motivo de la firma</reason>
       <contact>Información de contacto</contact>
       <location>Localización</location>
  <!-- FIN propiedades de firma que se visualizan con Adobe Reader-->

  <certificatePDF>Opcional. 1 si se desea certificar el PDF (MDP)</certificatePDF>
  <returnImgB64>1 si se desea obtener el grafo de la imagen en formato jpg. Disponible sólo para tabletas Wacom</returnImgB64>
</signedPDFFromApplication>

*se muestran los nodos que aplican.

Respuesta:

<signedPDFFromApplicationResponse xmlns="http://www.edatalia.com/">
  <signedPDFFromApplicationResult>
    <code>0 si el resultado es OK, código de error en otro caso.</code>
    <pdfSignedB64>PDF firmado en base64</pdfSignedB64>
    <!-- en el caso de firmar con tableta Wacom y de haber marcado el parámetro returnImgB64=1 -->
    <signatureData>
      <signature>
        <imgB64>imagen codificada en base64</imgB64>
      </signature>
    </signatureData>
    <error>Descripción del error</error>
  </signedPDFFromApplicationResult>
</signedPDFFromApplicationResponse>

Puede consultar el detalle completo del servicio web de firma presencial en este enlace

Antes de realizar la prueba

• Solicite los componentes locales de firma Wacom y su token de acceso en la dirección de correo partners@edatalia.com

A continuación

1. Descargar un proyecto SOAP-UI con peticiones de ejemplo desde este enlace
2. Arrancar la aplicación ecoSignature_LaunchPC.exe, esto hará visible el terminal de firma.
3. En SOAP-UI, llamar al método getUsers en la llamada de ejemplo, en el bloque ServiceSoap12 . Se obtiene la lista de identificadores de terminales conectados y su estado. Seleccionar el id del terminal identificado con su alias. El alias se puede consultar (y modificar) en el fichero ecoSignatureLaunchPC.ini en el parámetro websocket-external-alias, o bien pulsando sobre el icono del área de notificaciones del programa ecoSignature LaunchPC.
4. Copiar el identificador del terminal e informar el valor en la etiqueta <edat:receiver> del método signedFromApplication / ejemplo del bloque ServiceSoap12.
5. Lanzaremos el método ejemplo. De forma similar a la prueba con navegador realizarán la firma del documento: en pantalla se mostrará el documento a firmar (<edat: pdfContent>) y capturaremos la firma en el terminal Wacom. Si quieren indicar otro documento, bastará con que codifiquen en base64 el documento y lo informen en ese campo. (Importante: no debe haber saltos de línea en el texto).
6. Una vez se pulsa el botón Firmar en la pantalla del PC, en la respuesta se obtiene el documento codificado en base64.

Antes de realizar la prueba

• • Descargue nuestra aplicación SIGNply desde Google Play en la tableta o smartphone donde firmará.
  • Obtenga la licencia de evaluación de Signply-Premium descargando este fichero en su dispositivo pulse aquí. Al abrir el fichero en su terminal , seleccione SIGNply como aplicación para abrirlo.

A continuación

1. Solicite un token de acceso en la dirección de correo partners@edatalia.com
2. Descargar el proyecto: Firma_WSFirmaBIO_SIGNply
3. En SOAP-UI, llamar al método getUsers en la llamada de ejemplo del bloque ServiceSoap12 . Obtendrán la lista de identificadores de terminales conectados y su estado. Seleccione el id del terminal identificado con su alias. El alias e identificador se pueden consultar en SIGNply en Configuración > Usuario/Identificador.
4. Copiar el identificador del terminal e informar el valor en la etiqueta <edat:receiver> del método signedFromApplication / ejemplo del bloque ServiceSoap12
5. Lanzar el método ejemplo. En pantalla se mostrará el documento a firmar (<edat: pdfContent>) y se capturará la firma en el terminal Android. Si quieren indicar otro documento, bastará con codificar en base64 el documento e informarlo en ese campo. (Importante: no debe haber saltos de línea en el texto).
6. Una vez completen la firma en SIGNply en la respuesta de la llamada SOAP obtendrán el documento codificado en base64.