---
title: "Ejemplos"
description: "Patrones del SDK listos para copiar para una tienda online de alquiler y una integración de servidor, como un catálogo por fechas, un formulario de solicitud de reserva, productos en venta, la sincronización de reservas nuevas y la gestión de los límites de peticiones."
canonical_url: "https://requiply.com/docs/es/developers/examples"
---
# Ejemplos

> Patrones del SDK listos para copiar para una tienda online de alquiler y una integración de servidor, como un catálogo por fechas, un formulario de solicitud de reserva, productos en venta, la sincronización de reservas nuevas y la gestión de los límites de peticiones.

Los fragmentos dan por hecho un cliente `requiply` como el del [inicio rápido](https://requiply.com/docs/es/developers/typescript-sdk/quick-start): una clave publicable para los ejemplos de tienda online y una clave secreta para los ejemplos de servidor. Los ID como `cameraKitId` representan UUID que lees del catálogo.

## Tienda online: catálogo para las fechas elegidas

```ts
const { items, nextCursor } = await requiply.inventory.list({
  startDate: '2026-07-01T10:00:00+03:00',
  endDate: '2026-07-03T18:00:00+03:00',
  limit: 50,
});

for (const item of items) {
  console.log(item.name, item.basePrice, item.currency, `${item.availableQuantity} free`);
}
```

Para listar solo lo que tiene al menos una unidad libre durante todo el periodo, usa `availability.items()` con las mismas fechas.

## Tienda online: ofrecer solo horas de recogida válidas

```ts
const { workingHours, timezone } = await requiply.org.info();

function isOpen(day: string, time: string) {
  const hours = workingHours.find((entry) => entry.day === day);
  return !!hours?.isWorkingDay && time >= hours.startTime && time <= hours.endTime;
}

isOpen('saturday', '10:00'); // compare in the organization's timezone
```

## Tienda online: formulario de solicitud de reserva

```ts
const result = await requiply.bookings.create({
  startDate: '2026-07-01T10:00:00',
  endDate: '2026-07-03T18:00:00',
  items: [{ groupId: cameraKitId, quantity: 1 }],
  deliveryType: 'pickup',
  asRequest: true,
  client: { name: 'Olena', email: 'olena@example.com', phone: '+380951234567' },
});

if (result.success) {
  showThankYou(`Request #${result.reservationOrgId} received`);
} else if (result.reason === 'minimum_duration' && result.minimumDuration) {
  const { earliestReturn, timeZone } = result.minimumDuration;
  showError(`The earliest return is ${earliestReturn} (${timeZone})`);
} else {
  showError(result.message ?? 'These dates cannot be booked');
}
```

## Tienda online: añadir productos en venta

Solo funciona mientras la organización [vende a los clientes](https://requiply.com/docs/es/developers/typescript-sdk/sales#con-una-clave-publicable).

```ts
import { RequiplyError, type PublicV1SaleItem } from '@requiply/api-sdk';

let goods: PublicV1SaleItem[] = [];
try {
  ({ items: goods } = await requiply.saleItems.list());
} catch (error) {
  if (!(error instanceof RequiplyError && error.reason === 'selling_disabled')) throw error;
}

try {
  const quote = await requiply.pricing.quote({
    startDate: '2026-07-01T10:00:00',
    endDate: '2026-07-03T18:00:00',
    items: [{ groupId: cameraKitId, quantity: 1 }],
    saleLines: [{ saleItemId: memoryCardId, quantity: 2 }],
  });
  console.log(quote.saleSubtotal, quote.total);
} catch (error) {
  if (error instanceof RequiplyError && error.reason === 'out_of_stock') {
    console.log('Only', error.data?.availableQuantity, 'left');
  } else {
    throw error;
  }
}
```

## Servidor: sincronizar las reservas nuevas

```ts
let cursor: string | undefined;

do {
  const page = await requiply.bookings.list({
    createdFrom: lastSyncAt,
    limit: 200,
    cursor,
  });

  for (const booking of page.bookings) {
    await upsertBooking(booking);
  }

  cursor = page.nextCursor ?? undefined;
} while (cursor);
```

## Servidor: buscar o crear un cliente

```ts
const { client, created } = await requiply.clients.create({
  name: 'Alex',
  email: 'alex@example.com',
});

console.log(created ? 'New client' : 'Existing client', client.id);
```

`clients.create()` devuelve el cliente existente cuando el email o el teléfono ya están registrados, así que puedes llamarlo sin problema antes de cada reserva.

## Cancelar un presupuesto lento

```ts
const controller = new AbortController();
const timeout = setTimeout(() => controller.abort(), 5_000);

try {
  const quote = await requiply.pricing.quote(
    {
      startDate: '2026-07-01T10:00:00',
      endDate: '2026-07-03T18:00:00',
      items: [{ groupId: cameraKitId, quantity: 1 }],
    },
    { signal: controller.signal },
  );

  console.log(quote.total);
} finally {
  clearTimeout(timeout);
}
```

## Gestionar el límite de peticiones

```ts
import { RequiplyError } from '@requiply/api-sdk';

async function withRetry<T>(call: () => Promise<T>): Promise<T> {
  try {
    return await call();
  } catch (error) {
    if (error instanceof RequiplyError && error.status === 429) {
      const seconds = error.retryAfter ?? 5;
      await new Promise((resolve) => setTimeout(resolve, seconds * 1000));
      return call();
    }
    throw error;
  }
}

const report = await withRetry(() => requiply.reports.pipeline());
```

Reintenta las lecturas y los presupuestos sin problema. No envuelvas así `bookings.create()` ni `sales.create()`; consulta [Reintentos](https://requiply.com/docs/es/developers/typescript-sdk/request-options#reintentos).

## Ejemplos ejecutables en el navegador

Para un proyecto de StackBlitz o similar en el navegador:

- Usa como dependencia una versión publicada de `@requiply/api-sdk` y fíjala.
- Usa solo una clave publicable de una organización de demostración, y que sea fácil de sustituir.
- Crea las reservas solo como solicitudes con `asRequest: true`.
- No incluyas nunca métodos que necesiten clave secreta ni datos reales de clientes.


## Sitemap

See the full [sitemap](https://requiply.com/docs/sitemap.md) for all pages.