Estas cifras se leen directamente de la base de datos y se actualizan solas: no son números escritos en la página.
El catálogo conserva también los modelos descatalogados: sirven para identificar existencias y colecciones anteriores. Cada referencia lleva su propio estado.
Dos vías para equipos distintos: una llamada desde su sistema o un archivo que abre cualquiera de la tienda.
Para integrar la web, el sistema de inventario o las publicaciones en marketplaces.
Para quien necesita un archivo y no una integración. Sin programador.
Imágenes de producto sobre fondo limpio, listas para el escaparate o el marketplace.
Datos reales del catálogo, no un ejemplo de la documentación.
Petición
GET /v1/products?brand=RAY-BAN&has_photo=true&limit=2Respuesta
{
"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
}
}El conjunto de campos lo decide usted: si solo necesita código de barras, precio y enlace a la foto, la respuesta contendrá exactamente eso. La lista completa de campos la entrega /v1/meta, el punto de partida más cómodo para construir la integración.
No. El catálogo son datos de referencia: atributos, fotografías, códigos de barras y precios recomendados. La disponibilidad vive en otro sistema y no forma parte de estos datos. Lo decimos desde el principio para que no haya expectativas equivocadas.
Los precios de venta recomendados, aquellos a los que la marca propone vender. Los precios de compra no se entregan ni por API ni en las exportaciones.
Sí, es el motivo más habitual para contratar el catálogo. La API devuelve enlaces directos a las imágenes; en las exportaciones llega un archivo comprimido con los ficheros y su índice.
El catálogo crece de forma continua, según llegan los datos de las marcas. La API tiene un método que devuelve solo lo cambiado desde una fecha: no hace falta volver a descargarlo todo.
De momento emitimos factura: todavía no hay pago con tarjeta en la web. Cuando lo haya, los clientes en activo no tendrán que cambiar nada.
Sí, en una sección aparte: curva base, potencia, cilindro, eje, adición, envase y precio. En la base no hay fotografías de lentes: aportarían poco.