Modules

Calendar

Certificates

CollectiveAgreements

Company Forms

Company Forms Management

Contacts

Contracts

Customer Assets

Equipment

Expenses

Job Checklists

Job Invoices

Jobs

Labour Actions

Library

Locates

Materials

Messages

Purchase Orders

Safety

Schedule

Service Quotes/Invoices

Service Requests

Services

Settings

TimeLogs

Users

Other

CollectiveAgreement Resource
In CollectiveAgreements Module


Endpoints

Endpoints URI Access Control Description
save POST /api/CollectiveAgreement/save Admin or Module WRITE
migrate POST /api/CollectiveAgreement/migrate Endpoint level permissions

Migrates references from one collective agreement to another. Use this when a union adopts a new agreement (e.g. after contract renewal) and you need to switch jobs, services, contracts, and optionally time logs from the old agreement to the new one.

Required parameters:

  • old_ca_id: (int) ID of the collective agreement to migrate from
  • new_ca_id: (int) ID of the collective agreement to migrate to

Optional parameters:

  • effective_date: (date) If provided, time logs on or after this date that reference the old agreement are updated to the new one. Must be a valid past date.

What it does: Jobs, services, and service contracts that reference the old agreement (or the union default) are updated to the new agreement. If the old agreement was the default for its union, the new one becomes the default. When effective_date is sent, qualifying time logs are also updated.

find GET /api/CollectiveAgreement/find Admin or Module READ
get GET /api/CollectiveAgreement/get Admin or Module READ
report GET /api/CollectiveAgreement/report Endpoint level permissions
save-batch POST /api/CollectiveAgreement/save-batch Admin or Module WRITE
delete POST /api/CollectiveAgreement/delete Admin or Module WRITE

Properties

Property Type Description
id number
title string
per_diem number
per_diem_range number
mileage_settings string
use_zone_mileage boolean
distance_calculation_method string
distance_is_one_way boolean
mileage_trigger_address string
mileage_trigger_distance number
mileage_zones_json string
mileage_deductable number
pay_scales string
start_address_id number
expiry_date date
archived boolean
created_at datetime
updated_at datetime
updated_by number
union_id number
is_default boolean

Settings

Setting
Pagination Limit (when page parameter is set) None
Default Sort Order title ASC

Relationships

Related Resource Key Relationship to CollectiveAgreement Property
Job collective_agreement_id Owns Many Job
Union union_id Belongs To Union
User updated_by Belongs To UpdatedBy