HomeInterfacesRecipesChangelogFAQ
Log In
Interfaces

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 OPEN in 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 closebin instead.
  • 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.
  • hidepicktolight can 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 types.


Compartment ID Calculation

Compartment TypeCompartment 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.

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.