> ## 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.

# Recursos

> Un recurso es un archivo que subes una vez y usas en todos los registros que quieras, desde una foto de producto hasta una guía de tallas.

Un recurso es un archivo que subes una sola vez y después usas en todos los registros que quieras. Puede ser la fotografía de un producto, un video, una guía de tallas o un PDF de garantía. Cada archivo que sube tu organización queda en la misma biblioteca. Asociar uno a tu producto no lo copia, así que una misma fotografía tuya puede estar en doscientos productos. Elimina uno de esos productos y tu fotografía sigue donde estaba.

Casi siempre llegas aquí por una de tres razones. Quieres fotografías en tus productos para que salgan a las tiendas y los marketplaces donde vendes. Quieres darles a tus clientes un documento que puedan descargar. O quieres corregir el nombre y el texto alternativo de archivos que subió alguien de tu equipo.

Tu biblioteca es `Recursos`, en la navegación de la izquierda. Es una tabla con una fila por archivo, no un muro de miniaturas. Aun así, no tienes que empezar ahí. El editor de cada producto, variante, marca y categoría te da sus propias zonas de subida. Un archivo que mandes desde una de ellas queda en la misma biblioteca que todo lo demás.

## Antes de empezar

### Qué te permite hacer tu rol

| Rol | Ver archivos y descargarlos | Subir, asociar y renombrar | Eliminar |
| --- | --- | --- | --- |
| `Administrador` | Sí | Sí | Sí |
| `Gerente` | Sí | Sí | Sí |
| `Editor` | Sí | Sí | No |

Quien tiene rol `Editor` es el caso que hay que conocer. Puedes subir, renombrar, asociar y reordenar todo el día, y el botón `Eliminar` simplemente nunca te aparece. Eso vale en el menú de tu fila, en la página propia del archivo y en la barra que sale cuando marcas filas. Hay un lugar distinto. El ícono de papelera del selector de la biblioteca se muestra para todo el mundo, así que puedes pulsarlo y recibes un aviso en inglés que dice que no tienes permiso. Tu rol se asigna en [equipo, roles y permisos](/es/team#qué-puede-hacer-cada-rol-del-pim).

### Eliminar un archivo es permanente

<Danger>
  Eliminar un archivo lo quita de inmediato de cada producto, variante, marca y categoría que lo esté usando. No hay papelera, ni restauración, ni deshacer. Quitar tu archivo de un solo producto es otra acción distinta y es segura.
</Danger>

## Cómo poner una fotografía en un producto

<Steps>
  <Step title="Abre el producto">
    Desde `Catálogo`, en la navegación de la izquierda, entra a `Productos` y pulsa la fila del producto que quieras. Baja en tu editor hasta la sección que dice `Recursos`.
  </Step>

  <Step title="Elige en qué área va la fotografía">
    Esa sección te da tres áreas donde poner un archivo, llamadas espacios: `Primary`, `Gallery` y `Resources`. `Primary` es la única imagen que representa a tu producto, así que empieza ahí.
  </Step>

  <Step title="Manda el archivo">
    Pulsa `Subir nuevo` dentro del espacio `Primary` para elegir un archivo de tu computadora. Pulsa `Seleccionar existente` para abrir tu biblioteca y reutilizar uno que ya tengas. También puedes arrastrar un archivo directo al espacio.
  </Step>

  <Step title="Escribe el texto alternativo">
    Pulsa el ícono de lápiz debajo de tu imagen. Escribe una frase que describa lo que se ve en la fotografía y pulsa `Guardar` en ese diálogo pequeño.
  </Step>

  <Step title="Guarda el producto">
    Pulsa `Guardar` arriba en el editor. Hasta que lo hagas, tu archivo está en la biblioteca pero no está en tu producto.
  </Step>
</Steps>

Ese es todo el flujo. Tu imagen aparece en el espacio de inmediato, y la próxima vez que el PIM publique ese producto tus cuentas conectadas también la reciben.

Todo lo que sigue explica tu biblioteca, tus espacios y tus integraciones una cosa a la vez. No necesitas nada de eso para poner una foto en un producto.

## Cada opción en detalle

### Sube archivos a la biblioteca

Ve a `Recursos`, en la navegación de la izquierda, y pulsa `Subir` arriba de la tabla. Se abre el selector de archivos de tu computadora y puedes elegir todos los que quieras de una vez. Soltar tus archivos en cualquier parte de la tabla hace lo mismo sin abrir el selector.

Mientras tus archivos suben recibes un contador, y eso es todo. No hay lista de archivos uno por uno ni forma de echar atrás lo que empezaste, así que corre hasta terminar. Si vuelves a empezar antes de que acabe, se te pide esperar.

Un archivo que pasa el límite de tamaño de su tipo ni siquiera sale de tu computadora. El resto de lo que soltaste sigue sin él. Además recibes un aviso que nombra el archivo rechazado.

**Nada revisa si ya tienes el archivo.** Sube la misma fotografía dos veces a mano y quedan dos filas y dos archivos. Nada te avisa. El PIM solo detecta duplicados en los caminos que corre por ti. Una [importación](/es/pim/uploads/imports), una sincronización de fuente de datos o una lectura de una de tus integraciones reutiliza un archivo que ya tienes cuando el contenido es idéntico.

<Accordion title="Por qué un modelo 3D hay que arrastrarlo">
  El botón `Subir` abre el selector de archivos de tu computadora con una lista de tipos puesta. Esa lista nombra imágenes, video, audio, PDF, archivos de Word y de Excel, CSV y comprimidos ZIP, RAR y 7z. Ningún formato 3D está ahí, así que no puedes elegir un `.glb` por ese diálogo.

  Te quedan dos caminos. Arrastra tu archivo sobre la tabla, o mándalo desde el espacio `Gallery` de un producto, que sí acepta modelos 3D.
</Accordion>

### Sube desde dentro de un producto, una marca o una categoría

Un espacio vacío dentro del editor de un registro te muestra dos botones. `Subir nuevo` manda un archivo de tu computadora y lo pone en ese espacio de una sola vez. `Seleccionar existente` abre el selector de la biblioteca para que reutilices algo. Arrastrar tu archivo al espacio también funciona.

Un espacio que ya tiene un archivo deja de mostrar esos dos botones. Se convierte en una tarjeta pequeña con un `+` al final de tu fila de tarjetas. Pulsa esa tarjeta y se abre el selector. Soltar un archivo encima sigue subiéndolo.

Estas zonas de subida mandan un archivo a la vez. Cada uno de tus archivos recibe su propia fila con un estado. El botón `Cancelar` aparece en los que siguen esperando y en los que fallaron, nunca en el que se está moviendo. Aquí nada se puede reanudar, así que una conexión que se corta reinicia ese archivo desde el principio.

**`Seleccionar existente` abre el selector de la biblioteca.** Recibes 24 archivos a la vez detrás de un botón `Cargar más`. Arriba hay una fila de fichas para acotar a un solo tipo de archivo. Un interruptor `Solo seleccionados` aparece en cuanto marcas algo. Su búsqueda es más estrecha que la de `Recursos`: lee el nombre para mostrar, el nombre de archivo original y el texto alternativo, y nada más. Cuando editas una variante, un interruptor `Desde el producto` reduce el selector a todo lo que ya tiene el producto padre.

El selector te deja marcar un archivo que el espacio no acepta. La revisión ocurre al confirmar, en un botón que dice `Done`, que rechaza tu archivo con un aviso en inglés que lo nombra. También te dice cuánto espacio te queda si marcas de más.

`Desde URL` está junto a `Subir nuevo` dentro del selector. Úsalo para traer un archivo desde una dirección web en lugar de tu computadora. También está en el editor donde escribes la descripción de un producto. En ninguna otra parte aparece, y no puedes pegar una imagen desde el portapapeles en ningún lugar del PIM.

### Los espacios donde puede ir un archivo

Un espacio es un área con nombre dentro del editor de un registro. Cada uno limita cuántos archivos puede tener y dice qué acepta.

| Registro | Espacio | Cuántos | Acepta |
| --- | --- | --- | --- |
| Producto | `Primary` | 1 | Imágenes |
| Producto | `Gallery` | 250 | Imágenes, video, audio y modelos 3D |
| Producto | `Resources` | 250 | Cualquier archivo |
| Variante | `Primary` | 1 | Imágenes |
| Variante | `Gallery` | 250 | Imágenes, video, audio y modelos 3D |
| Marca | `Logo` | 1 | Imágenes |
| Marca | `Banner` | 1 | Imágenes |
| Marca | `Resources` | 250 | Cualquier archivo |
| Categoría | `Thumbnail` | 1 | Imágenes |
| Categoría | `Banner` | 1 | Imágenes |
| Categoría | `Resources` | 250 | Cualquier archivo |

Esos nombres se muestran en inglés dentro del editor, incluso con la app en español, así que búscalos tal cual. En un producto y en una variante tus espacios están en la sección que dice `Recursos`. En una marca y en una categoría están al final del editor, cada uno bajo su propio nombre.

**Pon un manual o una hoja técnica en `Resources`, no en `Gallery`.** `Gallery` es para lo que mira quien compra. También es lo que leen tus integraciones cuando arman los medios de un producto. `Resources` es para lo que descarga quien compra, y sale como una lista de enlaces.

Una variante no tiene espacio `Resources`, y saber por qué te ahorra buscarlo. Un manual describe tu producto entero, no una de sus tallas, así que va en el producto. [Variantes](/es/pim/catalog/variants) explica ese reparto.

**Tu imagen principal es la que está en el espacio `Primary`.** No es la primera de tu galería. Reordenar la galería no cambia nada aquí. Para mover una de tus imágenes a `Primary`, abre el menú de los tres puntos de su tarjeta y pulsa `Establecer como principal`. Arrastrar la tarjeta al espacio hace lo mismo.

Un archivo tuyo sí puede estar en dos espacios del mismo registro, que es como una fotografía puede estar en `Primary` y en `Gallery`. Lo que no puede es estar dos veces en un mismo espacio. Agrégalo una segunda vez y se descarta sin aviso. Agrégalo por `Reemplazar` y se te dice que ya está ahí.

<Accordion title="Qué pasa cuando un espacio ya está lleno o ya está ocupado">
  Suelta un archivo en un espacio de uno solo que ya tiene algo y reemplaza lo que estaba, de inmediato y sin preguntarte. No se destruye nada. El archivo que reemplazó sigue en tu biblioteca y puedes devolverlo.

  Arrastra un archivo desde un espacio de uno solo a otro que está ocupado y los dos se intercambian.

  Suelta en un espacio de 250 más archivos tuyos de los que caben y acepta los que quepan. Después te dice a cuántos dejó fuera.
</Accordion>

### Reordena, reemplaza y quita un archivo de un espacio

Cada tarjeta de un espacio, dentro del editor de cualquier registro, te da la misma fila de controles. Un ícono de ojo abre una vista previa. Un ícono de lápiz abre un diálogo pequeño para tu nombre para mostrar y tu texto alternativo. Un ícono rojo de papelera saca tu archivo de este espacio y lo deja en la biblioteca. Detrás de los tres puntos están `Establecer como principal`, `Reemplazar`, `Optimizar`, `Descargar` y `Copiar URL`.

El orden dentro de un espacio lo defines tú arrastrando tarjetas, y un arrastre puede llevar un archivo de uno de tus espacios a otro.

`Copiar URL` te da una dirección web pública del archivo. Quien la reciba puede abrirla sin iniciar sesión, que es justo por lo que tus integraciones pueden traer tus imágenes desde ahí. `Optimizar` nunca toca tu original: escribe un segundo archivo y, desde un espacio, apunta ese espacio al nuevo.

**Marca la casilla de una tarjeta y una barra reemplaza el título del espacio.** Cuenta lo que elegiste. Después te da `Descargar`, `Optimizar` y `Quitar`, más un atajo `Seleccionar todo` para ese espacio. `Quitar` te pide confirmar y te dice que tus archivos se quedan en la biblioteca.

Aquí nada cambia el archivo que hay detrás de una fila. `Reemplazar` cambia a qué archivo apunta tu espacio. Para publicar una versión corregida de una imagen, sube el archivo corregido y apunta tus espacios hacia él. Elimina el viejo después si quieres que desaparezca.

En un registro que solo puedes ver siguen ahí las miniaturas, la vista previa, `Descargar` y `Copiar URL`. Todo lo que cambiaría algo no queda gris. Simplemente no está.

**Una imagen que pegas dentro de la descripción de un producto también es un recurso.** Queda en tu biblioteca como cualquier otra y ahí te la vas a encontrar. Está en un espacio propio que no se muestra en ninguna parte, y eso la mantiene fuera de tu galería y evita que desaparezca cuando editas la descripción.

### Vuelve a encontrar un archivo

Tu biblioteca es plana. No tienes carpetas, ni colecciones, ni álbumes, ni etiquetas de recurso, y nada en el PIM crea ninguna de esas cosas. Volver a encontrar un archivo es tu casilla de búsqueda y tus filtros de columna, y eso es todo.

La casilla de búsqueda que está arriba de la tabla en `Recursos` coincide con parte de una palabra, sin distinguir mayúsculas, en cinco cosas: el nombre para mostrar, el nombre de archivo original, el texto alternativo, el tipo de archivo y su extensión. No busca en los productos donde está asociado tu archivo. Busca el nombre de un producto aquí y no recibes nada.

Recibes 50 filas a la vez, las más nuevas primero. Se refrescan solas cuando alguien de tu equipo o una de tus integraciones cambia algo.

| Columna | Qué te da |
| --- | --- |
| `Recurso` | El nombre para mostrar con su extensión. Ordena por él, o fíltralo como texto |
| `Tipo` | Uno de `Imagen`, `Video`, `Audio`, `Documento`, `Archivo comprimido`, `Modelo 3D` o `Archivo`, con filtro de un solo tipo |
| `Asignado a` | Cuántos productos, variantes, marcas y categorías usan el archivo, o un filtro de asignados y sin asignar |
| `Tamaño` | Cuánto pesa el archivo, con filtro por rango de tamaño |
| `Dimensiones` | Ancho y alto en píxeles, con filtro por rango de megapíxeles |
| `Tipo MIME` y `Extensión` | Qué clase de archivo es, los dos filtrables |
| `Texto alternativo` | El texto alternativo, o nada. Fíltralo como texto para encontrar a los que les falta |
| `Fecha de creación`, `Creado por`, `Última actualización`, `Actualizado por` | Cuándo pasó, y quién o qué lo hizo |

Cada lista de filtro solo te ofrece valores de los que tienes archivos. Un tipo, un rango de tamaño o una extensión de la que no tienes nada no aparece, así que es normal que veas una lista corta.

`Creado por` nombra quién lo hizo y cómo, separados por un punto medio. Un archivo que trajo una de tus integraciones se lee como el nombre de la cuenta y después `Integración`. Uno que bajó una importación se lee como la persona que corrió tu importación y después `Importación`.

Lo que no tiene medida en píxeles no está en ningún rango de megapíxeles, y eso cubre todos los PDF, todos los audios y casi todos los modelos 3D. Usa el filtro de vacíos de esa columna para encontrar los tuyos.

Debajo de la tabla está tu lista de [vistas guardadas](/es/pim/saved-views), que empieza en `Todos los recursos`. Guarda ahí la búsqueda y los filtros que rehaces siempre. La próxima vez los vuelves a tener.

### Abre un archivo y ve todo sobre él

Pulsa cualquier fila en `Recursos` y ese archivo se abre en su propia dirección web, así que puedes pasarle el enlace a alguien de tu equipo.

La página te da la vista previa, los datos del archivo, quién lo tocó y cuándo, y una fila de acciones: `Abrir`, `Vista previa`, `Descargar`, `Editar` y `Eliminar`. `Optimizar` se agrega en una imagen. `Fuentes de datos` se agrega en un archivo que alguna de tus fuentes haya emparejado.

Debajo hay una lista de cada registro que usa tu archivo, una línea por cada uno. Cada línea nombra el registro, de qué clase es y en qué espacio está tu archivo, y se abre en una pestaña nueva. La lista se detiene en 100 y te avisa cuando hay más.

**La vista previa funciona en la misma página con imágenes, video, audio y PDF.** También cubre los modelos GLB, glTF y USDZ. Todo lo demás te muestra su ícono y una línea que dice que no hay nada que ver, y `Descargar` es la forma de leerlo.

Tus GIF animados siguen animándose y tus SVG se ven nítidos en cualquier tamaño, porque el PIM te muestra esos dos tal como los subiste.

### Ponle nombre y texto alternativo a un archivo

Dos campos, que se editan de a un archivo. Ábrelos desde el ícono de lápiz de cualquier tarjeta dentro de tu registro, o desde `Editar` en la página propia del archivo.

`Nombre para mostrar` es obligatorio y llega hasta 100 caracteres. Es una etiqueta, no un nombre de archivo. Renombrar tu archivo nunca cambia su dirección web, así que nunca rompe un enlace que alguien ya copió. La extensión que ves después del nombre se agrega al mostrar tu fila y no es parte de lo que escribiste.

`Texto alternativo` llega hasta 500 caracteres. Deja el tuyo por debajo de 125 si puedes, porque ahí es donde los lectores de pantalla y los buscadores dejan de prestar atención. Tu contador en la página propia del archivo se pone en advertencia pasado ese punto.

**El texto alternativo llega vacío en cada subida.** Nada lo completa por ti: ni generación, ni sugerencia, ni forma de editarlo para muchos archivos a la vez. La única excepción es [el optimizador](/es/pim/assets/optimizer), que copia el texto alternativo de tu imagen de origen al archivo que escribe.

Tus dos lugares de edición no son iguales. La página propia del archivo cuenta los caracteres mientras escribes y te detiene en el límite. El diálogo del lápiz no cuenta nada y deja que tu guardado falle.

### Descarga tus archivos

`Descargar`, en el menú de una fila de `Recursos`, te da el archivo original de inmediato, tal como lo subiste. Nada se convirtió, se redimensionó ni se comprimió al entrar, así que lo que sale es exactamente lo que mandaste.

Marcar filas cambia lo que significa esa palabra. El `Descargar` masivo de arriba de la tabla te arma un ZIP y te dice que lo está preparando. Después te llega igual que una [exportación](/es/pim/uploads/exports). Aparece en tu tabla de exportaciones y recibes un correo cuando está listo.

La misma palabra dentro del editor de un registro hace otra cosa. Ahí mete las tarjetas que marcaste en un ZIP dentro de tu propio navegador y lo guarda de inmediato, sin correo y sin esperar.

### Elimina un archivo para siempre

`Eliminar` está en tres lugares: el menú de tu fila en `Recursos`, las acciones de la página propia del archivo y la barra que sale cuando marcas filas. Los tres te piden confirmar primero. Los tres se esconden salvo que tu rol sea `Gerente` o más alto.

La confirmación del selector de la biblioteca es la útil. Cuenta primero y te dice qué vas a romper antes de que aceptes. La de `Recursos` nombra tu archivo y avisa que se quita de todos los registros, sin el conteo.

Las filas que marcas tú se eliminan mientras miras. Usa la selección por filtro con más de 100 archivos y el PIM lo hace en segundo plano. Te da su propio progreso y un botón para cancelar, así que tu página sigue usable mientras corre.

### Límites

| Qué | Límite |
| --- | --- |
| Imagen más grande | 25 MB |
| Video o modelo 3D más grande | 476 MB |
| Audio o comprimido más grande | 200 MB |
| Documento o cualquier otro archivo más grande | 50 MB |
| Archivos en `Primary`, `Logo`, `Banner` o `Thumbnail` | 1 |
| Archivos en `Gallery` o `Resources` | 250 |
| Nombre para mostrar | 100 caracteres |
| Texto alternativo | 500 caracteres |
| Archivos en una acción masiva | 10.000 |
| Registros listados en las asignaciones de un archivo | 100 |
| Archivos por página en el selector de la biblioteca | 24 |
| Filas por página en `Recursos` | 50 |

Los MB se cuentan igual que los cuenta tu explorador de archivos, así que una fotografía que tu computadora llama 24,9 MB está por debajo del límite de imagen.

<Note>
  Nada cuenta cuántos archivos guardas ni cuánto espacio ocupan, y ningún plan te cobra por ninguna de las dos cosas.
</Note>

### Lo que la biblioteca de recursos no puede hacer

| No puedes | Haz esto en su lugar |
| --- | --- |
| Ordenar tus archivos en carpetas, colecciones o álbumes | Busca, filtra las columnas y guarda una vista |
| Etiquetar un archivo | Pon la palabra en su nombre para mostrar o en su texto alternativo |
| Cambiar el archivo que hay detrás de una fila | Sube el archivo corregido y apunta tus espacios hacia él |
| Recibir el texto alternativo escrito o sugerido | Escríbelo de a un archivo |
| Editar el texto alternativo de muchos archivos a la vez | Abre cada archivo y edítalo |
| Encontrar archivos que subiste dos veces | Compáralos a ojo |
| Pegar una imagen desde el portapapeles | Arrastra el archivo, o usa `Desde URL` |
| Asociar un archivo a un registro desde la tabla de la biblioteca | Abre el registro y usa sus espacios |
| Deshacer una eliminación | Vuelve a subir el archivo |
| Guardar datos de cámara, derechos o licencia en un archivo | El PIM no guarda nada de eso |
| Ver cuántas veces se vio o se descargó un archivo | Nada lleva esa cuenta |

## Qué acepta cada integración

Lo que pasa con tus archivos depende de qué integración los recibe, y no hay dos iguales. Un archivo tuyo puede publicarse en una cuenta, ser rechazado por otra y no tener a dónde ir en una tercera. Tu página de [integraciones](/es/pim/integrations) expone el resto de las diferencias, cuenta por cuenta.

| Integración | Imágenes | Video y 3D | El `Resources` de un producto |
| --- | --- | --- | --- |
| Shopify | Sale en cada envío, entra solo en la primera sincronización | Sale en cada envío, entra solo en la primera sincronización | Como enlaces, solo de ida |
| BigCommerce | Salen en cada envío, entran solo en la primera sincronización | No | No |
| Square | Salen en cada envío, entran solo en la primera sincronización | No | No |
| Google | Solo de ida, y obligatorias | No | No |
| Amazon | No | No | No |

**Las imágenes son lo único que acepta más de una integración.** Todo lo demás es de Shopify. Lee esa columna del medio antes de decidir si vale la pena subir un video.

Un archivo que tu integración rechaza nunca detiene tu envío. Los datos de tu producto y cada archivo válido igual salen, y la insignia de tu producto se pone naranja. Recibes una línea por tipo de problema, así que diez imágenes rechazadas producen un aviso y no diez.

### Shopify

Shopify acepta más archivos tuyos que ninguna otra. Es la única que acepta un video o un modelo 3D.

Tu envío manda primero la `Primary` del producto, luego su `Gallery`, luego la `Primary` y la `Gallery` de cada variante, sin repetidos. La imagen principal de tu variante también queda como la imagen de esa variante en Shopify. La excepción es un video o un modelo 3D, para los que Shopify no tiene espacio de variante, así que esos quedan solo en tu producto.

La primera sincronización trae a tu biblioteca las imágenes, los videos y los modelos 3D de tu tienda, y es la única vez que entra algo. La primera imagen queda en tu espacio `Primary` y el resto en tu `Gallery`. Un video de YouTube o de Vimeo incrustado en tu producto de Shopify no es un archivo y no se trae. Un archivo que alguien agregue en tu tienda después se queda donde está en vez de borrarse en tu siguiente envío, y no entra a tu biblioteca, así que un archivo que quieras aquí es uno que subes aquí. [La integración de Shopify](/es/integrations/shopify) cubre el resto.

**El `Resources` de un producto sale como enlaces, nunca como tus archivos.** Tu envío escribe el nombre, la dirección web, el tipo, el peso y la extensión de cada archivo en un metafield `pim` de tu producto. El orden es el que armaste, para que tu tema pueda montar un bloque de descargas. Tus archivos se quedan en el PIM, que es por lo que un manual de 400 MB no es problema. Nada lee esa lista de vuelta, así que un cambio que hagas en tu panel de Shopify se sobrescribe en tu siguiente envío. El espacio `Resources` de una marca o una categoría no sale a ninguna integración.

<Accordion title="Los formatos y los tamaños que acepta Shopify">
| Clase de medio | Formatos que acepta | Archivo más grande |
| --- | --- | --- |
| Imagen | PNG, JPEG, WebP, GIF, SVG, HEIC, BMP, TIFF y PSD | 20 MB |
| Video | MP4, MOV y WebM | 1 GB |
| Modelo 3D | GLB o USDZ | 500 MB |

  Shopify también rechaza una imagen de más de 5000 por 5000 píxeles.

  O sea que AVIF, HEIF y AVI entran sin problema a tu biblioteca y aquí se rechazan. Igual pasa con cualquier formato 3D fuera de GLB y USDZ, y con un audio que esté en tu galería.

  Algunas de esas respuestas no son inmediatas. Shopify acepta tu archivo primero y decide después, así que tu envío espera unos segundos. Una respuesta más lenta llega en tu siguiente envío de ese producto, que es como una insignia se pone naranja sin que nadie toque el archivo.
</Accordion>

### BigCommerce

BigCommerce acepta imágenes y nada más. Tus videos, audios, modelos 3D y documentos no tienen a dónde ir en un producto de BigCommerce.

Tu primera sincronización juega a tu favor. Las imágenes que ya están en tu tienda se descargan a tu biblioteca antes de mandar nada de vuelta. De ahí en adelante decides tú. Cada envío después de ese reemplaza la lista de imágenes de un producto por la tuya, en tu orden, y tu `Primary` queda como la miniatura del producto. Una imagen que alguien agregue en tu panel de BigCommerce no se queda después de tu siguiente envío.

<Accordion title="Qué acepta BigCommerce">
  BMP, GIF, JPEG, PNG, WBMP, XBM y WebP, de hasta 8 MB cada una, y hasta 1.000 imágenes en un producto. WebP es el formato que hay que mirar, porque Square lo rechaza y BigCommerce no.

  Un archivo rechazado aquí se reporta como advertencia en tu producto y nada más se detiene. [Integraciones](/es/pim/integrations) lista lo que acepta el resto de un producto.
</Accordion>

### Square

Square acepta imágenes y nada más: JPEG, PNG o GIF, de hasta 15 MB cada una. Tus archivos WebP, AVIF, SVG, HEIC y TIFF están bien en la biblioteca y aquí se rechazan. El catálogo de Square no tiene dónde poner tus videos, audios, PDF ni modelos 3D.

Tu nombre para mostrar se convierte en el nombre de la imagen en Square, y tu texto alternativo en su leyenda. Los dos se cortan a 255 caracteres.

Los archivos van en un solo sentido después de conectar. Square te da las imágenes que ya tenía mientras corre tu primera sincronización. De ahí en adelante el PIM escribe y no vuelve a leer. [La integración de Square](/es/integrations/square) lista lo que sí acepta.

### Google

Google Merchant Center es el único lugar donde una imagen que falta detiene tu publicación. Una variante sin imagen publicable propia, y sin ninguna en su producto, no se manda. La ves reportada como bloqueada y no como advertencia de medios.

La imagen propia de tu variante va primero, y las imágenes de tu producto son el respaldo para una variante que no tiene ninguna. Google acepta una imagen principal y hasta 10 más.

Google nunca recibe tu archivo. Recibe la dirección web y trae la imagen desde tu biblioteca, que es por lo que la foto que ve quien compra se actualiza cuando cambias el archivo. Los formatos aceptados son JPEG, PNG, WebP, GIF, BMP y TIFF, de hasta 16 MB cada uno.

### Amazon

Amazon no recibe ningún archivo. Amazon en el PIM es solo de oferta. Tu envío manda la condición, el precio, el vínculo entre tu SKU y el ASIN en el primer envío y, en publicaciones que despachas tú, la cantidad. Tus imágenes, títulos, descripciones y especificaciones nunca se mandan ni se leen de vuelta.

O sea que cambiar una fotografía mala en el PIM no cambia nada en tu publicación de Amazon. Corregir su texto alternativo tampoco, porque la oferta que describe [la integración de Amazon](/es/integrations/amazon) no lleva imágenes.

## Cuando algo falla

### Mensajes que puedes ver

| Mensaje | Qué hacer |
| --- | --- |
| `"{name}" supera el límite de {kind} de {limit}` | Tu archivo pasa el límite de tamaño de su tipo. Hazlo más chico, o déjalo fuera |
| `Ya hay una subida en curso. Espera a que termine antes de iniciar otra.` | Tu subida anterior sigue corriendo. Mira el contador y vuelve a empezar cuando pare |
| Un aviso en inglés que nombra tu archivo y dice que ese tipo no se acepta ahí | Ese espacio no acepta esa clase de archivo. Ponlo en `Resources`, o súbelo solo a tu biblioteca |
| `{count} recursos omitidos: espacio lleno` | Tu espacio llegó a su límite. Saca algo primero |
| `Ese recurso ya está en este rol` | Tu archivo ya está en ese espacio, y no cambió nada |
| `El nombre de visualización no puede estar vacío` | Escribe un nombre. Cada archivo necesita uno |
| Un aviso en inglés que dice que no tienes permiso para eliminar recursos | Tu rol está por debajo de `Gerente`, así que pídeselo a alguien con un rol más alto |
| `Esta URL devolvió una página web en lugar de un archivo. Usa un enlace de descarga directa.` | Le diste a `Desde URL` la dirección de una página. Copia la dirección del archivo mismo |
| `No se pudo actualizar el recurso` | Intenta de nuevo, y recarga tu página si pasa dos veces |

### Cambiar un nombre o un texto alternativo llega a dos integraciones

Cambia cualquiera de los dos campos en un archivo que ya tiene una de tus integraciones y el PIM manda tu cambio de vuelta por su cuenta. Pasa sin que tú envíes el producto. Dos integraciones actúan. Shopify actualiza el nombre y el texto alternativo de tu archivo, y Square actualiza el nombre y la leyenda de la imagen.

BigCommerce tiene copias de tus imágenes y no recibe ninguno de los dos cambios. Ahí un cambio de nombre solo surte efecto la próxima vez que envíes ese producto.

Aquí importan tres detalles. A un video o un modelo 3D de Shopify no se le puede cambiar el nombre de archivo, así que en esos solo sale tu texto alternativo. Si vacías el texto alternativo en el PIM, también queda vacío en tu integración. Y una falla aquí nunca frena la sincronización real de tu producto. No se te avisa cuando pasa, así que revisa el canal si un cambio de nombre no aparece.

### Dos cosas que pasan sin aviso

Nada en pantalla te avisa de ninguna de las dos.

Agregar un archivo dos veces al mismo espacio descarta el segundo sin decir nada. Si te falta una tarjeta que esperabas, revisa eso primero.

Un archivo que no se puede traer mientras se arma tu descarga masiva se omite, y tu ZIP termina igual. No se te dice cuál faltó.

## A dónde ir después

<Columns cols={2}>
  <Card title="El optimizador" icon="wand-sparkles" href="/es/pim/assets/optimizer">
    Redimensiona una imagen, quítale el fondo y publica el resultado como archivo nuevo.
  </Card>

  <Card title="Productos" icon="package" href="/es/pim/catalog/products">
    El editor donde están tus espacios, y todo lo demás de un producto.
  </Card>

  <Card title="Integraciones" icon="plug" href="/es/pim/integrations">
    Qué cuentas tienen una copia de cada archivo, y qué aceptó cada una.
  </Card>

  <Card title="Importaciones" icon="upload" href="/es/pim/uploads/imports">
    Llenar tu biblioteca desde un archivo de direcciones web, y la regla de reutilización.
  </Card>
</Columns>
