Los ERP, los PIM y las herramientas que generan archivos de productos suelen enviar sus exportaciones comprimidas. Llegue por donde llegue un archivo de catálogo (al subirlo en «Ajustes de la cuenta › Catálogo», por la API, desde un origen de importación o a la dirección de importación), puede venir en un ZIP o en un gzip, como catalogo.csv.gz o el feed.xml.gz de Merchant Center. Lo abrimos en memoria, nunca en disco, e importamos el archivo que lleva dentro exactamente como si llegara suelto: los mismos formatos, las mismas columnas deducidas y la misma confirmación, los mismos límites. El archivo comprimido no se guarda: solo el que lleva dentro, mientras su importación espera o se ejecuta, como cualquier otro (Catálogo e importaciones).
Qué archivo de un ZIP
- Un ZIP con un solo archivo en un formato que leemos (CSV u otro texto delimitado,
.xlsx, JSON, un archivo XML de productos de Merchant Center) da ese. Las carpetas, las copias__MACOSXde macOS, los archivos ocultos, los archivos de bloqueo de Office (~$…) y los archivos en otros formatos se ignoran. - Un ZIP con varios: la página de subida pregunta cuál importar y vuelve a leer la misma subida con tu elección. Por la API, nómbralo con
entry. Un origen lo guarda en «Archivo dentro del ZIP (si trae varios)»: su nombre, su ruta dentro del ZIP o un patrón comoarticulos_*.csv, y se toma el más reciente que coincida; sin él, cada intento termina diciendo que el ZIP trae varios archivos. - Por correo, cada archivo en un formato que leemos dentro de un ZIP adjunto se importa como si llegara suelto, como máximo 10 archivos por correo, y los de un archivo comprimido cuentan uno a uno.
- Un gzip lleva un solo archivo: su nombre es el del gzip sin
.gz. La importación conserva el nombre del archivo comprimido (catalogo.zip › productos.csvpara uno sacado de un ZIP).
ZIP con contraseña
- Abrimos los ZIP cifrados con el método tradicional (ZipCrypto, el que usan por defecto las herramientas de Windows y 7-Zip) y con AES de 128 a 256 bits (el de WinZip, que también escriben 7-Zip y WinRAR).
- En la página de subida, escribe la contraseña cuando la pida: la usamos una vez para abrir el ZIP y no la guardamos en ningún sitio. Por la API, envíala con el archivo en la cabecera
X-Archive-Password, o en el cuerpo definish_import_upload(consulta Importar el catálogo por la API). - Un origen de importación guarda la contraseña del ZIP en «Contraseña del ZIP (si la tiene)», y la dirección de importación en su tarjeta, porque una contraseña no viaja segura en el mismo correo que el archivo. Las dos se guardan cifradas con los demás secretos del origen, solo se usan para abrir los archivos y no se vuelven a mostrar: la página dice desde cuándo hay una guardada. Para cambiar la contraseña del ZIP de un origen, vuelve a escribir también su secreto.
- Sin contraseña, o con una equivocada, la importación dice cuál de las dos cosas pasa, y la página deja volver a escribirla.
Límites y rechazos
- El archivo comprimido cuenta como el archivo de importación: hasta 20 MB, y el que lleva dentro también hasta 20 MB, con las mismas 25.000 filas de códigos de tienda y 5.000 de lo demás.
- Se rechaza con su motivo, sin guardar nada: un archivo comprimido dentro de otro (un ZIP en un ZIP, un gzip en un ZIP: envía el archivo en sí; un libro de Excel cuenta como archivo); uno que se descomprime a mucho más que su tamaño (más de 100 veces por encima de un megabyte, o más de 200 MB en total), que lleva más de 1.000 archivos o que nombra archivos fuera de sí mismo; un ZIP64, uno dividido en partes o uno comprimido o cifrado de otra forma (guárdalo como un ZIP normal); un archivo dañado o cortado.
- No leemos archivos 7-Zip, RAR ni tar: guarda el archivo como ZIP o envíalo suelto.