Shift marketplace (Beta)¶
Beta
The shift marketplace is still in development and is not yet available in WFM. This page describes how it will work; details may change before it is released.
The shift marketplace lets agents swap shifts of a published schedule among themselves. An agent puts a shift on the board or proposes a swap to a colleague directly; the colleague accepts, and WFM either exchanges the shifts at once or sends the swap to an approver. Every swap is checked against the same rules (skills, rest, contract, absences …), so a swap never produces a schedule the planner could not have made.
The marketplace is switched on per workplace. It is off until an administrator or planner turns it on.
Set up the marketplace for a workplace¶
- Go to Settings > Configuration > Shift marketplace.
- If you manage more than one workplace, pick it in Workplace.
- Set the options and click Save.
| Option | What it does |
|---|---|
| Shift marketplace switched on | Agents of the workplace can offer and swap shifts. It cannot be switched on while the workplace shows agents only their own row (Agents see in the schedule: Only themselves, see Agent view). |
| When does a swap need approval | Only when a rule is not met (otherwise the swap happens at once) - a swap that meets every rule is applied as soon as the colleague accepts; one that breaks an approvable rule waits for an approver. Always - every accepted swap waits for an approver. |
| Who approves swaps | The superiors of the agents (team leaders and planners) (default) - the team leaders and planners who are direct superiors of either agent. The planners of the workplace - the planners responsible for the workplace. Selected users - the people you list in Approvers (members of the workplace who are team leaders, planners, HR or administrators). Administrators and HR can approve in every mode. |
| Minimum notice (hours before the shift) | How long before a shift starts it can still be swapped (default 24 h). Offers and proposals also expire at this point. |
| How far ahead shifts can be swapped (days) | Only shifts up to this many days ahead can be swapped (default 28). |
| Minimum rest between shifts (hours) | The rest the swap must leave between an agent's shifts. Empty: the rest the workplace plans with. |
| Check the weekly hours limit of the contract | A swap must not take an agent over the weekly hours of their contract. |
Only administrators, HR and planners see this page; a planner can set it up only for their own workplaces and their team's.
As an agent¶
Open Shift marketplace in the left menu.
Week calendar¶
Week calendar shows your shifts and your colleagues' offers for one week (Monday to Sunday) on the workplace's clock. Use the arrows or Today to move between weeks; only days from tomorrow up to the end of the swap window can be swapped. The cards show what each shift is:
- My shift - your shift, not on the marketplace.
- Offered / Swap proposed / Awaiting approval - your shift is in play; the label says how far it got.
- Offer - a colleague's shift you can take.
- Offer outside the rules - a colleague's shift you cannot take; the card names the first rule that stops it. Hide offers outside the rules hides these.
- Your absence - days of your own vacation or other absence (greyed).
An on-call shift carries On-call ·
Click a card to see its details and what you can do with it in the panel on the right.
Offer a shift on the board¶
- Click your shift in the calendar (or Offer shift and pick it).
- Optionally write a Note for colleagues and pick Valid until (optional) (without a date, the offer lasts until the notice period before the shift).
- Click Offer on the board.
Colleagues see the offer in their calendars and can propose one of their shifts for it. You get an e-mail for every proposal and choose the one you want; the others are declined automatically. Take off the board withdraws the offer.
Propose a swap for a colleague's offer¶
- Click the colleague's Offer.
- Under Which of your shifts would you give for it?, pick one of your shifts. The rule checklist shows for both of you which rules pass, which need an approval and which block the swap.
- Click Propose swap.
The list offers your shifts of the week shown in the calendar.
Propose a direct swap¶
- Click your shift.
- Under Propose a direct swap, WFM lists the colleagues' shifts you could swap with (every blocking rule passes for both of you).
- Click Propose swap next to the one you want.
Accept or decline¶
When a colleague proposes a swap to you, open it from the e-mail or from the calendar and click Accept or Decline (optionally with a reason). Until the swap is approved, each of you works your original shift as planned.
My swap requests¶
My swap requests lists your swaps - Received and Sent - with their state (Proposed, Awaiting approval, Approved, Declined, Rejected, Cancelled, Expired). Filter by state with the chips above the list. You can Withdraw a swap you proposed while it waits for the colleague, and either of you can withdraw it while it waits for approval.
Approve swaps¶
Approvers find the waiting swaps in Shift marketplace > Approvals.
- Pick the workplace if you approve in more than one.
- Each row shows both agents, the shifts they give and Why it needs approval: the rules that were not met, or "This workplace requires approval of every swap".
- Select one or more swaps and click Approve (optionally with a note) or Reject (a reason for the agents is required).
When a swap is approved, the agents exchange the shifts right away and their hours are recalculated. One approval is enough: a swap decided by another approver leaves your queue, and a swap whose shifts changed in the meantime is reported as not decided.
Rules¶
Every proposal, acceptance and approval checks these rules for both agents:
| Rule | Type |
|---|---|
| The schedule is published and not closed | Blocking |
| The shift is on a future day | Blocking |
| Enough notice before the shift | Blocking |
| The shift is within the swap window | Blocking |
| Both shifts are in the same workplace | Blocking |
| The shift still belongs to the same agent | Blocking |
| On-call only for on-call of the same skill | Blocking |
| Skills and their levels match | Blocking |
| No overlap with another shift | Blocking |
| No absence during the shift | Blocking |
| A valid contract | Blocking |
| Minimum rest between shifts | Needs approval |
| Weekly hours limit | Needs approval |
A blocking rule cannot be overridden by anybody. A rule that needs approval sends the swap to an approver instead of applying it at once.
On-call shifts¶
On-call shifts can be swapped only for another on-call shift with exactly the same on-call skill(s); a regular shift only for a regular one. The other rules change for on-call like this:
- No overlap with another shift - on-call and a regular shift do not count as overlapping, unless the workplace has On-call holder takes no shifts switched on. Two on-call shifts, or two regular shifts, are checked as usual.
- Minimum rest between shifts and Weekly hours limit - on-call shifts are left out: taking one is not checked, and on-call duty does not count as rest-breaking work or towards the weekly hours.
- Notice, the swap window, the future day and absences are checked on the start of the on-call shift.
An agent without the on-call skill does not see on-call offers at all. After a swap, the on-call hours move with the shift in the agents' hours, and the next on-call rotation counts whoever actually served.
The direct-swap list of an on-call shift offers only colleagues' on-call shifts of the same skill; when you propose a swap for a colleague's on-call offer, your regular shifts are listed as blocked by this rule.
Note
An agent does not see a colleague's offer at all when they cannot cover its skills at the original agent's level. When a planner changes or removes a shift that is in a swap, the swap is cancelled and both agents are told.
Agents in more than one workplace
The overlap, rest and weekly hours rules look at all of the agent's shifts, in every workplace. A shift in another workplace therefore blocks taking an overlapping shift here, even though the swap itself stays within one workplace.
E-mails¶
| To | When | |
|---|---|---|
| Shift swap proposed to you | The colleague | Somebody proposed a direct swap |
| Proposal for your shift on the marketplace | The agent who offered the shift | Somebody proposed a swap for their offer |
| Shift swap accepted, waiting for approval | The agent who proposed | The colleague accepted and the swap waits for an approver |
| Shift swap waiting for approval | The approvers | Only when the workplace approves every swap (Always): the team leaders and planners who are superiors of either agent and may approve the swap - never HR or administrators |
| Shift swap done | Both agents | The swap was applied |
| Shift swap rejected | Both agents | The approver rejected it (with the reason) |
| Shift swap cancelled | The other agent, or both when a planner changed a shift | The swap was withdrawn, declined or one of its shifts changed |
| Shift swap expired | Both agents | Nobody decided in time |
Each e-mail links to the swap in WFM. E-mails go out in the recipient's language; their texts can be edited like the other notifications (see Requests and Notifications).