> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/platform-core/connect-hub/edge-app-marketplace-for-plug-ins-and-extentions/apps/coffeecloud.md).

# CoffeeCloud

## App konfigurieren

<div data-full-width="false"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F1YJa3SkpZiKXxOVpNA7o%2FDocs%20-%20CoffeeCloud%20aktivieren.png?alt=media&#x26;token=45ec615f-3574-43a0-bd78-22cb868b2af4" alt=""><figcaption></figcaption></figure></div>

1. Klicken Sie auf **Einstellungen \[A]**
2. Klicken Sie auf **Apps \[B]**
3. Navigieren Sie zu der **CoffeeCloud-App \[C]**
4. Klicken Sie auf **\[D]**\
   ▷ Das App-Frontend öffnet sich
5. Fügen Sie die unten stehende .json-Vorlage in die **Anfrage \[E]** Fenster
6. \
   ▷ Füllen Sie die .json-Vorlage mit den korrekten Daten aus
7. Unter **Endpunkt \[F]**, wählen Sie die */configs* Option\
   ▷ Die *Methode* Option erscheint
8. Unter **Methode \[G]**, wählen Sie die *POST* Option
9. Klicken Sie auf **Senden \[H]**

Unter ↗ Assets werden Assets für alle Geräte erstellt, die in Ihrem CoffeeCloud-Konto vorhanden sind.

{% hint style="warning" %}
Alle Maschinen innerhalb einer Gruppe werden angezeigt. Untergruppen werden jedoch nicht berücksichtigt.

Wenn Sie in Ihrem CoffeeCloud-Konto Kaffeemaschinen in Untergruppen platziert haben, wird diese Struktur in BuildingPro Suites NICHT übernommen. Die Maschinen selbst erscheinen jedoch in BuildingPro Suites.
{% endhint %}

### .json-Vorlage

```json
{
    "id": 1,
    "username": "Geben Sie hier Ihren Benutzernamen ein",
    "password": "Geben Sie hier Ihr Passwort ein",
    "apiKey": "Geben Sie hier Ihren API-Schlüssel ein",
    "url": "https://coffeecloud.scanomat.com",
    "enable": true,
    "refreshInterval": 113600,
    "requestTimeout": 120,
    "active" false,
    "tenantIDs": [
        "10"
    ]
}
```

### API-Schlüssel generieren

<div data-full-width="false"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F3hB4fPTXGKEyveuTQ7Yz%2FCoffeeCloud%20API%20generieren.png?alt=media&#x26;token=9bf0ebd4-e972-48ed-a8dc-6afdbc40ca16" alt=""><figcaption></figcaption></figure></div>

Um den API-Schlüssel zu generieren, melden Sie sich mit Ihren Daten bei Ihrem CoffeeCloud-Konto an. Der API-Schlüssel kann unter "Einstellungen" generiert werden.

## Generierte Asset-Typen

Es werden 3 Asset-Typen erstellt:

1. CoffeeCloud
2. CoffeeCloud-Gruppe
3. CoffeeCloud-Kaffeemaschine

### CoffeeCloud

Ein Stammverzeichnis für Kaffeemaschinen

### CoffeeCloud-Gruppe

Eine Gruppe für Kaffeemaschinen.

### CoffeeCloud-Kaffeemaschine

Ein Asset-Typ für eine einzelne Kaffeemaschine, einschließlich verschiedener Attribute.

## CoffeeCloud-Dashboard

Die CoffeeCloud-App wird mit einer ↗ Dashboard-Vorlage geliefert.

### Beschreibung

<div data-full-width="false"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2Fq3J2G2GCaOTKZsaDjKyc%2FCoffeeCLoud%20Dashboard.png?alt=media&#x26;token=f76935c7-2fd4-408a-b25b-69e39e3018da" alt=""><figcaption></figcaption></figure></div>

Das CoffeeCloud-Dashboard zeigt eine Liste verbundener CoffeeCloud-Kaffeemaschinen und zugehöriger Statusmeldungen an.

### Dashboard-Vorlage aktivieren

Siehe ↗ hier

## Bekannte Einschränkungen

### Maximales Aktualisierungsintervall

Die API ist auf etwa 20 bis 30 Anfragen pro Stunde begrenzt. Wenn in einem Zeitraum mehr Anfragen gestellt werden, können möglicherweise keine Daten gesendet werden.

Wir empfehlen, etwa 1 Anfrage pro Stunde durchzuführen.

### Nur der Stammordner wird berücksichtigt

Wenn Sie in Ihrem CoffeeCloud-Konto Kaffeemaschinen in Unterordnern abgelegt haben, werden diese Unterordner in BuildingPro Suites NICHT übernommen!

Die Maschinen selbst erscheinen jedoch in BuildingPro Suites.

Sie können [↗ die Maschinen manuell platzieren](/collection/german/verpflichtende-basis/assets/structuring-assets.md) bei Bedarf in Ordnern.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.buildings.ability.abb/collection/german/verpflichtende-basis/platform-core/connect-hub/edge-app-marketplace-for-plug-ins-and-extentions/apps/coffeecloud.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
