Bienvenido ...

Felicitaciones, el servicio de firma digital de agente automatizado se encuentra activo. Aquí pondremos algunos ejemplos de uso.

Usted está usando la versión 1.2.

Configurar el servicio antes del inicio

Para poder ver esta ventana Ud debió primero haber instalado Java Versión 1.8 como mínimo. Luego configurar las siguientes variables de entorno en su servidor.

                                
                                    $BIGSIGNER_PATHIN : Ruta de entrada para lectura de documentos PDF.
                                    $BIGSIGNER_PATHOUT : Ruta de salida para documentos firmados.
                                    $BIGSIGNER_CERTIFICATE_ALIAS : Alias del certificado de agente automatizado instalado en el almacen de windows.

El puerto por defecto donde corre el servicio es el : 9000, para cambiar el puerto se debe ejecutar -Dhttp.port=PUERTO_NUEVO al momento de ejecutar el servicio

¿Como consumo el servicio?

A continuación detallamos la lista de RUTAS que puede consumir desde su aplicación.

                        
                            POST        /api/signpdf
                            POST        /api/signbatch
                            POST        /api/getstatus

Procedemos a detallar a continuación.

/api/signpdf : Se envía un PDF adjunto dentro de la petición.
/api/signbatch : Se envía un JSON con dos rutas una de entrada y otra de salida. Especial para procesos de firma masivos.
/api/getstatus : Se envía un JSON con el identificador del proceso para verificar el estado.

Respuesta de cada Servicio

Cada servicio web, devuelve un JSON con la siguiente información:

code: Código identificador del proceso, con el que luego se puede verificar el estado.
status: Estado del proceso de firma, (Estado 0: PENDIENTES DE FIRMA, Estado 1: Proceso de firma completo).
numOfFiles: Cantidad de archivos por firmar en el proceso.
listSignedFiles: Lista de archivos firmados.

Procesos de firma en lote

Para proceso de firma masivos, usar el servicio /api/signbatch, para saber si el sistema ya culminó el proceso de firma usar el servicio /api/getstatus, el cuerpo del mensaje para firma en lotes debe ser un JSON con la siguiente estructura:

                            
                                {
                                    "fileIn":"RUTA_INGRESO",
                                    "fileOut":"RUTA_SALIDA_FIRMADOS",
                                    "emailNotification":""
                                }

Ejemplos de uso

Ponemos a disposición ejemplos de conexión en los lenguajes: JAVA, .NET y PHP. como referencia para el consumo de servicios.

                            https://bitbucket.org/luish192/bigsigner-ejemplos