API (JSON)


Mit den API Funktionen der Getränkeliste können
andere Systeme automatisiert (wie z.B. ein Zahlungsdienstleister) angebunden werden.
Die API liefert JSON Daten und wird einfach mit GET Parametern aufgerufen.

Unter Verwaltung > Einstellungen kann eine Zahlungs-URL mit variablen festegelegt werden.
Mit dieser kann mit der "account" und "amount" Variable bei z.B. beliebigen Zahlungsdienstleistern gestartet werden.

Oder alternativ mit der Liste der offnen Beträge aus 1) selbst Zahlungsanweisungen erzeugen.
Ist eine Zahlung erfolgreich, kann es mit 2) wieder mit dem Konto verbucht werden.

Der API Key wird in der Verwaltung unter Einstellungen angezeigt.

Bei Fragen, weiteren Funktionen, etc. => Kontaktformular

1) Auslesen offener Beträge


URL Aufruf
https://iqmeta.com/gliste/api/unpaid/?email={verwalter@email.com}&apikey={01234567890123456789012345678912345678912345678901}

Ergebnis Objekt
{
    date_utc (datetime)
    error (boolean)
    msg (string)
    unpaid_sum (decimal)
    unpaid (array) [{
        account (guid)
        unpaid (decimal)
        name (string)
        email (string)
    }]
}
Beispiel Ergebnis
{
  "date_utc": "2018-08-08T14:40:43.0219675Z",
  "error": false,
  "msg": "success",
  "unpaid_sum": 56.00,
  "unpaid": [
    {
      "account": "e2a4f338-fe98-488f-a9a4-634174167df3",
      "unpaid": 32.00,
      "name": "Wurst, Hans",
      "email": "some@email.com"
    },
    {
      "account": "420d4153-d502-40ae-a869-51419e604124",
      "unpaid": 24.00,
      "name": "Gemüse, Olga",
      "email": "another@emai.com"
    }
  ]
}

2) Betrag bezahlen


URL Aufruf
https://iqmeta.com/gliste/api/payment/?email={verwalter@email.com}&apikey={01234567890123456789012345678912345678912345678901}&account={420d4153-d502-40ae-a869-51419e604124}&amount={20.00}

Ergebnis Objekt
{
    error (boolean)
    msg (string)
    name (string)
    account (guid)
    date_utc (datetime)
    unpaid_before_fullfilled (decimal)
    unpaid_new (decimal)
    current_balance (decimal)
    payment_fullfilled (decimal)
    credit_overpaid (decimal)
}
Beispiel Ergebnis
{
  "error": false,
  "msg": "success",
  "name": "Gemüse, Olga",
  "account": "420d4153-d502-40ae-a869-51419e604124",
  "date_utc": "2018-08-08T14:41:40.7975722Z",
  "unpaid_before_fullfilled": 24.00,
  "unpaid_new": 4.00,
  "payment_fullfilled": 20.0,
  "current_balance": 4.00,
  "credit_overpaid": 0.0
}