Reservation

The Reservation module provides complete booking functionality including services, providers, availability, and checkout.

Services

Services represent bookable offerings (haircuts, consultations, classes, etc.).

Create Service

Create a new bookable service.

const result = await sdk.reservation.createService({
key: 'haircut',
nodeIds: ['node_services', 'node_hair'],
blocks: [
  {
    key: 'description',
    type: 'TEXT',
    content: {
      body: { en: 'Professional haircut service' }
    }
  }
],
prices: [
  { market: 'USD', amount: 3500 },
  { market: 'EUR', amount: 3200 }
],
durations: [
  { duration: 30, isPause: false },
  { duration: 45, isPause: false }
],
isApprovalRequired: false,
status: 'ACTIVE',
providers: [
  {
    providerId: 'prv_sarah',
    workingDays: [
      { day: 'MONDAY', workingHours: [{ from: 540, to: 1020 }] },
      { day: 'TUESDAY', workingHours: [{ from: 540, to: 1020 }] }
    ],
    specificDates: []
  }
]
});

Get Service

Retrieve a service by ID or slug.

// By ID
const result = await sdk.reservation.getService({
  id: 'svc_xyz789'
});

// By slug (locale-aware)
const result = await sdk.reservation.getService({
  slug: 'haircut'
});

List Services

List all services with filtering.

const result = await sdk.reservation.getServices({
providerId: 'prv_sarah',
ids: ['svc_1', 'svc_2'],
query: 'haircut',
statuses: ['ACTIVE'],
nodeId: 'node_services',
blocks: ['description', 'gallery'],
sortField: 'createdAt',
sortDirection: 'desc',
priceFrom: 2000,
priceTo: 5000,
cursor: null,
limit: 20
});

result.items.forEach(service => {
console.log(service.key, service.prices);
});

Update Service

await sdk.reservation.updateService({
  id: 'svc_xyz789',
  key: 'premium-haircut',
  prices: [{ market: 'USD', amount: 4000 }],
  status: 'ACTIVE'
});

Delete Service

await sdk.reservation.deleteService({
  id: 'svc_xyz789'
});

Providers

Providers are staff members who perform services.

Create Provider

const result = await sdk.reservation.createProvider({
key: 'sarah-johnson',
nodeIds: ['node_stylists'],
blocks: [
  {
    key: 'bio',
    type: 'TEXT',
    content: {
      body: { en: 'Senior stylist with 10 years experience' }
    }
  },
  {
    key: 'image',
    type: 'IMAGE',
    content: {
      mediaId: 'media_sarah123'
    }
  }
],
status: 'ACTIVE'
});

Get Provider

// By ID
const result = await sdk.reservation.getProvider({
  id: 'prv_abc123'
});

// By slug
const result = await sdk.reservation.getProvider({
  slug: 'sarah-johnson'
});

List Providers

const result = await sdk.reservation.getProviders({
serviceId: 'svc_haircut',
ids: ['prv_1', 'prv_2'],
query: 'sarah',
statuses: ['ACTIVE'],
nodeId: 'node_stylists',
blocks: 'bio,image',
sortField: 'createdAt',
sortDirection: 'desc',
cursor: null,
limit: 20,
createdAtFrom: '2024-01-01',
createdAtTo: '2024-12-31'
});

result.items.forEach(provider => {
console.log(provider.key, provider.status);
});

Find Service Providers

Get all provider connections for a service, including working time, prices, and durations.

const serviceProviders = await sdk.reservation.findServiceProviders({
  serviceId: 'svc_haircut'
});

// Each service provider has working time, prices, durations
for (const serviceProvider of serviceProviders) {
  console.log(serviceProvider.providerId, serviceProvider.workingTime, serviceProvider.prices);
}

Create Service Provider

Connect a provider to a service with working time and pricing configuration.

const serviceProvider = await sdk.reservation.createServiceProvider({
  serviceId: 'svc_haircut',
  providerId: 'prv_sarah',
  workingDays: [],
  specificDates: [],
  prices: [{ market: 'us', amount: 5000 }],
  durations: [{ duration: 60, isPause: false }],
  isApprovalRequired: false
});

Update Service Provider

Update an existing service-provider connection.

Delete Service Provider

Remove a provider connection from a service.

Update Provider

await sdk.reservation.updateProvider({
  id: 'prv_abc123',
  key: 'sarah-johnson-senior',
  status: 'ACTIVE'
});

Delete Provider

await sdk.reservation.deleteProvider({
  id: 'prv_abc123'
});

Cart (Client-Side)

The SDK provides local cart management for building booking flows.

Add to Cart

sdk.reservation.addToCart({
  id: 'slot_123',
  serviceId: 'svc_haircut',
  providerId: 'prv_sarah',
  from: 1704110400,  // Unix timestamp
  to: 1704112200,
  timeText: '10:00 AM',
  dateText: 'Jan 15, 2024'
});

Get Cart

const cart = sdk.reservation.getCart();
// Returns array of Slot objects
console.log(cart);

Remove from Cart

sdk.reservation.removeFromCart('slot_123');

Clear Cart

sdk.reservation.clearCart();

Reservations

Create Reservation

Create a reservation from selected slots.

const result = await sdk.reservation.createReservation({
  // Any additional params
});

Get Reservation

const result = await sdk.reservation.getReservation({
  id: 'res_xyz789'
});

console.log(result.status, result.parts, result.payment);

Search Reservations

const result = await sdk.reservation.searchReservations({
query: '[email protected]',
serviceIds: ['svc_haircut'],
providerIds: ['prv_sarah'],
accountId: 'acc_customer123',
from: 1704067200,  // Unix timestamp
to: 1704672000,
status: 'CONFIRMED',
sortField: 'createdAt',
sortOrder: 'desc',
cursor: null,
limit: 50
});

result.items.forEach(reservation => {
console.log(reservation.id, reservation.status);
});

Update Reservation

await sdk.reservation.updateReservation({
  id: 'res_xyz789',
  status: 'CANCELLED',
  blocks: [
    {
      key: 'cancellation-reason',
      type: 'TEXT',
      content: { body: 'Customer request' }
    }
  ],
  items: [/* updated items */],
  payment: null
});

Checkout

Get Quote

Calculate pricing before checkout.

const quote = await sdk.reservation.getQuote({
items: [
  {
    serviceId: 'svc_haircut',
    providerId: 'prv_sarah',
    from: 1704110400,
    to: 1704112200
  }
],
paymentMethodId: 'pm_card_visa',
promoCode: 'FIRSTVISIT',
location: {
  lat: 40.7128,
  lng: -74.0060
}
});

console.log('Subtotal:', quote.subtotal);
console.log('Discount:', quote.discount);
console.log('Total:', quote.total);

Checkout Reservation

Process payment for a reservation. Can use cart items or provide items directly.

// Using cart items (if cart has items)
const result = await sdk.reservation.checkout({
paymentMethodId: 'pm_card_visa',
blocks: [
  {
    key: 'customer-info',
    type: 'FORM',
    content: {
      email: '[email protected]',
      firstName: 'John',
      lastName: 'Doe',
      phone: '+1234567890'
    }
  },
  {
    key: 'notes',
    type: 'TEXT',
    content: { body: 'First time customer' }
  }
],
promoCodeId: 'promo_firstvisit',
location: {
  lat: 40.7128,
  lng: -74.0060
}
});

// Or provide items directly
const result = await sdk.reservation.checkout({
items: [
  {
    serviceId: 'svc_haircut',
    providerId: 'prv_sarah',
    from: 1704110400,
    to: 1704112200
  }
],
paymentMethodId: 'pm_card_visa',
blocks: [/* customer info blocks */]
});

Complete Booking Flow

async function bookAppointment() {
  // 1. Get available services
  const services = await sdk.reservation.getServices({
    statuses: ['ACTIVE']
  });

  // 2. Get providers for a service
  const providers = await sdk.reservation.getProviders({
    serviceId: 'svc_haircut',
    statuses: ['ACTIVE']
  });

  // 3. Get service provider config (working time, prices, etc.)
  const serviceProviders = await sdk.reservation.findServiceProviders({
    serviceId: 'svc_haircut'
  });
  const serviceProvider = serviceProviders.find(serviceProvider => serviceProvider.providerId === 'prv_sarah');
  const workingTime = serviceProvider.workingTime;

  // 4. User selects a slot - add to cart
  sdk.reservation.addToCart({
    id: 'slot_unique_id',
    serviceId: 'svc_haircut',
    providerId: 'prv_sarah',
    from: 1704110400,
    to: 1704112200,
    timeText: '10:00 AM',
    dateText: 'Jan 15, 2024'
  });

  // 5. Get quote
  const quote = await sdk.reservation.getQuote({
    items: sdk.reservation.getCart().map(s => ({
      serviceId: s.serviceId,
      providerId: s.providerId,
      from: s.from,
      to: s.to
    })),
    promoCode: 'FIRSTVISIT'
  });

  console.log('Total:', quote.total);

  // 6. Checkout
  const result = await sdk.reservation.checkout({
    paymentMethodId: 'pm_card_visa',
    blocks: [
      {
        key: 'customer',
        type: 'FORM',
        content: {
          email: '[email protected]',
          firstName: 'John',
          lastName: 'Doe'
        }
      }
    ]
  });

  // 7. Clear cart after successful booking
  sdk.reservation.clearCart();

  return result;
}