El catálogo guarda tus propias referencias: tu código de artículo, su EAN, tu descripción y el producto que es. Con él, el Localizador encuentra un producto por su EAN o por tu código, y una ruta de preparación acepta líneas con ellos. Lo tienen las cuentas de establecimiento con el plan Localizador o Tienda Pro, también durante su piloto; el Visor y Etiquetas no lo incluyen. Solo tu cuenta lo ve: ninguna marca, ninguna otra cadena ni nadie más, y no lo usamos para nada más (cláusula 3.7 (d) de las condiciones del visor para establecimientos).
Cómo se vincula una referencia
Cada referencia se vincula a uno de los productos que vemos en tus tiendas: los que muestra tu vista de la tienda y los que ha visto tu propio equipo en su mapa privado. Nunca a otro producto: nuestros productos no llevan código de barras, así que un EAN solo no vincula nada. Para vincular una referencia, escribe el producto como lo da el Localizador (su nombre exacto) o su identificador. Hasta que la vincules, buscar su código no encuentra nada: la respuesta dice not_found, sin adivinar.
En «Por vincular», la página muestra tus referencias sin producto y, para cada una, hasta tres sugerencias: productos de tus tiendas cuyo nombre, tamaño y marca coinciden con tu descripción. Pulsa «Vincular» en la que corresponda. Nada se vincula solo: una sugerencia equivocada daría el lugar de otro producto. Un producto que todavía no hemos visto en tus tiendas no se puede vincular hasta que un recorrido lo vea.
Cargar el catálogo
En «Ajustes de la cuenta» › «Catálogo»:
- Un archivo. CSV, Excel o JSON, o un ZIP con él, de hasta 20 MB. La columna del código es obligatoria; el EAN, el nombre y el producto, opcionales. Si las columnas no son las nuestras, el portal adivina cuál es cada una y un miembro lo confirma antes de importar.
- Tus servidores. Un administrador puede guardar hasta 10 orígenes (HTTPS, SFTP, FTPS o almacenamiento en la nube) para traer el archivo a petición o cada hora o cada día (orígenes de importación). Sus secretos se guardan cifrados y no se vuelven a mostrar.
- La API. Una clave con el permiso
catalogue:writeenvía el archivo o sus filas (import_file,import_rows), y concatalogue:readlee el resultado (get_import). Un administrador da esos permisos a una clave en «Ajustes de la cuenta» › «API», con un segundo factor reciente.
Una cuenta tiene como máximo 5.000 referencias en uso, y 50 importaciones al día. Tu catálogo solo admite referencias: los códigos de tienda, las tarifas y los pedidos son de las marcas.
El resultado de cada importación
«Últimas importaciones» dice, de cada archivo, cuántas filas se aplicaron y, en «Vínculos», cuántas quedaron vinculadas, cuántas sin vincular y cuántas de estas tienen una sugerencia. Una fila que nombra un producto que no vemos en tus tiendas se rechaza con ese motivo. Por la API, get_import da los mismos recuentos en links.