Hilfe - Produkte & Funktionen
German English
German English

Dirmeier smartSCHANK Dispenser

This article explains which parameters a Dirmeier dispenser with smartSCHANK requires for a connection to a bessa product. bessa implements the DIRMEIER smartschank – REST API for Cash Interface (version 1.0). The connection runs over the network only.

Prerequisites

  • The dispenser is equipped with smartSCHANK and provides the cash REST interface on the local network.

  • The dispenser has a static IP from the local network or a reserved DHCP lease.

  • The Sales Point and the dispenser are on the same network, or the networks are routed. The Sales Point has to reach the dispenser on TCP port 80.

  • The dispenser is not in configuration mode. In that mode it pauses the interface, see Paused dispenser.

  • A dispenser profile exists in the bessa Manager, populated with the article PLUs and user numbers of the dispenser. The entry is only present if the dispenser module was ordered from bessa beforehand. See Dispensers.

Some Dirmeier units also support the E protocol and VMPS. Dirmeier advises against the serial connection and against VMPS over UDP and recommends the REST interface. Use smartSCHANK whenever the unit offers it.

Parameters

smartSCHANK runs on the Network connection type only. The values are entered in the respective bessa product — on the Sales Point under Dispenser Settings.

Field

Meaning

Value

Connection type

Type of connection

Network

Protocol

POS protocol

smartSCHANK REST

IP address

Static IP of the dispenser

e.g. 192.168.0.70

Port

HTTP port of the cash interface

80 (prefilled)

There are no further fields. Digit settings and a checksum switch as used by the E protocol do not apply, because smartSCHANK transmits all payload data as JSON. No pairing on the display is needed as with the Brau Union Z1U: the interface works without sign-in.

Communication runs over unencrypted HTTP within the local network. Dirmeier's cloud variant with HTTPS and credentials is not supported.

Checking reachability

Test & Save in the dispenser settings requests the list of open dispenses from the dispenser. This request changes nothing on the unit. If the dispenser is unreachable or paused, the Sales Point shows an error and does not save the setting.

To diagnose without a Sales Point, open http://<IP address>/cash/1.0/credits in a browser on the same network, or http://<IP address>:<port>/cash/1.0/credits for a different port. A reachable dispenser answers with a list of the open credits, or with status 410 if there are none. If the page gets no answer, the dispenser cannot be reached from this network.

What the Sales Point sends to the dispenser

With smartSCHANK, the Sales Point works in credit mode: every dispenser article that is booked is released on the dispenser and can be poured afterwards.

  • Article PLU and quantity — from the article assignment of the dispenser profile.

  • User number — from the user assignment of the dispenser profile. Waiters sign in on the dispenser itself with their PIN. Whether a credit can only be poured by the waiter with the same number depends on the dispenser's configuration.

  • Article name — the name of the item, so the credit is readable on the dispenser's display.

  • Table number — only for orders on a table. For counter, room, kiosk and online orders it stays empty.

A void on the Sales Point reduces the credit on the dispenser by the voided quantity. If the credit has already been poured, the dispenser can no longer reduce it: the Sales Point reports this, and the void is still booked on the Sales Point.

Reset credit in the menu of the dispenser detail view books back all open credits on the dispenser. This is useful after test bookings or when the Sales Point and the dispenser have drifted apart.

Drinks poured without a credit from the Sales Point are not picked up by the Sales Point. Debit mode, where pouring on the dispenser automatically triggers a booking on the Sales Point, is not available for smartSCHANK.

Paused dispenser

While the dispenser is in configuration mode, it pauses the cash interface. On the Sales Point this has the following effect:

  • Test & Save fails. The setting is not saved.

  • A credit does not reach the dispenser. The Sales Point reports that the articles could not be transferred to the dispenser and names them. The booking on the Sales Point remains.

Leave configuration mode on the dispenser before setting up the connection or starting operation.

FAQ

Can a smartSCHANK be connected serially? Not with the smartSCHANK REST protocol — it is available for the Network connection type only.

Do I have to change the port? Only if the cash interface on the dispenser is set up on a port other than 80. The Dirmeier technician provides the value.

Why is there no table number on the dispenser? The Sales Point only sends the table number for orders on a table. Counter bookings arrive without a table.

Why was a void not deducted on the dispenser? The credit had already been poured. What has been poured can no longer be reduced on the dispenser.

Troubleshooting

  • Test & Save fails — wrong IP address or port, the dispenser is switched off or disconnected, the Sales Point and the dispenser are in separate VLANs without routing, or the dispenser is in configuration mode.

  • The articles could not be transferred to the dispenser — the dispenser was unreachable or paused at the time of booking. Check reachability as described above.

  • A credit appears but cannot be poured — the PLU in the dispenser profile does not match the dispenser, or the dispenser binds credits to the waiter and a different waiter is signed in than the one the credit was sent for.

  • A firewall blocks HTTP — the path from the Sales Point to the dispenser has to allow TCP port 80 (or the port entered).