Skip to main content

Add or Update a Worksheet Answer

Sets the answer to a worksheet question. Can be called before a job is sent to the device to pre-populate the worksheet.

Will either update an existing answer, if the AnswerId parameter is supplied, or will add a new answer for the question.

Be sure to check if a question has been answered using the JobWorksheetQuestions web service. Use the AnswerId returned by that call to update the answer.

Query String Parameters

NameTypeDescriptionRequired
ActionStringJobSaveWorksheetAnswerRequired
QuestionIdIntRetrieved from a call to jobWorksheetQuestionsRequired
AnswerIdIntRetrieved from a call to jobWorksheetQuestions – if no answerId is specified it is assumed the question has not previously been answered and a new answer is inserted Into the DBRequired
AnswerStringAnswer value. E.g.: "True", "3.14", "List item 1"Required
JobIdIntOptional
JobRefStringJob reference.Optional
JobCustRefIntJob customer reference.Optional
NoteStringComments or notes on the answer.Optional
QuantityDoubleOptional
ExclTax*DoubleCost value.Optional
Vat*DoubleTax as a percentage of the cost IncTax.Optional
IncTax*DoubleCost value.Optional
Currency*StringISO 3 character currency identifier, e.g.: "GBP" "USD" "EUR"Optional

* Applicable to cost answer types.


note

Only one of JobId, JobRef and JobCustRef are required, if more than one is supplied the first in the order above will be used.


note

Either IncTax or ExclTax should be specified.


Response Codes

CodeMessageInformation
0null
2questionId parameter required
2result
2questionResult

Example

Request URL

https://webservice.bigchange.com/v01/services.ashx?action=jobsaveworksheetanswer