Cadorama

Rechercher des produits dans le catalogue Cadorama par mot-clé, catégorie, ou sous-catégorie. Retourne une liste de produits avec prix, stock et lien direct.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Mot-clé de recherche (nom du produit, marque, etc.)",
      "type": "string"
    },
    "category": {
      "description": "Catégorie (ex: \"Alimentation & Boissons\", \"Électronique\", \"Maison & Décoration\")",
      "type": "string"
    },
    "subcategory": {
      "description": "Sous-catégorie (ex: \"Nouilles\", \"Sauces\", \"Café\")",
      "type": "string"
    },
    "minPrice": {
      "description": "Prix minimum en euros",
      "type": "number"
    },
    "maxPrice": {
      "description": "Prix maximum en euros",
      "type": "number"
    },
    "limit": {
      "default": 10,
      "description": "Nombre de résultats (max 50, défaut 10)",
      "type": "number",
      "minimum": 1,
      "maximum": 50
    },
    "inStockOnly": {
      "default": true,
      "description": "Afficher uniquement les produits en stock (défaut: true)",
      "type": "boolean"
    },
    "exclude": {
      "description": "Régime / allergènes à EXCLURE (ex: [\"porc\",\"lait\",\"gluten\"]). Écarte tout produit dont le nom/ingrédients/description contient l'un de ces termes (synonymes courants inclus : porc→jambon/lard/bacon…). Idéal pour \"sans porc\", \"sans lactose\".",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Obtenir les détails complets d'un produit Cadorama par son ID (description complète, toutes les images, gencode, poids, produits similaires).

{
  "type": "object",
  "properties": {
    "productId": {
      "type": "string",
      "description": "ID unique du produit (obtenu via search_products)"
    }
  },
  "required": [
    "productId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lister toutes les catégories et sous-catégories disponibles dans le catalogue Cadorama.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Créer un lien de paiement Stripe sécurisé pour un panier d'articles Cadorama. Deux modes : livraison à domicile en France métropolitaine (frais de port INCLUS, calculés par la boutique) ou retrait GRATUIT au magasin de Saint-Quentin (delivery: "retrait"). La réponse chiffre aussi le Point Relais, souvent moins cher, qui se choisit sur le site : avant de transmettre le lien, signale à l'utilisateur toute option moins chère. Produits réservés aux majeurs (alcool, tabac…), produits frais ou surgelés en précommande et produits à variantes exclus : les commander sur https://www.cadorama02.fr. Retourne une URL que l'utilisateur doit ouvrir pour payer (carte bancaire) ; la commande est créée automatiquement après paiement.

{
  "type": "object",
  "properties": {
    "items": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "productId": {
            "type": "string",
            "description": "ID du produit (obtenu via search_products)"
          },
          "quantity": {
            "type": "number",
            "minimum": 1,
            "description": "Quantité souhaitée"
          }
        },
        "required": [
          "productId",
          "quantity"
        ]
      },
      "description": "Liste des articles à commander"
    },
    "customerEmail": {
      "description": "Email du client pour la confirmation de commande (optionnel)",
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "delivery": {
      "description": "« domicile » (défaut) : livraison Colissimo en France métropolitaine ; « retrait » : retrait gratuit au magasin, 119 rue d'Isle, 02100 Saint-Quentin (aucune adresse demandée)",
      "type": "string",
      "enum": [
        "domicile",
        "retrait"
      ]
    }
  },
  "required": [
    "items"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Vérifier le statut d'un paiement Stripe par son ID de session. Utile pour confirmer si un utilisateur a finalisé son paiement.

{
  "type": "object",
  "properties": {
    "sessionId": {
      "type": "string",
      "description": "ID de la session Stripe (obtenu via create_checkout)"
    }
  },
  "required": [
    "sessionId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lister les produits actuellement en promotion chez Cadorama. Retourne les produits avec prix barré, pourcentage de réduction, et date de fin de la promo si applicable.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "description": "Nombre max de promos à retourner",
      "type": "number",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lister les nouveautés Cadorama (produits récemment ajoutés au catalogue, marqués Nouveauté par l'admin pendant 14 jours après leur arrivée).

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "description": "Nombre max de nouveautés à retourner",
      "type": "number",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lister les produits les plus vendus chez Cadorama (top sales). Pratique pour suggérer ce qui plaît le plus aux clients.

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "description": "Nombre max de best-sellers à retourner",
      "type": "number",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Obtenir les informations du magasin physique CADORAMA à Saint-Quentin : adresse, horaires d'ouverture À JOUR (lus en direct, avec la coupure de midi), statut ouvert/fermé en ce moment, fermetures exceptionnelles à venir, téléphone, services proposés (Click & Collect, livraison, retours), mentions légales.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}