e-guma in aico POS

FunktionenFunctions

Was die Integration kannWhat the integration does

Alles, was an der Kasse mit einem e-guma-Gutschein passiert, vom Verkauf bis zur Rückerstattung.Everything that happens to an e-guma voucher at the till, from the sale to the refund.

EinrichtungSetup

API-Schlüssel von e-guma in aiconeo, bei Bedarf pro Filiale. Dazu ein Gutschein-Artikel und eine Zahlungsmethode.The e-guma API key in aiconeo, per store if needed, plus one voucher article and one payment method.

Depotgutscheine verkaufenSelling depot vouchers

Code scannen, Betrag eingeben, kassieren. aico aktiviert den Gutschein bei e-guma, sobald der Verkauf gebucht ist.Scan the code, enter the amount, take the payment. aico activates the voucher at e-guma once the sale is booked.

Guthaben prüfenChecking the balance

«Saldo» im Menü der Kasse zeigt das Guthaben jedes e-guma-Gutscheins, auch wenn er anderswo verkauft wurde.“Balance” in the till's menu shows the balance of any e-guma voucher, wherever it was sold.

AufladenTopping up

Ein Gutschein in Gebrauch wird mit demselben Artikel aufgeladen. Die Kasse erkennt das selbst am Code.A voucher in use is topped up with the same article. The till recognises it from the code.

Mit Gutschein bezahlenPaying with a voucher

Eigene Zahlungsmethode: ganzer Betrag oder Teilzahlung, eingelöst noch während der Zahlung.A payment method of its own: all of the amount or part of it, redeemed while the payment is taken.

RückerstattungenRefunds

Zahlung zurück auf den Gutschein, Aufladung storniert, verkaufter Gutschein deaktiviert und wieder verkaufbar.A payment back onto the voucher, a top-up cancelled, a sold voucher deactivated and sellable again.

AblaufHow it works

So arbeitet die IntegrationHow the integration works

Die Kasse spricht nie direkt mit e-guma. Jeder Aufruf geht über die aico Plattform, die den Schlüssel hält und jede Operation festhält.The till never talks to e-guma directly. Every call goes through the aico platform, which holds the key and records every operation.

aico POSaico POSScannt den Code, zeigt das Guthaben, kassiertScans the code, shows the balance, takes the payment

aico Plattformaico platformServer mit dem API-Schlüssel, aiconeo zeigt jede OperationServer holding the API key, aiconeo shows every operation

e-guma-APIe-guma APIAktivieren, Aufladen, Einlösen, Saldo, StornierenActivate, top up, redeem, balance, cancel

e-guma-Backofficee-guma back officeGuthaben, Bestellungen, Top-ups, Redemptions, ProtokollBalance, orders, top-ups, redemptions, protocol

Sofort, während die Kundin wartetAt once, while the customer waits

Prüfen, Saldo, Einlösen und die Stornierung vor einer Auszahlung. Die Kasse fragt über den aico-Server; der API-Schlüssel bleibt dort und liegt nie auf der Kasse.Check, balance, redeem, and cancelling before any payout. The till asks through the aico server; the API key stays there and never sits on the till.

Im Hintergrund, nach der BuchungIn the background, after booking

Aktivieren und Aufladen laufen, sobald der Verkauf gebucht ist, und werden bei einem Ausfall wiederholt.Activation and top-up run once the sale is booked, and are retried after an outage.

Nachvollziehbar auf beiden SeitenTraceable on both sides

In aiconeo hat jede Bestellung den Tab «Gutscheine» mit allen e-guma-Operationen. Im e-guma-Backoffice erscheint jeder Schritt beim Gutschein.In aiconeo every order has a “Gift cards” tab with all its e-guma operations. In the e-guma back office every step shows on the voucher.

FunktionFunction	An der KasseAt the till	e-guma-APIe-guma API	Im e-guma-BackofficeIn the e-guma back office
Depotgutschein verkaufenSell a depot voucher	Code scannen, Prüfen, Betrag, kassierenScan the code, Check, amount, take the payment	`activate_status` beim Prüfen `activate` nach der Buchung`activate_status` on Check `activate` after booking	Gutschein einlösbar, Guthaben = Betrag, Bestellung von aicoVoucher redeemable, balance = amount, an order by aico
Guthaben prüfenCheck the balance	Saldo im Menü, Code scannenBalance in the menu, scan the code	`balancebalance`	Nichts, Saldo liest nurNothing, Balance only reads
Gutschein aufladenTop up a voucher	Gutschein-Artikel, Code, Prüfen erkennt «in Gebrauch», Aufladebetrag, kassierenVoucher article, code, Check finds it in use, top-up amount, take the payment	`charge_status` beim Prüfen `charge` nach der Buchung`charge_status` on Check `charge` after booking	Guthaben höher, Zeile unter Top-ups, ProtokolleintragHigher balance, a row under Top-ups, a protocol entry
Mit Gutschein bezahlenPay with a voucher	Zahlungsmethode e-guma, Code, Prüfen zeigt das Guthaben, Betrag (leer = alles), bezahlene-guma payment method, code, Check shows the balance, amount (empty = all), pay	`balance` beim Prüfen `redeem` sofort, Referenz `aico-pos-…balance` on Check `redeem` at once, reference `aico-pos-…`	Guthaben tiefer, Zeile unter Redemptions mit der Referenz der Kasse, ProtokolleintragLower balance, a row under Redemptions with the till's reference, a protocol entry
Gutscheinzahlung zurückerstattenRefund a voucher payment	Beleg, Rückerstattung, ursprüngliche ZahlungsmethodeReceipt, Refund, original payment method	`cancel_redemption` auf die ursprüngliche Einlösung`cancel_redemption` on the original redemption	Einlösung «Canceled», Gegenbuchung «Refund … at the till», ProtokolleintragRedemption “Canceled”, a counter row “Refund … at the till”, a protocol entry
Aufladung zurückerstattenRefund a top-up	Beleg, Rückerstattung, z. B. barReceipt, Refund, e.g. in cash	`cancel_charge` vor der Auszahlung`cancel_charge` before paying out	Guthaben tiefer, Aufladung «Storniert», ProtokolleintragLower balance, top-up “Storniert”, a protocol entry
Gutscheinverkauf zurückerstattenRefund a voucher sale	Beleg, Rückerstattung, z. B. barReceipt, Refund, e.g. in cash	`deactivate_status`, `deactivate` vor der Auszahlung`deactivate_status`, `deactivate` before paying out	Verkauf entfernt; der Depotgutschein ist wieder unverkauft (Guthaben 0) und neu verkaufbarThe sale is removed; the depot voucher is unsold again (balance 0) and can be sold anew

VideosVideos

Jede Funktion im VideoEvery function on video

Sieben kurze Filme, zusammen 5:51 Minuten. Jeder zeigt die Kasse und danach dieselbe Änderung im e-guma-Backoffice.Seven short films, 5:29 minutes in all. Each shows the till, then the same change in the e-guma back office.

e-guma-Gutscheine einrichtenSetting up e-guma vouchers

e-guma ist das Gutscheinsystem, das viele Hotels, Restaurants und Läden bereits nutzen. aico verbindet sich damit über den API-Schlüssel, den e-guma dem Geschäft gibt. Die Kasse verkauft und lädt dann e-guma-Gutscheine auf, nimmt sie als Zahlung an, prüft ihr Guthaben und erstattet alles zurück; jeder Schritt wird bei e-guma gebucht und ist im Backoffice sofort sichtbar.e-guma is the voucher system many hotels, restaurants and shops already run. aico connects to it with the API key e-guma gives the shop. The till then sells and tops up e-guma vouchers, takes them as payment, checks their balance and refunds all of it, and every step is booked at e-guma, where the back office shows it right away.

In aiconeo einrichtenSet it up in aiconeo

Integrationen → e-guma: den API-Schlüssel von e-guma als Standardschlüssel erfassen und Prüfen tippen. Der Schlüssel funktioniert bestätigt ihn. Danach werden nur noch seine letzten vier Zeichen angezeigt.
Hat e-guma einer Filiale einen eigenen Schlüssel gegeben, wird er darunter unter API-Schlüssel hinzufügen für diese Filiale erfasst.
Produkte: ein Artikel verkauft die Gutscheine (hier e-guma Gutschein). Unter Flags Ist e-guma Depotgutschein einschalten: deshalb fragt die Kasse nach dem Code. Unter Buchhaltung eine Steuerklasse mit 0 % wählen (hier Export / Befreit): ein Gutschein ist beim Verkauf kein Umsatz.
POS Einstellungen → Zahlungsmethoden: damit die Kasse e-guma-Gutscheine als Zahlung annimmt, eine Zahlungsmethode vom Typ e-guma-Gutschein anlegen (hier e-guma Gutschein).

Integrations → e-guma: enter the API key from e-guma as the Default key and tap Verify. The key works confirms it. Afterwards only its last four characters are shown.
A store that e-guma gave a key of its own gets it below, under Add API key, for that store.
Products: one article sells the vouchers (here e-guma Gutschein). Under Flags, switch on Is e-guma depot voucher: that is what makes the till ask for the code. Under Accounting, give it a tax class of 0 % (here Export / exempt): a voucher is not turnover when it is sold.
POS Settings → Payment Methods: to take e-guma vouchers as payment, add a payment method of the type e-guma voucher (here e-guma Gutschein).

An der KasseAt the till

Der Gutschein-Artikel verkauft einen neuen Gutschein oder lädt einen auf, der schon in Gebrauch ist: welches von beiden, fragt die Kasse anhand des Codes bei e-guma nach.
Saldo, im Menü, zeigt das Guthaben eines beliebigen e-guma-Gutscheins.

The voucher article sells a new voucher, or tops up one that is already in use: the till asks e-guma which, from the code.
Balance, in the menu, shows what is left on any e-guma voucher.

ErgebnisResult

Jeder Verkauf, jede Aufladung, Zahlung und Rückerstattung wird von aico bei e-guma gebucht und erscheint im e-guma-Backoffice.
In aiconeo listet Aico Bestellungen → Bestellung → Gutscheine jeden Schritt, den aico bei e-guma für diese Bestellung ausgeführt hat.

Every sale, top-up, payment and refund is booked at e-guma by aico and appears in the e-guma back office.
In aiconeo, Aico Orders → order → Gift cards lists every step aico took at e-guma for that order.

HinweiseNotes

Saldo erscheint im Menü, sobald der Workspace einen aktiven e-guma-Schlüssel hat, ab Kassenversion 6.5.8, und nie auf einem Selbstbedienungs-Kiosk. Es lässt sich unter POS Einstellungen → Sidebar-Seiten ausblenden.
e-guma-Gutscheine werden nur an der bedienten Kasse verkauft, nicht am Selbstbedienungs-Kiosk.
Jede Gutscheinaktion fragt bei e-guma nach; die Kasse muss dafür online sein.

Balance appears in the menu once the workspace has an active e-guma key, from till version 6.5.8, and never on a self-service kiosk. It can be hidden under POS Settings → Sidebar Pages.
e-guma vouchers are sold at the staffed checkout only, not at a self-service kiosk.
Every voucher action asks e-guma, so the till must be online for it.

e-guma-Gutschein verkaufenSelling an e-guma voucher

Depotgutscheine sind vorgedruckte e-guma-Gutscheinkarten, die an der Kasse liegen. Zum Verkauf den Code scannen, den Betrag eingeben und wie gewohnt kassieren. Sobald der Verkauf gebucht ist, aktiviert aico den Gutschein bei e-guma, mit diesem Betrag darauf.Depot vouchers are pre-printed e-guma voucher cards kept at the till. To sell one, scan its code, enter the amount and take the payment as usual. As soon as the sale is booked, aico activates the voucher at e-guma, with that amount on it.

VoraussetzungBefore you start

Gutschein-Artikel und e-guma-Schlüssel sind eingerichtet: siehe e-guma-Gutscheine einrichten.

The voucher article and the e-guma key are set up: see Setting up e-guma vouchers.

An der KasseAt the till

Auf den Gutschein-Artikel tippen (hier e-guma Gutschein). e-guma-Gutschein verkaufen öffnet sich.
Den QR-Code auf dem Gutschein scannen, oder Gutscheincode tippen und ihn eingeben, dann Prüfen. e-guma antwortet Gutschein … kann verkauft werden.
Den Betrag (CHF) eingeben und In den Warenkorb tippen. Ein Gutscheintyp mit festem Wert zeigt seinen Wert statt eines Betragsfelds.
Der Gutschein ist eine Position ohne Mehrwertsteuer. Wie gewohnt kassieren, hier Bezahlen, Exakt, Bezahlen in bar.

Tap the voucher article (here e-guma Gutschein). Sell e-guma voucher opens.
Scan the QR code on the voucher, or tap Voucher code and type it, then Check. e-guma answers Voucher … can be sold.
Enter the Amount (CHF) and tap Add to cart. A voucher type with a fixed value shows its Voucher value instead of an amount field.
The voucher is a line without VAT. Take the payment as usual, here Pay, Exact, Pay in cash.

ErgebnisResult

aico aktiviert den Gutschein bei e-guma, sobald der Verkauf gebucht ist. Im e-guma-Backoffice ist der Gutschein Redeemable (einlösbar), mit dem Betrag als Balance, aus einer heutigen Bestellung von aico.
In aiconeo zeigt Aico Bestellungen → Bestellung → Gutscheine die Aktivierung mit ihrem Status (Erfolgreich), dem Code, dem Betrag und der Kasse.

aico activates the voucher at e-guma once the sale is booked. In the e-guma back office the voucher is Redeemable, with the amount as Balance, from an order made today by aico.
In aiconeo, Aico Orders → order → Gift cards shows the Activation with its status (Succeeded), the code, the amount and the till.

HinweiseNotes

Einen Code, den e-guma als bereits in Gebrauch kennt, verkauft die Kasse nicht nochmals: sie bietet stattdessen eine Aufladung an.
Antwortet e-guma nicht, zeigt der Tab Gutscheine der Bestellung die Versuche und den letzten Fehler.

A code that e-guma knows as already in use is not sold again: the till offers a top-up instead.
If e-guma does not answer, the order's Gift cards tab shows the attempts and the last error.

Guthaben eines e-guma-Gutscheins prüfenChecking an e-guma voucher's balance

Saldo, im Menü der Kasse, fragt e-guma, was auf einem beliebigen e-guma-Gutschein noch drauf ist: einem an dieser Kasse verkauften, einem aus einem anderen Geschäft oder einem aus dem e-guma-Backoffice. Der Film stellt einen Gutschein im Backoffice aus und prüft ihn an der Kasse.Balance, in the till's menu, asks e-guma what is left on any e-guma voucher: one sold at this till, at another shop, or in the e-guma back office. The film issues a voucher in the back office and checks it at the till.

Im e-guma-BackofficeIn the e-guma back office

Gutscheine lassen sich auch direkt in e-guma verkaufen: Vouchers → Issue voucher, Gutscheintyp wählen, Betrag, Add to Cart, Proceed to checkout, Kunde, Zahlung (hier Cash) und Order.
Die Seite des Gutscheins zeigt seinen Code und seine Balance (Guthaben).

Vouchers can also be sold directly in e-guma: Vouchers → Issue voucher, pick the voucher type, the amount, Add to Cart, Proceed to checkout, the customer, the payment (here Cash) and Order.
The voucher's page shows its Code and Balance.

An der KasseAt the till

Im Menü auf Saldo tippen. Gutscheinguthaben öffnet sich.
Den Gutschein scannen, oder Gutscheincode tippen und ihn eingeben, dann Prüfen.
Der Dialog zeigt Gutschein … ist einlösbar., sein Guthaben und den Gesamtbetrag. Schliessen.

Tap Balance in the menu. Voucher balance opens.
Scan the voucher, or tap Voucher code and type it, then Check.
The dialog shows Voucher … can be redeemed., its Balance and the Total amount. Close.

ErgebnisResult

Die Kasse zeigt dasselbe Guthaben wie das e-guma-Backoffice. Gebucht wird nichts: Saldo liest nur.

The till shows the same balance as the e-guma back office. Nothing is booked: Balance only reads.

HinweiseNotes

Saldo steht nur im Menü, solange ein e-guma-Schlüssel aktiv ist, ab Kassenversion 6.5.8, und nicht auf einem Selbstbedienungs-Kiosk.
Einen Code, den e-guma nicht kennt, beantwortet die Kasse mit einer Meldung, den Code zu prüfen.

Balance is only in the menu while an e-guma key is active, from till version 6.5.8, and not on a self-service kiosk.
A code e-guma does not know answers e-guma does not know this voucher. Check the code.

e-guma-Gutschein aufladenTopping up an e-guma voucher

Ein Gutschein, der schon in Gebrauch ist, lässt sich an der Kasse mit demselben Gutschein-Artikel aufladen: die Kasse erkennt den Code, die Kundin bezahlt die Aufladung, und aico bucht den Betrag bei e-guma auf den Gutschein.A voucher already in use can be topped up at the till with the same voucher article: the till recognises the code, the customer pays the top-up, and aico adds the amount to the voucher at e-guma.

An der KasseAt the till

Auf den Gutschein-Artikel tippen (hier e-guma Gutschein), den Code scannen oder eingeben und Prüfen.
Bei einem Gutschein in Gebrauch wird daraus e-guma-Gutschein aufladen: Gutschein … ist bereits in Gebrauch (Guthaben …) und kann aufgeladen werden.
Den Aufladebetrag (CHF) eingeben und Aufladung in den Warenkorb tippen. Die Position im Warenkorb trägt das Abzeichen Aufladung.
Wie gewohnt kassieren, hier bar.

Tap the voucher article (here e-guma Gutschein), scan or type the code and Check.
For a voucher in use the dialog becomes Top up e-guma voucher: Voucher … is already in use (balance …) and can be topped up.
Enter the Top-up amount (CHF) and tap Add top-up to cart. The cart line carries the Top-up badge.
Take the payment as usual, here in cash.

ErgebnisResult

Sobald der Verkauf gebucht ist, lädt aico den Gutschein bei e-guma auf. Im Backoffice wächst seine Balance, die Aufladung steht unter Top-ups mit ihrer Bestellung, und das Voucher protocol hält sie fest.
In aiconeo zeigt der Tab Gutscheine der Bestellung die Aufladung.

Once the sale is booked, aico tops the voucher up at e-guma. In the back office its Balance grows, the top-up is listed under Top-ups with its order, and the Voucher protocol records it.
In aiconeo, the order's Gift cards tab shows the Top-up.

HinweiseNotes

Gratisguthaben bei einer Aufladung wird in e-guma pro Gutscheintyp eingerichtet; aico bucht, was e-guma dazugibt.

Free credit on a top-up is set up in e-guma, per voucher type; aico books whatever e-guma adds.

Mit e-guma-Gutschein bezahlenPaying with an e-guma voucher

Eine Kundin bezahlt mit einem e-guma-Gutschein über die e-guma-Zahlungsmethode: die Kasse prüft den Gutschein, zeigt sein Guthaben, und e-guma bucht den Betrag vom Gutschein ab, bevor der Verkauf abgeschlossen wird.A customer pays with an e-guma voucher through the e-guma payment method: the till checks the voucher, shows its balance, and e-guma takes the amount off the voucher before the sale closes.

VoraussetzungBefore you start

Eine Zahlungsmethode vom Typ e-guma-Gutschein besteht: siehe e-guma-Gutscheine einrichten.

A payment method of the type e-guma voucher exists: see Setting up e-guma vouchers.

An der KasseAt the till

Bezahlen, dann die Zahlungsmethode e-guma Gutschein wählen. Mit e-guma-Gutschein bezahlen öffnet sich.
Den Code scannen oder eingeben und Prüfen: Gutschein …: Guthaben CHF ….
Betrag leer lassen, um den ganzen offenen Betrag zu zahlen, oder weniger eingeben, um einen Teil mit dem Gutschein und den Rest anders zu zahlen.
CHF … bezahlen tippen.

Pay, then choose the payment method e-guma Gutschein. Pay with e-guma voucher opens.
Scan or type the code and Check: Voucher …: balance CHF ….
Leave Amount empty to pay the whole amount due, or enter less to pay part with the voucher and take the rest another way.
Tap Pay CHF ….

ErgebnisResult

e-guma bucht den Betrag sofort vom Gutschein ab. Im Backoffice ist die Balance tiefer, die Zahlung steht unter Redemptions mit der Referenz der Kasse (aico-pos-…), und das Protokoll hält sie fest.

e-guma takes the amount off the voucher at once. In the back office the Balance is lower, the payment is listed under Redemptions with the till's reference (aico-pos-…), and the protocol records it.

HinweiseNotes

Bestätigt e-guma eine Zahlung nicht, meldet die Kasse das und bietet Erneut prüfen an: in der Zwischenzeit keine andere Zahlung für denselben Betrag annehmen.
Der Gutschein zahlt höchstens sein Guthaben; der Rest des Verkaufs wird anders bezahlt.

If e-guma does not confirm a payment, the till says so and offers Check again: do not take another payment for the same amount meanwhile.
The voucher can pay at most its balance; the rest of the sale is paid another way.

Gutscheinverkauf oder Aufladung zurückerstattenRefunding a voucher sale or top-up

Eine Aufladung oder der Verkauf eines nie benutzten Gutscheins wird über den Beleg zurückerstattet. Vor der Auszahlung nimmt aico das Geld bei e-guma wieder vom Gutschein: eine Aufladung wird storniert, ein verkaufter Gutschein deaktiviert und wieder zum unverkauften Depotgutschein.A top-up, or the sale of a voucher that was never used, is refunded from its receipt. Before paying out, aico takes the money back off the voucher at e-guma: a top-up is cancelled, a sold voucher is deactivated and becomes an unsold depot voucher again.

An der KasseAt the till

Belege, den Beleg suchen (die Suche nimmt die Belegnummer), Rückerstattung.
Die Position Auswählen, Weiter.
Das Geld geht zurück, wie es bezahlt wurde (hier Ursprüngliche Zahlungsmethode, bar). Rückerstattung durchführen.

Receipts, find the receipt (the search takes the receipt number), Refund.
Select the line, Next.
The money goes back the way it was paid (here Original payment method, cash). Trigger refund.

ErgebnisResult

Eine Aufladung: die Balance des Gutscheins im e-guma-Backoffice sinkt um die Aufladung, die unter Top-ups als Storniert markiert ist.
Ein Gutscheinverkauf: der Verkauf ist bei e-guma weg. Die Suche nach dem Code im Backoffice zeigt den unverkauften Depotgutschein mit einem Guthaben von 0.00; die Karte kann wieder verkauft werden.

A top-up: the voucher's Balance in the e-guma back office drops by the top-up, which is marked Storniert under Top-ups.
A voucher sale: the sale is gone at e-guma. Searching the code in the back office shows the unsold depot voucher with a balance of 0.00; the card can be sold again.

HinweiseNotes

Eine Aufladung lässt sich nur zurückerstatten, solange ihr Geld noch auf dem Gutschein ist. Ist ein Teil davon ausgegeben, lehnt die Kasse ab; das ist endgültig.
Ein verkaufter Gutschein, der schon benutzt wurde, lässt sich nicht mehr stornieren.

A top-up can only be refunded while its money is still on the voucher. Once part of it is spent, the till refuses: This top-up has already been spent… This is final.
A sold voucher that has already been used can no longer be cancelled.

RegelnRules

Regeln und SonderfälleRules and edge cases

Was die Integration garantiert, und wo ihre Grenzen liegen.What the integration guarantees, and where its limits are.

Kein Geld ohne StornierungNo money before the cancellation

Bei der Rückerstattung eines Verkaufs oder einer Aufladung storniert aico zuerst bei e-guma. Erst danach verlässt Geld die Kasse.For the refund of a sale or a top-up, aico cancels at e-guma first. Only then does money leave the till.

Einlösung bei der ZahlungRedeemed when paying

Der Gutschein wird während der Zahlung eingelöst, nicht erst bei der Buchung. Ein inzwischen anderswo ausgegebener Gutschein kann so keinen Verkauf bezahlen.The voucher is redeemed while the payment is taken, not when the sale is booked, so a voucher spent elsewhere in the meantime cannot pay for a sale.

Ausfälle werden geklärtOutages are settled

Aktivierung und Aufladung werden wiederholt. Was sich nicht automatisch klären lässt, etwa eine verlorene Antwort, schliesst ein Admin in aiconeo bei der Bestellung von Hand ab.Activation and top-up are retried. What cannot be settled automatically, such as a lost answer, an admin settles by hand on the order in aiconeo.

Warten nach cancel_redemptionWaiting after cancel_redemption

Nach einer Stornierung wartet aico, bis das Guthaben sie bestätigt, bevor eine weitere Schreiboperation auf denselben Gutschein folgt, wie von e-guma empfohlen.After a cancellation, aico waits until the balance confirms it before any further write to the same voucher, as e-guma recommends.

Grenzen der RückerstattungRefund limits

Eine Aufladung lässt sich nur zurückerstatten, solange ihr Betrag noch auf dem Gutschein ist. Ein benutzter verkaufter Gutschein lässt sich nicht mehr deaktivieren.A top-up can only be refunded while its amount is still on the voucher. A sold voucher that has been used can no longer be deactivated.

API-Schlüssel und GratisguthabenAPI keys and free credit

Ein Standardschlüssel pro aico-Workspace; Filialen mit eigenem e-guma-Schlüssel erhalten ihn separat. Gratisguthaben übernimmt aico so, wie e-guma es meldet.One default key per aico workspace; stores with an e-guma key of their own get it separately. aico takes free credit as e-guma reports it.

Bediente Kasse, onlineStaffed till, online

Gutscheine werden an der bedienten Kasse verkauft, nicht am Self-Checkout. Jede Gutscheinaktion fragt e-guma; die Kasse muss dafür online sein. Codes per QR-Scan oder von Hand, mit oder ohne Bindestriche.Vouchers are sold at the staffed till, not at self-checkout. Every voucher action asks e-guma, so the till must be online. Codes are scanned from the QR code or typed, with or without dashes.

Aktivierung im BackofficeActivation in the back office

Eine Aktivierung über die API erscheint nicht im Gutscheinprotokoll, sondern als Bestellung von aico (Order number, Created by aico). Aufladung, Einlösung und ihre Stornierungen stehen im Protokoll.An activation through the API does not appear in the voucher protocol but as an order made by aico (order number, created by aico). Top-ups, redemptions and their cancellations are in the protocol.

e-guma-Gutscheine in aico POSe-guma vouchers in aico POS

Was die Integration kannWhat the integration does

EinrichtungSetup

Depotgutscheine verkaufenSelling depot vouchers

Guthaben prüfenChecking the balance

AufladenTopping up

Mit Gutschein bezahlenPaying with a voucher

RückerstattungenRefunds

So arbeitet die IntegrationHow the integration works

Sofort, während die Kundin wartetAt once, while the customer waits

Im Hintergrund, nach der BuchungIn the background, after booking

Nachvollziehbar auf beiden SeitenTraceable on both sides

Jede Funktion im VideoEvery function on video

e-guma-Gutscheine einrichtenSetting up e-guma vouchers

In aiconeo einrichtenSet it up in aiconeo

An der KasseAt the till

ErgebnisResult

HinweiseNotes

e-guma-Gutschein verkaufenSelling an e-guma voucher

VoraussetzungBefore you start

An der KasseAt the till

ErgebnisResult

HinweiseNotes

Guthaben eines e-guma-Gutscheins prüfenChecking an e-guma voucher's balance

Im e-guma-BackofficeIn the e-guma back office

An der KasseAt the till

ErgebnisResult

HinweiseNotes

e-guma-Gutschein aufladenTopping up an e-guma voucher

An der KasseAt the till

ErgebnisResult

HinweiseNotes

Mit e-guma-Gutschein bezahlenPaying with an e-guma voucher

VoraussetzungBefore you start

An der KasseAt the till

ErgebnisResult

HinweiseNotes

Gutscheinzahlung zurückerstattenRefunding a voucher payment

An der KasseAt the till

ErgebnisResult

HinweiseNotes

Gutscheinverkauf oder Aufladung zurückerstattenRefunding a voucher sale or top-up

An der KasseAt the till

ErgebnisResult

HinweiseNotes

Regeln und SonderfälleRules and edge cases

Kein Geld ohne StornierungNo money before the cancellation

Einlösung bei der ZahlungRedeemed when paying

Ausfälle werden geklärtOutages are settled

Warten nach cancel_redemptionWaiting after cancel_redemption

Grenzen der RückerstattungRefund limits

API-Schlüssel und GratisguthabenAPI keys and free credit

Bediente Kasse, onlineStaffed till, online

Aktivierung im BackofficeActivation in the back office

Entwickelt und getestet von aicoBuilt and tested by aico