Skip to main content

​
Implementation Overview

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

​
Configuration

​
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 (Custom Implementation via /apiv2/jobdiva/createJobNote passthrough)
  • Candidate Notes (Custom Implementation via /apiv2/jobdiva/createCandidateNote passthrough)
  • Application Attachments (Inherited)
  • Candidate Attachments (Unsupported)
Both application and candidate notes post through JobDiva passthrough endpoints (createJobNote with candidateAction, createCandidateNote with action). Candidate-level call-result PDF attachments are not supported.
  • 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
  • Posting application and candidate notes (createJobNote, createCandidateNote)

​
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