# Placement Listing

## Columns & Information Displayed

For each placement listed, the following information is displayed in columns:

1. **Company Name**
   * **Format**: This column displays two lines of information:
     * **Line 1**: The **Job Order** associated with the placement.
     * **Line 2**: The **Company Name** where the candidate is placed.
2. **Candidate Name:** The name of the candidate who has been placed in the job.
3. **Placement Status:** The current status of the placement, which can be one of the following:
   * **Not Invoiced**: The placement has been made, but the invoice has not yet been issued.
   * **Paid Partly**: The invoice has been partially paid.
   * **Paid Fully**: The invoice has been fully paid.
   * **Cancel**: The placement was canceled before completion.
4. **Total Revenue:** The total revenue generated from the placement, representing the gross amount billed to the client.
5. **Fee:** The fee associated with the placement
6. **Hired Date:** The date on which the candidate was officially hired by the client.
7. **Start Date:** The date when the candidate started their new role at the company.
8. **End Date:** The end date of the candidate’s contract or employment, if applicable.
9. **Profit Split**: Information on how the profit from the placement is divided, such as between different teams or individuals
10. **Created By:** The end date of the candidate’s guarantee responsibility, marking the conclusion of the obligation to the company client regarding the placement.

<figure><img src="/files/KApTtG3DKvXPf8nJfTNn" alt=""><figcaption></figcaption></figure>

## Placement Searching

{% hint style="info" %}
The Placement Searching feature allows users to quickly locate specific placements within the system using a variety of search criteria and filters
{% endhint %}

* **Search by Keyword:** Enter a keyword related to the placement, such as the candidate’s name, job title, or other relevant information to quickly locate specific placements.
* **Company:** Select a company from the list of companies that have job orders associated with placements

  \*\* The list can be narrowed down by searching for a specific company name, making it easier to find and select the desired company.\*
* **Member:** Search for placements by members who are included in the profit split list. This allows users to find placements associated with specific members within the agency.
* **Status:** Filter placements by selecting from a list of statuses such as Not Invoiced, Paid Partly, Paid Fully, or Canceled.
* **Hired Date & Start Date:** Select a range of dates to filter placements based on when the candidate was hired or when they started their job. This is useful for tracking placements within specific periods.

<figure><img src="/files/UvOScpjXNMve9bliQjDd" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.hireforce.io/product-guides/placement-management/placement-listing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
