---
title: "Buchungen über ein anderes Kassensystem abrechnen"
description: "Lass ein externes Kassensystem lesen, was eine Buchung kostet, und den Verkauf zurückmelden, damit die Buchung abgeschlossen wird."
url: "https://bookatu.com/de-de/help/checkout-from-an-outside-till"
language: "de"
section: "Hilfe"
category: "Für Entwickler"
published: "2026-10-28"
updated: "2026-11-18"
---

# Buchungen über ein anderes Kassensystem abrechnen

Lass ein externes Kassensystem lesen, was eine Buchung kostet, und den Verkauf zurückmelden, damit die Buchung abgeschlossen wird.

## Was es ist

Die Checkout-Übergabe ist eine Adresse mit zwei Aufrufen: GET und POST /api/v1/{slug}/appointments/{id}/checkout. GET liefert, was die Buchung kostet: jede Leistung und jedes Extra mit seiner lineId und wer es gemacht hat, den Preis, Rabatte, Steuerzeilen, die schon bezahlte Anzahlung und dueCents, also genau den Betrag, den du kassieren sollst. POST hält den Verkauf fest, den dein Kassensystem gemacht hat, schließt die Buchung ab und verknüpft den Verkauf mit ihr, und nutzt dafür denselben Code zum Abrechnen wie die eigene Kasse von Bookatu.

## Warum es hilft

Niemand tippt einen Besuch zweimal ein, und Buchung, Verkauf, Gutschrift fürs Team und das Geld stimmen in Bookatu überein, als hätte die eigene Kasse von Bookatu kassiert. Das Senden ist idempotent über deine externalSaleId, ein erneuter Versuch nach einer abgebrochenen Verbindung liefert also replayed: true und schreibt nichts.

## So nutzt du es

1. Inhaber und Admins legen den Schlüssel unter Settings, dann API & monitoring, bei API keys an. Hak unter What this key may do in der Zeile Checkout at another point of sale beide Kästchen an: See what a booking comes to at checkout (checkout:read) und Check bookings out from another point of sale (checkout:write). Beide sind aus, bis du sie anhakst, und ein Schlüssel, der angelegt wurde, bevor es Scopes gab, hat sie nie. Wer den Schlüssel anlegt, muss den Kalender aller sehen können (für checkout:read) und den Kalender bearbeiten können (für checkout:write). Füg See bookings (bookings:read) hinzu, um mit GET /appointments die Buchungen des Tages aufzulisten, und See clients (customers:read), wenn dein Kassensystem Name, E-Mail und Telefonnummer des Kunden braucht. Ohne das kommt der Kunde nur mit seiner id.
2. Schick den Schlüssel bei jedem Aufruf als Authorization: Bearer. Ruf GET /api/v1/{slug}/appointments/{id}/checkout auf und tipp seine Zeilen ein. checkout.allowed sagt, ob die Buchung jetzt abgerechnet werden kann, und checkout.blocked nennt den Grund: not_live, deposit_pending, already_checked_out oder invoiced. invoiced heißt, die Buchung steht auf einer Rechnung und wird dort bezahlt, kassier an deinem Kassensystem also kein Geld dafür.
3. Kassier das Geld und schick dann einen POST an dieselbe Adresse mit { externalSaleId, source, amountCents, currency, tender, tipCents, tipSplit, lines }. externalSaleId ist die eigene Verkaufs-id deines Kassensystems. source nennt dein Kassensystem, etwa front_desk_pos (Standard ist external, und es darf nie bookatu sein). amountCents muss gleich dueCents sein. currency ist optional, muss aber die des Geschäfts sein. tender ist card, cash oder other. lines, als [{ lineId, staffId }], schreibt eine Zeile jemand anderem gut.
4. Schickst du dieselbe externalSaleId vom selben Kassensystem noch einmal, kommt der ursprüngliche Verkauf mit replayed: true zurück. Ablehnungen schreiben nichts und nennen einen Grund: 400 card_number (externalSaleId oder source sieht aus wie eine Kartennummer, was nie angenommen wird); 409 amount_mismatch (mit expectedCents), already_checked_out, external_sale_used, lines_changed (lies den Checkout noch einmal), not_live, deposit_pending oder invoiced (die Buchung wird über ihre Rechnung bezahlt); 422 currency oder tip_split; 503, solange die Übergabe für das Geschäft noch eingeschaltet wird.
5. Um von jedem Checkout zu erfahren, füg in der Karte Webhooks auf derselben Seite einen Webhook hinzu und hak booking.checked_out unter Only if you tick it an. Er wird nie an einen Endpunkt geschickt, der alle Ereignisse annimmt. Er wird auch bei Checkouts an der eigenen Kasse von Bookatu ausgelöst (sale.source bookatu), mit derselben Payload wie GET und dem Kunden nur mit seiner id.
6. Die vollständige Referenz mit jedem Feld und Beispiel steht in der Doku für Entwickler unter /developers#checkout-handoff, und als Markdown unter /developers.md.
