Księgowość bez przepisywania
Raz w miesiącu pobierasz potwierdzone rezerwacje z kwotami i wrzucasz je do programu księgowego. Koniec z ręcznym przenoszeniem liczb z panelu do arkusza.
GET /reservations?status=confirmed
API erphome.pl to interfejs REST, którym pobierzesz z własnego konta rezerwacje, zajęte terminy, cennik, opinie i statystyki, a także dodasz rezerwację ręczną, wyślesz e-mail do gościa i wygenerujesz link do płatności. Dane wracają w JSON, autoryzacja to token Bearer z zakresami nadawanymi przez właściciela konta. Specyfikacja w standardzie OpenAPI 3.1.
Aktualizacja: 2026-09-09. Wiążąca jest specyfikacja OpenAPI, do której linkujemy niżej.
Dwanaście operacji na danych własnego konta. Każda wymaga tokenu z konkretnym zakresem, więc integracja dostaje dokładnie tyle, ile ma robić.
| Zasób | Co dostajesz | Wywołanie | Zakres tokenu |
|---|---|---|---|
| Tożsamość konta | Nazwa firmy i e-mail właściciela, żeby potwierdzić że token działa i podpisać nim połączenie w narzędziu typu Zapier/Make. Jedyny endpoint bez wymogu zakresu — działa z każdym ważnym tokenem. | GET /me |
brak |
| Apartamenty | Lista apartamentów konta z ich identyfikatorami. Od tego zaczyna każda integracja, bo reszta filtruje po apartment_id. | GET /apartments |
apartments:read |
| Rezerwacje | Lista ze wszystkich apartamentów, z filtrem po dacie, statusie i apartamencie, stronicowana kursorem. | GET /reservations |
reservations:read |
| Jedna rezerwacja | Dane gościa, kwota, promocja i kaucja pojedynczej rezerwacji. | GET /reservations/{id} |
reservations:read |
| Rezerwacja ręczna | Dopisanie rezerwacji spoza strony, z odrzuceniem kolidujących terminów. | POST /reservations |
reservations:write |
| Wiadomości | Cały wątek korespondencji z gościem, razem z e-mailami automatycznymi. | GET /reservations/{id}/messages |
messages:read |
| E-mail do gościa | Wysyłka wiadomości na adres gościa i zapis w wątku rezerwacji. | POST /reservations/{id}/messages |
messages:write |
| Link do płatności | Transakcja Przelewy24 na Twoich danych, link jednorazowy, ważny dobę. | POST /reservations/{id}/payment-link |
payments:write |
| Dostępność | Same zajęte przedziały dat, bez danych gości. Domyślnie rok do przodu. | GET /availability |
availability:read |
| Blokady terminów | Terminy zablokowane ręcznie: remont, pobyt własny, przerwa techniczna. | GET /blocks |
blocks:read |
| Cennik | Ceny sezonowe, minimalne długości pobytu i opłaty dodatkowe. | GET /pricing |
pricing:read |
| Opinie gości | Oceny z treścią, gwiazdkami, statusem moderacji i odpowiedzią właściciela. | GET /reviews |
reviews:read |
| Statystyki | Obłożenie i przychód miesiąc po miesiącu dla wskazanego apartamentu. | GET /stats |
stats:read |
Zakładka API w panelu. Zaznaczasz tylko te zakresy, których integracja naprawdę potrzebuje.
Token pokazujemy jeden raz, przy tworzeniu. Zgubiony kasujesz i wystawiasz nowy.
Każde zapytanie niesie nagłówek Authorization z tym tokenem. Reszta to zwykły HTTP.
curl -H "Authorization: Bearer erph_live_..." \
"https://api.erphome.pl/v1/reservations?status=confirmed&from=2026-09-01"{
"data": [
{
"id": 128,
"apartment_id": 3,
"status": "confirmed",
"source": "online",
"check_in": "2026-09-12",
"check_out": "2026-09-15",
"guests": 2,
"guest": {
"name": "Anna Kowalska",
"email": "[email protected]"
},
"amount_pln": 1350,
"deposit": { "amount_pln": 300, "status": "paid" }
}
],
"pagination": { "limit": 100, "has_more": false, "next_after": null }
}Pięć zastosowań, po które właściciele sięgają najczęściej. Każde da się złożyć z operacji z tabeli powyżej.
Raz w miesiącu pobierasz potwierdzone rezerwacje z kwotami i wrzucasz je do programu księgowego. Koniec z ręcznym przenoszeniem liczb z panelu do arkusza.
GET /reservations?status=confirmed
Obłożenie i przychód miesiąc po miesiącu, gotowe do wykresu w Arkuszach Google czy Power BI.
GET /stats
Zajęte terminy bez danych gości, więc pokażesz dostępność na blogu albo w aplikacji, nie ujawniając niczego o gościach.
GET /availability
Scenariusz wysyła gościowi wiadomość na Twój sygnał, a cała korespondencja zostaje widoczna w panelu.
POST /reservations/{id}/messages
Rezerwacja przyjęta telefonicznie albo z portalu bez iCala wchodzi skryptem i od razu blokuje termin.
POST /reservations
Granice są tu celowe. Lepiej wiedzieć o nich przed napisaniem integracji niż po.
Nie. Wchodzi w abonament i działa od pierwszego dnia 14-dniowego okresu próbnego. Nie ma opłaty za wywołania ani limitu liczby tokenów, jest tylko limit częstotliwości: 300 zapytań GET i 60 POST na 10 minut na token.
Z panelu, zakładka API (panel.erphome.pl). Wystawia go wyłącznie właściciel konta, sub-użytkownicy panelu tej zakładki nie widzą. Token pokazujemy jeden raz, przy tworzeniu, więc trzeba go od razu skopiować do integracji.
Tak, o ile trafiły do Twojego kalendarza przez synchronizację iCal. Wyglądają wtedy jak zajęte terminy, bo portale nie przekazują w iCalu ani danych gościa, ani kwoty. Pełne dane mają rezerwacje z Twojej strony i te dopisane ręcznie.
Nie, i to jest decyzja projektowa. Zmiana terminu i anulowanie zostają w panelu, gdzie widać kalendarz i wiadomości, które przy takiej zmianie pójdą do gościa. Przez API dodasz nową rezerwację, odczytasz każdą i wyślesz wiadomość.
Tak. Odczyty domyślnie obejmują wszystkie apartamenty konta, a parametr apartment_id zawęża je do jednego. Wyjątkiem są statystyki, gdzie apartment_id jest wymagany: obłożenia apartamentów o różnych cenach za noc nie da się sensownie zsumować w jedną liczbę.
Tak, zwykłym blokiem HTTP z nagłówkiem Authorization: Bearer i adresem endpointu. Gotowej wtyczki do tych narzędzi nie publikujemy, bo API jest na tyle proste, że blok HTTP wystarcza.
API działa od pierwszego dnia okresu próbnego i nie jest osobno płatne. 14 dni za darmo, bez karty.