¿Cómo crear un proceso de firma?

processTypeId

Tipo de proceso a crear. Puede ser:

• 1 (Solo Yo)

• 2 (Otros y Yo)

• 3 (Solo Otros)

Int

SI

balanceTypeId

Método con tipo de saldo el cual asignará un valor.

1. Saldo por firmas

2. Saldo por documentos

Int

SI

signatureMethodId

Método de firma con el cual se creará el proceso.

1. Firma electrónica simple.

2. Firma electrónica certificada.

Int

SI

isHandWritten

Parámetro que permite agregar firma manuscrita. Valores:

• True, proceso tendrá firma manuscrita

• False, el proceso no tendrá firma manuscrita.

Boolean

No

isPhotographic

Parámetro que permite agregar firma fotográfica. Valores:

• True, el proceso tendrá firma fotográfica.

• False, el proceso no tendrá firma fotográfica.

Boolean

No

isInOrden

Parámetro que permite que el proceso sea por orden de firmantes predefinido. Valores:

• True, el proceso tendrá orden de firmantes.

• False, el proceso no tendrá orden de firmantes.

Boolean

No

deadlineDays

Plazo máximo en días para que todos los signatarios firmen el documento asociado al proceso.

Int

SI

signatures[]

Listado de firmantes vinculados al proceso, sujeto al tipo de proceso.

-

SI

order

(parámetro del array signatures) El orden de cada firmante en el proceso

Int

Si el valor isOrden = True

processId

(parámetro del array signatures) Debe tener como valor 0.

Int

SI

authenticationMethodId

(parámetro del array signatures) Método de autenticación OTP (One-Time Password) con el cual el firmante validará su proceso de firma.

1. OTP Llamada.

2. OTP SMS.

3. OTP Email.

4. OTP Whatsapp.

Int

SI

contactInformation{}

(objeto del array signatures) Objeto que contiene la información de contacto del firmante asociado al proceso a crear.

-

SI

phone{}

(objeto de contactInformation) Objeto que contiene la información del número de celular asociado al firmante.

-

SI

indicative

(parámetro del objeto phone) Indicativo de país asociado al número de celular del firmante. Ejemplo para Colombia: 57.

String

SI

number

(parámetro del objeto phone) Número celular del firmante. Máximo de caracteres para Colombia: 10. Máximo de caracteres para números extranjeros: 20.

String

SI

phoneId

(parámetro de contactInformation) Debe tener como valor 0.

Int

SI

email

(parámetro de contactInformation) Correo electrónico del firmante. Máximo: 100 caracteres.

String

SI

personId

(parámetro de contactInformation) Debe tener como valor 0.

Int

SI

person{}

(objeto de contactInformation) Objeto que contiene información básica asociada al firmante.

-

SI

firstName

(parámetro del objeto person) Primer nombre del firmante. Mínimo: 2 caracteres. Máximo: 100 caracteres.

String

SI

secondName

(parámetro del objeto person) Segundo nombre del firmante. Mínimo: 2 caracteres. Máximo: 100 caracteres. (En caso de no enviarlo, su valor debe ser null.)

String

NO

firstLastName

(parámetro del objeto person) Primer apellido del firmante. Mínimo: 2 caracteres. Máximo: 100 caracteres.

String

SI

secondLastName

(parámetro del objeto person) Segundo apellido del firmante. Mínimo: 2 caracteres. Máximo: 100 caracteres. (En caso de no enviarlo, su valor debe ser null.)

String

NO

identification

(parámetro del objeto person) Número de identificación del firmante. Mínimo: 5 caracteres (Cédula de Ciudadanía) o Máximo: 12 caracteres (Cédula Extranjera).

String

SI

identificationTypeId

(parámetro del objeto person) Tipo de identificación del firmante.

1. Cédula de Ciudadanía.

2. Cédula Extranjera.

Int

SI

typePersonId

(parámetro del objeto person) Tipo de persona del firmante.

1. Persona Natural.

2. Persona Jurídica.

Int

SI

pathHandWritten

(parámetro del objeto person) Ruta de donde se encuentra almacenada la firma manuscrita del firmante.

String

NO

fileNameHandWritten

(parámetro del objeto person) Nombre del archivo de la firma manuscrita del firmante.

String

No

signatory_type

(objeto del array signatures) Tipo de firmante que se representa en la evidencia digital para cada firmante-

String

No

documents[]

Objeto que contiene la información del documento a firmar.

-

SI

filename

(parámetro del objeto documents) Nombre del documento PDF. Máximo: 100 caracteres.

String

SI

documentTypeId

(parámetro del objeto documents) Debe tener como valor 1.

Int

SI

base64String

(parámetro del objeto documents) String con el documento PDF codificado en base64.

String

SI

callback

URL donde se debe enviar el documento cuando el proceso se termine exitosamente. Este parámetro hace referencia a la estrategia callback mencionada en la sección 1.3.

String

NO

subjectEmail

Asunto que se desea incluir en el correo electrónico con la solicitud de firma a los firmantes. (En caso de no enviarse, el asunto por defecto es "solicitud de firma.") Máximo: 150 caracteres.

String

NO

messageEmail

Mensaje que se desea incluir en el correo electrónico con la solicitud de firma a los firmantes. (En caso de no enviarse, no hay un mensaje por defecto.) Máximo: 500 caracteres.

String

NO

copyEmails

Listado separado por comas de los correos electrónicos a los cuales se enviará una copia del documento una vez firmado por todos los involucrados. (No se incluyen correos asociados a los firmantes.) Máximo string: 255 caracteres. Máximo de correos electrónicos permitidos: 10.

String

NO