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

# Quivo

> Zeige Quivo-Fulfillment-Bestellungen im Posteingang und lass KI-Agenten Stornierungen und Adressänderungen anfragen.

Die Quivo-Integration verbindet Chatarmin CX mit deinem Quivo-Lager, damit Agenten und KI-Agenten Bestell- und Sendungsstatus sehen und WISMO-, Storno- sowie Adressänderungs-Tickets bearbeiten können — ohne den Posteingang zu verlassen.

## Wann du es nutzt

Nutze Quivo in Chatarmin CX, wenn:

* du über Quivo fulfilst und Kunden fragen, wo ihre Bestellung ist
* ein Kunde stornieren möchte, bevor die Bestellung versendet wird
* ein Kunde sich bei der Adresse vertippt hat und sie vor dem Versand korrigiert werden muss
* KI-Agenten Bestellungen per E-Mail nachschlagen und Stornierungen oder Adressänderungen mit Freigabe vorschlagen sollen

## Einrichten

Du brauchst einen Quivo-API-Key, einen Username und ein Passwort. Anders als bei manch anderer Fulfillment-Integration brauchst du für Quivo keine Shopify-Verbindung — Quivo sucht Bestellungen direkt über die Kunden-E-Mail.

<Steps>
  <Step title="Integrationen öffnen">
    Geh zu [Integrationen](https://armin.cx/app/_/settings/integrations) und wähle **Quivo**.
  </Step>

  <Step title="Quivo verbinden">
    Klick auf **Verbinden** und gib deinen **API-Key**, **Username** und dein **Passwort** aus Quivo ein.
  </Step>

  <Step title="Speichern">
    Speichere die Verbindung. cx prüft alle drei Angaben zusammen, indem es sich vorab bei Quivo einloggt — schlägt der Login fehl, bekommst du eine Fehlermeldung und nichts wird gespeichert.
  </Step>

  <Step title="KI-Agenten-Aktionen aktivieren">
    Öffne in [KI-Agenten](https://armin.cx/app/_/ai/agents-v2) die Agenten für Bestell-Tickets und aktiviere die benötigten Quivo-Aktionen.
  </Step>
</Steps>

## Quivo im Posteingang nutzen

Passt ein Ticket-Kontakt zu einem Kunden mit Quivo-Bestellungen, zeigt das Kundenpanel diese Bestellungen mit Status, Positionen und Tracking.

<Steps>
  <Step title="Ticket öffnen">
    Öffne das Ticket des Kunden, der zur Bestellung geschrieben hat.
  </Step>

  <Step title="Bestellkarte prüfen">
    Jede Bestellung zeigt Bestellnummer, Status, Positionen und — falls vorhanden — einen Tracking-Link.
  </Step>

  <Step title="Volle Details ansehen">
    Klick auf **View details**, um die komplette Bestellung zu sehen: Liefer- und Rechnungsadresse, jede Position und die dahinterliegenden Fulfillment-Aufträge.
  </Step>

  <Step title="Stornierung anfragen">
    Klick auf **Request cancellation**, trag einen Grund ein und bestätige. Das *fragt nur eine Stornierung an* — Quivo kann sie trotzdem ablehnen, wenn die Bestellung schon versendet wurde. Sag dem Kunden "Stornierung angefragt", nicht "Bestellung storniert".
  </Step>

  <Step title="Adresse bearbeiten">
    Klick auf **Edit address**, um die Lieferadresse vor dem Versand zu korrigieren.
  </Step>
</Steps>

<Note>
  Cancel und Edit address gibt es nur, solange die Bestellung noch offen ist. Ist eine Bestellung **Delivered**, **Cancelled**, oder wurde schon eine Stornierung angefragt, verschwinden beide Buttons.
</Note>

## KI-Agenten-Aktionen

| Aktion | Zweck |
| - | - |
| **`quivo_cancel_order`** | Fragt die Stornierung einer Quivo-Bestellung an. Quivo kann ablehnen, wenn die Bestellung schon versendet wurde. |
| **`quivo_update_delivery_address`** | Aktualisiert die Lieferadresse einer Quivo-Bestellung vor dem Versand. |

<Warning>
  Beide Aktionen stehen standardmäßig auf **immer Freigabe erforderlich** — sie greifen in einen echten Versand ein, also lass die Freigabe an, wenn du keinen triftigen Grund dagegen hast.
</Warning>

## Best practices

* Lass die Freigabe für beide Quivo-Schreibaktionen an — eine falsche Stornierung oder Adressänderung lässt sich nicht immer rückgängig machen
* Sag Kunden, dass eine Stornierung "angefragt" ist, nicht "bestätigt", bis sich der Bestellstatus tatsächlich ändert
* Prüfe **View details**, bevor du eine Adresse änderst — stell sicher, welche Bestellung der Kunde meint, wenn mehrere offen sind
* Eskaliere an einen Menschen, sobald eine Bestellung als versendet gilt — Quivo nimmt dann keine Stornierungen oder Adressänderungen mehr an

## FAQ

**Was passiert, wenn ich auf Request cancellation klicke und Quivo ablehnt?**
Quivo kann die Anfrage ablehnen, meist weil die Bestellung schon versendet wurde. Der Bestellstatus ändert sich dann nicht auf storniert — prüf die Bestellung erneut oder wende dich an den Quivo-Support, wenn du unsicher bist.

**Brauche ich Shopify, um Quivo zu nutzen?**
Nein. Quivo sucht Bestellungen direkt über die Kunden-E-Mail, eine Shopify-Verbindung ist nicht nötig.

**Kann ich die Adresse noch ändern, nachdem die Bestellung versendet wurde?**
Nein. Ist eine Bestellung in einem terminalen Status (delivered oder cancelled) oder wurde schon eine Stornierung angefragt, werden Edit address und Request cancellation nicht mehr angezeigt.

**Brauchen KI-Agenten meine Freigabe, um Bestellungen zu stornieren oder Adressen zu ändern?**
Ja, standardmäßig. Beide Aktionen fragen jedes Mal um Freigabe, weil sie einen echten Versand betreffen.


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