Доступність і ціни

Усі три методи працюють із публічним ключем, тож вітрина може викликати їх просто з браузера.

availability.calendar()

availability.calendar(
  input: AvailabilityCalendarInput,
  options?: RequiplyRequestOptions,
): Promise<AvailabilityCalendarResponse>

Обовʼязкові: startDate і endDate як звичайні дати (YYYY-MM-DD), щонайбільше за 366 днів одна від одної. Значення з часом перетворюється на дату в UTC, що може зсунути його на день. Необовʼязковий groupIds обмежує календар до 200 товарів.

const { days } = await requiply.availability.calendar({
  startDate: '2026-07-01',
  endDate: '2026-07-07',
  groupIds: [cameraKitId],
});

Кожен день містить групу, загальну кількість, заброньовану кількість і availabilityStatus, який може бути null.

availability.items()

availability.items(
  input: AvailabilityItemsInput,
  options?: RequiplyRequestOptions,
): Promise<AvailabilityItemsResponse>

Обовʼязкові: startDate і endDate; endDate не може бути раніше за startDate. Дата й час без зсуву читаються в часовому поясі організації. Необовʼязкові: search, limit (від 1 до 100, за замовчуванням 25), cursor.

const page = await requiply.availability.items({
  startDate: '2026-07-01T10:00:00',
  endDate: '2026-07-03T18:00:00',
  search: 'camera',
  limit: 25,
});

const nextCursor = page.nextCursor;

Відповідь має ту саму форму елемента інвентарю, що й inventory.list(). Додатково вона повертає nextCursor: string | null. Вона перелічує лише товари, у яких хоча б одна одиниця вільна на весь період. Тут categoryId завжди null. Коли потрібні категорії, використовуйте inventory.list() з тими самими датами.

pricing.quote()

pricing.quote(
  input: PricingQuoteInput,
  options?: RequiplyRequestOptions,
): Promise<PricingQuoteResponse>

Обовʼязкові: startDate, endDate, items. Кожен елемент потребує groupId (id товару) і quantity. items може бути порожнім, коли ви надсилаєте bundles. Необовʼязкові:

const quote = await requiply.pricing.quote({
  startDate: '2026-07-01T10:00:00',
  endDate: '2026-07-03T18:00:00',
  items: [{ groupId: cameraKitId, quantity: 2 }],
  services: [{ serviceId: deliveryServiceId }],
});

console.log(quote.currency, quote.total);

Дата й час без зсуву читаються в часовому поясі організації, як і для bookings.create(). Розрахунок ціни виконується точно так само, як для бронювання, тож показаний вами total дорівнюватиме сумі бронювання.

Відповідь розрахунку ціни