Los orígenes de importación vienen con los planes Pro Nacional y Enterprise (página de planes). Forman parte del catálogo del módulo de campo (consulta Catálogo e importaciones).
Si tu ERP o tu PIM publica tu catálogo en una dirección, o lo deja en un servidor tuyo, guarda esa dirección como origen en «Ajustes de la cuenta › Catálogo › Orígenes de importación» y trae el archivo desde allí. Un archivo traído se importa como uno que subes.
Un origen
Una cuenta guarda hasta 10 orígenes. Los administradores los añaden y los cambian, con su segundo factor comprobado poco antes, que la página pide antes del formulario; los miembros los abren para traer el archivo. Si no se puede guardar, el formulario se queda como lo escribiste, salvo los secretos.
- Dirección:
https://en el puerto 443,sftp://oftps://(más abajo), con un nombre público y sin usuario ni contraseña en ella. Comprobamos todas las direcciones que da el nombre, nos conectamos solo a una pública y, por HTTPS, seguimos hasta tres redirecciones, cada una comprobada igual y nunca ahttp://. - Autenticación: ninguna, usuario y contraseña, un token (Bearer), una cabecera propia, como
X-Api-Key, o, con SFTP, usuario y clave privada. El formulario muestra solo sus campos. Solo la enviamos al servidor que guardaste, nunca a otro al que apunte una redirección. - Secreto: la contraseña, el token, el valor de la cabecera, la clave privada o los parámetros de una dirección
https://(?token=…). Lo guardamos cifrado y solo lo usamos para traer el archivo; la página no vuelve a mostrarlo, solo el día en que se guardó (y la huella pública de una clave). Escribe uno nuevo para sustituirlo; si eliges «Sin autenticación», se borra. - Qué contiene el archivo: referencias, códigos de tienda, los precios de una tarifa (con la tarifa que llena), las respuestas de tu ERP a los pedidos o las cargas de furgoneta, como al subirlo.
Servidores SFTP y FTPS
- SFTP:
sftp://files.example.com/exports/catalogo.csv, en el puerto22o en uno por encima de1023escrito tras el nombre (sftp://files.example.com:2222/exports/catalogo.csv). Entra con una contraseña o con una clave privada pegada entera en su campo, tal como está en su archivo (OpenSSH, PEM o PuTTY): Ed25519, ECDSA o RSA de 3.072 bits o más, sin frase de contraseña, porque la guardamos cifrada con nuestras propias claves. La página muestra la huella de su parte pública, para compararla con las claves autorizadas del servidor. - FTPS:
ftps://files.example.com/exports/catalogo.csvcon TLS explícito (AUTH TLSen el puerto21) oftps://files.example.com:990/exports/catalogo.csvcon TLS implícito, con usuario y contraseña. Comprobamos siempre el certificado del servidor con su nombre: el servidor necesita uno de una autoridad reconocida. El archivo también llega protegido, y solo desde la dirección del propio servidor: rechazamos una respuesta en modo pasivo que indique otra dirección. - No ofrecemos FTP sin cifrar: envía el usuario, la contraseña y el archivo en claro, así que cualquiera en el camino podría leer tu catálogo y entrar en tu servidor. Usa FTPS, SFTP o HTTPS.
La ruta indica el archivo (/exports/catalogo.csv) o una carpeta y un patrón en su última parte (/exports/catalogo_*.csv: * vale por cualquier serie de caracteres y ? por uno), y traemos el archivo más reciente que coincida, en carpetas de hasta 10.000 entradas. /~/ empieza la ruta en la carpeta propia del usuario. Solo leemos: nunca escribimos, renombramos ni borramos nada en tu servidor.
La clave del servidor (SFTP)
Antes de traer el primer archivo, un administrador pulsa «Leer la clave del servidor» en la página del origen, comprueba la huella que aparece (SHA256:…) con quien gestiona el servidor y pulsa «Confirmar esta clave». Desde entonces solo traemos archivos mientras el servidor presente esa misma clave, comprobada antes de enviarle la contraseña o la clave privada. Si cambia, el intento se detiene y el origen con él: la página muestra la clave que presentó el servidor, y no se trae nada hasta que un administrador confirme una clave. Si nadie la cambió, avisa a quien gestiona el servidor antes de confirmar nada. No dejamos confirmar una clave más débil que Ed25519, ECDSA o RSA de 2.048 bits.
Traer ahora
«Traer ahora» trae el archivo y abre una importación, que aparece en la página del origen y entre las importaciones en curso. El archivo sigue las reglas de uno subido: hasta 20 MB, 25.000 filas de códigos de tienda y 5.000 de lo demás, en cualquier formato que lean las importaciones, también en un ZIP o un gzip; el archivo de un ZIP de varios y su contraseña se indican en el origen (archivos ZIP, gzip y con contraseña).
- Las columnas nuevas esperan en la página de la importación a que las confirmes; si marcas «Recordar estas columnas», el próximo archivo con las mismas columnas se importa solo.
- Un archivo que no sabemos leer se rechaza con su motivo, como uno subido.
- Si no se puede traer, el origen dice por qué: la dirección no es pública, el servidor tardó demasiado, no aceptó la autenticación o respondió con un error, su clave cambió o aún no está confirmada, su certificado no es válido para su nombre, ningún archivo coincide con la ruta o el archivo llegó incompleto. Corrígelo y vuelve a traerlo; un origen se trae unas pocas veces por hora como máximo, de una en una.
Una programación
Un administrador puede hacer que un origen traiga el archivo solo, cada hora o cada día a la hora que elija (hora peninsular). Los intentos programados actúan como el administrador que guardó la programación; si pierde el acceso, la programación se pausa y los administradores reciben un correo.
- Solo lo que cambia. Un intento programado pregunta primero si el archivo cambió desde la última importación (su ETag y su Last-Modified, o el tamaño y la hora de un archivo SFTP o FTPS); un archivo sin cambios, o los mismos bytes otra vez, no abre ninguna importación y queda como «Sin cambios». «Traer ahora» siempre importa.
- Las columnas que cambian esperan a que las confirmes en la página de la importación, y los administradores reciben un correo; mientras tanto, la programación no abre otra importación.
- Los fallos se reintentan al cabo de 15 minutos y después con el doble de espera cada vez. Tras 3 seguidos, los administradores reciben un correo; tras 10, el origen se pausa hasta que un administrador pulse «Reanudar», y la programación pasa a actuar en su nombre.
La página del origen muestra sus últimos intentos y la importación que abrió cada uno.
Qué guardamos
La dirección del origen, su autenticación, su secreto cifrado y su programación, hasta que borres el origen o se cierre la cuenta; con SFTP, la huella de la clave del servidor que confirmaste y la de una pendiente de confirmar, que son públicas. El registro de cada intento (cuándo, quién lo pidió o si fue la programación, cómo terminó, la respuesta del servidor y el tamaño del archivo), durante 90 días. El archivo solo se guarda mientras dura su importación, como uno subido. Al borrar un origen se borran su secreto y el registro de sus intentos; las importaciones que abrió se quedan.