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

# Parkonect

> Connect Parkonect to KODE OS for reservations data

> Connect Parkonect to KODE OS for reservations data integration

## Overview

Use this integration to connect Parkonect parking reservations and payments to KODE OS. REST and webhooks deliver hybrid collection with optional actions so parking assets stay visible alongside other building data.

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

## Supported Capabilities

* Collect Sensor Data
* Collect Non-Sensor Data
* Receive Webhook Data

## Prerequisites

* An active account with Parkonect and access to their API or developer portal
* Username and password credentials for the Parkonect system
* KODE OS environment with access to Data Sources

## Configure Webhook

This integration uses webhooks for real-time data delivery. After creating the connector in KODE OS:

1. Copy the webhook URL provided on the connector detail page
2. In the Parkonect platform, navigate to the webhook or notification settings
3. Add a new webhook endpoint using the KODE OS URL
4. Configure the authentication header as specified on the connector detail page
5. Save and enable the webhook

## Configure Connector in KODE OS

1. Navigate to **Data Sources** in your building
2. Click **API Catalog** and search for **Parkonect**
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        |
| **Username**  | Yes      | text     | The username for authenticating with the external system |
| **Password**  | Yes      | password | The password for authenticating with the external system |
| **Vendor ID** | Yes      | password | The vendor identifier in the external system             |
| **Garage ID** | Yes      | password | The parking garage identifier                            |

## What Data You Get

### Bookings

Space reservation records including attendees, check-in/out times, confirmation status, and room/space details

KODE OS maps the collected data to these standard fields:

| KODE Field         | Description                                          |
| ------------------ | ---------------------------------------------------- |
| **ID**             | Unique booking identifier                            |
| **Title**          | Booking title or subject                             |
| **Description**    | Booking details                                      |
| **Status**         | Booking status (e.g., Confirmed, Pending, Cancelled) |
| **Type**           | Booking type (Room, Desk, Parking, Visitor)          |
| **Location**       | Space or room being booked                           |
| **Host Name**      | Person who created the booking                       |
| **Host Email**     | Email of the booking host                            |
| **Attendee Name**  | Visitor or attendee name                             |
| **Attendee Email** | Visitor or attendee email                            |
| **Start Time**     | Booking start date and time                          |
| **End Time**       | Booking end date and time                            |
| **Check-In**       | Actual check-in timestamp                            |
| **Check-Out**      | Actual check-out timestamp                           |
| **Confirmed**      | Whether the booking has been confirmed               |
| **Cancelled**      | Whether the booking has been cancelled               |
| **Created At**     | Timestamp when the booking was created               |
| **Updated At**     | Timestamp of the last update                         |

### Polling Schedule

* **Booking** -- Default polling: 1 hours (min: 1 hours, max: 1 days)

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

## Available Actions

### Create Booking

**Type:** Write

Creates a new parking booking in Parkonect

| Field                     | Type       | Required | Input    | Options / Default |
| ------------------------- | ---------- | -------- | -------- | ----------------- |
| **Visit ID**              | STRING     | Yes      | Text Box | --                |
| **QR Code**               | STRING     | Yes      | Text Box | --                |
| **Start Time**            | DATE\_TIME | Yes      | Text Box | --                |
| **End Time**              | DATE\_TIME | Yes      | Text Box | --                |
| **Parking Space Charges** | DOUBLE     | No       | Number   | --                |
| **Visitor Name**          | STRING     | No       | Text Box | --                |
| **License Plate**         | STRING     | No       | Text Box | --                |
| **Vehicle Make**          | STRING     | No       | Text Box | --                |
| **Vehicle Model**         | STRING     | No       | Text Box | --                |
| **Vehicle Color**         | STRING     | No       | Text Box | --                |

#### Example Request

```json theme={null}
{
  "visit_id": "12345",
  "qr_code": "example-value",
  "start": "2026-03-29T10:00:00Z",
  "end": "2026-03-29T10:00:00Z",
  "parking_space_charges": 1.0,
  "visitor_name": "example-value"
}
```

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

### Update Booking

**Type:** Write

Updates an existing parking booking in Parkonect

| Field          | Type       | Required | Input    | Options / Default |
| -------------- | ---------- | -------- | -------- | ----------------- |
| **Visit ID**   | STRING     | Yes      | Text Box | --                |
| **QR Code**    | STRING     | Yes      | Text Box | --                |
| **Start Time** | DATE\_TIME | Yes      | Text Box | --                |
| **End Time**   | DATE\_TIME | Yes      | Text Box | --                |

#### Example Request

```json theme={null}
{
  "visit_id": "12345",
  "qr_code": "example-value",
  "start": "2026-03-29T10:00:00Z",
  "end": "2026-03-29T10:00:00Z"
}
```

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

### Cancel Booking

**Type:** Write

Cancels a parking booking in Parkonect

| Field                | Type       | Required | Input    | Options / Default |
| -------------------- | ---------- | -------- | -------- | ----------------- |
| **Visit ID**         | STRING     | Yes      | Text Box | --                |
| **Action Date Time** | DATE\_TIME | No       | Text Box | --                |

#### Example Request

```json theme={null}
{
  "visit_id": "12345",
  "action_datetime": "2026-03-29T10:00:00Z"
}
```

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

### Update Booking Status

**Type:** Write

Records check-in/check-out for a parking booking

| Field              | Type   | Required | Input    | Options / Default |
| ------------------ | ------ | -------- | -------- | ----------------- |
| **Order Number**   | STRING | Yes      | Text Box | --                |
| **Barcode**        | STRING | Yes      | Text Box | --                |
| **Check-In Time**  | STRING | No       | Text Box | --                |
| **Check-Out Time** | STRING | No       | Text Box | --                |

#### Example Request

```json theme={null}
{
  "OrderNumber": "example-value",
  "Barcode": "example-value",
  "CheckInTime": "2026-03-29T10:00:00Z",
  "CheckOutTime": "2026-03-29T10:00:00Z"
}
```

#### 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 space and resource booking data across platforms
* Track no-show rates and actual utilization versus bookings
* Coordinate meeting room conditions (HVAC, lighting) with reservation schedules

## 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. Verify the username and password are correct and the account has not been locked in the Parkonect system.
  </Accordion>

  <Accordion title="Webhook data not arriving">
    Verify the webhook URL is correctly registered in the Parkonect platform. Check that the authentication header matches the value from the KODE OS connector detail page. Ensure the Parkonect system can reach the KODE OS webhook endpoint over the network.
  </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 Parkonect API.
  </Accordion>
</AccordionGroup>