Rezerwacje

Katalog zwraca aktywne usługi rezerwacji i aktywnych specjalistów placówki. Identyfikatory z katalogu to parametry service i resource dla wolnych terminów oraz pola serviceId i resourceId przy rezerwacji.

curl "https://app.pozyskajpacjenta.pl/api/v1/booking/catalog" \
  -H "Authorization: Bearer pp_live_TWOJ_KLUCZ"

{
  "services": [
    {
      "id": "bs_4k9x2m",
      "name": "Konsultacja implantologiczna",
      "durationMin": 30,
      "priceLabel": "300 zł",
      "resourceIds": ["br_7q1w3e"],
      "serviceSlug": "implanty",
      "nfz": false
    }
  ],
  "resources": [
    {
      "id": "br_7q1w3e",
      "name": "Anna Kowalska",
      "title": "lek. dent.",
      "doctorSlug": "anna-kowalska"
    }
  ]
}

• priceLabel to cena samej wizyty, np. konsultacja za 300 zł, nawet gdy powiązany zabieg kosztuje „od 3 200 zł”. Gdy placówka nie podała ceny wizyty, widzisz cenę powiązanego zabiegu (priceFromLabel z GET /api/v1/services/{slug}), a gdy nie ma żadnej — null. Tak działa od wersji 1.8.1, tak samo jak widżet rezerwacji na stronie placówki.
• resourceIds to specjaliści, u których da się umówić tę usługę. Pusta lista oznacza, że dziś nie ma u kogo jej umówić.
• serviceSlug i doctorSlug prowadzą do opublikowanego zabiegu i profilu w zespole. W drugą stronę działają pola bookingServiceId zabiegu i bookingResourceId profilu (Encje): przycisk „Umów” na stronie zabiegu ma od razu właściwe id usługi. Wartość null oznacza, że tej pozycji nie da się umówić online.
• nfz (od 1.8.0): true oznacza świadczenie NFZ. Pokaż je z dopiskiem „rejestracja telefoniczna” i telefonem placówki — online się go nie umówi: /booking/slots i /booking/appointments odpowiadają 400 z code: "nfz_phone_only". Brak pola (starszy serwer) znaczy false.

Terminy liczymy na żywo z grafików, urlopów i już umówionych wizyt. Zakres to najwyżej 31 dni; bez parametru resource dostajesz terminy wszystkich specjalistów wykonujących usługę. Odpowiedź nie jest cache'owana.

curl "https://app.pozyskajpacjenta.pl/api/v1/booking/slots?service=bs_4k9x2m&from=2026-10-05&to=2026-10-09" \
  -H "Authorization: Bearer pp_live_TWOJ_KLUCZ"

startAt musi pochodzić z listy wolnych terminów. Pacjent trafia do CRM jako lead (znajdowany po telefonie albo tworzony), a placówka dostaje wizytę w kalendarzu i e-mail „Nowa wizyta” z plikiem .ics na adres powiadomień.

curl -X POST "https://app.pozyskajpacjenta.pl/api/v1/booking/appointments" \
  -H "Authorization: Bearer pp_live_TWOJ_KLUCZ" \
  -H "Content-Type: application/json" \
  -d '{
    "serviceId": "bs_4k9x2m",
    "resourceId": "br_7q1w3e",
    "startAt": 1791187200,
    "patient": { "name": "Jan Nowak", "phone": "+48 600 100 200" }
  }'

Od 1.7.0: rezerwacja opiera się na art. 6 ust. 1 lit. b i art. 9 ust. 2 lit. h RODO, więc formularz nie ma wymaganej zgody na przetwarzanie. Pokaż pod nim klauzulę informacyjną z GET /api/v1/privacy i opcjonalne, niezaznaczone pole zgody marketingowej, a w treści rezerwacji wyślij privacyNoticeVersion i (gdy pacjent zaznaczył pole) marketingConsent: true. Wizyta zapisze wersję klauzuli i czas wysłania. Zgoda marketingowa bez privacyNoticeVersion nie jest zapisywana, a u powracającego pacjenta zgoda e-mail obejmuje tylko adres zapisany przy jego leadzie.

Jeśli ktoś zajął ten termin w międzyczasie, dostajesz 409 i nic się nie zapisuje. Odpowiedź zawiera świeżą listę wolnych terminów tego dnia, więc możesz od razu zaproponować pacjentowi inny:

{
  "error": "slot_taken",
  "slots": [
    {
      "resourceId": "br_7q1w3e",
      "startAt": 1791189000,
      "endAt": 1791190800,
      "localDate": "2026-10-05",
      "localStartMin": 630
    }
  ]
}

BookingCatalogService — usługa w katalogu

BookingCatalogResource — specjalista w katalogu

Slot — wolny termin

SlotTaken — odpowiedź 409 na zajęty termin