Degaso Cash Backend API (1.0.0)

Download OpenAPI specification:

Automatisch generierte API-Dokumentation

Auswertungen

Täglichen Kassenwert abrufen

Responses

Response samples

Content type
application/json
{
  • "cashValue": 1250.5
}

Monatlichen Kassenwert abrufen

Responses

Response samples

Content type
application/json
{
  • "cashValue": 35420.75
}

Monatlichen Steuerwert berechnen

Responses

Response samples

Content type
application/json
{
  • "taxValue": "string"
}

Bestellungen

Artikel als "zum Tisch gebracht" markieren

Request Body schema: application/json
required
orderId
required
string

Bestellungs-ID

productUniqueId
required
string

Eindeutige Artikel-ID

Responses

Request samples

Content type
application/json
{
  • "orderId": "order123",
  • "productUniqueId": "art-uuid-123"
}

Tisch einer Bestellung ändern oder Bestellungen zusammenführen

Ändert die Tischnummer einer Bestellung. Falls auf dem Zieltisch bereits eine Bestellung existiert, werden sie zusammengeführt.

Request Body schema: application/json
required
orderId
required
string

ID der zu verschiebenden Bestellung

table
required
string

Ziel-Tischnummer

Responses

Request samples

Content type
application/json
{
  • "orderId": "order123",
  • "table": "7"
}

Bestellung löschen (nur im Kiosk-Modus)

Request Body schema: application/json
required
_id
required
string

ID der zu löschenden Bestellung

payed
boolean

Wurde bereits bezahlt?

Responses

Request samples

Content type
application/json
{
  • "_id": "order123",
  • "payed": false
}

HTML-Formular zur Bestellungsreparatur anzeigen

Responses

Bestellungen mit doppelten UUIDs reparieren

Behebt Bestellungen mit doppelten uniqueOrderArticleIds

Responses

Alle aktiven Bestellungen abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Alle abgeschlossenen Bestellungen abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Alle abgeschlossenen Bestellungen des aktuellen Checkouts abrufen

Request Body schema: application/json
required
checkout
required
number

Checkout-Nummer

Responses

Request samples

Content type
application/json
{
  • "checkout": 42
}

Alle ausstehenden Bestellungen abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Ausstehende Bestellungen abrufen (neuer Pfad)

Responses

Response samples

Content type
application/json
[
  • { }
]

Ausstehende Bestellungen mit Statusfilter abrufen

path Parameters
status
required
string

Responses

Response samples

Content type
application/json
[
  • { }
]

Neue Bestellung erstellen

Erstellt eine neue Bestellung mit den angegebenen Artikeln

Request Body schema: application/json
required
object

Responses

Request samples

Content type
application/json
{ }

Artikel bestellen (neue Bestellung oder zu bestehender hinzufügen)

Request Body schema: application/json
required
orderId
string

ID einer bestehenden Bestellung (optional)

table
string

Tischnummer

required
Array of objects
employee
required
string

Name des Mitarbeiters

dontPrint
boolean

Nicht drucken?

Responses

Request samples

Content type
application/json
{
  • "table": "5",
  • "employee": "Max",
  • "articles": [
    ]
}

Alias für Artikel zu einer Bestellung hinzufügen

Request Body schema: application/json
required
object

Responses

Request samples

Content type
application/json
{ }

Kurz-Bestellung erstellen oder erweitern

Request Body schema: application/json
required
object

Responses

Request samples

Content type
application/json
{ }

Bestellung bezahlen

Request Body schema: application/json
required
orderId
required
string

ID der Bestellung

payedArticels
required
Array of objects

Liste der bezahlten Artikel

total
required
string

Gesamtbetrag

tipValue
string

Trinkgeld

payment
required
string

Zahlungsmethode (BAR, EC, etc.)

isStorno
boolean

Ist es ein Storno?

freeText
string

Freitext für Bon

Responses

Request samples

Content type
application/json
{
  • "orderId": "string",
  • "payedArticels": [
    ],
  • "total": "string",
  • "tipValue": "string",
  • "payment": "string",
  • "isStorno": true,
  • "freeText": "string"
}

Bestellung erneut drucken

Request Body schema: application/json
required
order
required
object

Bestellungsobjekt zum erneuten Drucken

employee
string

Mitarbeiter (optional)

Responses

Request samples

Content type
application/json
{
  • "order": { },
  • "employee": "string"
}

Artikel aus Bestellung entfernen (ohne Storno-Bon)

Nur für Splitting und Verschieben von Artikeln. Druckt keinen Storno-Bon.

Request Body schema: application/json
required
payed
required
boolean

Muss true sein (false ist für Stornos, siehe /stornoItem)

orderId
required
string

Bestellungs-ID

productUniqueId
required
string

Eindeutige Artikel-ID

removeComplete
required
boolean

Komplette Bestellung löschen falls keine Artikel übrig

Responses

Request samples

Content type
application/json
{
  • "payed": true,
  • "orderId": "order123",
  • "productUniqueId": "art-uuid-123",
  • "removeComplete": true
}

Kassenbon erneut drucken

Request Body schema: application/json
required
paymentId
required
string

Payment-ID der bezahlten Bestellung

hospitality
required
boolean

Als Bewirtungsbeleg drucken?

employee
string

Mitarbeiter (optional)

Responses

Request samples

Content type
application/json
Example
{
  • "paymentId": "pay-uuid-123",
  • "hospitality": false,
  • "employee": "Max"
}

Label einer Bestellung setzen

path Parameters
orderId
required
string
Request Body schema: application/json
required
label
required
string

Responses

Request samples

Content type
application/json
{
  • "label": "string"
}

Artikel stornieren

Setzt den Preis eines Artikels auf 0 und druckt einen Storno-Bon

Request Body schema: application/json
required
orderId
required
string

Bestellungs-ID

productUniqueId
string

Eindeutige Artikel-ID (optional, wenn leer werden alle nicht bezahlten Artikel storniert)

employee
required
string

Mitarbeiter der das Storno durchführt

reason
required
string

Storno-Grund

Responses

Request samples

Content type
application/json
Example
{
  • "orderId": "order123",
  • "productUniqueId": "art-uuid-123",
  • "employee": "Max",
  • "reason": "Kunde hat sich umentschieden"
}

Artikelstatus aktualisieren (in Arbeit/Fertig/Zum Tisch gebracht)

Request Body schema: application/json
required
orderId
required
string

Bestellungs-ID

productUniqueId
required
string

Eindeutige Artikel-ID

orderStatus
number

Neuer Status des Artikels

Responses

Request samples

Content type
application/json
{
  • "orderId": "order123",
  • "productUniqueId": "art-uuid-123",
  • "orderStatus": 1
}

Drucken

Mitarbeiterauswertung drucken

Request Body schema: application/json
required
evaluationData
required
object

Auswertungsdaten für den Mitarbeiter

Responses

Request samples

Content type
application/json
{
  • "evaluationData": { }
}

Freitext drucken

Request Body schema: application/json
required
Array
string

Responses

Request samples

Content type
application/json
[
  • "string"
]

Bewirtungsbeleg drucken

Request Body schema: application/json
required
order
required
object

Bestelldaten

employee
string

Mitarbeitername (optional)

Responses

Request samples

Content type
application/json
{
  • "order": { },
  • "employee": "string"
}

Tischbestellung drucken

Request Body schema: application/json
required
order
required
object

Bestellungsobjekt zum Drucken

Responses

Request samples

Content type
application/json
{
  • "order": { }
}

Einstellungen

Kundendaten abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Ansichtskonfiguration abrufen

Ruft die aktuelle Ansichtskonfiguration ab, inklusive Kiosk-Modus, Ordner-Ansicht und verschiedener UI-Optionen

Responses

Response samples

Content type
application/json
{
  • "kioskState": false,
  • "folderView": true,
  • "showExtras": true,
  • "showCourse": true,
  • "showTable": true,
  • "showDivers": true,
  • "showVoucher": true,
  • "groupArticles": false,
  • "usePreorders": false,
  • "scanOnly": false
}

Ansichtskonfiguration setzen

Aktualisiert die Ansichtskonfiguration. Felder können einzeln oder zusammen aktualisiert werden.

Request Body schema: application/json
required
kioskState
boolean

Kiosk-Modus aktiviert (false=Restaurant, true=Kiosk)

folderView
boolean

Ordner-Ansicht aktiviert (true=Ordner, false=Ausklappbar)

showExtras
boolean

Extras-Button in Bestellartikelliste anzeigen

showCourse
boolean

Gang-Auswahl in Bestellung anzeigen

showTable
boolean

Tisch-Auswahl im Kiosk-Modus anzeigen

showDivers
boolean

"Diverses"-Artikel-Button anzeigen

showVoucher
boolean

"Gutschein"-Button anzeigen

groupArticles
boolean

Artikel gruppieren (true=3x Bier, false=Bier Bier Bier)

scanOnly
boolean

Nur-Scan-Modus im SCO-Modus

Responses

Request samples

Content type
application/json
{
  • "kioskState": false,
  • "folderView": true,
  • "showExtras": true,
  • "groupArticles": true
}

Response samples

Content type
application/json
{
  • "kioskState": true,
  • "folderView": true,
  • "showExtras": true,
  • "showCourse": true,
  • "showTable": true,
  • "showDivers": true,
  • "showVoucher": true,
  • "groupArticles": true,
  • "scanOnly": true
}

Gutscheine

Neuen Gutschein erstellen

Request Body schema: application/json
required
objectId
required
string

Objekt-ID für den Gutschein

Responses

Request samples

Content type
application/json
{
  • "objectId": "voucher_basic"
}

Response samples

Content type
application/json
{
  • "success": true,
  • "voucher": { }
}

Gutschein löschen

Request Body schema: application/json
required
id
required
string

Gutschein-Code

Responses

Request samples

Content type
application/json
{
  • "id": "ABC123XYZ"
}

Alle Gutscheine abrufen

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "vouchers": [
    ]
}

Mehrere Gutscheine anhand von IDs abrufen

Request Body schema: application/json
required
objectIds
required
Array of strings

Array von Gutschein-IDs

Responses

Request samples

Content type
application/json
{
  • "objectIds": [
    ]
}

Response samples

Content type
application/json
{
  • "success": true,
  • "vouchers": [
    ]
}

Bestimmten Gutschein abrufen

Request Body schema: application/json
required
voucherKey
required
string

Gutschein-ID oder Code

Responses

Request samples

Content type
application/json
{
  • "voucherKey": "string"
}

Neuen Gutschein erstellen (DEPRECATED) Deprecated

Verwenden Sie stattdessen /vouchers/create und /vouchers/topup

Request Body schema: application/json
required
price
required
number

Gutscheinwert

Responses

Request samples

Content type
application/json
{
  • "price": 0
}

Gutschein auszahlen und löschen

Request Body schema: application/json
required
objectId
required
string

Gutschein-ID

paymentId
required
string

Zahlungs-ID

Responses

Request samples

Content type
application/json
{
  • "objectId": "string",
  • "paymentId": "string"
}

Gutschein aufladen

Request Body schema: application/json
required
objectId
required
string

Gutschein-ID

topupAmount
required
number

Aufladebetrag

paymentId
required
string

Zahlungs-ID

Responses

Request samples

Content type
application/json
{
  • "objectId": "string",
  • "topupAmount": 0,
  • "paymentId": "string"
}

Integrationen::Karte::Adyen

Adyen-Zahlung stornieren

path Parameters
tid
required
string

Terminal-ID des Adyen-Terminals

payid
required
string

Zahlungs-ID der zu stornierenden Zahlung

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "Result": "Success"
}

Adyen-Konfiguration abrufen

Responses

Response samples

Content type
application/json
{
  • "apiKey": "AQE...xyz",
  • "merchant": "MyCompanyPOSGmbH",
  • "testMode": false,
  • "terminals": [
    ]
}

Adyen-Konfiguration setzen

Request Body schema: application/json
required
apiKey
string

Adyen API-Key

merchant
string

Händler-ID

Array of objects

Liste der Terminals

testMode
boolean

Testmodus aktivieren/deaktivieren

Responses

Request samples

Content type
application/json
{
  • "apiKey": "AQE...xyz",
  • "merchant": "MyCompanyPOSGmbH",
  • "testMode": true,
  • "terminals": [
    ]
}

Response samples

Content type
application/json
{
  • "apiKey": "AQE...xyz",
  • "merchant": "MyCompanyPOSGmbH",
  • "testMode": true,
  • "terminals": [
    ]
}

Adyen-Konfiguration von Adyen-API aktualisieren

Ruft die aktuellen Terminals von der Adyen-API ab und aktualisiert die lokale Konfiguration

Responses

Response samples

Content type
application/json
{
  • "apiKey": "AQE...xyz",
  • "merchant": "MyCompanyPOSGmbH",
  • "testMode": false,
  • "terminals": [
    ]
}

Liste aller konfigurierten Adyen-Terminals abrufen

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Verfügbare Adyen-Händlerkonten abrufen

Ruft die Liste der verfügbaren Händlerkonten für den angegebenen API-Key ab

Request Body schema: application/json
optional
apiKey
string

Adyen API-Key (optional, verwendet gespeicherten Key falls nicht angegeben)

Responses

Request samples

Content type
application/json
{
  • "apiKey": "AQE...xyz"
}

Response samples

Content type
application/json
[
  • [
    ],
  • [
    ]
]

Zahlung über Adyen-Terminal initiieren

path Parameters
tid
required
string

Terminal-ID des Adyen-Terminals

Request Body schema: application/json
required
amount
required
number

Zahlungsbetrag

Responses

Request samples

Content type
application/json
{
  • "amount": 42.5
}

Response samples

Content type
application/json
{
  • "success": true,
  • "id": "pay_abc123xyz"
}

Status einer Adyen-Zahlung abrufen

path Parameters
tid
required
string

Terminal-ID des Adyen-Terminals

payid
required
string

Zahlungs-ID

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "Result": "Success",
  • "AdditionalResponse": "authorisationCode=123456"
}

Integrationen::Karte::Mollie

Mollie-Zahlung stornieren

path Parameters
tid
required
string

Terminal-ID des Mollie-Terminals

payid
required
string

Zahlungs-ID der zu stornierenden Zahlung

Responses

Response samples

Content type
application/json
{
  • "id": "tr_abc123xyz",
  • "status": "canceled",
  • "mode": "live",
  • "amount": {
    }
}

Mollie-Konfiguration abrufen

Responses

Response samples

Content type
application/json
{
  • "apiKey": "live_abc123xyz",
  • "terminals": [
    ]
}

Mollie-Konfiguration setzen

Request Body schema: application/json
required
apiKey
string

Mollie API-Key

Array of objects

Responses

Request samples

Content type
application/json
{
  • "apiKey": "live_abc123xyz",
  • "terminals": [
    ]
}

Response samples

Content type
application/json
{
  • "apiKey": "live_abc123xyz",
  • "terminals": [
    ]
}

Mollie-Konfiguration von Mollie-API aktualisieren

Ruft die aktuellen Terminals von der Mollie-API ab und aktualisiert die lokale Konfiguration

Responses

Response samples

Content type
application/json
{
  • "success": true
}

Liste aller konfigurierten Mollie-Terminals abrufen

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Zahlung über Mollie-Terminal initiieren

path Parameters
tid
required
string

Terminal-ID des Mollie-Terminals

Request Body schema: application/json
required
amount
required
string

Zahlungsbetrag als String

reference
string <= 255 characters

Optional Referenz (max. 255 Zeichen)

Responses

Request samples

Content type
application/json
{
  • "amount": "42.50",
  • "reference": "Bestellung #12345"
}

Response samples

Content type
application/json
{
  • "id": "tr_abc123xyz",
  • "mode": "live",
  • "description": "Zahlung",
  • "amount": {
    },
  • "status": "open"
}

Status einer Mollie-Zahlung abrufen

path Parameters
tid
required
string

Terminal-ID des Mollie-Terminals

payid
required
string

Zahlungs-ID

Responses

Response samples

Content type
application/json
{
  • "id": "tr_abc123xyz",
  • "mode": "live",
  • "description": "Zahlung",
  • "amount": {
    },
  • "status": "paid"
}

Integrationen::Karte::myPOS

myPOS-Zahlung stornieren

path Parameters
tid
required
number

Terminal-ID des myPOS-Terminals

ruid
required
string

Eindeutige Anfrage-ID der zu stornierenden Zahlung

Responses

Response samples

Content type
application/json
{
  • "ruid": "req_cancel_xyz789",
  • "status": 0,
  • "status_msg": "OK",
  • "ruid_original": "req_abc123xyz",
  • "ruid_original_status": 0
}

Lokale myPOS-Konfiguration abrufen

Ruft die aktuelle lokale myPOS-Konfiguration ab

Responses

Response samples

Content type
application/json
{
  • "enabled": true,
  • "mail": "shop@example.com",
  • "testMode": false,
  • "terminals": [
    ]
}

myPOS-Konfiguration von Cloud abrufen

Ruft die myPOS-Konfiguration vom Cloud-Service ab und speichert sie optional lokal

Request Body schema: application/json
required
storeConfig
boolean

Konfiguration lokal speichern

Responses

Request samples

Content type
application/json
{
  • "storeConfig": true
}

Response samples

Content type
application/json
{
  • "enabled": true,
  • "mail": "shop@example.com",
  • "terminals": [
    ]
}

Liste aller konfigurierten myPOS-Terminals abrufen

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Zahlung über myPOS-Terminal initiieren

path Parameters
tid
required
number

Terminal-ID des myPOS-Terminals

Request Body schema: application/json
required
amount
required
string

Zahlungsbetrag als String

reference
string <= 50 characters

Optional Referenz (max. 50 Zeichen)

Responses

Request samples

Content type
application/json
{
  • "amount": "42.50",
  • "reference": "Bestellung #12345"
}

Response samples

Content type
application/json
{
  • "ruid": "req_abc123xyz",
  • "status": 0,
  • "status_msg": "OK"
}

Status einer myPOS-Zahlung abrufen

path Parameters
tid
required
number

Terminal-ID des myPOS-Terminals

ruid
required
string

Eindeutige Anfrage-ID

Responses

Response samples

Content type
application/json
{
  • "ruid": "req_abc123xyz",
  • "status": 0,
  • "status_msg": "OK",
  • "amount": "42.50",
  • "response_code": "00",
  • "auth_code": "123456",
  • "masked_pan": "************1234"
}

Integrationen::Karte::OPI

OPI-Konfiguration abrufen

Ruft die aktuelle OPI-Konfiguration mit allen konfigurierten Terminals ab

Responses

Response samples

Content type
application/json
{
  • "configName": "opi",
  • "enableRefunds": true,
  • "terminals": [
    ]
}

OPI-Konfiguration setzen

Aktualisiert die OPI-Konfiguration mit neuen Terminals und Einstellungen

Request Body schema: application/json
required
Array of objects

Liste der zu konfigurierenden Terminals

enableRefunds
boolean

Rückerstattungen aktivieren/deaktivieren

Responses

Request samples

Content type
application/json
{
  • "terminals": [
    ],
  • "enableRefunds": true
}

Response samples

Content type
application/json
{
  • "success": true
}

Status einer OPI-Zahlung abrufen

Ruft den aktuellen Status einer Zahlung anhand der Zahlungs-ID ab

Request Body schema: application/json
required
paymentId
required
string

Eindeutige Zahlungs-ID

Responses

Request samples

Content type
application/json
{
  • "paymentId": "payment_12345"
}

Response samples

Content type
application/json
{
  • "status": "success"
}

Zahlung über OPI-Terminal initiieren

Sendet eine Zahlungsanfrage an ein OPI-Terminal. Unterstützt auch Rückerstattungen bei negativem Betrag.

Request Body schema: application/json
required
amount
required
string

Zahlungsbetrag (negativ für Rückerstattungen)

required
object

Terminal-Objekt

paymentId
string

Optional eindeutige Zahlungs-ID zur Nachverfolgung

Responses

Request samples

Content type
application/json
{
  • "amount": "42.50",
  • "terminal": {
    },
  • "paymentId": "payment_12345"
}

Response samples

Content type
application/json
{
  • "success": true
}

Integrationen::Karte::Softpay

Softpay-Rückerstattung abbrechen

Bricht eine laufende Rückerstattungsanfrage bei Softpay ab

Request Body schema: application/json
required
requestId
required
string

Eindeutige Request-ID der abzubrechenden Rückerstattung

Responses

Request samples

Content type
application/json
{
  • "requestId": "req_xyz789abc"
}

Response samples

Content type
application/json
{
  • "success": true,
  • "message": "Refund cancelled"
}

Softpay-Konfiguration vom Server abrufen

Ruft die aktuelle Softpay-Konfiguration vom Server ab und aktualisiert lokale Einstellungen

Responses

Response samples

Content type
application/json
{
  • "sandbox": true,
  • "appId": "app_abc123xyz",
  • "haveAuthData": true
}

Softpay-Konfiguration abrufen

Ruft die aktuelle öffentliche Softpay-Konfiguration ab (ohne sensible Daten)

Responses

Response samples

Content type
application/json
{
  • "sandbox": true,
  • "appId": "app_abc123xyz",
  • "haveAuthData": true
}

Softpay-Konfiguration setzen

Aktualisiert die Softpay-Konfiguration mit Client-Zugangsdaten und Einstellungen

Request Body schema: application/json
required
client
string

Client-ID für Softpay

secret
string

Client-Secret für Softpay

sandbox
boolean

Sandbox-Modus aktivieren/deaktivieren

appId
string

App-ID für Softpay

Responses

Request samples

Content type
application/json
{
  • "client": "client_abc123",
  • "secret": "secret_xyz789",
  • "sandbox": true,
  • "appId": "app_abc123xyz"
}

Response samples

Content type
application/json
{
  • "success": true
}

Rückerstattung über Softpay anfordern

Sendet eine Rückerstattungsanfrage an Softpay für einen bestimmten Betrag

Request Body schema: application/json
required
amountInCents
required
string

Rückerstattungsbetrag in Cent

employee
required
string

Name des Mitarbeiters, der die Rückerstattung durchführt

currency
string

Währungscode (Standard=EUR)

appId
required
string

App-ID für die Transaktion

Responses

Request samples

Content type
application/json
{
  • "amountInCents": "4250",
  • "employee": "Max Mustermann",
  • "currency": "EUR",
  • "appId": "app_abc123xyz"
}

Response samples

Content type
application/json
{
  • "success": true,
  • "message": "Refund initiated",
  • "intent": "softpay://transaction/refund_xyz789"
}

Integrationen::Karte::Sumup

Zahlung abbrechen

Bricht eine laufende Zahlung auf einem SumUp-Terminal ab

path Parameters
tid
required
string
Example: rdr_3MSAFM23CK82VSTT4BN6RWSQ65

Terminal-ID des SumUp-Terminals

Responses

Response samples

Content type
application/json
{
  • "success": true,
  • "status": "CANCELLED"
}

Konfiguration abrufen

Ruft die aktuelle SumUp-Konfiguration ab

Responses

Response samples

Content type
application/json
{
  • "apiKey": "sup_sk_xxxxxxxxxxxxxxxxxxxxxxxxxx",
  • "merchant": "MRCDE12345",
  • "terminals": [
    ],
  • "tipRates": [
    ]
}

Konfiguration speichern

Speichert die SumUp-Konfiguration (API-Key, Merchant, Terminals)

Request Body schema: application/json
required
apiKey
string

SumUp API-Schlüssel

merchant
string

SumUp Merchant-Code

Array of objects

Liste der konfigurierten Terminals

tipRates
Array of numbers

Optionale Trinkgeld-Sätze in Prozent

Responses

Request samples

Content type
application/json
{
  • "apiKey": "sup_sk_xxxxxxxxxxxxxxxxxxxxxxxxxx",
  • "merchant": "MRCDE12345",
  • "terminals": [
    ],
  • "tipRates": [
    ]
}

Response samples

Content type
application/json
{
  • "apiKey": "sup_sk_xxxxxxxxxxxxxxxxxxxxxxxxxx",
  • "merchant": "MRCDE12345",
  • "terminals": [
    ],
  • "tipRates": [
    ]
}

Konfiguration aktualisieren

Ruft die aktuelle Konfiguration von SumUp ab und aktualisiert die lokale Konfiguration (Terminal-Liste)

Responses

Response samples

Content type
application/json
{
  • "apiKey": "sup_sk_xxxxxxxxxxxxxxxxxxxxxxxxxx",
  • "merchant": "MRCDE12345",
  • "terminals": [
    ],
  • "tipRates": [
    ]
}

Terminals abrufen

Ruft die Liste aller konfigurierten SumUp-Terminals ab

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Zahlung initiieren

Sendet eine Zahlungsanforderung an ein SumUp-Terminal

path Parameters
tid
required
string
Example: rdr_3MSAFM23CK82VSTT4BN6RWSQ65

Terminal-ID des SumUp-Terminals

Request Body schema: application/json
required
amount
number

Zahlungsbetrag in Euro

Responses

Request samples

Content type
application/json
{
  • "amount": 49.99
}

Response samples

Content type
application/json
{
  • "success": true,
  • "id": "TXNID123456789"
}

Zahlungsstatus abrufen

Ruft den Status einer laufenden oder abgeschlossenen Zahlung ab

Request Body schema: application/json
required
payid
string

Zahlungs-ID

Responses

Request samples

Content type
application/json
{
  • "payid": "TXNID123456789"
}

Response samples

Content type
application/json
{
  • "success": true,
  • "id": "TXNID123456789",
  • "status": "SUCCESSFUL",
  • "amount": 49.99,
  • "currency": "EUR",
  • "timestamp": "2026-02-18T10:30:00Z",
  • "transaction_code": "ABC123",
  • "client_transaction_id": "CLIENT-TXN-001"
}

Integrationen::Karte::Sumup-A2A

Sumup-Konfiguration abrufen

Ruft die aktuelle Sumup-Konfiguration mit dem API-Key ab

Responses

Response samples

Content type
application/json
{
  • "configName": "sumupKey",
  • "sumupKey": "00000000-0000-0000-0000-000000000000"
}

Sumup-Konfiguration aktualisieren

Aktualisiert den Sumup API-Key und benachrichtigt alle verbundenen Clients über die Änderung

Request Body schema: application/json
required
sumupKey
required
string

Neuer Sumup API-Key

Responses

Request samples

Content type
application/json
{
  • "sumupKey": "00000000-0000-0000-0000-000000000000"
}

Integrationen::Karte::ZVT

ZVT-Konfiguration abrufen

Ruft die aktuelle ZVT-Konfiguration mit allen konfigurierten Terminals ab

Responses

Response samples

Content type
application/json
{
  • "configName": "zvtData",
  • "zvtDevices": [
    ]
}

ZVT-Konfiguration setzen

Aktualisiert die ZVT-Konfiguration mit neuen Terminals

Request Body schema: application/json
required
configName
string

Name der Konfiguration (optional, immer "zvtData")

required
Array of objects

Liste der zu konfigurierenden ZVT-Terminals

Responses

Request samples

Content type
application/json
{
  • "configName": "zvtData",
  • "zvtDevices": [
    ]
}

Response samples

Content type
application/json
{
  • "success": true
}

Zahlung über ZVT-Terminal initiieren

Sendet eine Zahlungsanfrage an ein ZVT-Terminal (ZVT-Protokoll)

Request Body schema: application/json
required
amount
required
string

Zahlungsbetrag

required
object

Terminal-Objekt mit Verbindungsinformationen

paymentId
string

Optional eindeutige Zahlungs-ID zur Nachverfolgung

Responses

Request samples

Content type
application/json
{
  • "amount": "42.50",
  • "terminal": {
    },
  • "paymentId": "payment_12345"
}

Response samples

Content type
application/json
{
  • "success": true
}

Integrationen::Kontakte

Kontakte-Integration konfigurieren (lesen)

Responses

Kontakte-Integration konfigurieren (schreiben)

Request Body schema: application/json
required
enabled
boolean

Responses

Request samples

Content type
application/json
{
  • "enabled": true
}

Kontakte laden oder suchen

Responses

Kontakte suchen

Request Body schema: application/json
optional
query
string
page
number
pageSize
number
updateTimeout
number

Responses

Request samples

Content type
application/json
{
  • "query": "string",
  • "page": 0,
  • "pageSize": 0,
  • "updateTimeout": 0
}

Kontakte seitenweise laden

path Parameters
page
required
number

Responses

Kontakte seitenweise suchen

path Parameters
page
required
number

Responses

Integrationen::NFC-Gutscheine

NFC tag scanning endpoints mounted at /api/nfc

NFC-Scan verarbeiten

Sendet ein NFC-Scan-Ereignis über WebSocket an verbundene Clients basierend auf appId und tagId

Request Body schema: application/json
required
appId
required
string

Anwendungskennung, um Scanner <-> Frontend zuzuordnen (zur Zeit nicht verwendet)

tagId
required
string

NFC-Tag-ID bzw. Gutscheincode, der gescannt wurde

Responses

Request samples

Content type
application/json
{
  • "appId": "kasse_01",
  • "tagId": "12345abcde"
}

Response samples

Content type
application/json
{
  • "success": true
}

Integrationen::Selfordering

Selfordering-Konfiguration ändern

Aktualisiert die Selfordering-Konfiguration und benachrichtigt alle verbundenen Clients über die Änderung.

Request Body schema: application/json
required
enabled
boolean

Selfordering aktivieren/deaktivieren

autoConfirm
boolean

Automatische Bestätigung aktivieren/deaktivieren

Responses

Request samples

Content type
application/json
{
  • "enabled": true,
  • "autoConfirm": false
}

Online-Bestellungen abrufen

Ruft alle aktuell offenen Online-Bestellungen vom Selfordering-Service ab.

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Selfordering-Konfiguration abrufen

Ruft die aktuelle Selfordering-Konfiguration ab. Falls keine Konfiguration existiert, wird eine neue mit Standardwerten erstellt.

Responses

Response samples

Content type
application/json
{
  • "_id": "config_123abc",
  • "configName": "selfordering",
  • "enabled": true,
  • "autoConfirm": false
}

Online-Bestellung aktualisieren

Aktualisiert den Status einer Online-Bestellung und erstellt optional die Bestellung lokal im System.

Request Body schema: application/json
required
orderId
required
string

ID der zu aktualisierenden Bestellung

confirm
boolean

Bestellung bestätigen (true) oder ablehnen (false)

createOrder
boolean

Bestellung lokal im System erstellen (nur wirksam wenn confirm=true)

Responses

Request samples

Content type
application/json
{
  • "orderId": "order_456def",
  • "confirm": true,
  • "createOrder": true
}

Integrationen::Vorbestellung

Vorbestellungen drucken

Druckt eine oder mehrere Vorbestellungen über den konfigurierten Drucker

Request Body schema: application/json
required
employee
required
string

Name des Mitarbeiters, der den Druck auslöst

required
Array of objects

Liste der zu druckenden Vorbestellungen

area
string

Optional - spezifischer Bereich für den Druck

Responses

Request samples

Content type
application/json
{
  • "employee": "Max Mustermann",
  • "area": "Restaurant",
  • "orders": [
    ]
}

Kassenabschlüsse

Einzahlung oder Auszahlung ins Kassenbuch buchen

Positive Beträge = Einzahlung, negative Beträge = Auszahlung

Request Body schema: application/json
required
amount
required
number

Geldbetrag (positiv = Einzahlung, negativ = Auszahlung)

text
string

Beschreibung der Buchung

Responses

Request samples

Content type
application/json
Example
{
  • "amount": 100,
  • "text": "Startkapital"
}

Kassenabschluss durchführen

Request Body schema: application/json
required
transactions
Array of objects

Liste der Transaktionen

Responses

Request samples

Content type
application/json
{
  • "transactions": [ ]
}

Response samples

Content type
application/json
{
  • "success": true,
  • "data": "string",
  • "sendSuccess": true
}

Kassenbuch-Metadaten abrufen

Responses

Response samples

Content type
application/json
{ }

Heutiges Kassenbuch abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Aktuelle Kassenabschluss-Nummer abrufen

Responses

Response samples

Content type
application/json
{
  • "data": 0
}

Vollständiges Kassenbuch abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Geld zur Kasse hinzufügen (DEPRECATED) Deprecated

Verwenden Sie stattdessen /closings/cash mit positivem Betrag

Request Body schema: application/json
required
amount
number
text
string

Responses

Request samples

Content type
application/json
{
  • "amount": 0,
  • "text": "string"
}

Geld aus der Kasse entfernen (DEPRECATED) Deprecated

Verwenden Sie stattdessen /closings/cash mit negativem Betrag

Request Body schema: application/json
required
amount
number
text
string

Responses

Request samples

Content type
application/json
{
  • "amount": 0,
  • "text": "string"
}

Alle Tresore abrufen

Responses

Einzelnen Tresor abrufen

path Parameters
safeName
required
string

Responses

Tresorbetrag aktualisieren

path Parameters
safeName
required
string
Request Body schema: application/json
required
amount
required
number

Responses

Request samples

Content type
application/json
{
  • "amount": 0
}

Kategorien

Reihenfolge von Kategorien ändern

Request Body schema: application/json
required
required
Array of objects

Responses

Request samples

Content type
application/json
{
  • "categorys": [
    ]
}

Kategorie löschen

Request Body schema: application/json
required
_id
required
string

ID der zu löschenden Kategorie

Responses

Request samples

Content type
application/json
{
  • "_id": "abc123"
}

Alle Kategorien abrufen

query Parameters
extraCategories
boolean

true = Extra-Kategorien, false = Artikel-Kategorien, undefined = alle Kategorien

Responses

Response samples

Content type
application/json
[
  • { }
]

Neue Kategorie erstellen

Request Body schema: application/json
required
name
required
string

Name der Kategorie

extraCategory
boolean
Default: false

Ist es eine Extra-Kategorie?

Responses

Request samples

Content type
application/json
Example
{
  • "name": "Getränke",
  • "extraCategory": false
}

Farbe einer Kategorie ändern

Request Body schema: application/json
required
_id
required
string

ID der Kategorie

color
required
string

Hex-Farbcode

Responses

Request samples

Content type
application/json
Example
{
  • "_id": "cat123",
  • "color": "#FF0000"
}

Kategorie aktualisieren

Request Body schema: application/json
required
_id
required
string

ID der Kategorie

name
required
string

Neuer Name der Kategorie

oldName
required
string

Alter Name der Kategorie

visible
boolean
Default: true

Sichtbarkeit der Kategorie

Responses

Request samples

Content type
application/json
{
  • "_id": "cat123",
  • "name": "Heiße Getränke",
  • "oldName": "Getränke",
  • "visible": true
}

Produkte

Reihenfolge von Produkten ändern

Request Body schema: application/json
required
required
Array of objects

Responses

Request samples

Content type
application/json
{
  • "products": [
    ]
}

Produkt löschen

Request Body schema: application/json
required
_id
required
string

ID des zu löschenden Produkts

Responses

Request samples

Content type
application/json
{
  • "_id": "prod123"
}

Alle Kombinations-Produkte abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Alle Produkte abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Alle Artikel abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Alle Artikel abrufen

path Parameters
asIs
required
string

Verwende den Wert asIs, um Rohdaten zu erhalten

Responses

Response samples

Content type
application/json
[
  • { }
]

Alle Extras abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Alle Extras abrufen

path Parameters
asIs
required
string

Verwende den Wert asIs, um Rohdaten zu erhalten

Responses

Response samples

Content type
application/json
[
  • { }
]

Produkt per PLU/EAN abrufen

Request Body schema: application/json
required
One of
plu
required
string

PLU Code des Produkts

Responses

Request samples

Content type
application/json
{
  • "plu": "4012345678901"
}

Response samples

Content type
application/json
{ }

Produkt per PLU/EAN abrufen

Request Body schema: application/json
required
plu
required
string

PLU oder EAN Code des Produkts

Responses

Request samples

Content type
application/json
{
  • "plu": "4012345678901"
}

Response samples

Content type
application/json
{ }

Lagerbestand um 1 erhöhen

Request Body schema: application/json
required
_id
required
string

Produkt-ID

Responses

Request samples

Content type
application/json
{
  • "_id": "prod123"
}

Neues Kombinationsprodukt erstellen

Request Body schema: application/json
required
name
required
string
price
required
string
availableProducts
required
Array of objects
required
required
boolean
changetax
required
boolean
category
string
color
string

Responses

Request samples

Content type
application/json
{
  • "name": "string",
  • "price": "string",
  • "availableProducts": [
    ],
  • "required": true,
  • "changetax": true,
  • "category": "string",
  • "color": "string"
}

Neues Produkt erstellen

Request Body schema: application/json
required
name
required
string

Name des Produkts

price
required
string

Preis des Produkts

category
required
string

Kategorie-Name

tax
required
string

Steuersatz

infoText
string

Zusätzliche Info

stockChecking
required
boolean

Lagerbestand prüfen?

stockAmount
required
number

Lagerbestand

customPrinterAddress
required
string

Drucker-Adresse

showOnGimig
required
boolean

Auf Gimig anzeigen?

ean
string

EAN

plu
string

PLU

Responses

Request samples

Content type
application/json
{
  • "name": "Cappuccino",
  • "price": "3.50",
  • "category": "Getränke",
  • "tax": "7",
  • "stockChecking": false,
  • "stockAmount": 0,
  • "customPrinterAddress": "",
  • "showOnGimig": true
}

Produkt aktualisieren

Request Body schema: application/json
required
_id
required
string
name
string
category
string
price
string
tax
string
active
boolean
infoText
string
stockChecking
boolean
stockAmount
number
customPrinterAddress
string
color
string
showOnGimig
boolean
variablePrice
boolean
favorite
boolean
ean
string
plu
string

Responses

Request samples

Content type
application/json
{
  • "_id": "prod123",
  • "name": "Latte Macchiato",
  • "price": "4.20",
  • "active": true
}

Produkt per URL-ID aktualisieren

path Parameters
id
required
string
Request Body schema: application/json
required
object

Responses

Request samples

Content type
application/json
{ }

Lagerbestand aktualisieren

Request Body schema: application/json
required
_id
required
string

Produkt-ID

stockAmount
required
number

Neuer Lagerbestand

Responses

Request samples

Content type
application/json
{
  • "_id": "prod123",
  • "stockAmount": 50
}

Kombinationsprodukt aktualisieren

Request Body schema: application/json
required
_id
required
string
name
required
string
price
required
string
active
required
boolean
availableProducts
required
Array of objects
required
required
boolean
changetax
required
boolean
category
string
color
string

Responses

Request samples

Content type
application/json
{
  • "_id": "string",
  • "name": "string",
  • "price": "string",
  • "active": true,
  • "availableProducts": [
    ],
  • "required": true,
  • "changetax": true,
  • "category": "string",
  • "color": "string"
}

Setup

Passwort ändern

Request Body schema: application/json
required
password
required
string

Neues Passwort

closing
boolean

Passwort für Kassenabschluss

article
boolean

Passwort für Artikel

settings
boolean

Passwort für Einstellungen

Responses

Request samples

Content type
application/json
{
  • "password": "1234",
  • "closing": true,
  • "article": false,
  • "settings": true
}

Prüfen, ob dies der erste Start ist

Responses

Response samples

Content type
application/json
{
  • "firstStart": true
}

Rabatte abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Mitarbeiter-Liste abrufen

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Stockwerk-Ansichtskonfiguration abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Küchen-Ignorier-Liste abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Passwort-Konfiguration abrufen

Responses

Response samples

Content type
application/json
{
  • "configName": "string",
  • "password": "string",
  • "closing": true,
  • "article": true,
  • "settings": true
}

Restaurant-Daten abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

Restaurant-Logo URL abrufen

Responses

Response samples

Content type
application/json
"string"

Server-IP-Adresse abrufen

Responses

Response samples

Content type
application/json
"string"

Anzahl der Tische abrufen

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Tisch-Ansichtskonfiguration abrufen

Responses

Response samples

Content type
application/json
[
  • { }
]

TSE-Konfiguration abrufen

Responses

Response samples

Content type
application/json
{ }

Server-Version abrufen

Responses

Alle Variablen initialisieren

Responses

First-Start-Status setzen

Request Body schema: application/json
required
status
boolean
Default: false

Neuer First-Start-Status

Responses

Request samples

Content type
application/json
{
  • "status": false
}

Stockwerk-Ansichtskonfiguration speichern

Request Body schema: application/json
required
floorArrangeObjects
required
Array of objects

Array mit Stockwerk-Anordnungs-Objekten

Responses

Request samples

Content type
application/json
{
  • "floorArrangeObjects": [
    ]
}

Küchen-Ignorier-Liste setzen

Artikel, die nicht in der Küche gedruckt werden sollen

Request Body schema: application/json
required
ignoreList
required
Array of strings

Liste der zu ignorierenden Artikel-IDs

Responses

Request samples

Content type
application/json
{
  • "ignoreList": [
    ]
}

Tisch-Ansichtskonfiguration speichern

Request Body schema: application/json
required
tableArrangeObjects
required
Array of objects

Array mit Tisch-Anordnungs-Objekten

Responses

Request samples

Content type
application/json
{
  • "tableArrangeObjects": [
    ]
}

Tischanzahl aktualisieren

Request Body schema: application/json
required
tableNumber
required
number

Anzahl der Tische

Responses

Request samples

Content type
application/json
{
  • "tableNumber": 20
}

Kunden-Daten aktualisieren

Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "customerData": {
    }
}

Rabatte aktualisieren

Request Body schema: application/json
required
customDiscountData
required
Array of objects

Array mit Rabatt-Konfigurationen

Responses

Request samples

Content type
application/json
{
  • "customDiscountData": [
    ]
}

Mitarbeiter-Liste aktualisieren

Request Body schema: application/json
required
employeeList
required
Array of strings

Liste der Mitarbeiternamen

Responses

Request samples

Content type
application/json
{
  • "employeeList": [
    ]
}

Restaurant-Daten aktualisieren

Request Body schema: application/json
required
required
object

Responses

Request samples

Content type
application/json
{
  • "restaurantData": {
    }
}

Restaurant-Logo URL aktualisieren

Request Body schema: application/json
required
string
required
string

Logo-URL oder Base64-String

Responses

Request samples

Content type
application/json

TSE-Konfiguration aktualisieren

Request Body schema: application/json
required
tseData
object

TSE-Einstellungen (wird aus Cloud geladen falls nicht angegeben)

Responses

Request samples

Content type
application/json
{
  • "tseData": { }
}

Kiosk-Modus und Ordner-Ansicht aktualisieren

Request Body schema: application/json
required
state
required
boolean

Kiosk-Modus aktivieren?

folderView
required
boolean

Ordner-Ansicht aktivieren?

Responses

Request samples

Content type
application/json
{
  • "state": true,
  • "folderView": false
}

Setup::Drucker

Drucker hinzufügen

Fügt einen neuen Drucker zur Konfiguration hinzu

Request Body schema: application/json
required
name
required
string

Name des Druckers

required
Array of objects
required
object

Responses

Request samples

Content type
application/json
{
  • "name": "Küche",
  • "devices": [
    ],
  • "config": {
    }
}

Drucker löschen

Löscht einen Drucker aus der Konfiguration

Request Body schema: application/json
required
name
required
string

Name des zu löschenden Druckers

Responses

Request samples

Content type
application/json
{
  • "name": "Küche"
}

Drucker bearbeiten

Aktualisiert die Konfiguration eines vorhandenen Druckers

Request Body schema: application/json
required
oldName
required
string

Aktueller Name des Druckers

name
required
string

Neuer Name des Druckers

required
Array of objects
required
object

Responses

Request samples

Content type
application/json
{
  • "oldName": "Küche",
  • "name": "Küche 1",
  • "devices": [
    ],
  • "config": {
    }
}

Drucker nach Name abrufen

Ruft einen einzelnen Drucker mit seinem aktuellen Status ab

path Parameters
name
required
string

Name des Druckers

Responses

Response samples

Content type
application/json
{
  • "name": "Küche",
  • "devices": [
    ],
  • "config": {
    }
}

Alle Drucker abrufen

Ruft die Liste aller konfigurierten Drucker ab

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Druck-Konfiguration abrufen

Ruft die globale Druckkonfiguration ab

Responses

Response samples

Content type
application/json
{}

Druck-Konfiguration setzen

Aktualisiert die globale Druckkonfiguration. Felder können einzeln oder zusammen aktualisiert werden.

Request Body schema: application/json
required
printingOnOwnDevice
boolean

Drucken auf eigenem Gerät aktiviert

automaticDigitalReceive
boolean

Automatischer digitaler Empfang

logoUrl
string

URL des Logos für Belege

Responses

Request samples

Content type
application/json
{}

Drucker-Migration Informationsseite

Zeigt eine HTML-Seite mit Informationen zur Druckermigration

Responses

Drucker-Migration durchführen

Führt die Migration der Drucker auf das neue Drucksystem durch

Responses

Response samples

Content type
text/html
Migration erfolgreich<br>2 Drucker migriert

Drucker testen

Sendet einen Testdruck an einen Drucker, um die Verbindung zu prüfen

Request Body schema: application/json
required
ip
required
string

IP-Adresse des Druckers

type
required
number

Druckertyp (0 = ESCPOS, 1 = VIRTUAL)

name
string

Optionaler Name des Druckers

Responses

Request samples

Content type
application/json
{
  • "ip": "192.168.1.100",
  • "type": 0,
  • "name": "Küche"
}

Drucker erneut finden

Versucht, einen Drucker an der angegebenen IP-Adresse erneut zu finden und die Verbindung wiederherzustellen

Request Body schema: application/json
required
name
required
string

Name des Druckers

ip
required
string

IP-Adresse des Druckers

Responses

Request samples

Content type
application/json
{
  • "name": "Küche",
  • "ip": "192.168.1.100"
}

Drucker-Konfiguration bearbeiten

Aktualisiert die Einstellungen eines Druckers. Felder können einzeln oder zusammen aktualisiert werden.

Request Body schema: application/json
required
name
required
string

Name des Druckers

kickDrawer
boolean

Kassenschublade öffnen nach Druck

orderedOrder
boolean

Bestellungen sortiert drucken

partialPrinting
boolean

Teilweises Drucken aktiviert

summaryOnPartialPrint
boolean

Zusammenfassung bei Teildruck anzeigen

textHuge
boolean

Große Textgröße verwenden

tableOnBottom
boolean

Tischnummer am Ende drucken

width
number

Druckbreite in Zeichen (1-1000)

footerText
string

Fußzeilentext

hideExtraPrice
boolean

Extra-Preis ausblenden

Responses

Request samples

Content type
application/json
{
  • "name": "Küche",
  • "kickDrawer": false,
  • "textHuge": true,
  • "orderedOrder": true,
  • "footerText": "Vielen Dank!"
}

Setup::Import/Export

Datenbank exportieren

Exportiert alle Einträge aus der angegebenen Datenbank

path Parameters
db
required
string
Enum: "cashbookDb" "categoryDb" "configDb" "orderDb" "payedOrdersDb" "productDb" "tempDb" "voucherDb"

Name der zu exportierenden Datenbank

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Datenbank importieren

Ersetzt alle Einträge in der angegebenen Datenbank mit den importierten Daten. ACHTUNG - Alle vorhandenen Daten werden gelöscht!

path Parameters
db
required
string
Enum: "cashbookDb" "categoryDb" "configDb" "orderDb" "payedOrdersDb" "productDb" "tempDb" "voucherDb"

Name der zu importierenden Datenbank

Request Body schema: application/json
required
Array
object

Responses

Request samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Response samples

Content type
application/json
{
  • "success": true
}

Setup::Kartenzahlung

Aktive Terminals abrufen

Ruft alle verfügbaren Kartenzahlungs-Terminals von allen aktivierten Anbietern ab

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Aktiven Kartenzahlungsanbieter abrufen

Ruft den aktuell konfigurierten Kartenzahlungsanbieter ab

Responses

Response samples

Content type
application/json
"sumup"

Kartenzahlungsanbieter festlegen

Setzt den aktiven Kartenzahlungsanbieter

Request Body schema: application/json
required
provider
required
string
Enum: "none" "mypos" "sumup" "zvt" "softpos" "mypos-glass" "opi" "mollie" "adyen"

Der zu aktivierende Kartenzahlungsanbieter

Responses

Request samples

Content type
application/json
{
  • "provider": "sumup"
}

Alle aktivierten Kartenzahlungsanbieter abrufen

Ruft die Liste aller aktivierten Kartenzahlungsanbieter ab

Responses

Response samples

Content type
application/json
[
  • "sumup",
  • "mypos",
  • "zvt"
]

Aktivierte Kartenzahlungsanbieter festlegen

Setzt die Liste der aktivierten Kartenzahlungsanbieter. Mit "all" können alle Anbieter aktiviert werden.

Request Body schema: application/json
required
Array
string
Enum: "none" "mypos" "sumup" "zvt" "softpos" "mypos-glass" "opi" "mollie" "adyen" "all"

Responses

Request samples

Content type
application/json
Example
[
  • "sumup",
  • "mypos",
  • "zvt"
]

Response samples

Content type
application/json
{
  • "success": true,
  • "object": [
    ]
}

Setup::Kassenbuch

Kassenbuch-Konfiguration abrufen

Ruft die aktuelle Kassenbuch-Konfiguration ab

Responses

Response samples

Content type
application/json
{
  • "autoCloseCheckout": true,
  • "closeCheckoutHour": 23
}

Kassenbuch-Konfiguration setzen

Setzt die Kassenbuch-Konfiguration. Felder können einzeln oder zusammen aktualisiert werden.

Request Body schema: application/json
required
autoCloseCheckout
boolean

Automatischer Kassenabschluss aktiviert

closeCheckoutHour
number [ 0 .. 23 ]

Stunde für automatischen Kassenabschluss (0-23)

cashbookEnabled
boolean

Kassenbuch aktiviert

Responses

Request samples

Content type
application/json
{
  • "autoCloseCheckout": true,
  • "closeCheckoutHour": 22,
  • "cashbookEnabled": true
}

Response samples

Content type
application/json
{
  • "autoCloseCheckout": true,
  • "closeCheckoutHour": 22,
  • "cashbookEnabled": true
}

Setup::Mitarbeiter

Mitarbeiterliste setzen

Setzt die Liste aller konfigurierten Mitarbeiternamen

Responses

Response samples

Content type
application/json
[
  • "Hauptkasse",
  • "Anna Schmidt",
  • "Max Müller"
]

Setup::Netzwerkscan

Netzwerkscan starten

Startet einen Netzwerkscan nach Geräten des angegebenen Typs

Request Body schema: application/json
required
type
required
string
Value: "printer"

Typ der zu suchenden Geräte

Responses

Request samples

Content type
application/json
{
  • "type": "printer"
}

Netzwerkscan-Status abrufen

Ruft den aktuellen Status des Netzwerkscans ab, inklusive gefundener Geräte und Fortschritt

Responses

Response samples

Content type
application/json
{
  • "scanning": true,
  • "foundDevices": [
    ],
  • "progress": 0.453
}

Netzwerkscan stoppen

Stoppt einen laufenden Netzwerkscan

Responses

Setup::Steuersätze

Steuersätze abrufen

Ruft die konfigurierten Steuersätze ab. Falls keine konfiguriert sind, werden die Standardwerte zurückgegeben.

Responses

Response samples

Content type
application/json
[
  • "20",
  • "19",
  • "10",
  • "7",
  • "0"
]

Steuersätze setzen

Setzt die aktiven Steuersätze aus der Liste der verfügbaren Standardwerte. Die Werte werden automatisch absteigend sortiert.

Request Body schema: application/json
required
Array
string
Enum: "20" "19" "10.7" "10" "7" "5.5" "0"

Responses

Request samples

Content type
application/json
[
  • "19",
  • "7",
  • "0"
]

Artikel mit ungültigen Steuersätzen abrufen

Ruft alle Artikel ab, die einen Steuersatz haben, der nicht in den aktuell konfigurierten Steuersätzen enthalten ist

Responses

Response samples

Content type
application/json
[
  • {
    },
  • {
    }
]

Artikel-Steuersätze migrieren

Migriert alle Artikel mit ungültigen Steuersätzen zu einem neuen, gültigen Steuersatz

Request Body schema: application/json
required
Array (= 1 items)
string

Responses

Request samples

Content type
application/json
[
  • "19"
]

Response samples

Content type
application/json
42

Setup::Zahlung

Zahlungskonfiguration abrufen

Ruft die aktuelle Zahlungskonfiguration ab, inklusive Trinkgeld-, Gutschein- und Zahlungsmethoden-Einstellungen

Responses

Response samples

Content type
application/json
{
  • "tipEnable": false,
  • "tipShowServer": true,
  • "tipFlip": false,
  • "tipPercentMode": true,
  • "tipPercentValues": [
    ],
  • "tipThanks": true,
  • "enabledPaymentMethods": [
    ],
  • "nfcVouchersEnabled": false,
  • "nfcVoucherTopupEnabled": false,
  • "nfcVoucherPayoutEnabled": false,
  • "cloudVouchersEnabled": false,
  • "showTipCalculator": true,
  • "showVoucherButton": true,
  • "showDiscountButton": true
}

Zahlungskonfiguration setzen

Aktualisiert die Zahlungskonfiguration. Felder können einzeln oder zusammen aktualisiert werden.

Request Body schema: application/json
required
tipEnable
boolean

Trinkgeld aktiviert

tipShowServer
boolean

Zeige Server-Auswahl bei Trinkgeld

tipFlip
boolean

Trinkgeld-Ansicht umdrehen

tipPercentMode
boolean

Trinkgeld als Prozentwerte anzeigen

tipPercentValues
Array of strings

Vordefinierte Trinkgeld-Prozentwerte

tipThanks
boolean

Dankesbild nach Trinkgeld anzeigen

enabledPaymentMethods
Array of strings
Items Enum: "CASH" "CARD" "INVOICE"

Aktivierte Zahlungsmethoden

nfcVouchersEnabled
boolean

NFC-Gutscheine aktiviert

nfcVoucherTopupEnabled
boolean

NFC-Gutschein-Aufladung aktiviert

nfcVoucherPayoutEnabled
boolean

NFC-Gutschein-Auszahlung aktiviert

cloudVouchersEnabled
boolean

Cloud-Gutscheine aktiviert

showTipCalculator
boolean

Trinkgeldrechner anzeigen

showVoucherButton
boolean

Gutschein-Button anzeigen

showDiscountButton
boolean

Rabatt-Button anzeigen

Responses

Request samples

Content type
application/json
{
  • "tipEnable": true,
  • "tipPercentMode": true,
  • "tipPercentValues": [
    ],
  • "enabledPaymentMethods": [
    ],
  • "showTipCalculator": true
}

Response samples

Content type
application/json
{
  • "tipEnable": true,
  • "tipShowServer": true,
  • "tipFlip": true,
  • "tipPercentMode": true,
  • "tipPercentValues": [
    ],
  • "tipThanks": true,
  • "enabledPaymentMethods": [
    ],
  • "nfcVouchersEnabled": true,
  • "nfcVoucherTopupEnabled": true,
  • "nfcVoucherPayoutEnabled": true,
  • "cloudVouchersEnabled": true,
  • "showTipCalculator": true,
  • "showVoucherButton": true,
  • "showDiscountButton": true
}

System

Client-HTML-Seite abrufen

Responses

Server herunterfahren

Responses