Cosa contiene il catalogo

I numeri vengono letti direttamente dal database e si aggiornano da soli: non sono cifre scritte nella pagina.

430.386: SKU in totale
59.862: nelle collezioni attuali
305: marchi
82.796: modelli
275.253: SKU con fotografie
324.546: SKU di lenti a contatto

Il catalogo conserva anche i modelli fuori produzione: servono per riconoscere le giacenze e le collezioni passate. Ogni SKU porta il proprio stato.

Come ottenere i dati

Due strade per team diversi: una chiamata dal vostro gestionale oppure un file che apre chiunque in negozio.

API REST

Per integrare il sito, il gestionale di magazzino o le inserzioni sui marketplace.

Filtri per marchio, modello, tipo, genere, forma, materiale e decine di altri campi
Paginazione a cursore: scaricate il catalogo intero senza salti né duplicati
Feed incrementale: prendete solo ciò che è cambiato dall’ultima sincronizzazione

Esportazione Excel

Per chi ha bisogno di un file e non di un’integrazione. Senza programmatore.

Scegliete marchi, filtri e colonne e salvate la selezione come modello
Prima di avviare vedete quanti articoli finiranno nel file
Le esportazioni grandi si preparano in background: il link compare nell’area riservata

Fotografie

Immagini dei prodotti su fondo pulito, pronte per la vetrina online o il marketplace.

Nell’API: link diretti alle immagini su ogni articolo
Nelle esportazioni: un archivio separato, ordinato per marchio e modello
Nell’archivio c’è l’indice che associa ogni codice a barre ai suoi file

Che aspetto ha una risposta

Dati veri presi dal catalogo, non un esempio da manuale.

Richiesta

GET /v1/products?brand=RAY-BAN&has_photo=true&limit=2

Risposta

{
  "data": [
    {
      "ean": "805289003472",
      "brand": "RAY-BAN",
      "model": "RB3136",
      "name": "RB3136 001 58",
      "color": "GOLD",
      "size": "58",
      "gender": "UNISEX",
      "material": "METAL",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/805289003472.png"
      ]
    },
    {
      "ean": "8056262017838",
      "brand": "RAY-BAN",
      "model": "RX5425D",
      "name": "RX5425D 2012 54",
      "color": "TORTOISE",
      "size": "54",
      "gender": "UNISEX",
      "material": "ACETATE",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056262017838.jpg"
      ]
    }
  ],
  "meta": {
    "returned": 2,
    "cursor": null
  }
}

Il set di campi lo decidete voi: se servono solo codice a barre, prezzo e link alla foto, la risposta conterrà esattamente quelli. L’elenco completo dei campi lo restituisce /v1/meta, il punto di partenza più comodo per costruire l’integrazione.

Domande frequenti

Il catalogo contiene le giacenze?

No. Il catalogo è un’anagrafica: attributi, fotografie, codici a barre e prezzi consigliati. La disponibilità vive in un altro sistema e non fa parte di questi dati. Lo diciamo subito per non creare aspettative sbagliate.

Quali prezzi fornite?

I prezzi al pubblico consigliati, quelli a cui il marchio propone di vendere. I prezzi d’acquisto non vengono forniti né via API né nelle esportazioni.

Posso usare le fotografie sul mio sito?

Sì, è il motivo più frequente per cui si prende il catalogo. L’API restituisce link diretti alle immagini; nelle esportazioni arriva un archivio di file con l’indice.

Ogni quanto si aggiornano i dati?

Il catalogo cresce di continuo, man mano che arrivano i dati dai marchi. L’API ha un metodo che restituisce solo ciò che è cambiato da una certa data: non serve riscaricare tutto.

Come si paga?

Per ora emettiamo fattura: sul sito non c’è ancora il pagamento con carta. Quando ci sarà, i clienti attivi non dovranno cambiare nulla.

Ci sono anche le lenti a contatto?

Sì, in una sezione dedicata: curva base, potere, cilindro, asse, addizione, confezione e prezzo. Per le lenti non ci sono fotografie in banca dati: aggiungerebbero poco.