# Objeto anuncio

Administra los anuncios. Consulta la documentación del producto sobre [anuncios](https://tradly.app/docs/listings) para obtener más información.

**Objeto anuncio**

| **nombre** | **tipo** | **descripción** |
| --- | --- | --- |
| `id` | `integer` | Identificador único del anuncio |
| `title` | `string` | Título del anuncio |
| `description` | `string` | Descripción del anuncio |
| `images` | `array` | Matriz de URL de imágenes |
| `sku` | `string` | SKU del anuncio, generado automáticamente de forma predeterminada |
| `barcode` | `string` | Código de barras del anuncio, generado automáticamente de forma predeterminada |
| `location` | `object` | Información de ubicación del anuncio. Consulta el objeto de ubicación más abajo |
| `gtin` | `string` | Número global de artículo comercial (GTIN), máximo 20 caracteres |
| `mpn` | `string` | Número de pieza del fabricante (MPN), máximo 40 caracteres |
| `weight_uom` | `string` | Unidad de peso: `pound`, `ounce`, `gram` o `kilogram` |
| `weight_value` | `float` | Valor del peso |
| `volume_uom` | `string` | Unidad de volumen: `liter` o `milliliter` |
| `volume_value` | `float` | Valor del volumen |
| `size_uom` | `string` | Unidad de tamaño: `centimeter`, `meter`, `inch` o `millimeter` |
| `height` | `float` | Altura del anuncio |
| `length` | `float` | Longitud del anuncio |
| `width` | `float` | Anchura del anuncio |
| `seller_protection_fee_enabled` | `boolean` | Indica si está activada la tarifa de protección del vendedor |
| `slug` | `string` | Slug único del anuncio, útil para SEO |
| `meta_title` | `string` | Meta título del anuncio, útil para SEO |
| `meta_description` | `string` | Meta descripción del anuncio, útil para SEO |
| `meta_keyword` | `string` | Meta palabra clave del anuncio, útil para SEO |
| `in_cart` | `boolean` | Indica si el anuncio está en el carrito |
| `liked` | `boolean` | Indica si el usuario que ha iniciado sesión ha marcado como favorito el anuncio |
| `active` | `boolean` | Indica si el anuncio está activo |
| `user` | `object` | Usuario que creó el anuncio. Consulta el objeto usuario |
| `rating_data` | `object` | Información de valoración del anuncio. Consulta el objeto de valoración |
| `coordinates` | `object` | Geolocalización del anuncio |
| `shipping_charges` | `float` | Coste de envío del anuncio |
| `type` | `string` | Tipo del objeto que se devuelve |

## Anuncios de alquiler

Un anuncio de alquiler necesita una fila `listing_rental_settings`. Establecer el tipo, las existencias y el estado activo del anuncio no habilita por sí solo el alquiler. Configura los ajustes después de crear el anuncio:

```bash
curl -X POST https://api.tradly.app/v1/rentals/settings \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "listing_id": 729341,
    "rate_unit": "day",
    "rate_amount": 500,
    "min_duration": 1,
    "max_duration": 30,
    "buffer_time": 0,
    "deposit_amount": 1000,
    "max_units": 1
  }'
```

Una vez configurados los ajustes, comprueba la disponibilidad para el periodo de alquiler solicitado:

```bash
curl "https://api.tradly.app/v1/rentals/availability?listing_id=729341&start_at=2026-10-10T10:00:00Z&end_at=2026-10-12T10:00:00Z&units=1" \
  -H "Authorization: Bearer <token>"
```

Los ajustes de alquiler admiten unidad e importe de tarifa, duración mínima y máxima, tiempo de margen, importe del depósito y número de unidades que se pueden alquilar. No hay un paso de aprobación independiente ni una habilitación de alquiler a nivel de cuenta.