---
title: "Rozliczaj rezerwacje z innego systemu kasowego"
description: "Pozwól zewnętrznemu systemowi kasowemu odczytać, ile wynosi rezerwacja, i odesłać sprzedaż, żeby rezerwacja została zakończona."
url: "https://bookatu.com/pl-pl/help/checkout-from-an-outside-till"
language: "pl"
section: "Pomoc"
category: "Dla programistów"
published: "2026-10-28"
updated: "2026-11-18"
---

# Rozliczaj rezerwacje z innego systemu kasowego

Pozwól zewnętrznemu systemowi kasowemu odczytać, ile wynosi rezerwacja, i odesłać sprzedaż, żeby rezerwacja została zakończona.

## Czym to jest

Przekazanie rozliczenia to jeden adres z dwoma wywołaniami: GET i POST /api/v1/{slug}/appointments/{id}/checkout. GET zwraca, ile wynosi rezerwacja: każdą usługę i dodatek z ich lineId i tym, kto je wykonał, cenę, rabaty, wiersze podatkowe, już zapłacony zadatek oraz dueCents, czyli dokładnie to, co trzeba pobrać. POST zapisuje sprzedaż, którą przyjął Twój system kasowy, kończy rezerwację i łączy z nią sprzedaż, używając tego samego kodu rozliczeń co własna kasa Bookatu.

## W czym pomaga

Nikt nie nabija wizyty dwa razy, a rezerwacja, sprzedaż, przypisanie personelu i pieniądze zgadzają się w Bookatu tak, jakby przyjęła je własna kasa Bookatu. Wysyłanie jest idempotentne względem Twojego externalSaleId, więc ponowna próba po zerwanym połączeniu zwraca replayed: true i niczego nie zapisuje.

## Jak z tego korzystać

1. Właściciele i administratorzy tworzą klucz w Settings, potem API & monitoring, w sekcji API keys. W What this key may do zaznacz oba pola w wierszu Checkout at another point of sale: See what a booking comes to at checkout (checkout:read) i Check bookings out from another point of sale (checkout:write). Trzeba je zaznaczyć samodzielnie, a klucz utworzony przed wprowadzeniem zakresów nigdy ich nie ma. Twórca klucza musi móc widzieć kalendarze wszystkich (dla checkout:read) i edytować kalendarz (dla checkout:write). Dodaj See bookings (bookings:read), żeby wyświetlać rezerwacje z danego dnia przez GET /appointments, i See clients (customers:read), jeśli Twój system kasowy potrzebuje imienia i nazwiska, e-maila i telefonu klienta. Bez tego klient jest podawany tylko przez id.
2. Wysyłaj klucz jako Authorization: Bearer w każdym wywołaniu. Wywołaj GET /api/v1/{slug}/appointments/{id}/checkout i nabij jego wiersze. checkout.allowed mówi, czy rezerwację można teraz rozliczyć, a checkout.blocked podaje powód: not_live, deposit_pending, already_checked_out albo invoiced. invoiced oznacza, że rezerwacja jest na fakturze i jest opłacana tam, więc nie pobieraj za nią pieniędzy w swoim systemie kasowym.
3. Przyjmij pieniądze, a potem wyślij POST na ten sam adres z { externalSaleId, source, amountCents, currency, tender, tipCents, tipSplit, lines }. externalSaleId to własny identyfikator sprzedaży Twojego systemu kasowego. source nazywa Twój system kasowy, na przykład front_desk_pos (domyślnie external i nigdy nie może być bookatu). amountCents musi być równe dueCents. currency jest opcjonalne, ale musi być walutą firmy. tender to card, cash albo other. lines, jako [{ lineId, staffId }], przypisuje wiersz komuś innemu.
4. Ponowne wysłanie tego samego externalSaleId z tego samego systemu kasowego zwraca pierwotną sprzedaż z replayed: true. Odmowy niczego nie zapisują i podają powód: 400 card_number (externalSaleId albo source wygląda jak numer karty, który nigdy nie jest przyjmowany); 409 amount_mismatch (z expectedCents), already_checked_out, external_sale_used, lines_changed (odczytaj rozliczenie ponownie), not_live, deposit_pending albo invoiced (rezerwacja jest opłacana na swojej fakturze); 422 currency albo tip_split; 503, dopóki przekazanie rozliczeń jest jeszcze włączane dla firmy.
5. Aby dostawać informację o każdym rozliczeniu, dodaj webhook w karcie Webhooks na tej samej stronie i zaznacz booking.checked_out w Only if you tick it. Nigdy nie jest wysyłany do punktu końcowego, który przyjmuje wszystkie zdarzenia. Wysyła się też przy rozliczeniach we własnej kasie Bookatu (sale.source bookatu), z tymi samymi danymi co GET i z klientem podanym tylko przez id.
6. Pełna dokumentacja, z każdym polem i przykładem, jest w dokumentacji dla programistów pod adresem /developers#checkout-handoff, a jako markdown pod adresem /developers.md.
