vendaeldocs
Integrationen

So funktionieren Integrationen

Trigger, Filter, Wiederholungen und die Garantien hinter jedem Connector

Jeder Connector folgt denselben Regeln - wer sie einmal verstanden hat, versteht alle.

Trigger-Status

Jede Verbindung hat einen Trigger: "handle, wenn die Bestellung … ist" (gekauft, bezahlt, versandt, angekommen). Die Bedeutung unterscheidet sich je nach Connector-Typ:

  • Rechnungen / Warenwirtschaft (Lexware, easybill, DreamRobot, Billbee): der Trigger bedeutet "dieser Status oder später". Eine Bestellung, die zwischen zwei Synchronisierungen von bezahlt direkt auf angekommen springt, bekommt trotzdem ihre Rechnung - nichts wird je übersehen.
  • Versand / Shop (Sendcloud, WooCommerce, Deutsche Post): ein Trigger gekauft oder bezahlt bedeutet nur aktive Bestellungen - Bestellungen, die bereits versandt oder angekommen sind, werden nie exportiert (es gibt nichts mehr zu verschicken). Wenn Sie versandte oder angekommene Bestellungen möchten, wählen Sie genau diesen Trigger.

Exactly-once-Lieferung

Jede Bestellung wird höchstens einmal pro Verbindung exportiert - Wiederholungen, erneutes Verbinden und manuelle Synchronisierungen können nie eine Rechnung oder Sendung duplizieren. Beim Löschen einer Verbindung merkt sich vendael, was bereits geliefert wurde; ein späteres erneutes Verbinden schiebt diese Bestellungen nicht noch einmal an. Nur der ausdrückliche Button "Alle Bestellungen erneut exportieren" übergeht dieses Gedächtnis.

Historien-Backfill

Beim Verbinden eines Tools kann optional die bestehende Bestellhistorie übertragen werden (Opt-in beim Verbinden; bei Lexware standardmäßig an). Deutsche Post überträgt nie die Historie - Briefmarken kosten echtes Geld.

Fehler und Wiederholungen

Vorübergehende Probleme (Ziel-API nicht erreichbar, Rate-Limits) werden automatisch mit steigenden Abständen wiederholt. Dauerhafte Probleme markieren die Bestellung als fehlgeschlagen, der Grund steht auf der Seite Integrationen - das rote Badge mit "Fehlgeschlagene wiederholen" lässt nach behobener Ursache alles Fehlgeschlagene mit einem Klick erneut laufen (falscher API-Schlüssel, fehlende Tarif-Funktion, leere Portokasse …).

Lehnt ein Tool Ihre Zugangsdaten ab, deaktiviert sich die Verbindung selbst und Sie erhalten eine E-Mail - Zugangsdaten über Bearbeiten aktualisieren und wieder aktivieren; ausstehende Exporte laufen automatisch weiter.

Versandarten-Filter

Sendcloud und WooCommerce lassen sich auf bestimmte Cardmarket-Versandarten beschränken (die Versandart-ID von cardmarket.com → Konto → Versandarten). Leerer Filter = alle Bestellungen werden übergeben.

Auf dieser Seite