Skip to main content

Implementation Overview

Implementation Type: Kombo-based Integration
Note Format: Plain Text
Status: Production Ready

Configuration

PropertyValue
Provider Enumjobdiva
Note FormatPLAIN
Disposition ReasonsSupported
All Application StagesSupported
Passthrough URL/passthrough/jobdiva/api

Feature Summary

Kombo-based integration with extensive custom implementations for JobDiva-specific features including qualifications and company management.

Streaming Operations (All Supported)

  • Stream Jobs (Inherited)
  • Stream Applications (Inherited)
  • Stream Candidates (Inherited)
All streaming operations work through Kombo’s unified API.
  • Move to Stage (Inherited)
  • Get Rejection Reasons (Custom Implementation via passthrough)
  • Reject Applications (Inherited)
  • Create Applications (Inherited)
  • Get All Stages (Inherited)
Implementation Notes:
Custom get_disposition_reasons() implementation uses JobDiva’s /apiv2/getRejectReasons endpoint via passthrough for accurate rejection reason data.
  • Get Job by ID (Inherited)
  • Get Enhanced Job (Custom Implementation)
  • Batch Job Operations (Custom Implementation)
Implementation Notes:
  • Custom job enhancement fetches company details and job sectors
  • Batch operations use JobDiva’s bulk job details endpoint
  • Req ID extracted from job_code field
  • Get Candidate by ID (Inherited)
  • Find by Details (Inherited)
  • Get Resume (Inherited)
Standard candidate operations through Kombo.
  • Application Notes (Inherited)
  • Candidate Notes (Inherited)
  • Application Attachments (Inherited)
  • Candidate Attachments (Inherited)
Full notes and attachments support via Kombo.
  • Application Custom Fields (Inherited)
  • Candidate Custom Fields (Inherited)
  • Job Custom Fields (Inherited with custom enhancements)
Custom field support across all entities.

JobDiva-Specific Features

Qualifications System

JobDiva uses a qualifications/certifications system for candidate tracking: Tenzo Certification:
  • Qualification Name: “Tenzo - Successful Screening”
  • Type ID: “38”
  • Value: “Yes” for certified candidates
Methods:
  • get_qualifications(candidate_id) - Retrieve candidate qualifications
  • add_qualification(candidate_id, qual_name, value) - Add/update qualification
  • get_tenzo_certified_candidates(job_ids) - Find certified candidates
Implementation Notes:
Uses passthrough API endpoints:
  • /apiv2/getApplicantsDetail - Detailed applicant data with qualifications
  • Qualification updates via candidate detail endpoints

Company Management

Retrieve company details associated with jobs:
  • Company name
  • Company ID
  • Additional company metadata

Employee Status Filtering

Support for filtering candidates by employee status qualification (used for Peak Staffing and similar workflows).

Job Sectors

Track and filter jobs by sector using custom fields:
  • Field Name: “Job Sectors”
  • Used for job categorization and filtering

Implementation Notes

Custom Passthrough Methods

JobDiva library (JobDivaLibrary) provides helper methods for:
  • Parsing rejection reasons
  • Fetching bulk job details
  • Retrieving qualifications
  • Company data access
  • Applicant detail queries

Field Constants

Client defines constants for JobDiva-specific fields:
  • TENZO_ACTIVE_FIELD_NAME = “Tenzo Active”
  • TENZO_ACTIVE_VALUE_YES = “Yes”
  • JOB_SECTORS_FIELD_NAME = “Job Sectors”
  • TENZO_CERTIFIED_QUAL_NAME = “Tenzo - Successful Screening”
  • TENZO_CERTIFIED_QUAL_TYPE_ID = “38”

Data Models

Rich JobDiva-specific models:
  • JobDivaJob - Job with custom field values
  • JobDivaApplicantDetail - Detailed applicant data
  • JobDivaQualification - Qualification/certification records
  • JobDivaCompany - Company information
  • Implementation: server/ats/jobdiva_ats/jobdiva_ats_client.py (~1,700 lines)
  • Library: server/ats/jobdiva_ats/jobdiva_library.py
  • Models: server/ats/jobdiva_ats/jobdiva_models.py
  • Field Mappings: server/ats/field_type_mapper.py (JOBDIVA_FIELD_MAPPINGS)
  • Base Class: server/ats/base_kombo_ats_client.py

See Also