# Objet annonce

Gérez les annonces. Pour en savoir plus sur les [annonces](https://tradly.app/docs/listings), consultez la documentation produit.

**Objet annonce**

| **nom** | **type** | **description** |
| --- | --- | --- |
| `id` | `integer` | Identifiant unique de l’annonce |
| `title` | `string` | Titre de l’annonce |
| `description` | `string` | Description de l’annonce |
| `images` | `array` | Tableau d’URL d’images |
| `sku` | `string` | SKU de l’annonce, généré automatiquement par défaut |
| `barcode` | `string` | Code-barres de l’annonce, généré automatiquement par défaut |
| `location` | `object` | Informations de localisation de l’annonce. Voir l’objet localisation ci-dessous |
| `gtin` | `string` | Code article international (GTIN), 20 caractères maximum |
| `mpn` | `string` | Référence fabricant (MPN), 40 caractères maximum |
| `weight_uom` | `string` | Unité de poids : `pound`, `ounce`, `gram` ou `kilogram` |
| `weight_value` | `float` | Valeur du poids |
| `volume_uom` | `string` | Unité de volume : `liter` ou `milliliter` |
| `volume_value` | `float` | Valeur du volume |
| `size_uom` | `string` | Unité de taille : `centimeter`, `meter`, `inch` ou `millimeter` |
| `height` | `float` | Hauteur de l’annonce |
| `length` | `float` | Longueur de l’annonce |
| `width` | `float` | Largeur de l’annonce |
| `seller_protection_fee_enabled` | `boolean` | Indique si les frais de protection du vendeur sont activés |
| `slug` | `string` | Slug unique de l’annonce, utile pour le référencement SEO |
| `meta_title` | `string` | Méta-titre de l’annonce, utile pour le référencement SEO |
| `meta_description` | `string` | Méta-description de l’annonce, utile pour le référencement SEO |
| `meta_keyword` | `string` | Méta-mot-clé de l’annonce, utile pour le référencement SEO |
| `in_cart` | `boolean` | Indique si l’annonce se trouve dans le panier |
| `liked` | `boolean` | Indique si l’utilisateur connecté a aimé l’annonce |
| `active` | `boolean` | Indique si l’annonce est active |
| `user` | `object` | Utilisateur ayant créé l’annonce. Voir l’objet utilisateur |
| `rating_data` | `object` | Informations de notation de l’annonce. Voir l’objet de notation |
| `coordinates` | `object` | Coordonnées géographiques de l’annonce |
| `shipping_charges` | `float` | Frais d’expédition de l’annonce |
| `type` | `string` | Type de l’objet renvoyé |

## Annonces de location

Une annonce de location nécessite une ligne `listing_rental_settings`. Le type, le stock et l’état actif de l’annonce ne suffisent pas à activer la location. Configurez ces paramètres après la création de l’annonce :

```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
  }'
```

Une fois les paramètres configurés, vérifiez la disponibilité pour la période de location demandée :

```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>"
```

Les paramètres de location prennent en charge l’unité et le montant du tarif, les durées minimale et maximale, le temps tampon, le dépôt et le nombre d’unités disponibles à la location. Aucune étape d’approbation distincte ni activation de location au niveau du compte n’est nécessaire.