To successfully import bulk jobs into Sassie using the Postman software, you will have to prepare your data for import. 


To use this endpoint, you will need the survey_id, client_location_id, and the "question_number"(QID) for the questions you want to import, prefixing them with "question_".



For example, if your survey has questions 1, 11, and 21, your CSV might look something like this:


 

The result, if successful, will have a 201 status and contain the newly created job_id, but the question data will not be returned. 

If there's a validation problem, the return will have a 400 status and contain a list of fields that contain errors.

Expected format for various question types

Multiple Choice

  • The answer_option_text should be provided. 
  • If it is possible to select multiple options, separate them using a "^" symbol.


Dates

  • yyyy-mm-dd is preferred, as it is the least ambiguous. 
  • If you provide a date in a "slash" format, we will assume it is in m/d/y order!


Time of Day

  • colon-separated, either 24-hour or am/pm, with our without seconds (e.g., 3:14 pm, 3:14:15 pm, 15:14, 15:14:15).


Time Duration

  • colon-separated, either hours:minutes:seconds, minutes:seconds, or seconds.


Measurement

  • Number in inches.


Media (image/audio) File

  • An HTTP[S] URL is preferred, but a base 64 encoded DATA URL is also acceptable (though keep in mind this can result in a very large request size). 
  • Media files will be copied to our media storage mechanism; once the import is complete, the URL you provided can be disabled if desired.


Allowed image file types

  • jpg, jpeg, jpe, gif, tiff, tif, png, bmp, pdf


Allowed audio file types

  • mp3, wav, ogg, aif, aiff, aifc, m4a, amr, wma


Additional Notes:

  • Imported jobs will be scored, but RuleZ will not be run and triggers will not be sent.


  • If not otherwise specified (by providing a "shopper_id" field), the "shopper" assigned to the shop will be the *kioskShopper for your system.


  • If not otherwise specified (by providing a "job_status" field), the job status assigned to the shop will be set to the distribution_level for the survey.


  • If not otherwise specified (by providing a "submit_date" field), the submit_date of the shop will be set to the date the import occurred.


  • If not otherwise specified (by providing a "job_date" field), the job_date of the shop will be set to the value provided in the question that is configured as the "official shop date" question. If no such value exists, it will be set to the date the import occurred. The due_date of the shop will be set to be the same as the job_date.


  • If not otherwise specified (by providing a "report_date" field), the report_date will be set to the job_date.



Format the file as CSV.