> ## Documentation Index
> Fetch the complete documentation index at: https://docs.readyforcommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.
> ## Agent Instructions
> Ready for Commerce is an ecosystem that currently contains two products, PIM and Repricer, standing on one shared foundation: one identity, one organization, one team, one bill. Do not call it a platform with features, and never hint at an unreleased product.
> PIM connects to Shopify, Amazon, Square, Google Merchant Center and BigCommerce. Repricer connects to Amazon, Walmart, Shopify, BigCommerce, eBay and Square. The two products do not share one list, and each integration is authorized separately inside each product. The roster grows on purpose, so describe what the product does and let a table carry which integrations do it today, instead of counting them or writing that only one does something.
> Integration is the word this product uses, and it is the default in the documentation: the connection, the account, the Integrations screen, the per-account settings and the sync state are all integrations. Channel is reserved for the narrow sense of a destination where a listing lives, as in a product being live on a channel or archived on the channel.
> Newegg is not a supported channel. Do not describe it.
> On Amazon, PIM manages the offer only: price, availability and condition. It does not publish listing content such as titles, descriptions, images or specifications.
> Sign-in is passwordless: a single-use code emailed to the user, or Google. There are no passwords anywhere, so never describe a password, a sign-up with a password, or an email confirmation link.
> There is no public API for customers and no customer-facing webhooks. There is no organization-wide activity feed and no audit export, but the PIM does keep version history on products, brands, categories, tags and specifications, with who changed what and a restore, so never write that changes are not recorded or that an edit cannot be undone. Do not describe capabilities that are not documented here.
> Never write that the products have no AI, and never write that anything is AI-powered. Both are wrong. The PIM's image Optimizer runs AI-backed transforms the seller starts on purpose: Upscale, Remove background, and the region selection behind Refine. The Repricer reads competitor prices off web pages on the server. No control, badge or tooltip in either product names AI, and the seller never writes a prompt, so describe what the buttons do in the app's own words instead of reaching for the word.
> A PIM product, brand, category or variant can be switched off per connected integration account. Hover the channel badge and the switch is beside the account name in the card that opens. It carries no visible caption, so never call it the Sync switch: Sync is only its accessible name. On a variant-grained provider, Amazon today, the switch moves into the variant editor. On a product it asks whether to delete it from the channel, archive it there, or leave it live. Disabling stops publishing, not reading. There is still no per-field sync toggle.
> The PIM's image Optimizer replaced a feature called Squarify, which no longer exists. It resizes to an aspect ratio or to exact dimensions, removes backgrounds, upscales, trims the transparent margin around a cutout and re-centers it, pads, fills and re-encodes, and it always publishes a new asset instead of changing the original. Nothing crops into the picture: the subject is always contained whole.
> The PIM has no repricing engine and never reacts to a competitor's price. It does build the price it publishes to each integration account from the seller's own fields, configured in that account's settings, so do not write that the PIM has no pricing rules.
> Neither product has an in-app notification center, bell or inbox. Notifications are delivered by email only.
> Billing is per organization and per product, and only the organization owner can see or change it. Team members are free and uncounted, so never describe seats or per-user pricing.
> The seller never picks a plan. Each product has twelve price tiers assigned automatically from usage: the PIM from catalog product count, which includes drafts and archived products, and the Repricer from trailing 30-day sales. Nothing is feature-gated by plan and exceeding a tier never blocks work, so never write that a feature requires a higher plan.
> A subscription that is past due or paused makes the product read-only, which stops repricing and blocks edits without deleting data. Only a canceled subscription locks the seller out. Nothing is ever charged without a payment method on file.
> Pages containing the text 'This page has not been written yet', or its Spanish equivalent 'Esta página todavía no está escrita', are placeholders. Do not treat their headings as documented behavior.
# Exportaciones
> Una exportación convierte cualquier parte de tu catálogo en una hoja de cálculo que puedes descargar y abrir en Excel o Google Sheets.
Una exportación convierte una parte de tu catálogo en un archivo de hoja de cálculo. Tú eliges qué va adentro, el PIM arma el archivo y tú lo descargas. Después lo abres en Excel, en Google Sheets, en Numbers o en cualquier cosa que lea hojas de cálculo.
Casi siempre se exporta por una de tres razones: para revisar tus datos fuera del PIM, para mandarle una lista a alguien que no tiene cuenta, o para hacer muchos cambios en una hoja de cálculo y devolver el archivo por [importaciones](/es/pim/uploads/imports).
Todo esto está en `Importar/Exportar`, dentro de la pestaña `Exportaciones`. El botón `Crear exportación`, arriba de la tabla, abre un diálogo sobre la página que te lleva por cuatro pasos. La tabla de abajo lista todas las exportaciones que ha hecho tu equipo, con su estado.
Hay una segunda cosa que también se llama exportación: en lugar de una hoja de cálculo que hable de tus imágenes y documentos, puedes descargar los archivos mismos en un ZIP. Eso funciona distinto y tiene su propia sección más abajo.
## Antes de empezar
Hay tres cosas que importan antes de tu primera exportación. Todo lo demás de esta página puede esperar hasta que lo necesites.
### Qué te permite hacer tu rol
Sea cual sea tu rol, puedes crear una exportación, cancelarla, renombrarla, guardar una plantilla y descargar un archivo. Nada de esta página queda por encima de tu nivel.
Hay algo que saber si tienes rol `Editor`. Puedes exportar pero no importar, así que ves el botón `Crear exportación` y no ves un botón `Crear importación` al lado. Los roles se asignan en [equipo, roles y permisos](/es/team#qué-puede-hacer-cada-rol-del-pim).
### Tu archivo se elimina a los 14 días
A los 14 días de terminar, el PIM elimina el archivo y quita su fila de la tabla. Nada lleva la cuenta y nada te avisa antes. Si todavía necesitas el archivo, vuelve a correr la exportación.
Esto importa más de lo que parece. Una exportación no es un respaldo ni es almacenamiento. Trátala como algo que armas, descargas y guardas tú en otro lado.
### Solo corre una exportación a la vez
Toda tu organización comparte un solo carril. Si alguien empieza una exportación mientras la tuya corre, la suya espera turno y arranca cuando la tuya termina. Las descargas de archivos de recursos esperan en la misma fila.
## Cómo exportar
Desde `Importar/Exportar`, entra a la pestaña `Exportaciones` y pulsa `Crear exportación` arriba de la tabla. El diálogo te pregunta cómo quieres empezar. Pulsa `Continuar` bajo `Empezar desde cero`, o elige una de las plantillas guardadas de tu equipo.
La primera pantalla dentro del diálogo se llama `Entidades`. Muestra ocho tarjetas, una por cada tipo de registro. Pulsa `Productos`, o pulsa la combinación de tarjetas que quieras en una misma exportación.
En `Configurar`, todas las columnas ya vienen marcadas, así que aquí lo tuyo es desmarcar las que no necesitas. Si solo quieres una parte de tu catálogo, pulsa `Agregar filtros`.
En `Opciones`, elige `CSV` o `XLSX`. Los demás ajustes de esa pantalla los puedes dejar como están la primera vez.
En `Revisar`, lee el resumen, ponle un nombre al archivo si quieres, y pulsa `Exportar`.
Ese es todo el flujo. Tu exportación aparece de inmediato al principio de la tabla, va pasando por varios estados mientras se arma, y muestra un botón `Descargar` cuando está lista. Además recibes un correo cuando termina.
Todo lo que sigue explica esas cuatro pantallas una por una. No necesitas nada de eso para una exportación sencilla.
## Cada opción en detalle
El diálogo tiene cuatro pantallas propias: `Entidades`, `Configurar`, `Opciones` y `Revisar`. Las secciones de abajo las siguen en ese orden. Dos de las pantallas hacen suficiente trabajo como para partirlas en dos, así que un par de números de paso aparecen repetidos.
Siempre puedes pulsar `Volver`, o pulsar un marcador de paso anterior en la parte de arriba del diálogo, para cambiar algo. Lo que no puedes es adelantarte a una pantalla que todavía no llenaste.
### Paso 1: Elige qué exportar
`Entidades` muestra ocho tarjetas. Cada tarjeta es un tipo de registro de tu catálogo, y cada una se convierte en su propio conjunto de datos. Elige una tarjeta o elige varias.
| Tarjeta | Una fila es |
| --- | --- |
| `Productos` | Una variante, o un producto. Más abajo está por qué un producto se convierte en varias filas |
| `Marcas` | Una marca, con su slug, sus sitios web, su descripción, sus campos SEO y sus enlaces de imagen |
| `Categorías` | Una categoría, con las madres antes que las hijas, su ruta completa y su nivel |
| `Etiquetas` | Una etiqueta, con su nombre y su descripción |
| `Grupos de especificaciones` | Un grupo, con las categorías a las que aplica |
| `Definiciones de especificación` | Una definición, con su grupo y sus marcas de obligatoria y única |
| `Valores de especificación` | Un valor permitido, con su definición y su grupo |
| `Recursos` | Una fila por asignación. Un archivo usado en 3 productos te da 3 filas |
Elegir varias tarjetas no las mezcla. Recibes un archivo por tarjeta, todos dentro de un mismo ZIP.
El botón `Siguiente` se queda en gris hasta que elijas al menos una tarjeta.
### Paso 2: Elige tus columnas
`Configurar` es donde decides qué columnas terminan en tu archivo. Todas las columnas vienen marcadas cuando llegas, así que aquí el trabajo es quitar, no agregar.
Si elegiste más de una tarjeta en la pantalla anterior, esta trabaja con una tarjeta a la vez. Usa la lista desplegable que está junto al título del diálogo para cambiar entre ellas.
Esto es lo que tienes enfrente:
| Qué ves | Qué hace |
| --- | --- |
| Grupos que se abren y se cierran | Las columnas vienen ordenadas en grupos como `Datos básicos` y `Precios`. Solo se abre uno a la vez, y `Mostrar` y `Ocultar` están a la derecha de cada uno, junto a un conteo de cuántas columnas conservaste |
| Una casilla `Buscar` | Escribe para acotar la lista. Los grupos sin coincidencias desaparecen mientras escribes |
| `Seleccionar todo` y `Limpiar todo` | Marcan o desmarcan todo lo que la búsqueda te está mostrando en ese momento, no todo lo de la tarjeta |
| Una columna en gris | No la puedes quitar, porque uno de tus filtros la usa. Borra primero el filtro |
| `No se encontraron campos` | Tu búsqueda no coincidió con nada. Vacía la casilla y prueba con una palabra más corta |
| `Selecciona al menos una columna para exportar.` | Desmarcaste todo en esa tarjeta. Marca algo, o vuelve atrás y quita la tarjeta |
El botón `Siguiente` se queda en gris hasta que cada tarjeta que elegiste conserve al menos una columna marcada.
`Datos básicos`, `Jerarquía`, `Taxonomía`, `Identificadores`, `Recursos`, `Precios`, `Inventario`, `Variantes`, `Especificaciones`, `Dimensiones`, `Archivo`, `Asignaciones`, `SEO`, `Aduana`, `Extra` y `Auditoría`.
Solo ves los grupos que tienen sentido para la tarjeta en la que estás, así que una exportación de `Etiquetas` muestra muchos menos que una de `Productos`. Una columna que el diálogo no puede ubicar en ningún grupo queda bajo `Otro`.
Tu archivo recibe los mismos nombres de columna que ves en esta lista. Marca `Códigos de barras` aquí y tu hoja de cálculo trae una columna llamada `Códigos de barras`.
Esos nombres se escriben en el idioma que tenía la app cuando pulsaste `Exportar`. La misma configuración le da `Precio` a una persona y `Price` a otra, así que pónganse de acuerdo en un idioma antes de compartir un archivo con tu equipo.
Las columnas salen en el orden en que las seleccionaste. Si desmarcas una columna y la vuelves a marcar, se va al final del archivo.
No puedes arrastrar columnas a otro orden y no puedes cambiarles el nombre aquí. Si el orden te importa, reacomódalo después en tu hoja de cálculo.
Las columnas del sistema, como los ID de registro y las fechas, no están en esta lista. Vienen apagadas, y las enciendes en el paso 3, dentro de `Avanzado`.
### Paso 2: Filtra tus filas
Sin filtros recibes la tabla completa. Los filtros son la forma de exportar solo una parte, como únicamente tus productos activos o únicamente las marcas que no tienen productos.
Pulsa `Agregar filtros` en esa misma pantalla `Configurar`. Se abre un panel llamado `Filtros de exportación`, y cada tarjeta que elegiste mantiene sus propios filtros, aparte.
| Qué pulsas | Qué hace |
| --- | --- |
| `Agregar condición` | Agrega una fila de filtro vacía. Siempre empiezas con una ya puesta |
| `Filtrar por` | Una lista desplegable con las columnas por las que puedes filtrar. Elige una |
| `Condición` | Una lista de comparaciones, como `contiene` o `está vacío`. Las opciones cambian según la columna que elegiste |
| `Valor`, o `Desde` y `Hasta` | Escribe qué estás buscando. Condiciones como `está vacío` y `es verdadero` no necesitan valor, así que estas casillas no aparecen |
| `Coincidencia` | Ponla en `Todas las condiciones` para exigir todos los filtros, o en `Cualquier condición` para aceptar cualquiera de ellos |
| `Quitar filtro` | Borra esa fila de filtro |
| `Aplicar` | Guarda tus filtros. Se queda en gris hasta que al menos una fila esté completa |
| `Cancelar`, hacer clic fuera del panel, o pulsar Escape | Te pregunta si quieres descartar tus cambios de filtros antes de cerrar |
| La × junto a `Agregar filtros` | Limpia todos los filtros de la tarjeta que estás viendo |
Las condiciones que te ofrece dependen del tipo de columna que elegiste:
| Tipo de columna | Condiciones que recibes |
| --- | --- |
| Texto | `contiene`, `no contiene`, `empieza con`, `termina con`, `es igual a`, `está vacío`, `no está vacío` |
| Un número o un conteo | `es igual a`, `mayor que`, `mayor o igual que`, `menor que`, `menor o igual que`, `está vacío`, `no está vacío` |
| Dinero | Lo mismo que un número. Escribe el monto como lo escribirías en la app |
| Una lista fija, como `Estado` o `Condición` | `es alguno de`, `no es ninguno de`, `es igual a` |
| Sí o no, como `Tiene variantes` | `es verdadero`, `es falso` |
| Una fecha | `antes de`, `después de`, `entre` |
| Una lista de cosas, como `Marcas` o `Categorías` | `es alguno de`, `está vacío`, `no está vacío` |
| Tamaño de recurso | `es igual a`, `no es igual a`, `es alguno de`, en nueve rangos que van de `< 100 KB` hasta `> 100 MB` |
Una fila de filtro que llenaste a medias se descarta al pulsar `Aplicar`, y nada te avisa de eso. Si tus resultados se ven raros, vuelve a abrir `Filtros de exportación` y revisa que cada fila siga teniendo sus tres partes.
Los filtros que pusiste en tu página de productos no se vienen contigo. El diálogo de exportación tiene sus propios filtros, y las tablas del catálogo no pueden exportar una selección por su cuenta.
Las listas desplegables que muestran tus propios registros, como marcas o categorías, ofrecen hasta 500 opciones. `Creado por` y `Actualizado por` ofrecen hasta 1.000. Si una tarjeta no tiene nada por lo que filtrar, el panel te lo dice en lugar de mostrarte listas vacías.
### Paso 3: Elige el formato del archivo
`Opciones` es donde decides qué tipo de archivo sale.
| Ajuste | Tus opciones |
| --- | --- |
| `Formato de archivo` | `CSV` o `XLSX` |
| `Delimitador` | Cuatro opciones, listadas abajo. Solo para CSV |
| `Formato de fecha` | `SQL (AAAA-MM-DD)` o `ISO 8601 (AAAA-MM-DDTHH:mm:ssZ)` |
| `Compresión` | `Ninguno`, `GZIP` o `ZIP` |
**Cuál formato elegir.** Elige `XLSX` si vas a abrir el archivo y trabajar dentro de él, porque las fechas salen como celdas de fecha de verdad que puedes ordenar y filtrar. Elige `CSV` si el archivo es muy grande, o si se lo vas a dar a otro sistema. Un `XLSX` aguanta 1.000.000 de filas, y un `CSV` no tiene límite de filas.
**El delimitador es el carácter que separa tus valores en un CSV.** Tus cuatro opciones son `Coma (,)`, `Punto y coma (;)`, `Tabulación` y `Barra vertical (|)`. La coma es la opción normal. Elige el punto y coma si tú o tus colegas usan una versión de Excel en español, que suele esperar ese. Este ajuste no hace nada en un `XLSX`.
**Los dos formatos de fecha incluyen la hora**, aunque las etiquetas solo muestren la fecha. `SQL (AAAA-MM-DD)` te da `2026-05-02 14:30:45`, e `ISO 8601 (AAAA-MM-DDTHH:mm:ssZ)` te da `2026-05-02T14:30:45+00:00`. El ajuste solo toca las columnas `Fecha de creación` y `Última actualización`.
**La compresión solo la eliges tú cuando exportas una sola tarjeta.** Marca una segunda y el ajuste se fija en `ZIP` y se pone gris, porque ahora hay más de un archivo que entregarte. Vuelve a una sola tarjeta y tu elección anterior regresa. Nada se comprime solo por ser grande.
Exportar varias tarjetas en `XLSX` te da un ZIP con un archivo `.xlsx` adentro por cada tarjeta, cada uno con su propia hoja. No recibes un solo libro con varias pestañas, y ningún ajuste te lo va a dar.
### Paso 3: Configura las opciones avanzadas
`Avanzado` está al final de esa misma pantalla `Opciones`, con una pestaña por cada tarjeta que elegiste. Casi ninguna exportación necesita algo de aquí, y una tarjeta sin nada que configurar te lo dice.
| Ajuste | Empieza | Qué hace |
| --- | --- | --- |
| `Incluir campos del sistema` | Apagado | Agrega el ID del registro, `Fecha de creación`, `Última actualización`, `Creado por (UUID)` y `Actualizado por (UUID)`. Productos suma `ID de variante`, y recursos suman `Hash de contenido` y `Ruta del objeto` |
| `Incluir sobreescrituras de moneda` | Apagado | Agrega tus precios por mercado junto a tus precios principales. Solo para productos, y solo mientras tengas una columna de precio marcada |
| `Separadores de arreglo` | Una barra vertical entre valores, y `>` entre las partes de una ruta de categoría | Cambia el carácter que se usa cuando varios valores comparten una misma celda |
**Enciende `Incluir campos del sistema` si piensas volver a importar el archivo.** Los ID que agrega son lo que permite que una importación encuentre tus registros actuales en lugar de crear otros nuevos. Es todo o nada por tarjeta, así que no puedes agregar solo una de esas columnas.
Aunque se llame `Creado por (UUID)`, esa columna te da un nombre legible y no un ID. Si el cambio no lo hizo una persona, recibes el motivo: importación, fuente de datos, integración o sistema.
**Enciende `Incluir sobreescrituras de moneda` si vendes en más de una moneda.** Cada columna de precio que dejaste gana una columna compañera al lado, con algo como `EUR=27.50|GBP=24.00`. Son cinco: `Sobreescrituras de precio`, `Sobreescrituras de costo`, `Sobreescrituras de precio comparativo`, `Sobreescrituras de MAP` y `Sobreescrituras de MSRP`. Solo recibes las compañeras cuya columna de precio conservaste.
**Los separadores de arreglo son para las celdas que guardan una lista.** Un producto con tres etiquetas tiene que meterlas todas en una celda, así que salen como `Verano|Oferta|Nuevo`. Si tus datos ya traen barras verticales, cambia el separador aquí por algo que tus datos no usen. Recibes una casilla por cada lista que la tarjeta puede producir, cada una acepta hasta 3 caracteres, y vaciar una casilla devuelve el valor por defecto.
Hay dos detalles fáciles de pisar. La barra vertical de una celda de sobreescritura de moneda siempre es una barra vertical, pongas lo que pongas aquí. Y tu archivo no registra qué separadores elegiste, así que anótalos si piensas volver a importarlo.
### Paso 4: Revisa y ponle nombre a tu archivo
`Revisar` te muestra un panel llamado `Resumen de exportación` antes de que corra nada.
| Fila | Qué te dice |
| --- | --- |
| `Entidades` | Las tarjetas que elegiste |
| `Formato de archivo` | Tu formato, más el delimitador si elegiste CSV |
| `Formato de fecha` | Qué estilo de fecha elegiste |
| `Compresión` | Lo que vas a recibir de verdad, así que con varias tarjetas dice ZIP |
| `Campos del sistema` | Si están incluidos, excluidos, o encendidos en unas tarjetas y en otras no |
| `Filtros` | Cuántos filtros pusiste. Pasa el cursor por la fila para leerlos |
**Para ponerle nombre tú**, marca `Nombre de archivo personalizado (opcional)` y escribe un nombre de hasta 50 caracteres. No escribes la extensión, porque el PIM la agrega por ti.
Tu nombre pasa por una limpieza antes de usarse, y eso sorprende a mucha gente. Las letras, los números, los guiones, los guiones bajos y los puntos pasan tal como los escribiste. Todo lo demás, incluidos los espacios, se convierte en un guion bajo. Los guiones bajos repetidos se juntan en uno, y los del principio y del final se recortan. Así que `My Export (2026)` está permitido, y lo que recibes es `My_Export_2026`.
El único lugar donde se te muestra ese cambio es la línea `Se guardará como` debajo de la casilla, así que léela antes de pulsar `Exportar`. Si es un ZIP, esa línea además te lista qué hay adentro.
**Si te saltas el nombre**, el PIM arma uno con lo que exportaste y cuándo.
| Exportaste | Recibes un archivo llamado así |
| --- | --- |
| Una tarjeta | `Products_Apr_18_2026_1430.csv` |
| Varias tarjetas | `Multi_Export_Apr_18_2026_1430.zip` |
| Archivos de recursos | `Assets_Apr_18_2026_1430.zip` |
Esa primera palabra siempre está en inglés, uses la app en el idioma que la uses.
Cerrar el diálogo antes de terminar pierde todo lo que configuraste. Primero te pide confirmar, con `Descartar` y `Seguir editando`, y hacer clic fuera del diálogo o pulsar Escape hace lo mismo. No queda ningún borrador al que volver.
### Guarda una configuración como plantilla
Si armas la misma exportación todos los meses, guárdala una vez y cárgala la próxima. Marca `Guardar como plantilla (opcional)` en `Revisar` y ponle un nombre de hasta 50 caracteres. A partir de ahí cualquier persona de tu organización puede cargarla.
Cargar una plantilla llena toda el diálogo y te salta directo a `Revisar`, para que la revises y pulses `Exportar`. El PIM no trae ninguna, así que tu lista está vacía hasta que alguien de tu equipo guarde la primera.
| Una plantilla recuerda | Una plantilla no recuerda |
| --- | --- |
| Las tarjetas y las columnas que elegiste | Los nombres de las columnas, que se leen de nuevo cada vez que exportas |
| Tus filtros | Lo que hayas escrito en la casilla de búsqueda de campos |
| Tus separadores | |
| `Incluir campos del sistema` e `Incluir sobreescrituras de moneda` | |
| El formato, el delimitador, el formato de fecha y la compresión | |
| Tu nombre de archivo personalizado | |
Como los nombres de las columnas se leen de nuevo, una plantilla que guardas hoy te sigue dando los nombres actuales después de que alguien renombre un campo o de que cambies el idioma de la app.
Una plantilla solo llena el diálogo. Nunca corre sola, así que guardar una no te da una exportación programada ni una que se repita.
No puedes editar una plantilla. Para cambiar una, elimínala con la × que está junto a su nombre y guarda una nueva. Se te pide confirmar antes de eliminarla, y eliminarla no toca las exportaciones que ya corriste con ella.
Hay dos cosas que te impiden guardar una plantilla. Un nombre que alguien ya usó se rechaza, y también se rechaza una configuración idéntica a la de otra plantilla, y ahí se te dice con cuál coincide.
### Descarga los archivos en lugar de una hoja de cálculo
Todo lo anterior produce una hoja de cálculo que habla de tus registros. Si lo que quieres son las imágenes y los documentos mismos, haz esto: ve a tu [biblioteca de recursos](/es/pim/assets), selecciona los recursos que quieras y pulsa `Descargar`.
El PIM mete esos archivos en un ZIP y aparece en esa misma tabla de exportaciones, con `ZIP` en la columna `Formato`. No hay diálogo y no hay nada que configurar.
| Pregunta | Respuesta |
| --- | --- |
| Cómo se llama cada archivo | Con su nombre original, o con su nombre para mostrar más la extensión, o con el ID del recurso y `.bin` al final |
| Dos archivos con el mismo nombre | El segundo recibe `-1`, el tercero recibe `-2`, y así |
| Si va comprimido | No. Las imágenes y los PDF ya vienen comprimidos, así que el ZIP solo los guarda |
| Un archivo que no se puede traer | Se omite y el ZIP termina igual. No se te dice cuál faltó |
### Límites
| Qué | Límite |
| --- | --- |
| Formatos de archivo | CSV y XLSX. Un ZIP con archivos de recursos es la única otra opción |
| Filas en un XLSX | 1.000.000. Todo lo que pase de ahí sale como CSV |
| Filas en un CSV | Sin límite |
| Filtros por tipo de registro | Sin límite |
| Opciones en una lista de filtro | 500. `Creado por` y `Actualizado por` muestran hasta 1.000 |
| Tu propio nombre de archivo | 50 caracteres |
| Nombre de plantilla | 50 caracteres |
| Un nombre que escribes en `Renombrar` | 250 caracteres |
| Un separador que escribes | 3 caracteres |
| Columnas de opción de variante | 50 pares |
| Exportaciones a la vez | Una por organización. El resto espera turno |
| Cuánto dura el archivo | 14 días |
| Cuánto dura un enlace de descarga | 1 hora, y recibes uno nuevo en cada clic |
| Cuánto duran los enlaces de imagen del archivo | 7 días |
### Lo que una exportación no puede hacer
| No puedes | Haz esto en su lugar |
| --- | --- |
| Ver una vista previa, un conteo de filas o el tamaño antes de correrla | Córrela y lee las columnas `Filas` y `Tamaño` |
| Programar una exportación o repetirla cada semana | Configura una [fuente de datos](/es/pim/uploads/data-sources#cómo-armar-una-fuente-de-datos), que trae datos hacia adentro |
| Volver a ejecutar o duplicar una exportación terminada | Guarda una plantilla y empieza desde ella la próxima vez |
| Reintentar una exportación fallida | Ármala de nuevo en el diálogo |
| Exportar las filas que seleccionaste o filtraste en una tabla del catálogo | Usa los filtros de dentro del diálogo de exportación |
| Obtener un PDF, JSON, XML o Google Sheets | Usa CSV o XLSX |
| Enviarle el archivo a otra persona, o mandarlo por SFTP o a la nube | Descárgalo y envíalo tú |
| Editar una plantilla | Elimínala y guarda una nueva |
## Cómo se ve tu archivo
Hay dos cosas del archivo que sorprenden la primera vez. Tu conteo de filas es más alto que tu conteo de productos, y algunas columnas no se pueden volver a mandar hacia adentro. Las dos se explican aquí.
### Por qué un producto se convierte en varias filas
Una hoja de cálculo tiene una fila por cada línea de datos, y un producto con variantes es más de una línea de datos. Por eso una exportación de `Productos` te da una fila por variante, y tu conteo de filas casi siempre sale más alto que tu conteo de productos.
- Un producto con una sola variante y sin opciones es **una fila**, con todo dentro.
- Cualquier otro caso es **una fila del producto y luego una fila por variante**. Un producto con 4 variantes te da 5 filas. Un producto con opciones y una sola variante te da 2 filas igual.
La fila del producto lleva la información compartida, y cada fila de variante lleva lo que esa variante tiene de distinto.
| Columnas | Fila del producto | Fila de variante | Producto sin opciones |
| --- | --- | --- | --- |
| `Slug` y `Moneda` | Llenas | Llenas | Llenas |
| `Título` | El título del producto | El nombre de la variante, como `Red / Small` | El título del producto |
| `Descripción`, `Estado`, `Condición`, `Tipo de producto`, `Marcas`, `Categorías`, `Etiquetas`, `Especificaciones`, SEO y notas | Llenas | Vacías | Llenas |
| `Opción 1: nombre` y las demás | Llenas | Llenas | Llenas |
| `Opción 1: valor` y las demás | Vacías | Llenas | Llenas |
| `SKU`, códigos de barras, precios, existencias, dimensiones y aduana | Vacías | Llenas | Llenas |
| Enlaces de imagen y de archivos | Los del producto | Los de la variante, sin tomar nada del producto | Los del producto |
| `ID de producto` | Llena | Llena | Llena |
| `ID de variante` | Vacía | Llena | Llena |
O sea que 100 productos donde 20 tienen variantes te dan bastante más de 100 filas, y la columna `Filas` de la tabla cuenta filas y no productos. Si no tienes claro cuáles de tus productos tienen variantes, mira [variantes](/es/pim/catalog/variants).
Cuántas columnas de opción recibes depende de tu producto más grande, no de los que estén en el archivo. Recibes un par `Opción N: nombre` y `Opción N: valor` por cada opción que ese producto use, hasta 50 pares, y los productos con menos opciones simplemente dejan esas columnas vacías. Si nadie ha usado opciones nunca, no verás ningún grupo `Variantes`.
### Cómo se escriben los valores en el archivo
| Columna | Qué recibes en la celda |
| --- | --- |
| Un precio o un costo | Solo el número, sin símbolo de moneda y con punto decimal, así que `29.99` en dólares, `1500` en yenes y `1.500` en dinares |
| `Moneda` | En qué moneda están las columnas de dinero de esa fila |
| Una medida | El número, en la unidad que nombra la columna de al lado |
| Una columna de unidad | Vacía siempre que la medida misma esté vacía |
| `Rastrear inventario`, `Es obligatorio` y `Es único` | `Yes`, `No`, o nada |
| `Estado` y `Condición` | Palabras con mayúscula inicial y en inglés, como `Active` y `Open Box` |
| `Tamaño de archivo` | Un texto que puedes leer, como `72 KB`, y no un número que puedas sumar |
| Una categoría | La ruta completa, como `Electrónica > Teléfonos > Smartphones` |
| Un enlace de imagen, logo, banner o archivo | Un enlace web hacia tus [recursos](/es/pim/assets) |
| Cualquier cosa vacía | Una celda vacía, nunca la palabra `NULL` |
Un CSV se abre bien en Excel sin pasos extra, con acentos y demás caracteres especiales incluidos. Un XLSX es una sola hoja con la fila de encabezado en negrita.
Los enlaces de imagen de tu archivo dejan de funcionar 7 días después de que se arma. Si le mandas un CSV a alguien, sus imágenes se rompen a la semana, aunque el archivo siga descargándose 14 días.
### Qué columnas puedes volver a importar
Casi toda una exportación de productos vuelve a entrar por [importaciones](/es/pim/uploads/imports), con nombres de columna incluidos. Estas son las que no.
| Tarjeta | Sale, y no puede volver a entrar |
| --- | --- |
| Productos | `Moneda`, `Stock físico`, `Stock del proveedor`, `Costo del proveedor`, las cinco columnas de sobreescrituras de moneda y las cuatro de auditoría |
| Marcas, Categorías, Etiquetas | Todas las columnas de conteo, más `Categoría padre` y `Nivel de categoría` en categorías |
| Grupos y Definiciones de especificación | `Cantidad de definiciones`, `Cantidad de categorías`, `Cantidad de valores` y `Cantidad de categorías excluidas` |
| Valores de especificación | `Ruta de especificación`, que solo existe en las exportaciones, y `Cantidad de productos` |
| Recursos | `Tipo MIME`, `Tipo`, `Tamaño de archivo`, `Ancho (px)`, `Altura (px)`, `Extensión de archivo`, `Cantidad de asignaciones`, `Hash de contenido` y `Ruta del objeto` |
Las columnas de existencias y de costo vienen de tus fuentes y de tus canales, así que ninguna importación las puede escribir. [Inventario](/es/pim/catalog/inventory) explica de dónde sale cada una. El `Título` de una fila de variante también se ignora al volver, ya que el PIM arma ese nombre a partir de las opciones.
`ID de producto` e `ID de variante` son la excepción útil. Enciende `Incluir campos del sistema`, deja esas columnas en el archivo, y una importación puede emparejar tus filas con tus registros actuales. Eso es lo que hace posible el recorrido completo de ida y vuelta.
## Cuando algo falla
### Cómo seguir tu exportación mientras corre
Tu exportación aparece de inmediato en la tabla y va pasando por estos estados:
| Estado | Qué significa |
| --- | --- |
| `En cola` | Hay otra corriendo. La tuya no ha empezado |
| `Pendiente` | La tuya es la siguiente en la fila |
| `Procesando` | La tuya se está escribiendo. Ves un porcentaje |
| `Completado` | Lista, y se puede descargar |
| `Fallido` | Terminó, y no hay nada que descargar |
| `Cancelado` | Terminó, y no hay nada que descargar |
El porcentaje es todo el avance que recibes, y no hay tiempo estimado. Una exportación que sigue corriendo después de 2 horas se marca `Fallido` sola, y la fila no te dice por qué. Nada se reintenta por ti, así que ármala de nuevo en el diálogo.
Estés donde estés en la app, aparece un aviso pequeño cuando tu exportación termina, se haya completado, haya fallado o la hayan cancelado.
### Cómo leer la tabla de exportaciones
| Columna | Qué muestra |
| --- | --- |
| `Archivo` | El nombre del archivo. La búsqueda rápida solo mira esta columna |
| `Entidad` | Qué exportaste. Pasa el cursor para verlas todas |
| `Filtros` | Cuántos filtros usaste. Pasa el cursor para leerlos |
| `Formato` | Lo que recibes de verdad: `CSV`, `ZIP/CSV`, `GZ/XLSX` o `ZIP` |
| `Tamaño` | Cuánto pesa el archivo, una vez que está listo |
| `Estado` | Dónde va, con un porcentaje mientras corre |
| `Filas` | Cuántas filas se escribieron. Pasa el cursor para el desglose por tarjeta |
| `Fecha de creación` | Cuándo se empezó |
| `Creado por` | Quién la empezó |
Las listas de `Entidad`, `Formato` y `Estado` que están arriba de la tabla solo ofrecen valores que tu equipo ya usó, así que es normal que ahí veas una lista corta.
### Renombrar, cancelar y descargar
| Acción | Puedes usarla cuando | Qué recibes si no |
| --- | --- | --- |
| `Renombrar` | La exportación terminó | Un mensaje que te pide esperar a que se complete |
| `Descargar` | La exportación terminó y el archivo sigue ahí | Un mensaje que dice que no está lista, o `Descargando...` mientras trabaja |
| `Cancelar` | Está en cola, pendiente o corriendo | Un mensaje que te dice que ya se completó, ya falló o ya fue cancelada |
Cancelar te deja sin nada que descargar. El archivo se guarda recién al final, así que nunca te quedas con medio archivo. Si la exportación justo terminó en el momento en que pulsaste, el PIM te dice que la cancelación no alcanzó a entrar.
`Renombrar` abre un diálogo pequeño con una casilla `Nombre de archivo`, de hasta 250 caracteres. Solo cambias el nombre, nunca la extensión, y un nombre sin ningún carácter utilizable se rechaza. Espera una rareza aquí: una exportación que salió como ZIP o como `.gz` sigue mostrando `.csv` o `.xlsx` después de renombrarla.
### Cómo obtener tu archivo
Pulsa `Descargar` en la tabla y recibes un enlace que sirve 1 hora. Púlsalo otra vez más tarde y recibes uno nuevo, así que un enlace vencido nunca es un problema.
Quien creó la exportación también recibe un correo cuando está lista, escrito en su propio idioma. No se avisa a nadie más, y no hay forma de mandarle el archivo a una dirección que escribas. Así que hay exactamente dos maneras de obtener tu archivo: el botón de la tabla y el botón de ese correo.
| Parte del correo | Una exportación | Archivos de recursos |
| --- | --- | --- |
| Asunto | `Exportación lista: {fileName}` | `Tus archivos están listos: {fileName}` |
| Encabezado | `Exportación lista` | `Tus archivos están listos` |
| Estado | `Completada` | `Completada` |
| Detalles | `Tipo de exportación`, `Archivo`, `Filas`, `Organización` | `Tipo de exportación`, `Archivo`, `Archivos`, `Organización` |
| Botón | `Descargar exportación` | `Descargar ZIP` |
Necesitas tener la sesión abierta para que el botón del correo funcione. Si el archivo ya no está, el botón simplemente te lleva de vuelta a la tabla de exportaciones. Puedes apagar este correo en `Exportación lista`, dentro de tu configuración de notificaciones.
### Mensajes de error
| Mensaje | Qué hacer |
| --- | --- |
| `Selecciona al menos una columna para exportar.` | Marca al menos una columna, o vuelve atrás y desmarca esa tarjeta |
| `Este campo no se puede quitar porque un filtro activo depende de él.` | Borra primero el filtro, y después quita la columna |
| `Ya existe una plantilla con ese nombre` | Usa otro nombre, o elimina la plantilla anterior |
| `El nombre de archivo solo puede contener letras, números, guiones y guiones bajos` | No sobrevivió nada de lo que escribiste a la limpieza. Usa una letra, un número, un punto, un guion o un guion bajo |
| `La exportación comenzó, pero la plantilla no se pudo guardar: {error}` | Tu exportación está bien y sigue corriendo. Guarda la plantilla la próxima vez |
| `Esta plantilla no tiene entidades configuradas. Por favor elige otra plantilla.` | Elimina esa plantilla y guarda una nueva |
| `No se pudo crear la exportación` | Intenta de nuevo. No se encoló nada, así que no vas a crear una duplicada |
| `La exportación no está lista para descargar.` | Todavía no termina, o el archivo ya pasó sus 14 días |
| `No se pudo cambiar el nombre` | Intenta renombrarla otra vez |
| `No se pudo eliminar la plantilla` | Alguien la eliminó antes que tú. Recarga la página |
| `Ocurrió un error inesperado` | Recarga la página y revisa el estado antes de volver a intentar nada |
### Dos cosas que pasan sin aviso
Nada en pantalla te avisa de ninguna de estas dos, así que conviene conocerlas.
Un `XLSX` de más de 1.000.000 de filas sale como `CSV`, y la única pista es el `.csv` al final del nombre del archivo.
Una fila de filtro que llenaste a medias se descarta al pulsar `Aplicar`. Si tus resultados se ven raros, eso es lo primero que hay que revisar.
## A dónde ir después
El mismo archivo en el sentido contrario, y los cuatro modos en que se puede leer.
Un archivo que llega con su propia frecuencia, y qué hace distinto.
Por qué un producto se convierte en varias filas, y qué es una opción.
A dónde apuntan los enlaces de imagen, y cómo una descarga masiva se vuelve una exportación.