labor.md

Labor

LaborApi laborApi = client.getLaborApi();

Class Name

LaborApi

Methods

• List Break Types
• Create Break Type
• Delete Break Type
• Get Break Type
• Update Break Type
• List Employee Wages
• Get Employee Wage
• Create Shift
• Search Shifts
• Delete Shift
• Get Shift
• Update Shift
• List Team Member Wages
• Get Team Member Wage
• List Workweek Configs
• Update Workweek Config

List Break Types

Returns a paginated list of BreakType instances for a business.

CompletableFuture<ListBreakTypesResponse> listBreakTypesAsync(
    final String locationId,
    final Integer limit,
    final String cursor)

Parameters

Parameter	Type	Tags	Description
locationId	String	Query, Optional	Filter Break Types returned to only those that are associated with the specified location.
limit	Integer	Query, Optional	Maximum number of Break Types to return per page. Can range between 1 and 200. The default is the maximum at 200.
cursor	String	Query, Optional	Pointer to the next page of Break Type results to fetch.

Response Type

ListBreakTypesResponse

Example Usage

String locationId = "location_id4";
Integer limit = 172;
String cursor = "cursor6";

laborApi.listBreakTypesAsync(locationId, limit, cursor).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Create Break Type

Creates a new BreakType.

A BreakType is a template for creating Break objects. You must provide the following values in your request to this endpoint:

• location_id
• break_name
• expected_duration
• is_paid

You can only have 3 BreakType instances per location. If you attempt to add a 4th BreakType for a location, an INVALID_REQUEST_ERROR "Exceeded limit of 3 breaks per location." is returned.

CompletableFuture<CreateBreakTypeResponse> createBreakTypeAsync(
    final CreateBreakTypeRequest body)

Parameters

Parameter	Type	Tags	Description
body	CreateBreakTypeRequest	Body, Required	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Response Type

CreateBreakTypeResponse

Example Usage

BreakType bodyBreakType = new BreakType.Builder(
        "CGJN03P1D08GF",
        "Lunch Break",
        "PT30M",
        true)
    .id("id2")
    .version(124)
    .createdAt("created_at0")
    .updatedAt("updated_at8")
    .build();
CreateBreakTypeRequest body = new CreateBreakTypeRequest.Builder(
        bodyBreakType)
    .idempotencyKey("PAD3NG5KSN2GL")
    .build();

laborApi.createBreakTypeAsync(body).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Delete Break Type

Deletes an existing BreakType.

A BreakType can be deleted even if it is referenced from a Shift.

CompletableFuture<DeleteBreakTypeResponse> deleteBreakTypeAsync(
    final String id)

Parameters

Parameter	Type	Tags	Description
id	String	Template, Required	UUID for the BreakType being deleted.

Response Type

DeleteBreakTypeResponse

Example Usage

String id = "id0";

laborApi.deleteBreakTypeAsync(id).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Get Break Type

Returns a single BreakType specified by id.

CompletableFuture<GetBreakTypeResponse> getBreakTypeAsync(
    final String id)

Parameters

Parameter	Type	Tags	Description
id	String	Template, Required	UUID for the BreakType being retrieved.

Response Type

GetBreakTypeResponse

Example Usage

String id = "id0";

laborApi.getBreakTypeAsync(id).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Update Break Type

Updates an existing BreakType.

CompletableFuture<UpdateBreakTypeResponse> updateBreakTypeAsync(
    final String id,
    final UpdateBreakTypeRequest body)

Parameters

Parameter	Type	Tags	Description
id	String	Template, Required	UUID for the BreakType being updated.
body	UpdateBreakTypeRequest	Body, Required	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Response Type

UpdateBreakTypeResponse

Example Usage

String id = "id0";
BreakType bodyBreakType = new BreakType.Builder(
        "26M7H24AZ9N6R",
        "Lunch",
        "PT50M",
        true)
    .id("id2")
    .version(1)
    .createdAt("created_at0")
    .updatedAt("updated_at8")
    .build();
UpdateBreakTypeRequest body = new UpdateBreakTypeRequest.Builder(
        bodyBreakType)
    .build();

laborApi.updateBreakTypeAsync(id, body).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

List Employee Wages

Returns a paginated list of EmployeeWage instances for a business.

CompletableFuture<ListEmployeeWagesResponse> listEmployeeWagesAsync(
    final String employeeId,
    final Integer limit,
    final String cursor)

Parameters

Parameter	Type	Tags	Description
employeeId	String	Query, Optional	Filter wages returned to only those that are associated with the specified employee.
limit	Integer	Query, Optional	Maximum number of Employee Wages to return per page. Can range between 1 and 200. The default is the maximum at 200.
cursor	String	Query, Optional	Pointer to the next page of Employee Wage results to fetch.

Response Type

ListEmployeeWagesResponse

Example Usage

String employeeId = "employee_id0";
Integer limit = 172;
String cursor = "cursor6";

laborApi.listEmployeeWagesAsync(employeeId, limit, cursor).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Get Employee Wage

Returns a single EmployeeWage specified by id.

CompletableFuture<GetEmployeeWageResponse> getEmployeeWageAsync(
    final String id)

Parameters

Parameter	Type	Tags	Description
id	String	Template, Required	UUID for the EmployeeWage being retrieved.

Response Type

GetEmployeeWageResponse

Example Usage

String id = "id0";

laborApi.getEmployeeWageAsync(id).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Create Shift

Creates a new Shift.

A Shift represents a complete work day for a single employee. You must provide the following values in your request to this endpoint:

• location_id
• employee_id
• start_at

An attempt to create a new Shift can result in a BAD_REQUEST error when:

• The status of the new Shift is OPEN and the employee has another shift with an OPEN status.
• The start_at date is in the future
• the start_at or end_at overlaps another shift for the same employee
• If Breaks are set in the request, a break start_at must not be before the Shift.start_at. A break end_at must not be after the Shift.end_at

CompletableFuture<CreateShiftResponse> createShiftAsync(
    final CreateShiftRequest body)

Parameters

Parameter	Type	Tags	Description
body	CreateShiftRequest	Body, Required	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Response Type

CreateShiftResponse

Example Usage

Money bodyShiftWageHourlyRate = new Money.Builder()
    .amount(1100L)
    .currency("USD")
    .build();
ShiftWage bodyShiftWage = new ShiftWage.Builder()
    .title("Barista")
    .hourlyRate(bodyShiftWageHourlyRate)
    .build();
List<Break> bodyShiftBreaks = new LinkedList<>();

Break bodyShiftBreaks0 = new Break.Builder(
        "2019-01-25T06:11:00-05:00",
        "REGS1EQR1TPZ5",
        "Tea Break",
        "PT5M",
        true)
    .id("id4")
    .endAt("2019-01-25T06:16:00-05:00")
    .build();
bodyShiftBreaks.add(bodyShiftBreaks0);

Shift bodyShift = new Shift.Builder(
        "2019-01-25T03:11:00-05:00")
    .id("id8")
    .employeeId("employee_id2")
    .locationId("PAA1RJZZKXBFG")
    .timezone("timezone2")
    .endAt("2019-01-25T13:11:00-05:00")
    .wage(bodyShiftWage)
    .breaks(bodyShiftBreaks)
    .teamMemberId("ormj0jJJZ5OZIzxrZYJI")
    .build();
CreateShiftRequest body = new CreateShiftRequest.Builder(
        bodyShift)
    .idempotencyKey("HIDSNG5KS478L")
    .build();

laborApi.createShiftAsync(body).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Search Shifts

Returns a paginated list of Shift records for a business. The list to be returned can be filtered by:

• Location IDs and
• employee IDs and
• shift status (OPEN, CLOSED) and
• shift start and
• shift end and
• work day details

The list can be sorted by:

• start_at
• end_at
• created_at
• updated_at

CompletableFuture<SearchShiftsResponse> searchShiftsAsync(
    final SearchShiftsRequest body)

Parameters

Parameter	Type	Tags	Description
body	SearchShiftsRequest	Body, Required	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Response Type

SearchShiftsResponse

Example Usage

List<String> bodyQueryFilterLocationIds = new LinkedList<>();
bodyQueryFilterLocationIds.add("location_ids2");
List<String> bodyQueryFilterTeamMemberIds = new LinkedList<>();
bodyQueryFilterTeamMemberIds.add("team_member_ids9");
bodyQueryFilterTeamMemberIds.add("team_member_ids0");
List<String> bodyQueryFilterEmployeeIds = new LinkedList<>();
bodyQueryFilterEmployeeIds.add("employee_ids7");
TimeRange bodyQueryFilterStart = new TimeRange.Builder()
    .startAt("start_at8")
    .endAt("end_at4")
    .build();
TimeRange bodyQueryFilterEnd = new TimeRange.Builder()
    .startAt("start_at2")
    .endAt("end_at0")
    .build();
DateRange bodyQueryFilterWorkdayDateRange = new DateRange.Builder()
    .startDate("start_date8")
    .endDate("end_date4")
    .build();
ShiftWorkday bodyQueryFilterWorkday = new ShiftWorkday.Builder()
    .dateRange(bodyQueryFilterWorkdayDateRange)
    .matchShiftsBy("START_AT")
    .defaultTimezone("default_timezone8")
    .build();
ShiftFilter bodyQueryFilter = new ShiftFilter.Builder(
        bodyQueryFilterLocationIds,
        bodyQueryFilterTeamMemberIds)
    .employeeIds(bodyQueryFilterEmployeeIds)
    .status("OPEN")
    .start(bodyQueryFilterStart)
    .end(bodyQueryFilterEnd)
    .workday(bodyQueryFilterWorkday)
    .build();
ShiftSort bodyQuerySort = new ShiftSort.Builder()
    .field("CREATED_AT")
    .order("DESC")
    .build();
ShiftQuery bodyQuery = new ShiftQuery.Builder()
    .filter(bodyQueryFilter)
    .sort(bodyQuerySort)
    .build();
SearchShiftsRequest body = new SearchShiftsRequest.Builder()
    .query(bodyQuery)
    .limit(164)
    .cursor("cursor0")
    .build();

laborApi.searchShiftsAsync(body).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Delete Shift

Deletes a Shift.

CompletableFuture<DeleteShiftResponse> deleteShiftAsync(
    final String id)

Parameters

Parameter	Type	Tags	Description
id	String	Template, Required	UUID for the Shift being deleted.

Response Type

DeleteShiftResponse

Example Usage

String id = "id0";

laborApi.deleteShiftAsync(id).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Get Shift

Returns a single Shift specified by id.

CompletableFuture<GetShiftResponse> getShiftAsync(
    final String id)

Parameters

Parameter	Type	Tags	Description
id	String	Template, Required	UUID for the Shift being retrieved.

Response Type

GetShiftResponse

Example Usage

String id = "id0";

laborApi.getShiftAsync(id).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Update Shift

Updates an existing Shift.

When adding a Break to a Shift, any earlier Breaks in the Shift have the end_at property set to a valid RFC-3339 datetime string.

When closing a Shift, all Break instances in the shift must be complete with end_at set on each Break.

CompletableFuture<UpdateShiftResponse> updateShiftAsync(
    final String id,
    final UpdateShiftRequest body)

Parameters

Parameter	Type	Tags	Description
id	String	Template, Required	ID of the object being updated.
body	UpdateShiftRequest	Body, Required	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Response Type

UpdateShiftResponse

Example Usage

String id = "id0";
Money bodyShiftWageHourlyRate = new Money.Builder()
    .amount(1500L)
    .currency("USD")
    .build();
ShiftWage bodyShiftWage = new ShiftWage.Builder()
    .title("Bartender")
    .hourlyRate(bodyShiftWageHourlyRate)
    .build();
List<Break> bodyShiftBreaks = new LinkedList<>();

Break bodyShiftBreaks0 = new Break.Builder(
        "2019-01-25T06:11:00-05:00",
        "REGS1EQR1TPZ5",
        "Tea Break",
        "PT5M",
        true)
    .id("X7GAQYVVRRG6P")
    .endAt("2019-01-25T06:16:00-05:00")
    .build();
bodyShiftBreaks.add(bodyShiftBreaks0);

Shift bodyShift = new Shift.Builder(
        "2019-01-25T03:11:00-05:00")
    .id("id8")
    .employeeId("employee_id2")
    .locationId("PAA1RJZZKXBFG")
    .timezone("timezone2")
    .endAt("2019-01-25T13:11:00-05:00")
    .wage(bodyShiftWage)
    .breaks(bodyShiftBreaks)
    .version(1)
    .teamMemberId("ormj0jJJZ5OZIzxrZYJI")
    .build();
UpdateShiftRequest body = new UpdateShiftRequest.Builder(
        bodyShift)
    .build();

laborApi.updateShiftAsync(id, body).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

List Team Member Wages

Returns a paginated list of TeamMemberWage instances for a business.

CompletableFuture<ListTeamMemberWagesResponse> listTeamMemberWagesAsync(
    final String teamMemberId,
    final Integer limit,
    final String cursor)

Parameters

Parameter	Type	Tags	Description
teamMemberId	String	Query, Optional	Filter wages returned to only those that are associated with the specified team member.
limit	Integer	Query, Optional	Maximum number of Team Member Wages to return per page. Can range between 1 and 200. The default is the maximum at 200.
cursor	String	Query, Optional	Pointer to the next page of Employee Wage results to fetch.

Response Type

ListTeamMemberWagesResponse

Example Usage

String teamMemberId = "team_member_id0";
Integer limit = 172;
String cursor = "cursor6";

laborApi.listTeamMemberWagesAsync(teamMemberId, limit, cursor).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Get Team Member Wage

Returns a single TeamMemberWage specified by id.

CompletableFuture<GetTeamMemberWageResponse> getTeamMemberWageAsync(
    final String id)

Parameters

Parameter	Type	Tags	Description
id	String	Template, Required	UUID for the TeamMemberWage being retrieved.

Response Type

GetTeamMemberWageResponse

Example Usage

String id = "id0";

laborApi.getTeamMemberWageAsync(id).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

List Workweek Configs

Returns a list of WorkweekConfig instances for a business.

CompletableFuture<ListWorkweekConfigsResponse> listWorkweekConfigsAsync(
    final Integer limit,
    final String cursor)

Parameters

Parameter	Type	Tags	Description
limit	Integer	Query, Optional	Maximum number of Workweek Configs to return per page.
cursor	String	Query, Optional	Pointer to the next page of Workweek Config results to fetch.

Response Type

ListWorkweekConfigsResponse

Example Usage

Integer limit = 172;
String cursor = "cursor6";

laborApi.listWorkweekConfigsAsync(limit, cursor).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});

Update Workweek Config

Updates a WorkweekConfig.

CompletableFuture<UpdateWorkweekConfigResponse> updateWorkweekConfigAsync(
    final String id,
    final UpdateWorkweekConfigRequest body)

Parameters

Parameter	Type	Tags	Description
id	String	Template, Required	UUID for the WorkweekConfig object being updated.
body	UpdateWorkweekConfigRequest	Body, Required	An object containing the fields to POST for the request. See the corresponding object definition for field details.

Response Type

UpdateWorkweekConfigResponse

Example Usage

String id = "id0";
WorkweekConfig bodyWorkweekConfig = new WorkweekConfig.Builder(
        "MON",
        "10:00")
    .id("id4")
    .version(10)
    .createdAt("created_at2")
    .updatedAt("updated_at0")
    .build();
UpdateWorkweekConfigRequest body = new UpdateWorkweekConfigRequest.Builder(
        bodyWorkweekConfig)
    .build();

laborApi.updateWorkweekConfigAsync(id, body).thenAccept(result -> {
    // TODO success callback handler
}).exceptionally(exception -> {
    // TODO failure callback handler
    return null;
});