Submit Test Toll

Note: This endpoint is only available in the staging environment and requires special permissions granted by administrators.

Endpoint

POST https://api.staging.fleetit.com/api/tickets/individual/

Description

This endpoint enables the submission of a dummy toll ticket for a specified vehicle and transaction with authentication. It either creates a new toll ticket or returns error messages if there are issues with the request or specific business rules are triggered. Tolls are not sent immediately; instead, they are queued and processed for integration in the background.

Request Body Parameters

Parameter	Type	Description
`transaction_date`	`string`	Date of the toll transaction in `YYYY-MM-DD` format.
`exit_time`	`string`	Time of exit in `HH:MM:SS` format.
`exit_plaza`	`string`	Identifier for the exit plaza e.g `"HT"`.
`agency`	`string`	Agency code associated with the toll (e.g., `"PANYNJ"`).
`amount`	`float`	Toll amount charged.
`plate_number`	`string`	License plate number of the vehicle of your fleet. Vehicle must be added prior to submitting test toll.
`plate_state`	`string`	State code of the vehicle registration (e.g., `"NY"`).

Sample Request Payload

{
    "transaction_date": "2024-08-15",
    "exit_time": "01:55:00",
    "exit_plaza": "HT",
    "agency": "PANYNJ",
    "amount": 100.0,
    "plate_number": "ABC123",
    "plate_state": "NY"
}

Responses

201 Created

Description: The toll ticket was successfully created. Sample Response:

{
    "exit_plaza": "HT",
    "agency": "PANYNJ",
    "amount": 100.0,
    "plate_number": "ABC123",
    "plate_state": "NY",
    "vehicle": 7848
}

400 Created

Case 1

Description: The submitted ticket is a duplicate of an existing one. Sample Response:

{
    "queue_reason": [
        "Duplicate of existing ticket: 11746"
    ]
}

Case 2

Description: The ticket submission matches specific business rules and cannot proceed. Sample Response:

{
    "queue_reason": [
        "Ticket matches business rule(s): All February Tolls"
    ]
}

403 Created

Description: You do not have permission to perform this action. Contact Support. Sample Response:

{
    "detail": "You do not have permission to perform this action."
}

Error Codes

Status Code	Description
201	Toll ticket created successfully.
400	Bad request due to duplicate ticket or business rule violation.
403	Forbidden: User lacks necessary permissions.

Additional Information

Environment: This endpoint is exclusive to the staging environment.
Permissions: Access requires special permissions that can be obtained from an administrator.

Usage Notes

Ensure that all date and time fields are formatted correctly.
The amount should be a positive number representing the toll charge.
Make sure you have the necessary permissions before attempting to use this endpoint.

Introduction

Integration Guides

Auth

Vehicles

Fleet

Parking

Transponders

Tolls

Documents

Integrations

Drivers

Billing

Support Tickets

Stats

Submit Test Toll

Endpoint

Description

Request Body Parameters

Sample Request Payload

Responses

201 Created

400 Created

Case 1

Case 2

403 Created

Error Codes

Additional Information

Usage Notes

​Endpoint

​Description

​Request Body Parameters

​Sample Request Payload

​Responses

​201 Created

​400 Created

​Case 1

​Case 2

​403 Created

​Error Codes

​Additional Information

​Usage Notes

Endpoint

Description

Request Body Parameters

Sample Request Payload

Responses

201 Created

400 Created

Case 1

Case 2

403 Created

Error Codes

Additional Information

Usage Notes