Aggiungi file di firma

POST /esignglobal/v1/envelope/files/addSignFiles

Descrizione dell'interfaccia

Quando la busta non è stata ancora aperta, è possibile aggiungere file da firmare alla busta; una volta aperta, la busta non supporta l'aggiunta di file da firmare.

Parametri della richiesta

Nome del parametro			Tipo	Obbligatorio	Descrizione
envelopeId			string	true	ID della busta
signFiles			array	true	Collezione delle informazioni sui file da firmare, visualizzati nell'ordine in cui sono stati aggiunti.
	fileKey		string	true	fileKey del file da firmare, supporta solo il formato PDF
	documentFields		array	false	Elenco dei controlli a livello di file. Utilizzato per aggiungere controlli a livello di file non associati a firmatari su un file specifico.
		fieldType	string	false	Tipo di controllo. Inserire eMeterai per indicare il controllo relativo all'imposta di bollo indonesiana.
		pageNo	string	false	Numero di pagina in cui si trova il controllo. Il controllo relativo all'imposta di bollo indonesiana supporta solo una singola pagina; è necessario inserire un numero di pagina singolo, non sono supportati formati multipli continui o non continui come 1-3 o 1,3.
		posX	float	false	Spostamento sull'asse x, con l'origine delle coordinate nell'angolo in basso a sinistra della pagina. L'intervallo delle coordinate è coerente con quello degli altri controlli.
		posY	float	false	Spostamento sull'asse y, con l'origine delle coordinate nell'angolo in basso a sinistra della pagina. L'intervallo delle coordinate è coerente con quello degli altri controlli.

Esempio di richiesta

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

Parametri di risposta

Nome del parametro	Tipo	Descrizione
code	int	Codice operativo, 0 indica successo, diverso da 0 indica un errore.
message	string	Informazioni operative [Nota] Valuta l'errore in base al codice; non affidarti alla corrispondenza del messaggio, poiché il messaggio potrebbe essere modificato.
data	object	Dati operativi

Esempio di risposta

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