quartiero · Anleitungen

Buchungen vom iPhone direkt in quartiero

Buchungen aus der Pulse-App oder von Airbnb per Teilen-Funktion übernehmen — ohne Abtippen. Einrichtung des iOS-Kurzbefehls, Schritt für Schritt.

Acht Schritte · 15–20 Minuten

Bevor Sie anfangen

Die zwei Fallen, an denen fast jeder hängenbleibt. Erstens: In Schritt 6 muss eine Variable aus der Vorschlagsleiste ausgewählt werden — abgetippt sieht sie gleich aus, funktioniert aber nicht. Zweitens: Die Reihenfolge der drei Aktionen in Schritt 3 entscheidet alles. Beides ist unten ausführlich erklärt.
1

Den Schlüssel aus quartiero holen

Der Kurzbefehl braucht einen Zugangsschlüssel, damit quartiero weiß, wem die Buchung gehört. Den holst Sie zuerst — dann liegt er in der Zwischenablage bereit.

  1. quartiero im Browser öffnen und anmelden
  2. Unten auf Menü tippen
  3. Teilen-Funktion auswählen
  4. Nach unten scrollen bis zum Abschnitt mit dem Schlüssel
  5. Auf Kopieren tippen Nicht den Text von Hand markieren — dabei fehlt schnell ein Zeichen am Anfang oder Ende.
Behandle den Schlüssel wie ein Passwort. Er ersetzt beim Import Ihre Anmeldung. Nicht weitergeben, keine Screenshots davon verschicken. Falls er doch einmal in falsche Hände gerät: an derselben Stelle neu erzeugen, der alte wird sofort ungültig.
2

Einen leeren Kurzbefehl anlegen

  1. App Kurzbefehle öffnen
  2. Unten Kurzbefehle auswählen, falls Sie woanders landen
  3. Oben rechts auf das + tippen
  4. Oben auf Neuer Kurzbefehl tippen — der Name lässt sich ändern
  5. Umbenennen wählen und Quartiero eingeben Unter diesem Namen erscheint er später im Teilen-Menü.
  6. Mit Fertig bestätigen
3

Drei Aktionen — die Reihenfolge ist entscheidend

Ein Kurzbefehl ist eine Kette. Jede Aktion gibt ihr Ergebnis an die nächste weiter. Steht eine an der falschen Stelle, wird das Falsche weitergereicht — und am Ende kommt nichts an.

  1. Unten ins Suchfeld Aktionen suchen tippen
  2. Share-Sheet eingeben
  3. Vom Share-Sheet erhalten antippen — sie erscheint oben
  4. Wieder ins Suchfeld, Base64 eingeben
  5. Base64 codieren antippen
  6. Wieder ins Suchfeld, Inhalte von URL eingeben
  7. Inhalte von URL abrufen antippen

Jetzt stehen drei Karten untereinander. Vergleiche mit dem Bild:

Die drei Aktionen in richtiger Reihenfolge
Zwischen den Karten stehen die blauen Verbindungen Kurzbefehleingabe und Base64-Codiert. Daran erkennst Sie, dass die Kette stimmt.
Falsche Reihenfolge? Halte den Anfasser rechts an der Karte (die drei waagerechten Striche) gedrückt und zieh sie an die richtige Stelle. „Base64 codieren" muss in der Mitte stehen — niemals unter „Inhalte von URL abrufen".
4

Base64 einstellen

Zwei Einstellungen an der mittleren Karte.

  1. Auf der Karte Base64 codieren den Pfeil rechts antippen
  2. Prüfen: Vor „mit Base64 codieren" muss Kurzbefehleingabe stehen Steht dort etwas anderes, antippen und Kurzbefehleingabe wählen.
  3. Bei Zeilenumbrüche auf den Wert tippen
  4. Keine auswählen Voreingestellt sind „Alle 76 Zeichen". Das bläht die Übertragung auf.
5

Die Verbindung zu quartiero eintragen

  1. Auf der Karte Inhalte von URL abrufen ins Adressfeld tippen
  2. Eingeben: https://app.quartiero.de/api/share/incoming Genau so, ohne Leerzeichen am Ende.
  3. Rechts auf den Pfeil nach unten tippen — die weiteren Felder klappen auf
  4. Bei Methode auf den Wert tippen und POST wählen
  5. Bei Haupttext anfordern auf den Wert tippen und JSON wählen
Die Aktion mit Adresse, POST und JSON
So sieht die Karte aus, wenn die drei Einstellungen stimmen. Die zwei Felder darunter legst Sie gleich an.
6

Zwei Felder anlegen — hier ist Sorgfalt nötig

Jetzt kommt der Teil, an dem die meisten scheitern. Lies ihn einmal ganz durch, bevor Sie anfangen.

Feld 1 — der Schlüssel:

  1. Auf neues Feld hinzufügen tippen
  2. Links in das Feld Schlüssel tippen und token eingeben Alles klein. Nicht die Leertaste drücken und nicht auf einen Vorschlag über der Tastatur tippen — dabei hängt iOS ein unsichtbares Leerzeichen an, und der Kurzbefehl funktioniert nicht.
  3. Rechts in das Feld Text tippen
  4. Den Schlüssel aus Schritt 1 einsetzen (Finger gedrückt halten → Einsetzen)

Feld 2 — die Datei:

  1. Wieder auf neues Feld hinzufügen tippen
  2. Links image eingeben — wieder ohne Leerzeichen
  3. Rechts auf das Wort Text tippen (nicht in das Feld daneben)
  4. In der Auswahl Wörterbuch wählen Bleibt es auf „Text", kommt die Datei nicht an.
  5. Rechts auf Wörterbuch konfigurieren tippen — eine neue Seite öffnet sich

Im Wörterbuch — die kritische Stelle:

  1. Auf neues Feld hinzufügen tippen
  2. Links base64 eingeben
  3. Rechts in das Wertfeld tippen — die Tastatur erscheint
  4. Über der Tastatur erscheint eine Leiste mit Vorschlägen. Dort auf Base64-Codiert tippen Erscheint sie nicht, tipp links in der Leiste auf das Variablen-Symbol. Dann siehst Sie alle Ergebnisse der vorherigen Aktionen.
  5. Nochmal neues Feld hinzufügen
  6. Links mediaType, rechts image/jpeg eingeben Das bleibt so, auch bei PDFs. quartiero erkennt selbst, was ankommt.
  7. Oben rechts auf Fertig

Jetzt der entscheidende Vergleich. Bei base64 muss die Variable blau hinterlegt stehen, mit einem kleinen Symbol davor. Ist es normale schwarze Schrift, wurde der Name nur abgetippt — dann schickt der Kurzbefehl den Text statt der Datei.

Richtig: blau hinterlegte Variable
RICHTIG — blau hinterlegt, mit Symbol. Das ist eine echte Variable.
Falsch: Variablenname als Text
FALSCH — normale Schrift. Damit kommt nur der Name an, nicht die Datei.
Steht dort schwarze Schrift? Wertfeld antippen, alles löschen, dann die Variable aus der Vorschlagsleiste antippen. Abtippen oder Einfügen aus der Zwischenablage führt immer wieder zum selben Fehler.
7

Im Teilen-Menü sichtbar machen

  1. Unten auf das ⓘ tippen
  2. Im Share-Sheet anzeigen einschalten — der Schalter wird grün
Der Schalter für das Teilen-Menü
Ohne diesen Schalter taucht der Kurzbefehl beim Teilen nicht auf.
  1. Auf die Zeile direkt darunter tippen (die akzeptierten Typen)
  2. Einschalten: Bilder, Dateien, PDFs
  3. Alles andere ausschalten
  4. Oben rechts auf den blauen Haken
  5. Nochmal auf Fertig
Auswahl der akzeptierten Typen
Airbnb teilt Screenshots, Pulse teilt PDFs — deshalb beides. Der Rest bleibt aus, damit der Kurzbefehl nur dort erscheint, wo er hilft.
8

Der erste Versuch

  1. Pulse-App öffnen
  2. Eine Buchung antippen
  3. Oben rechts auf das Teilen-Symbol
  4. In der Liste nach unten scrollen bis Quartiero
  5. Antippen

Beim ersten Mal fragt iOS um Erlaubnis:

Der Berechtigungsdialog von iOS
Auf Immer erlauben tippen — sonst fragt iOS bei jeder einzelnen Buchung erneut.

Nach ein paar Sekunden meldet der Kurzbefehl das Ergebnis. Steht dort "enriched" : true, ist die Buchung in quartiero angekommen und ergänzt.

Erfolgsmeldung mit enriched true
So sieht Erfolg aus: Gastname, Apartment und die Bestätigung, dass die Zuordnung eindeutig war.
Keine Meldung zu sehen? Dann fehlt eine Anzeige-Aktion. Öffne den Kurzbefehl, such nach Schnellansicht und häng die Aktion ganz unten an. Sie ist auch später nützlich, falls einmal etwas klemmt.

Wenn etwas nicht klappt

Die Meldung sagt ziemlich genau, woran es liegt. Such Ihre hier heraus.

„Im gesendeten JSON fehlt das Feld token"

An einem Feldnamen klebt ein unsichtbares Leerzeichen — meist entsteht es, wenn man beim Tippen einen Vorschlag über der Tastatur antippt.

Beide Felder mit dem roten Minus löschen und neu anlegen. Beim Eingeben von token und image die Vorschlagsleiste ignorieren und die Leertaste nicht berühren.

„Ungültiger oder fehlender Share-Token"

Der Wert im Feld token passt nicht. Meist ist beim Markieren von Hand ein Zeichen verloren gegangen.

Hol ihn in quartiero neu über den Kopieren-Knopf, lösch im Kurzbefehl den alten Wert vollständig und setz den neuen ein. Der Schlüssel beginnt mit btk_ und ist 52 Zeichen lang.

„Image content must be a URL …" oder „Value error"

Das ist die häufigste Ursache überhaupt: Bei base64 steht der Variablenname als Text statt als Variable.

Vergleich es mit den beiden Bildern in Schritt 6. Die Variable muss blau hinterlegt sein. Wertfeld leeren und die Variable aus der Vorschlagsleiste antippen — nicht abtippen.

„Keine Dateien übergeben"

Das Feld image steht noch auf Typ Text statt auf Wörterbuch.

Tipp in der Zeile auf das Wort „Text" — dann erscheint die Auswahl.

„KI-Integration nicht konfiguriert"

In quartiero fehlt der Schlüssel für die Texterkennung. Ohne ihn kann die Buchung nicht ausgelesen werden.

Zu finden unter Einstellungen → KI-Integration.

Es passiert überhaupt nichts

Meistens steht „Base64 codieren" an der falschen Stelle — unter dem URL-Aufruf statt in der Mitte.

Vergleich die Reihenfolge mit dem Bild in Schritt 3. Zwischen den Karten müssen die blauen Verbindungen „Kurzbefehleingabe" und „Base64-Codiert" stehen.

Quartiero fehlt im Teilen-Menü

Scroll in der Liste ganz nach unten bis Aktionen bearbeiten, tipp darauf und schalte Quartiero ein. Danach kannst Sie es nach oben ziehen.

Hilft das nicht, starte das iPhone einmal neu — iOS übernimmt neue Kurzbefehle gelegentlich erst danach.

„enriched": false — keine Buchung ergänzt

Die Erkennung hat funktioniert, aber quartiero war sich nicht sicher, welche Buchung gemeint ist. Der Grund steht daneben unter matchReason.

Das passiert etwa, wenn zwei Unterkünfte im selben Zeitraum belegt sind und im Dokument kein Name steht. Öffne dann den Link aus der Antwort und wähl die Buchung von Hand. Absicht: Lieber einmal nachfragen als die falsche Buchung überschreiben.