eSign.AIeSign.AI
Centro de desarrolladores

Agregar archivo de firma

POST /esignglobal/v1/envelope/files/addSignFiles

Descripción de la interfaz

Cuando el sobre no está abierto, se pueden agregar archivos pendientes de firma al sobre. Los sobres ya abiertos no admiten la adición de archivos para firmar.

Parámetros de solicitud

Nombre del parámetro

Tipo

Obligatorio

Descripción

envelopeId

string

true

ID del sobre

signFiles

array

true

Conjunto de información de los archivos firmados; el orden de visualización corresponde al orden en que se agregaron los archivos.

 

fileKey

string

true

fileKey del archivo firmado; solo se admite formato PDF

 documentFieldsarrayfalseLista de controles a nivel de documento. Se utiliza para agregar controles a nivel de documento no vinculados a un firmante específico en un archivo determinado.
  

fieldType

string

false

Tipo de control. Indique eMeterai para representar el control de impuesto de timbre de Indonesia.

  

pageNo

string

false

Número de página donde se encuentra el control. El control de impuesto de timbre de Indonesia solo admite una única página especificada; debe proporcionarse un número de página individual. No se admiten formatos de múltiples páginas continuas o discontinuas como 1-3 o 1,3.

  posXfloatfalseDesplazamiento en el eje x, siendo el origen de coordenadas la esquina inferior izquierda de la página. El rango de coordenadas es consistente con el de otros controles.
  posYfloatfalseDesplazamiento en el eje y, siendo el origen de coordenadas la esquina inferior izquierda de la página. El rango de coordenadas es consistente con el de otros controles.

Ejemplo de solicitud

{   
  "envelopeId": "9fbe6c8190824227bde29136b0145c81",
  "signFiles": [
  {
    "fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c"
  }
]
}

Parámetros de respuesta

Nombre del parámetro

Tipo

Descripción

code

int

Código de negocio, 0 indica éxito, distinto de 0 indica error.

message

string

Información de negocio

[Nota] Evalúe los errores según el código; no dependa de la coincidencia con el mensaje, ya que este podría modificarse.

data

object

Datos de negocio

Ejemplo de respuesta

{
    "code": "0",
    "message": "success",
    "data": null
}