HiLucyHelp Center

Assigning Units and Swaps

HiLucy Team·Atualizado 2026-04-26·2 min read

A booking has dates and a quantity, but until it has an assigned unit identifier (a serial number / plate / asset ID), the rental isn't ready to hand over. This article covers assigning, swapping, and resolving conflicts.

Why assignment matters

The Rental Manager separates product (e.g. "Honda Wave 110") from unit (e.g. plate XYZ-123). A booking starts product-bound and is upgraded to unit-bound when you assign an identifier — at which point the unit is reserved for that window.

Assign an identifier

  1. In the Rentals tab, expand the rental row.
  2. Click Assign Identifier.
  3. The modal lists available units for the product, scoped by your active store and the rental window. Pick one.
  4. Confirm. The unit's availability grid (in the Fleet tab) updates immediately.

💡 For category-mode bookings: if the rental was created through Manual Rental in Category mode, the first available unit was already auto-assigned. You only need this flow for product-mode bookings or when you want to override.

Swap a unit mid-rental

You'll need this when a unit needs to come out of service after a rental has started — mechanical issue, guest preference change, or planned rotation.

  1. Expand the rental row → Swap Unit.
  2. Pick the replacement unit from the available list.
  3. Confirm. Condition history carries forward where possible (the previous unit's condition log stays attached for audit).

When assignment fails

If the Assign Identifier flow shows "no units available", one of these is true:

  • The product has no units configured (check the Inventory tab → Manage Units)
  • All units are already assigned for the requested window (look at the Fleet tab availability grid)
  • A pending booking is holding the units; check Upcoming rentals for conflicts

If you see a 409 response in the browser network tab when calling POST /bookings/{id}/assignments, that's the conflict signal — another rental owns the unit you tried to assign.

Bulk assignment lookup

Need to know which unit is bound to a list of bookings (e.g. preparing for tomorrow's pickups)? The dashboard fetches this in batch via GET /booking-assignments/bulk?ids=1,2,3,… — handy for fleets where you're tracking many handovers in a single morning.

See also

Este artigo foi útil?