> ## 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.

# Zenfulfilment

> KI-Agenten den Status einer Zenfulfilment-Bestellung prüfen oder sie aus einem Ticket heraus stornieren lassen.

Die Zenfulfilment-Integration verbindet [Zenfulfilment](https://www.zenfulfilment.com), einen deutschen Fulfillment- und Versanddienstleister, mit Chatarmin CX. Sie lässt KI-Agenten den Status einer Bestellung prüfen oder sie aus einem Ticket heraus stornieren.

## Wann du es brauchst

Nutze Zenfulfilment, wenn deine Lagerbestellungen über Zenfulfilment versendet werden und dein Support-Team Folgendes bearbeitet:

* Fragen wie „Wo ist meine Bestellung?“, die den aktuellen Fulfillment-Status brauchen
* die Lieferadresse oder Artikel einer Bestellung prüfen, bevor du einem Kunden antwortest
* eine Bestellung stornieren, bevor sie verschickt wird, statt das Lager manuell zu kontaktieren

## Voraussetzungen

Du brauchst ein Zenfulfilment-Konto mit API-Zugang: eine **Client ID**, ein **Client Secret** und einen **API Key**. Frag deinen Zenfulfilment-Kontakt danach, falls du sie noch nicht hast.

## Einrichtung

<Steps>
  <Step title="Integrationen öffnen">
    [Öffne Integrationen](https://armin.cx/app/_/settings/integrations) in den Workspace-Einstellungen und wähle **Zenfulfilment**.
  </Step>

  <Step title="Konto verbinden">
    Klick auf **Verbinden**, trag **Client ID**, **Client Secret** und **API Key** ein und bestätige. cx meldet sich mit diesen Zugangsdaten bei Zenfulfilment an, bevor die Verbindung gespeichert wird — ein falscher Wert wird also sofort abgelehnt.
  </Step>

  <Step title="Verbindung prüfen">
    Füge einem KI-Agenten die Aktion **Get order** hinzu (siehe unten) und teste sie mit einer bekannten Bestellnummer, um zu prüfen, ob die Bestellung zurückkommt.
  </Step>
</Steps>

## Aktionen für KI-Agenten

Gib einem [KI-Agenten](/de/ai-agents/skills-and-actions) Zenfulfilment-Aktionen, wenn Automatisierung den Bestellstatus prüfen oder eine Bestellung stornieren soll. Verbinde zuerst Zenfulfilment, aktiviere dann die Aktionen am Agenten und wähle aus, welche verbundenen Zenfulfilment-Konten er nutzen darf.

### Get order

Fragt eine Zenfulfilment-Bestellung anhand der eigenen Bestellnummer des Shops ab (dieselbe Nummer wie in Shopify, zum Beispiel `#1164329`) und liefert Status, Lieferadresse und Positionen. Das ist eine Lese-Aktion und braucht keine Freigabe.

<Note>
  Bevor eine Bestellung zurückgegeben wird, prüft cx, ob die E-Mail der Bestellung zu einer E-Mail passt, die bereits am Ticket-Kontakt hinterlegt ist. Stimmt sie nicht überein — oder lässt sie sich nicht prüfen —, wird dem Agenten mitgeteilt, dass die Bestellung nicht gefunden wurde, statt ihm die Bestellung eines anderen Kunden zu zeigen.
</Note>

### Cancel order

Storniert eine Zenfulfilment-Bestellung anhand der eigenen Bestellnummer des Shops. **Das lässt sich nicht rückgängig machen.** Zenfulfilment lehnt die Anfrage ab, sobald eine Bestellung bereits verschickt wurde — sag dem Kunden in dem Fall, dass eine Stornierung zu spät ist, und biete stattdessen eine Rücksendung an.

Diese Aktion ist standardmäßig auf **Jedes Mal fragen** gesetzt. Testläufe von KI-Agenten simulieren die Stornierung und ändern nichts in Zenfulfilment. Prüf den Freigabe-Modus, bevor du ihn lockerst.

## Sicher testen

1. Nutze eine Bestellung, von der du weißt, dass sie noch nicht verschickt wurde.
2. Lass den Agenten im Testmodus laufen und prüf die simulierte Stornierung.
3. Kontrolliere die vorgeschlagene Bestellnummer, bevor du freigibst.
4. Gib die erste echte Stornierung nur für eine Test-Bestellung frei und prüf den stornierten Status in Zenfulfilment.

## Fehlerbehebung

| Symptom | Was du prüfen solltest |
| - | - |
| Verbinden schlägt sofort fehl | cx prüft Client ID, Client Secret und API Key per Login bei Zenfulfilment; kontrolliere die Werte erneut |
| Ein KI-Agent meldet, dass eine Bestellung nicht gefunden wurde | Prüf die Bestellnummer samt führendem `#`; die E-Mail der Bestellung muss außerdem zu einer E-Mail am Ticket-Kontakt passen |
| Cancel order wird abgelehnt | Die Bestellung wurde wahrscheinlich schon verschickt — sag dem Kunden, dass eine Stornierung zu spät ist, und biete eine Rücksendung an |


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