> ## Documentation Index
> Fetch the complete documentation index at: https://f4c7a9e2d8b1-docs.tenzo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# JobDiva ATS

> Feature coverage and implementation details for JobDiva integration

## Implementation Overview

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

## Configuration

| Property               | Value                      |
| ---------------------- | -------------------------- |
| Provider Enum          | `jobdiva`                  |
| Note Format            | `PLAIN`                    |
| Disposition Reasons    | Supported                  |
| All Application Stages | Supported                  |
| Passthrough URL        | `/passthrough/jobdiva/api` |

## Feature Summary

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

<AccordionGroup>
  <Accordion title="Streaming Operations (All Supported)" defaultOpen>
    * Stream Jobs (Inherited)
    * Stream Applications (Inherited)
    * Stream Candidates (Inherited)

    All streaming operations work through Kombo's unified API.
  </Accordion>

  <Accordion title="Application Management (All Supported)">
    * 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.
  </Accordion>

  <Accordion title="Job Management (All Supported)">
    * 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
  </Accordion>

  <Accordion title="Candidate Management (All Supported)">
    * Get Candidate by ID (Inherited)
    * Find by Details (Inherited)
    * Get Resume (Inherited)

    Standard candidate operations through Kombo.
  </Accordion>

  <Accordion title="Notes & Attachments (All Supported)">
    * Application Notes (Inherited)
    * Candidate Notes (Inherited)
    * Application Attachments (Inherited)
    * Candidate Attachments (Inherited)

    Full notes and attachments support via Kombo.
  </Accordion>

  <Accordion title="Custom Fields (All Supported)">
    * Application Custom Fields (Inherited)
    * Candidate Custom Fields (Inherited)
    * Job Custom Fields (Inherited with custom enhancements)

    Custom field support across all entities.
  </Accordion>
</AccordionGroup>

## 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

## Related Files

* 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

* [ATS Coverage Matrix](/internal/ats-coverage)
