Skip to main content

Revel Integration Known Limitations

What the iPaaS.com Revel integration does and does not do in its initial release — scope, design decisions, and settings to confirm before go-live.

New here? This page is a configuration reference for teams implementing the Revel integration in iPaaS.com. It documents scope, design decisions, and settings to confirm before go-live. These are not product defects, and most items are handled during implementation by iPaaS.com or your Managed Integration Service Provider (MiSP). See Understanding Integration Scope & Known Limitations for how we document this for every integration.

Introduction

The items below are the known limitations of the iPaaS.com Revel integration. They are inherent to the current design of the integration and to the capabilities of the Revel API at the time this documentation was written, and they apply to all subscribers. This initial release supports employee and timesheet synchronization.

Platform Scope and Tested Versions

This integration was built for Revel Systems, the point-of-sale platform, and its REST API.

  • API base address: Revel hosts each customer on their own subdomain, so the base address is specific to your account — https://yoursubdomain.revelup.com. There is no shared host.

  • API version: Revel does not expose a stable, publicly versioned API namespace. The integration was built against Revel's documented production REST endpoints for this initial release (integration version 1.0.0).

  • Not built for: This integration connects to the Revel POS REST API only. It is not built for Revel's separate business-intelligence data product (which uses its own credentials, generated in a different part of the Revel console), nor for any other Revel product line. If Revel launches a separate product or a materially different API version in the future, this integration will not automatically support it.

1. Historical data is not loaded automatically

The integration does not perform a bulk import of existing employees or timesheets when it is first connected. Synchronization begins from the point the integration starts running.

What this means for you: Your existing Revel employee roster and past timesheets are not pulled in automatically on day one. To seed historical records, subscribers or their MiSP can use bulk sync using Postman. Ongoing changes flow normally once the integration is running.

2. Changes are detected on a polling schedule

Revel does not notify iPaaS.com when a record changes, so the integration checks Revel for changes on a schedule that subscribers or their MiSP set. A change made in Revel appears in iPaaS.com on the next scheduled check rather than instantly.

What this means for you: There is a short delay between a change in Revel and its appearance in iPaaS.com, determined by how often the integration is scheduled to poll. You can set the cadence, and run an on-demand check at any time, from Dashboard / Integration Monitoring / Events.

3. Records are added and updated, not deleted

The employee and timesheet collections add new records and update existing ones. They do not delete records.

What this means for you: Removing an employee or a timesheet entry in one system does not remove the matching record in the other. If you need records removed on both sides, remove them in each system directly.

4. Only mapped fields are written; other fields are preserved

When the integration updates a record in Revel, it writes only the fields that are mapped. Any other value already on the Revel record is left as it is.

What this means for you: For the fields it manages, the source system is the source of truth — those values are refreshed on every transfer. Values you maintain only in Revel, on fields the integration does not map, are not overwritten. If both directions of a collection are enabled at once, review the mapping filters so a change written by one direction does not immediately flow back through the other.

5. Employees must be synchronized before their timesheets

A timesheet is attached to an employee, so the employee must already be present and linked in the destination system before a timesheet for that employee can transfer. When synchronizing timesheets into iPaaS.com, a timesheet whose employee is not yet linked is skipped quietly and transfers on a later run once the employee is present. When writing timesheets into Revel, the transfer fails if the employee does not yet exist in Revel.

What this means for you: Synchronize employees before timesheets. If a timesheet is missing, the most common reason is that its employee has not been synchronized yet. Because inbound timesheets for an unlinked employee are skipped rather than reported as errors, confirm the employee is present before investigating a missing shift.

6. Open shifts transfer without an end time until closed

A shift that is still in progress has no clock-out time. It transfers with the start time populated and the end time and total hours empty, and is completed on a later transfer once the shift is closed.

What this means for you: An in-progress shift appears with no end time until it is closed in Revel and transferred again. This is expected; the record fills in once the shift ends and the collection runs again.

7. Break timing reflects duration, not time of day

Revel records how long a break lasted but not when it started. The integration places the break at the start of the shift and calculates its end from the recorded length.

What this means for you: Break duration is accurate, but the time of day a break is shown at is not the moment it was actually taken. For totalling paid versus break time this is exact; if your reporting depends on when in the shift a break occurred, that detail is not available from Revel.

8. Revel custom fields are not supported

The integration does not read from or write to custom fields defined in Revel.

What this means for you: Only the standard employee and timesheet fields the integration maps are synchronized. Data held in Revel custom fields is not transferred. (This is separate from the iPaaS.com-side custom fields the integration uses to hold an employee's PIN and start date, which are supported and described in the mapping documentation.)

9. Employee role, wage, and establishment assignments are not mapped by default

Revel can hold an employee's establishment, role, and hourly wage on a separate assignment record. The integration is able to write that assignment, but the mappings for it are not configured by default.

What this means for you: By default, synchronizing an employee to Revel does not set their establishment, role, or wage assignment. If you need those written, subscribers or their MiSP can add the corresponding mappings. If your workflow needs this configured as standard, submit a feature request through your iPaaS.com partner channel describing the requirement.

10. Timesheet role, wage, department, and approval detail are not transferred

When synchronizing timesheets into iPaaS.com, the integration carries the core shift — employee, start and end times, remarks, and calculated hours. The role worked, the hourly wage applied, the department, and Revel's approval or processing stage are not carried across.

What this means for you: iPaaS.com timesheets reflect who worked and for how long, not the pay rate or approval state recorded against the shift in Revel. If you need that detail downstream, note that it stays in Revel for this release.

11. Date and time zone handling follows Revel's unpublished conventions

Revel documents its date and time values as ISO 8601 but does not publish a literal format or state whether values are interpreted in UTC or in the establishment's local time zone.

What this means for you: For most single-location accounts this is not noticeable. Where establishments span more than one time zone, or where shifts run across midnight, confirm that times land on the expected day and hour in a staging environment before relying on the integration for payroll.

12. Revel's API call allowance is not published

Revel enforces a daily allowance on the number of API calls an account may make, but does not publish the specific figure. When the allowance is exhausted, Revel rejects further requests until it resets, and the rejection appears in Dashboard / Integration Monitoring / Error Logs.

What this means for you: Under normal operation you are unlikely to reach the allowance. When running large transfers, stagger them rather than running several intensive jobs at once. If you reach the limit regularly, contact iPaaS.com Support at support@ipaas.com.

Placeholder Values to Replace Before Go-Live

The integration ships with a small number of example values that must be reviewed and replaced with values that are valid for your own Revel account before the affected collections are enabled. Leaving them in place produces records that look valid but carry the wrong data.

Establishment (Static)

  • Collection: Add/Update Revel Timesheet FROM iPaaS.com

  • Shipped default: 1

  • Why it's a placeholder: Revel requires an establishment on every timesheet entry, and 1 is an example identifier that is not meaningful in your Revel account. A timesheet written against an establishment that does not exist is rejected.

  • Suggested action: Replace the value with the identifier of the establishment these timesheets belong to. If timesheets need to be recorded against more than one establishment, change the mapping from a fixed value to a formula or field mapping that selects the correct establishment per record.

Role Wage (Static)

  • Collection: Add/Update Revel Timesheet FROM iPaaS.com

  • Shipped default: 16.5

  • Why it's a placeholder: Revel requires an hourly wage on every timesheet entry, and 16.5 is an example rate that does not apply to any particular employee. A single fixed value applies the same rate to every shift.

  • Suggested action: Replace the value before enabling the collection. If more than one pay rate is in use, change the mapping from a fixed value to a formula or field mapping that supplies the correct rate per record.

API Url (Subscription Setting)

  • Collection: Subscription Settings (applies to the whole integration)

  • Shipped default: https://api.revelsystems.com

  • Why it's a placeholder: Revel is hosted per account on your own subdomain, so the correct address is https://yoursubdomain.revelup.com. The shipped default is not a working address for any account and must be changed, or the connection will not authenticate.

  • Suggested action: Enter your own Revel site address, using the same subdomain you sign in with, on the subscription settings page.

Closing

This article covers 12 known limitations and 3 placeholder values to review before go-live. For detailed technical documentation of each employee and timesheet collection, see the mapping collection descriptions in the iPaaS.com subscription mapping page and the related mapping documentation articles.

Related Documents

Did this answer your question?