Comment créer et gérer des offres avec un flux produit ?

En publiant des offres sur Ricardo, tu acceptes nos Conditions générales (CG) ainsi que notre Déclaration de confidentialité.

Des frais de vente s’appliquent à chaque article vendu avec succès.

Ricardo est tenu de collecter la TVA sur les ventes réalisées auprès d’acheteurs en Suisse et au Liechtenstein, puis de la reverser à l’Administration fédérale des contributions (AFC) pour le compte des vendeurs. Ricardo peut également être amené à transmettre, sur demande, les données suivantes :

• Ton nom, ton adresse postale, ton adresse e-mail et ton site web
• Le chiffre d’affaires généré via Ricardo
• Les types de produits proposés

Les acheteurs et acheteuses sur Ricardo recherchent en priorité des pièces uniques, des objets de collection, des classiques du design ou encore de bonnes affaires, tout en attachant une grande importance à la durabilité de ces produits. L’idée est simple : lorsqu’un produit est transmis et réutilisé, il n’a pas besoin d’être (re)produit ou transporté, et cela évite aussi qu’un ancien objet soit jeté. Cela permet d’économiser des ressources précieuses et de réduire les émissions.

Tu as donc plus de chances de réussir tes ventes si tu proposes ce type de produits sur Ricardo :

• Seconde main
• D’une saison précédente
• Reconditionné
• Modèle d’exposition
• Fait main
• Fin de série
• Objet de collection
• Pièce détachée
• Produit avec date de péremption
• Article endommagé ou avec un défaut de fabrication

Si tes produits ne correspondent pas à ces catégories (par exemple des articles neufs produits en grande quantité, du dropshipping, etc.), ta limite d’offres pourrait ne pas être augmentée, ou même être réduite.

Tous les produits issus du flux sont synchronisés avec le même compte Ricardo.

Par défaut, la limite d’offres est fixée à 100 offres actives. Cette limite correspond au nombre maximum d’offres que tu peux avoir en ligne en même temps. Ce plafond peut être augmenté en accord avec Ricardo.

Pour conserver une limite plus élevée, les conditions suivantes doivent être remplies :

• Ton inventaire est principalement composé de produits correspondant aux catégories recommandées (voir la section Conseils pour ton inventaire).
• Ton inventaire génère au minimum 10 % de commandes par mois. Par exemple, pour 10 000 offres en ligne, on attend environ 1 000 commandes par mois.

L’inventaire est synchronisé avec Ricardo via un flux produit accessible publiquement en HTTPS, dans un format JSON spécifique (voir Contenu et format du flux). L’URL doit être statique.

Le flux doit être mis à jour immédiatement en cas de modification du stock, de suppression d’un produit ou de changement de prix. En l’absence de changements, une mise à jour quotidienne suffit.

Pour garantir un traitement efficace, nous demandons que le serveur inclue un ETag dans l’en-tête HTTP de la réponse, si le flux n’est pas généré via Channable. Cela nous permet de détecter les changements de manière efficace en termes de ressources.

Ricardo se réserve le droit de retirer les articles qui ne se sont pas vendus dans un délai de 90 jours après leur première publication.

Les paramètres suivants ne sont pas transmis produit par produit dans le flux, mais sont définis au niveau du compte utilisateur. Merci d’indiquer ta configuration souhaitée dans ta demande d’intégration  :

• Mode de livraison : Envoi uniquement / Retrait uniquement / Envoi et retrait

• Pour les envois : Indique le mode d’envoi et le prix (ex. : Colis B-Post 2 kg, CHF 8.50)

  Consulte notre formulaire de mise en vente pour connaître les modes de livraison disponibles et les frais d’envoi autorisés.

• Pour les envois : Indique le seuil à partir duquel la livraison devient gratuite (à partir de quel prix de l’article les frais de port passent à CHF 0.–)

Les produits inclus dans le flux doivent être définis et décrits à l’aide des informations suivantes :

• product_id (string) : Chaque produit doit posséder un identifiant unique et permanent, qui apparaît une seule fois dans l’inventaire et ne change jamais.
• gtin (optional, string) : Numéro valide et unique selon les normes GTIN.
• title (string) :
  • Maximum 60 caractères
  • Lisible et commençant par une majuscule
  • Contient les caractéristiques essentielles du produit
  • Identique ou très similaire pour chaque variante du produit
  • Langues prises en charge : DE, FR ou IT
  • Sans codes internes, identifiants ou prix
• description (string) :
  • Maximum 5 000 caractères
  • Texte brut uniquement (pas de HTML) ; sauts de ligne via \n
  • Structurée, lisible, avec une capitalisation normale
  • Similaire entre les variantes
  • Décrire le produit de manière objective, avec un ton convivial
  • Inclure l’état du produit, ses particularités et caractéristiques
  • Mentionner tout défaut ou signe d’usure
  • Indiquer le prix de vente initial
  • Langues prises en charge : DE, FR ou IT
  • Pas d’informations de contact ni de liens URL
• images (list of strings) :
  • De 1 à 10 images
  • Formats acceptés : JPG ou PNG, résolution minimale 700 px
  • Une modification de l’image n’est détectée que si l’URL change
  • Pas de photos issues de banques d’images
  • Pas de filigranes, QR codes, logos ou coordonnées
• price (integer, in cents) :
  • Devise : CHF
  • Doit se terminer par 0 ou 5 (ex. : 1995)
  • Prix TTC, hors frais de livraison
  • Fourchette autorisée : de CHF 1.00 à CHF 1 000 000
• stock (integer) :
  • Nombre d’articles à proposer sur Ricardo
  • Si tu vends le même article sur plusieurs plateformes, tu peux indiquer une quantité plus basse dans le flux pour éviter de vendre un produit qui n’est plus en stock. Garde à l’esprit que les mises à jour de stock sur Ricardo ne sont pas immédiates. Il peut y avoir un petit décalage.
  • Fourchette autorisée : de 1 à 99
• specification :
  • product_type (string) :
    • Classification du produit selon ta propre taxonomie, mappée vers celle de Ricardo (ex. : Jacket / veste / giacca da sci → mapped à Jacket)
    • Le produit est rejeté si aucune correspondance valide n’est possible
    • Utilise le formulaire en ligne pour vérifier les types de produits valides
    • Langues prises en charge : DE, FR ou IT (les termes en anglais sont moins bien reconnus)
  • category (optional, string) :
    • Catégorisation plus large selon ta taxonomie, pour affiner le mapping vers celle de Ricardo (ex. : Vêtements / Mode femme / Pantalons)
    • Langues prises en charge : DE, FR ou IT (les termes en anglais sont moins bien reconnus)
  • attributes (list of attributes as name/value pairs) :
    • Liste des attributs permettant de caractériser le produit (ex. : Couleur : bleu)
    • Les noms sont basés sur ta taxonomie mais mappés vers celle de Ricardo
    • Les attributs non associable à une catégorie sont ignorés
    • Les attributs obligatoires doivent être présents et reconnus, sinon le produit est rejeté
    • Voir le formulaire en ligne pour les attributs obligatoires par type de produit
    • Formats de date conformes à RFC 3339
    • Les nombres décimaux sont autorisés
    • Pas d’attributs en double : chaque attribut doit apparaître une seule fois avec une seule valeur
• condition (string) :
  • Indiquer l’état général du produit
  • Utiliser la description pour plus de détails
  • Valeurs possibles : new, like_new, used, damaged

• variant (optional object) : utilisé pour regrouper des produits quasi identiques, qui ne diffèrent que par certains attributs (ex. : même chaussure en différentes tailles ou couleurs). Tous les produits d’un même groupe de variantes doivent avoir un titre et une description similaires, ainsi que le même état.

  • group (string) : Identifiant unique du groupe de variantes. Tous les produits avec le même identifiant appartiennent au même groupe.
  • image (string) : Image spécifique pour la variante concernée (ex. : version rouge de la chaussure)
  • options (list of attributes as name/value pairs) : Définit ce qui différencie chaque variante au sein du groupe (ex. : taille, couleur, matériau). Ces attributs doivent aussi figurer dans specification.attributes.

  Consulte nos pages d’aide pour bien décrire ton article.

Le flux produit doit contenir un tableau JSON composé d’objets produit.

[{Product},
{Product},
{Product},
...
{Product}]

{
  "product_id": "12345678900",
  "gtin": "77665544332211",
  "title": "My product title",
  "description": "My product description.",
  "images": [
    "https://my.cdn.com/image1.jpg",
    "https://my.cdn.com/image2.jpg",
    "https://my.cdn.com/image3.jpg"
  ],
  "price": "12300",
  "stock": "20",
  "specification: {
    "category": "Product category",
    "product_type": "Product type",
    "attributes": [
      {
        "name": "Color",
        "value": [
          "Red"
        ]
      },
      {
        "name": "Size",
        "value": [
          "M"
        ]
      },
      {
        "name": "My attribute name",
        "value": [
          "My first attribute value",
          "My second attribute value"
          ]
      }
    ]
  },
  "condition": "used",
  "variant": {
    "group": "999888777",
    "image": "https://my.cdn.com/image1.jpg",
    "options": [
      {
        "name": "Color",
        "value": "Red"
      },
      {
        "name": "Size",
        "value": "M"
      }
    ]
  }
}

{
  "product_id": "1",
  "gtin": "1000000",
  "title": "Cool T-Shirt",
  "description": "Comfortable cotton t-shirt, available in multiple colors and sizes.",
  "images": [
    "https://my.cdn.com/image-red-m1.jpg",
    "https://my.cdn.com/image-red-m2.jpg",
    "https://my.cdn.com/image-red-m3.jpg"
  ],
  "price": "12300",
  "stock": "20",
  "specification: {
    "category": "Apparel",
    "product_type": "T-Shirt",
    "attributes": [
      {
        "name": "Color",
        "value": ["Red"]
      },{
        "name": "Size",
        "value": ["M"]
      },{
        "name": "Brand",
        "value": ["Nike"]
      },{
        "name": "Fit",
        "value": ["oversized"]
      }
  },
  "condition": "new",
  "variant": {
    "group": "TSHIRT_GROUP_001",
    "image": "https://my.cdn.com/image-red-m1.jpg",
    "options": [
      {
        "name": "Color",
        "value": "Red"
      },{
        "name": "Size",
        "value": "M"
      }
    ]
  }
},{
  "product_id": "2",
  "gtin": "200000",
  "title": "Cool T-Shirt",
  "description": "Comfortable cotton t-shirt, available in multiple colors and sizes.",
  "images": [
    "https://my.cdn.com/image-blue-m1.jpg",
    "https://my.cdn.com/image-blue-m2.jpg",
    "https://my.cdn.com/image-blue-m3.jpg"
  ],
  "price": "12300",
  "stock": "20",
  "specification: {
    "category": "Apparel",
    "product_type": "T-Shirt",
    "attributes": [
      {
        "name": "Color",
        "value": ["Blue"]
      },{
        "name": "Size",
        "value": ["M"]
      },{
        "name": "Brand",
        "value": ["Nike"]
      },{
        "name": "Fit",
        "value": ["oversized"]
      }
  },
  "condition": "new",
  "variant": {
    "group": "TSHIRT_GROUP_001",
    "image": "https://my.cdn.com/image-blue-m1.jpg",
    "options": [
      {
        "name": "Color",
        "value": "Blue"
      },{
        "name": "Size",
        "value": "M"
      }
    ]
},{
  "product_id": "3",
  "gtin": "3000000",
  "title": "Cool T-Shirt",
  "description": "Comfortable cotton t-shirt, available in multiple colors and sizes.",
  "images": [
    "https://my.cdn.com/image-red-s1.jpg",
    "https://my.cdn.com/image-red-s2.jpg",
    "https://my.cdn.com/image-red-s3.jpg"
  ],
  "price": "12300",
  "stock": "20",
  "specification: {
    "category": "Apparel",
    "product_type": "T-Shirt",
    "attributes": [
      {
        "name": "Color",
        "value": ["Red"]
      },{
        "name": "Size",
        "value": ["S"]
      },{
        "name": "Brand",
        "value": ["Nike"]
      },{
        "name": "Fit",
        "value": ["oversized"]
      }
  },
  "condition": "new",
  "variant": {
    "group": "TSHIRT_GROUP_001",
    "image": "https://my.cdn.com/image-red-s1.jpg",
    "options": [
      {
        "name": "Color",
        "value": "Red"
      },{
        "name": "Size",
        "value": "S"
      }
    ]
}

{
      [{
    "product_id": "11111111",
    "gtin": "25345345345345",
    "title": "Jacke Damen",
    "description": "Beschreibung Jacke Damen",
    "images": [
        "https://cdn.wherever.com/image1.jpg",
        "https://cdn.wherever.com/image2.jpg"
    ],
    "price": "2990",
    "stock": "3",
    "attributes": {
        "color": [
            "Pink"
        ],
        "size": [
            "36"
        ],
        "gender": [
            "Damen"
        ],
        "age": [
            "Erwachsen"
        ],
        "model": [
            "Carol-W"
        ],
        "brand": [
            "Adidas"
        ]
    },
    "category": "Skijacken",
    "product_type": "Jacken",
    "condition": "new",
    "variant": {
        "option_color": [
            "Pink"
        ],
        "group": [
            "879878976789897"
        ],
        "option_size": [
            "36"
        ],
        "image": [
            "https://cdn.wherever.com/image1.jpg"
        ]
    }
}]

Actuellement, seuls les formats de flux mentionnés ci-dessus sont pris en charge.

D’autres formats peuvent être évalués sur demande — merci de nous contacter à l’adresse accountmanagement@ricardo.ch.