Paperwork Template Object

Paperwork Template Object

The Paperwork Template object represents a template for custom paperwork that can be utilized during a worker's onboarding process.

attributetypedescription
templateIDstringUnique identifier for the template
companyIDstringUnique identifier for Zeal company
form_namestringName of the paperwork form
descriptionstringDescription of the paperwork form
paperwork_typestringType of paperwork form. Holds one of the following values:
W4, I9, W9, CustomPaperwork
worker_typestringType of worker the form is applicable to. Can be Employee, Contractor, or All
jurisdictions_filterobjectFilter for jurisdictions where the form is applicable
jurisdiction_typestringType of jurisdiction for the form. Can be WorkLocation, Residency, or All
effective_datestringDate from which the template is effective (format: YYYY-MM-DD)
archive_datestringDate when the template will be archived (format: YYYY-MM-DD)
form_fieldsarrayArray of form fields in the template
urlsarrayList of URLs associated with the template
statusstringCurrent status of the template. Can be Draft, Live, or Archived

Example Paperwork Template Object

{
  "templateID": "template_123456",
  "companyID": "fc235fcccee46aa8a082f357715bcfa",
  "form_name": "Updated W-4 Form",
  "description": "Updated Employee's Withholding Certificate",
  "paperwork_type": "W4",
  "worker_type": "Employee",
  "jurisdictions_filter": {
    "type": "include",
    "jurisdictions": [
      "CA",
      "NY",
      "TX"
    ]
  },
  "jurisdiction_type": "WorkLocation",
  "effective_date": "2023-08-01",
  "archive_date": "2024-07-31",
  "form_fields": [
    {
      "field_name": "employee_name",
      "label": "Employee's Full Name",
      "type": "string",
      "required": true
    },
    {
      "field_name": "ssn",
      "label": "Social Security Number",
      "type": "string",
      "required": true
    }
  ],
  "urls": [
    "https://example.com/updated_w4_form.pdf"
  ],
  "status": "Live"
}