Dostępność i ceny

Wszystkie trzy metody działają z kluczem publicznym, więc sklep internetowy może je wywoływać bezpośrednio z przeglądarki.

availability.calendar()

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

Wymagane: startDate i endDate jako zwykłe daty (YYYY-MM-DD), oddalone o najwyżej 366 dni. Wartość z godziną jest zamieniana na datę w UTC, co może przesunąć ją o jeden dzień. Opcjonalne groupIds ogranicza kalendarz do najwyżej 200 pozycji.

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

Każdy dzień zawiera grupę, łączną ilość, zarezerwowaną ilość i availabilityStatus, który może mieć wartość null.

availability.items()

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

Wymagane: startDate i endDate. endDate nie może być wcześniejsze niż startDate. Daty z godziną bez przesunięcia są odczytywane w strefie czasowej organizacji. Opcjonalne: search, limit (od 1 do 100, domyślnie 25) i 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;

Odpowiedź ma taki sam kształt pozycji jak inventory.list() i zwraca nextCursor: string | null. Wymienia tylko pozycje, w których co najmniej jeden egzemplarz jest wolny przez cały okres. categoryId ma tu zawsze wartość null. Jeśli potrzebujesz kategorii, użyj inventory.list() z tymi samymi datami.

pricing.quote()

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

Wymagane: startDate, endDate i items. Każda pozycja potrzebuje groupId (id pozycji) i quantity. items może być puste, gdy wysyłasz bundles. Opcjonalne:

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);

Daty z godziną bez przesunięcia są odczytywane w strefie czasowej organizacji, tak jak w bookings.create(). Wycena jest liczona dokładnie tak samo jak rezerwacja, więc pokazywane total to suma, którą otrzyma rezerwacja.

Odpowiedź z wyceną