> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.kodelabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manager Plus

> Connect Manager Plus to KODE OS for work orders data

> Connect Manager Plus to KODE OS for work orders data integration

## Overview

Use this integration to connect Manager Plus to KODE OS. You can discover devices and points, sync inspections, work orders, and inventory-related data over REST with hybrid snapshot collection, and use supported actions where the API allows.

| Property            | Value                |
| ------------------- | -------------------- |
| **System Type**     | Work Orders          |
| **Communication**   | REST                 |
| **Collection**      | Hybrid (Pull + Push) |
| **Collection Mode** | SNAPSHOT             |
| **Actions**         | Supported            |

## Supported Capabilities

* Discover Devices & Points
* Collect Sensor Data
* Collect Non-Sensor Data

## Prerequisites

* An active account with Manager Plus and access to their API or developer portal
* API key or token from the Manager Plus platform
* KODE OS environment with access to Data Sources

## Generate API Credentials

1. Log in to the Manager Plus platform or admin console
2. Navigate to the API settings, developer section, or account settings
3. Generate a new API key or token
4. Copy the key and store it securely -- you will need it when configuring the connector in KODE OS

## Configure Connector in KODE OS

1. Navigate to **Data Sources** in your building
2. Click **API Catalog** and search for **Manager Plus**
3. Click **+ Add Datasource**
4. Fill in the fields below and complete the three-page setup flow

| Field       | Required | Type     | Description                                             |
| ----------- | -------- | -------- | ------------------------------------------------------- |
| **URL**     | Yes      | text     | The base URL or IP address of the external system       |
| **API Key** | Yes      | password | The API key for authenticating with the external system |

## Discover Devices and Points

After configuring the connector, click **Discover** on the connector detail page. KODE OS will query the Manager Plus system and return a list of available devices and their data points.

Review the discovered items and select the devices you want to register in KODE OS.

For more details on the discovery process, see the [Discovery guide](/products/integrations/capabilities/discovery).

## Devices and Points

When you discover devices from Manager Plus, KODE OS maps them to the following device types and data points:

### Connected Device

Canonical Type: `default`

| # | Point    | Description              | Unit | Writable | Collection |
| - | -------- | ------------------------ | ---- | -------- | ---------- |
| 1 | `Status` | Current operating status | --   | No       | Polling    |

## What Data You Get

### Point History

Time-series readings including Status, collected at regular intervals from connected devices

### Work Orders

Maintenance and service requests including title, description, status, priority, assignee, due dates, vendor response, resolution details, and cost estimates

KODE OS maps the collected data to these standard fields:

| KODE Field           | Description                                                               |
| -------------------- | ------------------------------------------------------------------------- |
| **ID**               | Unique work order identifier from the external system                     |
| **WO Number**        | Display work order number                                                 |
| **Title**            | Work order title or subject line                                          |
| **Description**      | Detailed work order description and scope of work                         |
| **Status**           | Current work order status (e.g., Open, In Progress, Completed, Cancelled) |
| **Priority**         | Work order priority level (e.g., High, Medium, Low)                       |
| **Type**             | Work order type classification                                            |
| **Category**         | Work order category (e.g., Corrective, Preventive, Inspection)            |
| **Sub-Category**     | Work order sub-category for finer classification                          |
| **Location**         | Physical location where the work is performed                             |
| **Floor**            | Floor identifier within the building                                      |
| **Problem Cause**    | Root cause or problem code associated with the work order                 |
| **Created By**       | Person or system that created the work order                              |
| **Assigned To**      | Individual assigned to perform the work                                   |
| **Assignment Group** | Team or group responsible for the work order                              |
| **Created At**       | Timestamp when the work order was created                                 |
| **Updated At**       | Timestamp of the last modification                                        |
| **Due Date**         | Target completion date for the work order                                 |
| **Started At**       | Timestamp when work began                                                 |
| **Completed At**     | Timestamp when work was completed                                         |
| **Duration (min)**   | Total time spent on the work order in minutes                             |
| **Service Provider** | External vendor or contractor performing the work                         |
| **Resolution**       | Description of how the issue was resolved                                 |
| **Estimated Cost**   | Estimated cost of the work order                                          |
| **Last Comment**     | Most recent comment or note on the work order                             |
| **Asset**            | Name of the asset or equipment this work order is for                     |
| **External URL**     | Link to the work order in the external system                             |

### Polling Schedule

* **Point History** -- Default polling: 1 hours (min: 1 hours, max: 1 hours)
* **WorkOrder**

For more details on collection modes, see the [Data Collection guide](/products/integrations/capabilities/data-collection).

## Available Actions

### Create Work Order

**Type:** Write

Creates a new work order in ManagerPlus

| Field                | Type    | Required | Input     | Options / Default                                |
| -------------------- | ------- | -------- | --------- | ------------------------------------------------ |
| **Purpose**          | STRING  | Yes      | Text Box  | --                                               |
| **Priority**         | INTEGER | No       | Drop Down | Dynamic: fetched from ManagerPlus priorities API |
| **Budget**           | STRING  | Yes      | Drop Down | Dynamic: fetched from ManagerPlus budgets API    |
| **Work Type**        | INTEGER | Yes      | Drop Down | Dynamic: fetched from ManagerPlus work types API |
| **Work Description** | STRING  | Yes      | Text Area | --                                               |

#### Example Request

```json theme={null}
{
  "purpose": "example-value",
  "budgetKey": "example-value",
  "workTypeKey": 1,
  "workDescription": "example-value",
  "priorityKey": "High"
}
```

#### Expected Result

* KODE OS sends the action to the external API using the configured connector credentials
* The external system returns success (typically HTTP 2xx) and processes the requested operation

For more details on how actions work, see the [Actions guide](/products/integrations/capabilities/actions).

## Use Cases

Once connected, this integration enables you to:

* Centralize maintenance requests and work order status from facility management systems
* Create and update work orders directly from KODE OS when issues are detected
* Track maintenance KPIs including response time, completion rate, and cost

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication or connection error">
    Verify that the credentials are correct and have not expired. Check that the URL is reachable from the KODE OS environment. Ensure the API key or token is valid and has not been revoked or expired in the Manager Plus platform.
  </Accordion>

  <Accordion title="Discovery returns no devices">
    Verify the connector credentials have sufficient permissions in the Manager Plus system to list devices. Run a test connection first to confirm connectivity. Some systems require specific API scopes or roles for device enumeration.
  </Accordion>

  <Accordion title="Data collection stops or gaps appear">
    Check the connector status on the Data Sources page. If the status shows an error, review the error logs on the connector detail page. Common causes include expired credentials, network changes, or rate limiting by the Manager Plus API.
  </Accordion>
</AccordionGroup>