> ## Documentation Index
> Fetch the complete documentation index at: https://docs.armin.cx/llms.txt
> Use this file to discover all available pages before exploring further.

# bol.com

> Bearbeite bol.com-Kundenfragen als Tickets mit Live-Bestelldaten – und lass KI-Agenten Artikel stornieren oder Retouren bearbeiten.

Die bol.com-Integration macht aus den Kundenfragen, die bol.com an dein Support-Postfach weiterleitet, übersichtliche Tickets mit der passenden Bestellung. So beantwortest du (und deine KI-Agenten) bol.com-Käufer an derselben Stelle wie jeden anderen Kanal. Antworten gehen als normale E-Mail raus.

## Wann du sie nutzt

Nutze bol.com in Chatarmin CX, wenn:

* du auf bol.com (Niederlande und Belgien) verkaufst und Käufer dir über bol.com Fragen stellen
* du diese Fragen mit Bestellnummer und den Worten des Käufers sehen willst statt als rohe Weiterleitungs-E-Mail
* du die Live-Bestellung und ihre Retouren direkt am Ticket sehen willst
* KI-Agenten oder Makros bol.com-Käufern genauso antworten sollen wie per E-Mail – und KI-Agenten mit deiner Freigabe Artikel stornieren oder Retouren bearbeiten sollen

> [!NOTE]
>
> bol.com wird schrittweise freigeschaltet. Siehst du **bol.com** noch nicht unter Integrationen, [kontaktiere den Support](mailto:support@chatarmin.com) für den Zugang.

## So funktioniert es

Es gibt zwei Teile, die unabhängig voneinander funktionieren:

1. **Kundenfragen kommen per E-Mail.** bol.com schickt jede Kundenfrage schon heute an die Support-Adresse in deinem bol.com-Konto – von einer Weiterleitungsadresse, die auf `@partnerplatform.bol.com` endet. Chatarmin CX liest diese E-Mails in deinem verbundenen Postfach. Es ruft keine Nachrichten bei bol.com ab. Es erkennt Bestellnummer, die Case-ID von bol.com und die Nachricht des Käufers und zeigt das Ticket im Posteingang als **bol.com** an. Technisch bleibt es ein E-Mail-Ticket – deine E-Mail-Regeln, Workflows und KI-Agenten greifen also weiter.
2. **Bestelldaten kommen von bol.com.** Sobald du dein bol.com-Retailer-Konto verbindest, lädt Chatarmin CX mit der Bestellnummer aus der E-Mail die Live-Bestellung von bol.com: Status, Artikel, Lieferadresse und Retouren.

Da Antworten normale E-Mails sind, gelten die Sende-Limits des verknüpften E-Mail-Kanals. Ein eigenes bol.com-Limit musst du nicht einstellen.

## Einrichtung

Du brauchst **Admin**-Zugriff in Chatarmin CX (die Berechtigung **Integrationen verwalten**) und Zugriff auf dein bol.com Seller Dashboard.

**1. API-Zugangsdaten bei bol.com erstellen**

Gehe im bol.com Seller Dashboard zu **Instellingen** → **API Instellingen** und erstelle **Client credentials voor de Retailer API**. Kopiere die **Client ID** und das **Client Secret**. bol.com zeigt das Secret nur einmal an – bewahre es sicher auf, bis die Verbindung steht.

**2. bol.com in Chatarmin CX verbinden**

Gehe zu [Integrationen → bol.com](https://armin.cx/app/_/settings/integrations/bol_com) und klicke auf **Verbinden**. Füge Client ID und Client Secret ein und klicke erneut auf **Verbinden**. Chatarmin CX prüft die Zugangsdaten bei bol.com, bevor etwas gespeichert wird. Sind sie falsch, siehst du einen Fehler und es wird nichts gespeichert. Der verbundene Account trägt den Namen deines bol.com-Shops.

**3. Prüfen, ob dein Support-Postfach verbunden ist**

Stell sicher, dass die E-Mail-Adresse, an die bol.com Kundenfragen schickt, in Chatarmin CX als [E-Mail-Kanal](https://docs.armin.cx/de/channels/email/intro.md) verbunden ist. Beantwortet dein Team bol.com-Fragen schon aus diesem Postfach, musst du nichts ändern. Bei bol.com musst du keine Benachrichtigungseinstellungen anpassen.

### Testen

Such dir eine aktuelle bol.com-Kundenfrage in deinem Posteingang oder warte auf die nächste. Sie sollte in der Ticketliste als **bol.com** erscheinen, mit der Nachricht des Käufers im Ticket. Öffne sie und prüf die bol.com-Bestellkarte in der Seitenleiste: Sie zeigt Bestellstatus, Artikel mit Preis und Angebotsreferenz, Gesamtbetrag, Lieferadresse und eventuelle Retouren. Zeigt das Ticket weiterhin **E-Mail**, schau unter Fehlerbehebung.

## Bestelldaten im Ticket

Die bol.com-Bestellkarte zeigt:

* den Bestellstatus und die Artikel mit Preis und Angebotsreferenz
* Gesamtbetrag und Lieferadresse (Felder, die bol.com anonymisiert, werden ausgeblendet)
* ein Tag **Cancellation requested**, wenn der Käufer bei bol.com eine Stornierung angefragt hat
* die Retouren der Bestellung mit Bearbeitungsstatus und RMA-ID

Passt die Bestellnummer zu keiner Bestellung im verbundenen Konto, zeigt die Karte einen leeren Zustand. Bei Retouren prüft Chatarmin CX die jeweils neuesten 50 bearbeiteten und 50 unbearbeiteten Retouren deines Kontos.

## bol.com-Kunden antworten

Öffne das Ticket wie jedes andere und nutze **Antworten senden**. Deine Nachricht geht als normale E-Mail-Antwort über das verknüpfte Postfach raus, und bol.com leitet sie an den Käufer weiter.

> [!NOTE]
>
> KI-Agenten können auf bol.com-Tickets genauso Antworten entwerfen und senden wie bei E-Mail. Eine separate Einrichtung ist nicht nötig.

## Aktionen für KI-Agenten

Gib einem [KI-Agenten](https://docs.armin.cx/de/ai-agents/skills-and-actions.md) bol.com-Aktionen, wenn er Bestellungen und Retouren nachschlagen oder bearbeiten soll. Verbinde zuerst bol.com, aktiviere dann die Aktionen am Agenten und wähle, welchen verbundenen bol.com-Account er nutzen darf.

### Lese-Aktionen

* **Get bol.com order**: Schlägt eine Bestellung per Nummer nach – oder die Bestellung, um die es im Gespräch geht.
* **Get bol.com returns**: Schlägt eine Retoure nach oder die Retouren einer Bestellung (aus den neuesten 50 bearbeiteten und 50 unbearbeiteten Retouren).

### Schreib-Aktionen

* **Cancel bol.com order item**: Storniert einen Artikel, der noch nicht versendet ist. bol.com erstattet dem Käufer den Betrag. Ein versendeter Artikel läuft stattdessen über eine bol.com-Retoure.
* **Handle bol.com return**: Hält fest, wie eine Retoure bearbeitet wurde – mit einem der sechs Ergebnisse, die bol.com Händlern erlaubt, zum Beispiel **Return received** oder **Exchange product**. **Still approved** macht eine frühere Ablehnung rückgängig.

Beide Schreib-Aktionen brauchen standardmäßig eine [menschliche Freigabe](https://docs.armin.cx/de/ai-agents/human-in-the-loop.md). Eine Stornierung lässt sich nicht rückgängig machen – lass die Freigabe also an, bis du den Anweisungen des Agenten vertraust.

In einem Kundengespräch funktionieren die Aktionen nur für die Bestellung, die in der bol.com-E-Mail des Käufers steht. Ein Agent kann also nicht an der Bestellung eines anderen Käufers arbeiten. Testläufe simulieren Schreib-Aktionen, statt bei bol.com etwas zu ändern.

## Trennen oder neu verbinden

* **Neu verbinden:** Lehnt bol.com die gespeicherten Zugangsdaten ab – zum Beispiel weil du sie im Seller Dashboard gelöscht oder ersetzt hast – zeigt der Account **Reconnect required**. Erstelle neue Zugangsdaten bei bol.com, klick in [Integrationen → bol.com](https://armin.cx/app/_/settings/integrations/bol_com) auf den Account und gib das neue Client Secret ein. Die Client ID ist schon ausgefüllt; ändere sie mit, wenn du neue Zugangsdaten erstellt hast. Beim Speichern verschwindet der Hinweis.
* **Trennen:** Gehe zu [Integrationen → bol.com](https://armin.cx/app/_/settings/integrations/bol_com), öffne das Statusmenü des Accounts und wähle **Disconnect**. Das entfernt die bol.com-Verbindung – Bestelldaten und KI-Agenten-Aktionen funktionieren dann nicht mehr. Dein E-Mail-Kanal und bestehende Tickets bleiben erhalten. Für eine erneute Verbindung wiederholst du die Schritte unter **Einrichtung** oben.

## Fehlerbehebung

| Symptom | Was du prüfen solltest |
| - | - |
| bol.com-Tickets zeigen **E-Mail** statt **bol.com** | Nur Kundenfragen, die bol.com von einer `@partnerplatform.bol.com`-Adresse weiterleitet, erscheinen als bol.com. Mitteilungen von `klantbericht.bol.com`, `verkopen.bol.com` und `automail@bol.com` sind Konto-Hinweise, keine Käufernachrichten – sie bleiben normale E-Mails. |
| Es kommen keine Kundenfragen an | Prüfe, ob die Support-Adresse in deinem bol.com-Konto die ist, die in Chatarmin CX als E-Mail-Kanal verbunden ist. |
| Keine Bestelldaten am Ticket | Prüfe, ob der Account unter **Integrationen → bol.com** **Reconnect required** zeigt und ob die Bestellung zum verbundenen bol.com-Konto gehört. Bestellnummern, die ein Käufer mit Bindestrichen eintippt, werden nicht erkannt. |
| Eine Folgenachricht hat keine Bestellnummer | Folge-E-Mails, die nur den Case nennen, übernehmen die Bestellnummer aus der ersten E-Mail dieses Case. Ist die erste E-Mail nie in Chatarmin CX angekommen, gibt es keine Nummer zum Übernehmen. |
| Eine Retoure fehlt auf der Bestellkarte | Geprüft werden nur die neuesten 50 bearbeiteten und 50 unbearbeiteten Retouren. Ältere Retouren findest du im bol.com Seller Dashboard. |
| Antworten erreichen den Käufer nicht | Prüfe, ob der verknüpfte E-Mail-Kanal senden kann (eigene Verbindung ist gesund). bol.com leitet Antworten automatisch weiter – einen Approved-Senders-Schritt gibt es nicht. |
| **Reconnect required** am Account | bol.com hat die gespeicherte Client ID oder das Client Secret abgelehnt – meist, weil die Zugangsdaten im Seller Dashboard gelöscht oder ersetzt wurden. Erstelle neue Zugangsdaten und verbinde neu, siehe **Trennen oder neu verbinden** oben. |
| Beim Verbinden erscheint ein Fehler | Prüfe, ob du Client ID und Client Secret von **Client credentials voor de Retailer API** ohne zusätzliche Leerzeichen kopiert hast. Gespeichert wird erst, wenn bol.com sie akzeptiert. |

Löst das dein Problem nicht, [kontaktiere den Support](mailto:support@chatarmin.com) mit dem betroffenen Ticket oder der bol.com-Bestellnummer.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.