bookeo_get_api_key_info
Get API key info
Show which Bookeo account the credentials belong to and which permissions were granted (e.g. bookings_rw_all, customers_r_all, availability_r). A cheap way to confirm the setup works. Bookeo: GET /settings/apikeyinfo.
無需輸入參數。
bookeo_get_business
Get the business
Get the business's name, contact details, address, website and description. Bookeo: GET /settings/business.
無需輸入參數。
bookeo_list_products
List products
List the bookable products (tours, classes, courses, appointments) with their ids, type (fixed, fixedCourse, flexibleTime), duration, participant limits per people category, default rates and options. Bookeo: GET /settings/products.
輸入參數langtypepageNumberitemsPerPagepageNavigationToken
bookeo_list_people_categories
List people categories
List the participant categories the account uses (default Adults/Children/Infants plus custom ones like Students), with their ids and seats taken. Needed for peopleNumbers. Bookeo: GET /settings/peoplecategories.
無需輸入參數。
bookeo_list_resources
List resources
List resource types and their resources (guides, instructors, rooms, boats...) with ids. Bookeo: GET /settings/resources.
輸入參數pageNumberitemsPerPagepageNavigationToken
bookeo_get_availability_slots
Get availability slots
List available slots (eventId, start/end, seats available) for fixed and fixedCourse products in a time window of at most 31 days. Not for flexibleTime products — use bookeo_search_matching_slots for those. Bookeo: GET /availability/slots.
輸入參數modeendTimeproductIdstartTimepageNumberitemsPerPagepageNavigationToken
bookeo_search_matching_slots
Search matching slots
Find slots that can take a given party (participant counts per category, options, resources), with an estimated price. Works for all product types, including flexibleTime appointments. Window max 31 days. To page through results pass only pageNavigationToken (+ pageNumber). Read-only. Bookeo: POST /availability/matchingslots, GET /availability/matchingslots/{pageNavigationToken}.
輸入參數modeendTimeoptionsproductIdresourcesstartTimepageNumberitemsPerPagepeopleNumberspageNavigationToken
bookeo_list_bookings
List bookings
List bookings by start time (startTime+endTime) and/or by last change (lastUpdatedStartTime+lastUpdatedEndTime) — at least one pair is required, each spanning at most 31 days. Optionally filter by product, include canceled bookings, and expand customer/participant details. Bookeo: GET /bookings.
輸入參數endTimeproductIdstartTimepageNumberitemsPerPageexpandCustomerincludeCanceledexpandParticipantslastUpdatedEndTimepageNavigationTokenlastUpdatedStartTime
bookeo_get_booking
Get a booking
Get one booking by its booking number: product, times, participants, options, price, paid amount, status (canceled/accepted/noShow). Bookeo: GET /bookings/{bookingNumber}.
輸入參數bookingNumber必填expandCustomerexpandParticipants
bookeo_list_booking_payments
List a booking's payments
List the payments (and refunds, as negative amounts) received for one booking. Bookeo: GET /bookings/{bookingNumber}/payments.
輸入參數pageNumberitemsPerPagebookingNumber必填pageNavigationToken
bookeo_list_customers
List customers
List or search customers — by name, firstName, lastName or emailAddress — optionally only members/non-members or those created since a date. Bookeo: GET /customers.
輸入參數pageNumbersearchTextsearchFieldcreatedSinceitemsPerPagecurrentMemberscurrentNonMemberspageNavigationToken
bookeo_get_customer
Get a customer
Get one customer: contact details, next/previous booking, number of bookings, cancellations and no-shows, membership and store credit. Bookeo: GET /customers/{id}.
輸入參數id必填
bookeo_list_customer_bookings
List a customer's bookings
List one customer's bookings, optionally between two dates. Bookeo: GET /customers/{id}/bookings.
輸入參數id必填endDatebeginDatepageNumberitemsPerPageexpandParticipantspageNavigationToken
bookeo_list_payments
List payments
List payments received in a time period, optionally by payment method. Refunds are included with a negative amount. Bookeo: GET /payments.
輸入參數endTimestartTimepageNumberitemsPerPagepaymentMethodpaymentMethodOtherpageNavigationToken
bookeo_get_payment
Get a payment
Get one payment: amount, method, reason, received time, customer and gateway transaction id. Bookeo: GET /payments/{id}.
輸入參數id必填
bookeo_create_hold
Hold seats (price check)
Temporarily reserve the seats/resources for a draft booking (default 300 s, max 600 s) and get the FINAL price, taxes and amount payable. The recommended step before bookeo_create_booking: pass the returned hold id as previousHoldId there. Holds expire automatically. Bookeo: POST /holds.
輸入參數endTimeeventIdoptionscustomerproductId必填resourcesstartTimecustomerIdexternalRefprivateEventpeopleNumbers必填previousHoldId另有 2 個
bookeo_create_booking
Create a booking
Create a confirmed booking for an existing customer (customerId) or a new one (customer). fixed/fixedCourse products need an eventId from the availability tools; flexibleTime products take eventId or startTime. Pass previousHoldId to convert a hold. Does NOT record any payment. Reversible with bookeo_cancel_booking. Bookeo: POST /bookings.
輸入參數modeendTimeeventIdoptionscustomerproductId必填resourcesstartTimecustomerIdexternalRefnotifyUsersprivateEvent另有 6 個
bookeo_update_booking
Update a booking
Change an existing booking — reschedule (eventId or startTime/endTime), change participant counts, options, resources or external reference. Fetches the current booking and sends it back with only your changes applied (Bookeo's PUT takes the full booking). Bookeo: GET then PUT /bookings/{bookingNumber}.
輸入參數modeendTimeeventIdoptionsresourcesstartTimeexternalRefnotifyUsersbookingNumber必填peopleNumbersnotifyCustomerpromotionCodeInput
bookeo_cancel_booking
Cancel a booking
Cancel a booking. It stays in the system (visible with includeCanceled) but frees its seats. The account's cancellation policy is NOT applied, so no cancellation fee is charged. Bookeo: DELETE /bookings/{bookingNumber}.
輸入參數reasonnotifyUsersbookingNumber必填notifyCustomercancelRemainingSeriestrackInCustomerHistory
bookeo_create_customer
Create a customer
Create a customer record. Not needed before booking — bookeo_create_booking can create the customer inline. Bookeo: POST /customers.
輸入參數genderlastName必填firstName必填middleNamedateOfBirthemailAddresslanguageCodephoneNumbersstreetAddressacceptSmsReminders
bookeo_update_customer
Update a customer
Update a customer's contact details. Fetches the current record and sends it back with only your changes applied (Bookeo's PUT takes the full customer). Bookeo: GET then PUT /customers/{id}.
輸入參數id必填genderlastNamefirstNamemiddleNamedateOfBirthemailAddresslanguageCodephoneNumbersstreetAddressacceptSmsReminders