Pick-To-Light API
Overview
The Pick-To-Light (PTL) API provides visual guidance to the operator:
- Displays the number of items to pick on the HMI.
- Lights LED strips indicating the source compartment to pick from and the target compartment to pick into.
- The Log Publisher provides feedback through the PTL segment when the operator presses the confirm button for a specific pick operation.
PTL Concept
The system is based on Pick-To-Light commands (showpicktolight to create a PTL and hidepicktolight to delete a PTL), which are created by the WMS.
Each PTL represents one picking operation and contains:
- Items to pick
- Source bin and compartment
- Target bin and compartment
PTL Status
A PTL can have one of the following statuses:
- Registered: PTL is registered and waiting to become active.
- Active: PTL is active; bins are open, and display + LED strips are active.
- Confirmed: PTL is confirmed by pressing the confirm button on HMI.
Key Rules
- The WMS can send multiple PTLs, but only one PTL is allowed per source–target port combination.
- A PTL is not activated until both the source and target bins are
OPENin their respective ports. - Target information is optional: for putaway operations or when picking into an external tote, only the source information is required.
- The confirm button:
- Confirms an active PTL (sets status to Confirmed).
- Turns off the LEDs.
- Has no effect if no PTL is active.
- Does not automatically close bins (it only changes the PTL status), so the WMS must call
closebininstead.
- Closing a port deletes all PTLs related to that port.
- Log Publisher updates reflect PTL status changes:
- Activation (bins arrive at port)
- Completion (confirm button pressed)
Visualization Without Confirm Button
- Closing a bin automatically deletes the active PTL for that port.
hidepicktolightcan be used instead if bins need to remain open for additional picks.
Handling WMS Disconnections
- AutoStore retains PTLs in case of disconnection between WMS and Log Publisher.
- On reconnect, the Log Publisher receives the current PTL statuses, including any Confirmed PTLs.
- Creating a new PTL for the same source–target combination overwrites the old PTL.
Compartment Definition
The Pick-To-Light API uses compartment numbering as follows:
- Compartment Type: Code identifying size and shape of a compartment.
- Compartment ID: Identifies both the size/shape and the compartment's location inside the bin.

Compartment types.
Compartment ID Calculation
| Compartment Type | Compartment ID |
|---|---|
| Types 1–8 | (compartment type × 10) + index |
| Types 9–13 | (compartment type × 100) + index |
- Indexing starts in the top-left (north-west) corner and moves left to right (west to east) across each row.
Mapping
See the complete mapping overview below:

Compartment ID overview.
FusionPort™ Support
- Supported compartment types: 1, 2, 4, 5, 7, 8, 13
- Manages port orientation (North vs. South)
NOTE:Compartment ID 71 == 1301 and 74 == 1303 physically.
Updated 2 months ago