Come creare e gestire le inserzioni con un feed prodotto

Pubblicando inserzioni su Ricardo, accetti i nostri Termini e condizioni (CG) e la nostra Informativa sulla privacy.

Per ogni articolo venduto con successo si applicano delle commissioni di vendita.

Ricardo è tenuto a riscuotere l’IVA sulle vendite effettuate verso acquirenti in Svizzera e nel Liechtenstein e a versarla all’Amministrazione federale delle contribuzioni (AFC) per conto dei venditori. Inoltre, su richiesta, Ricardo può essere tenuto a fornire i seguenti dati:

• Nome, indirizzo postale, indirizzo e-mail e sito web del venditore
• Volume delle vendite generate tramite Ricardo
• Tipologie di prodotti venduti

Gli acquirenti su Ricardo sono particolarmente interessati a pezzi unici, articoli da collezione, classici del design e occasioni vantaggiose, con una forte attenzione alla sostenibilità. Il concetto è semplice: un prodotto riutilizzato non necessita di nuova produzione e trasporto, evitando così di finire tra i rifiuti. In questo modo si risparmiano risorse preziose e si riducono le emissioni.

Avrai quindi maggiori opportunità di vendita offrendo i seguenti tipi di articoli:

• Secondhand
• Di una stagione precedente
• Ricondizionati
• Modelli da esposizione
• Fatti a mano
• Rimanenze di magazzino
• Articoli da collezione
• Pezzi di ricambio
• Prodotti con data di scadenza
• Articoli danneggiati o con difetti di fabbricazione

Se i tuoi articoli non rientrano in queste categorie (ad esempio, prodotti nuovi di fabbrica, dropshipping, ecc.), il limite massimo di inserzioni a tua disposizione potrebbe non essere aumentato e, in alcuni casi, potrebbe anche essere ridotto.

Tutti i prodotti inclusi nel feed vengono sincronizzati con lo stesso account Ricardo.

Il limite predefinito è di 100 inserzioni attive, ovvero il numero massimo di inserzioni che possono essere online contemporaneamente. Questo limite può essere aumentato previo accordo con il team Ricardo.

Per mantenere un limite superiore, devono essere soddisfatte le seguenti condizioni:

• L’inventario è composto principalmente da articoli appartenenti alle categorie elencate in precedenza
• Almeno il 10% delle inserzioni attive genera ordini ogni mese. Ad esempio, con 10’000 inserzioni attive, ci si aspetta circa 1’000 ordini mensili

L’inventario viene sincronizzato tramite un feed pubblico accessibile via HTTPS, nel formato JSON specificato (vedi Contenuto e formato del feed). L’URL del feed deve essere statico.

Il feed deve essere aggiornato immediatamente in caso di variazioni di stock, rimozione di prodotti o modifiche di prezzo. In assenza di cambiamenti, è sufficiente un aggiornamento giornaliero.

Per garantire un'elaborazione efficiente, richiediamo che il server includa un ETag nell’header della risposta HTTP, se il feed non è generato tramite Channable. Questo ci consente di rilevare le modifiche al file in modo efficiente dal punto di vista delle risorse.

Ricardo si riserva il diritto di rimuovere i prodotti che non generano vendite entro 90 giorni dalla data di pubblicazione iniziale.

I seguenti parametri non vengono trasmessi per ogni singolo prodotto, ma sono configurati a livello di account. Indicali nella richiesta di integrazione:

• Modalità di consegna: solo spedizione / solo ritiro / spedizione e ritiro

• Per la spedizione: indica il metodo di consegna e il relativo costo (es. Pacco Posta B 2 kg, CHF 8.50)

  Consulta il form di messa in vendita per verificare i metodi di spedizione disponibili e i relativi costi accettati.

• Spedizione gratuita: definisci la soglia di prezzo a partire dalla quale la spedizione diventa gratuita (i costi di spedizione saranno impostati a CHF 0.–)

Ogni prodotto presente nel feed deve essere definito e descritto in modo completo utilizzando le seguenti informazioni:

• product_id (string): ogni prodotto deve avere un ID univoco e permanente, presente una sola volta nell'inventario e che non cambia nel tempo.
• gtin (optional, string): codice univoco e conforme agli standard GTIN.
• title (string):
  • Massimo 60 caratteri
  • Deve iniziare con lettera maiuscola e risultare leggibile
  • Deve contenere le caratteristiche principali del prodotto
  • Deve essere identico o molto simile tra le varianti
  • Lingue supportate: DE, FR, IT
  • Non deve contenere codici interni, ID o informazioni sul prezzo
• description (string):
  • Massimo 5.000 caratteri
  • Solo testo semplice (no HTML); gli a capo si indicano con \n
  • Testo strutturato e leggibile, con uso corretto delle maiuscole
  • Deve essere simile tra le varianti
  • Presentazione del prodotto in modo obiettivo e cordiale
  • Includere informazioni dettagliate su condizione, caratteristiche e particolarità
  • Segnalare eventuali difetti o segni d’usura
  • Indicare il prezzo di vendita originale
  • Lingue supportate: DE, FR o IT
  • Vietato inserire informazioni di contatto o URL
• images (list of strings):
  • Da 1 a 10 URL di immagini
  • Formati supportati: JPG o PNG, risoluzione minima 700px
  • Le modifiche alle immagini vengono riconosciute solo se cambia anche l'URL
  • Non sono ammesse immagini stock
  • Vietati watermark, codici QR, loghi o dati di contatto visibili
• price (integer, in cents):
  • Valuta: CHF
  • Deve terminare con 0 o 5 (es. 1995)
  • Prezzo comprensivo di IVA, esclusi i costi di spedizione
  • Valori accettati: da CHF 1.00 a CHF 1.000.000
• stock (integer):
  • Quantità di articoli che desideri mettere in vendita su Ricardo
  • Se lo stesso articolo è in vendita su più piattaforme, ti consigliamo di indicare una quantità inferiore nel feed per minimizzare il rischio di vendite in eccesso. Ricorda che l'aggiornamento dello stock su Ricardo non avviene in tempo reale, quindi possono verificarsi lievi ritardi.
  • Valori accettati: da 1 a 99
• specification:
  • product_type (string):
    • Classificazione del prodotto secondo la tua tassonomia, allineata a quella di Ricardo (es. Jacket / veste / giacca da sci → Jacket)
    • Il prodotto viene rifiutato se non è possibile alcuna corrispondenza valida
    • Usa il form di pubblicazione per verificare i tipi di prodotto validi
    • Lingue supportate: DE, FR, IT. I termini in inglese vengono riconosciuti con minore affidabilità
  • category (optional, string):
    • Classificazione più ampia secondo la tua tassonomia, utile per ottimizzare la corrispondenza con la classificazione Ricardo (es. Abbigliamento / Moda donna / Pantaloni)
    • Lingue supportate: DE, FR, IT. I termini in inglese vengono riconosciuti con minore affidabilità
  • attributes (list of attributes as name/value pairs):
    • Lista di attributi e relativi valori per caratterizzare il prodotto (es. Colore: blu)
    • I nomi sono basati sulla tua tassonomia ma vengono collegati a quella di Ricardo
    • Gli attributi non riconoscibili vengono ignorati
    • Gli attributi obbligatori devono essere presenti e riconosciuti, altrimenti il prodotto sarà rifiutato
    • Consulta il form online per conoscere gli attributi obbligatori per ogni tipo di prodotto
    • I formati di data devono essere conformi a RFC 3339
    • I numeri decimali devono avere un formato valido
    • Lingue supportate: DE, FR, IT. I termini in inglese vengono riconosciuti con minore affidabilità
    • Nessun attributo duplicato: ogni attributo deve comparire una sola volta e avere un solo valore
• condition (string):
  • Indica la condizione generale del prodotto
  • Ulteriori dettagli devono essere specificati nella descrizione
  • Valori accettati: new, like_new, used, damaged
• variant (optional object): Utilizzato per raggruppare prodotti praticamente identici che differiscono solo per alcuni attributi (es. stessa scarpa in taglie o colori diversi). Tutti i prodotti all’interno di un gruppo variante devono avere un titolo identico o molto simile, una descrizione simile e la stessa condizione. Ogni variante (cioè ogni prodotto del gruppo) deve avere una combinazione diversa di valori attributo.
  • group (string): Identificatore univoco del gruppo variante. Tutti i prodotti con lo stesso valore group appartengono allo stesso gruppo.
  • image (string): Immagine specifica per la variante (es. versione rossa della scarpa)
  • options (list of attributes as name/value pairs): Attributi che distinguono una variante all'interno del gruppo (tipicamente: taglia, colore, materiale). Questi attributi devono essere presenti anche in specification.attributes.

Consulta le nostre pagine di aiuto per ulteriori consigli su come descrivere al meglio la tua inserzione.

Il feed deve contenere un array JSON di oggetti prodotto.

[{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"
        ]
    }
}]

Attualmente supportiamo esclusivamente i formati indicati sopra. Altri formati possono essere valutati su richiesta: contattaci all’indirizzo accountmanagement@ricardo.ch.