Introducción
Puede integrar la firma manuscrita biométrica en su aplicación a través de llamadas al Servidor Centralizado de Firma. A través de una llamada SOAP estándar podrá enviar a su tableta Wacom o Android un documento para firmar y capturar los datos biométricos del firmante.
Acceso
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.
Cabecera de las peticiones
En todas las peticiones hay que informar el token de acceso.
Recuerde solicitar el suyo
getUsers
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 y 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>
signedPDFFromApplication
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> <remotePdfUrl>path de documento PDF en servidor desde su raíz</remotePdfUrl> <pdfPassword>Si el documento tiene una contraseña, se debe informar en base64</pdfPassword> <pathIni>path de archivo en configuración ini en servidor desde su raíz</pathIni> <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 para activar la transparencia del widget</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> <jsigMode>firma con biometría o sin biometría</jsigMode> <jsigJPG>imagen de fondo en base 64 para firmado sin biometría</jsigJPG> <savePath>path de guardado desde la raíz del servidor</savePath> <saveName>nombre del documento guardado en PDF</saveName> <returnPdfB64>1 si se desea obtener el documento firmado en base 64</returnPdfB64> <returnImgB64>1 si se desea obtener el grafo de la imagen en formato jpg. Disponible sólo para tabletas Wacom</returnImgB64> </signedPDFFromApplication>
Nota
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>
Documentación
Puede consultar el detalle completo del servicio web de firma presencial en este enlace.
Ejemplo SOAP-UI: firma presencial en tabletas Wacom
1. Solicite un token de acceso en la dirección de correo soporte@edatalia.com, así como el paquete local necesario para poder firmar con su tableta.
2. Descargar el proyecto: Firma_WSFirmaBIO_Wacom
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. Si su terminal no aparece en la lista, debe comprobar que el programa ecoSignatureLaunchPC.exe esté arrancado.
4. Copiar el identificador del terminal e informar el valor en la etiqueta receiver método signedFromApplication / ejemplo del bloque ServiceSoap12
5. Lanzar el método ejemplo. En pantalla se mostrará el documento a firmar y se capturará la firma en la tableta Wacom. 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 la respuesta de la llamada SOAP obtendrán el documento codificado en base64.