/testsite/Services/Gateway.asmx/AddSigningLocation (Method)

Description

Functions as AddSigningLocation with a pint_FieldType of 1 (Full Name Text Box).

Request (AddSigningLocationSoapIn)

The request body is of type AddSigningLocation.

Request Body Parameters

Name	Description	Data Type
pstr_APICode	The API code of the site. This can be found through your Sertifi web interface under Administration -> Account Settings.	xml:string
pstr_FileID	The id of the relevant file.	xml:string
pstr_DocumentID	The id of the relevant document.	xml:string
pint_Page	The page of the pdf to add the location.	xml:int
pint_Top	The distance from the top of the page to the top edge of the signing location.	xml:int
pint_Left	The distance from the left side of the page to the left edge of the signing location.	xml:int
pint_Height	Pass '0'. Unused, but still required.	xml:int
pint_Width	Pass '0'. Unused, but still required.	xml:int
pstr_SignerEmail	The email address of the signer who needs to sign in this location.	xml:string
pstr_Caption	Not used. Not required.	xml:string

Response (AddSigningLocationSoapOut)

The response body is of type AddSigningLocationResponse.

Response Body Parameters

Name	Description	Data Type
AddSigningLocationResult	"SUCCESS" or error message.	xml:string

Remarks

Common Errors include:
"ERROR: Invalid API Code"
"ERROR: Invalid page number."
"ERROR: Invalid top coordinates."
"ERROR: Invalid left coordinates."
"ERROR: Invalid signer email"
"ERROR: Invalid signer email: ..."
"ERROR: File could not be accessed"
"ERROR: Document could not be accessed"
"ERROR: Document Expired"
"ERROR: SignerEmail not valid"
"ERROR: Signer sequence ambiguous. Sequence must be included for this signer and document."
"ERROR: Signing locations can only be added for signers of a document."
"ERROR: Signing locations can only be added to unsigned signature requests"
"ERROR: Could not remove an existing large signature box before adding a new one"