Reservations

In the Lochting software, a reservation is a collection of products set aside for pickup by a customer.

Reservations can be fulfilled through two devices:

• MT.Matic — products are reserved in the dispensing robot and collected through the MT.Matic vending machine.
• MT.Collect — products are reserved in a parcel locker and collected through the MT.Collect parcel locker.

Each reservation is assigned a pickup code. The customer provides this code at the MT.Matic or MT.Collect to retrieve their products.

Through the API you can create, retrieve, update, and list reservations, request delivery, and retrieve QR codes and overbox barcodes (overBoxBarCodes).

📄️ New Vending Machine Reservation (legacy path)

Legacy alias for [New Vending Machine Reservation](/api/new-vending-machine-reservation). Creates a vending machine reservation for a given order. Prefer `/reservation/vendingMachine/create` for new integrations.

📄️ New Reservation

This endpoint allows you to create a new reservation for an order.

📄️ New Vending Machine Reservation

This endpoint allows you to create a new vending machine reservation for a given order.

📄️ New Locker Reservation

This endpoint allows you to create a new locker reservation for a given order.

📄️ Reservation Details

This endpoint returns a JSON object with the reservation details.

📄️ Update Reservation Details

This endpoint allows you to update a reservation.

📄️ Reservation Collection

This endpoint returns a JSON object with reservations.

📄️ Request Delivery

This endpoint allows you to trigger the delivery process for a specific reservation, specifying the output destination within the MT.Matic system where the reserved products should be delivered.

📄️ Reservation QR Code

This endpoint returns a string containing the base64 encoded representation of a QR code. This QR code can be utilized by customers at the MT.Matic for picking up their reservations, eliminating the need for manual entry of the reservation code.

📄️ Reservation Overbox Barcode

This endpoint returns a string containing the base64 encoded representation of an EAN13 overbox barcode. This barcode can be utilized by pharmacists to put on the overbox to be registered by the robot.

📄️ Reservation Simulation

This endpoint allows you to simulate a reservation status change. It is only available on the DEV and staging environments. It sets the reservation to any valid `ReservationStatus` value without enforcing production transition rules.