SUMARIO

1. Información general

a. Definiciones importantes de Amazon

b. Fecha límite de Amazon para la migración

2. Página de errores comerciales

3. Migración a la V.2: pasos a seguir

a. Pedidos

b. Publicación de ofertas

c. Publicación de productos

4. Preguntas frecuentes

a. Amazon Direct > Amazon V.2

b. ¿Cómo configurar variaciones de productos?

c. Atributos frecuentemente necesarios

d. Nivel de requisitos vs. errores de publicación

e. Publicaciones en error

Participe en nuestro webinar dedicado a Amazon V2 para descubrir en 30 minutos qué cambia, cómo migrar fácilmente y resolver sus dudas en directo.

Amazon ha hecho algunos cambios en su API, que incluyen la depreciación de los ficheros XML para las publicaciones. Debido a esto, BeezUP debe migrar a los ficheros JSON para el proceso de publicación.

Decidimos aprovechar esta oportunidad para crear un nuevo canal con todas nuestras funcionalidades de V.2, y con algunas sorpresas 😉

Los tipos de publicación ahora estarán alineados con la mayoría de nuestros otros marketplaces: solo productos y ofertas.

* Las publicaciones de oferta dinámica y de 1 h solo están disponibles para algunos planes BeezUP. Por favor, contacta a nuestro servicio de atención al cliente si deseas saber más.

📘 Product types: Las categorías de Amazon están vinculadas al tipo de producto, y cada tipo de producto tiene requisitos específicos de atributos y valores. En el nuevo canal V.2, verás los tipos de productos en el último nivel del mapping de categorías:

Usaremos el tipo de producto para mostrarte solo los atributos relevantes para tus productos en la página de mapeo de columnas.

📘 Patch mode: Amazon tiene dos modos de publicación que se establecen para cada producto: "update" y "patch".

Por defecto, BeezUP envía todos los productos en modo de "update", que reemplazará automáticamente la información si Amazon acepta el listado (producto sin errores). Sin embargo, si solo deseas actualizar la información que se está enviando (sin afectar a los atributos no enviados), puedes optar por activar el modo "patch" para cualquier producto (o para todos). Este es el equivalente del modo patial_update en el canal V.1.

Para activarlo, debes enviar el valor True en el campo Patch Mode del mapping. Puedes usar un campo personalizado para determinar qué productos enviar en modo patch.

📘 Universos de Amazon: El canal V.2 puede publicar productos para todas las categorías, así como productos que ya se han creado en Amazon (correspondencia de EAN que se realiza en Amazon Direct (V.1)).

📘 Errores técnicos: Utilizamos el término error técnico para los errores devueltos por Amazon cuando los datos enviados no corresponden al esquema de Amazon. Esto podría ser, atributos requeridos que faltan, o valores enviados con el tipo de datos incorrecto (por ejemplo, un texto fue enviado para un atributo numérico).

📘 Errores comerciales: Utilizamos el término error comercial para problemas relacionados con el contenido de la información enviada o el estado de tu cuenta. Un atributo puede tener el tipo de datos correcto, pero Amazon podría rechazarlo, o podrían solicitar autorizaciones antes de listar productos de ciertas marcas. También podrían rechazar listados debido a razones relacionadas con el estado de su cuenta.

📅 Amazon dejará de procesar los ficheros XML el 30 de junio de 2025.

⚠️ Tienes hasta entonces para migrar al canal V.2 y así evitar cualquier interrupción en tus publicaciones.

Con los nuevos feeds JSON, viene un cambio en el reporte de publicación de Amazon.

Los informes de las publicaciones con ficheros XML (Amazon V.1) contienen errores técnicos y comerciales, sin embargo, los reportes de publicaciones con ficheros JSON (Amazon V.2) solo contienen errores técnicos.

Una vez que el producto no tiene ningún error en el reporte de publicación, puede ser considerado como aceptado desde un punto de vista técnico. Ahora, Amazon puede tardar hasta 8 horas en procesar este producto.

Si Amazon rechaza el producto, verás el error comercial en nuestra nueva página Errores comerciales.

Esta nueva página está disponible en Publicaciones y Visión de producto.

Los errores mismatch (códigos de error 8541/8542) serán visibles en esta nueva página, y aún podrás establecer productos como idénticos para aceptar el ASIN sugerido por Amazon para corregir este error.

1. Añadir el canal de Amazon V.2 para tu país.

2. Mapear las categorías en la página Mapeo de categorías. Ten en cuenta que el árbol de categorías ha sido actualizado, por lo que no será posible copiar el mapeo de categorías de la V.1 a V.2. Si utilizas Amazon Direct o solo envías publicaciones de ofertas, sigue estos pasos.

3. Ir a la página de Mapeo de columnas y mapear al menos los atributos obligatorios. Si tienes preguntas sobre los nuevos atributos, por favor revisa las descripciones que se encuentran junto a cada atributo y examina esta sección para ver la lista de los atributos más comunes.

4. Replicar manualmente las mismas condiciones de exclusión del canal V.1 en Amazon V.2.

5. Recuperar el token API desde la página Parámetros API y seleccionar los países para la recuperación de pedidos (puedes ir a los Parámetros API del canal V.1 para ver la configuración actual). No es necesario activar ningún tipo de publicación por el momento.

6. Activar el canal de Amazon V.2 - mientras el(los) canal(es) V.1 sigue(n) activo(s).

No habrá ningún impacto para la recuperación de pedidos y las solicitudes de cambio de estado. Una vez que actives el canal de Amazon V.2, la recuperación del pedido se hará como de costumbre.

Ya sea que cambies el estado de un pedido con el uso de nuestro módulo, directamente en la página BeezUP o por API, el proceso actual seguirá siendo el mismo. No necesitas hacer ningún cambio ni adaptación.

⚠️ Por favor, presta atención a los países seleccionados en los Parámetros API del canal V.1 de Amazon para que puedas tener la misma configuración en la V.2.

Recomendamos que comiences por migrar las publicaciones de ofertas.

Mapea al menos los atributos mencionados aquí y activa la publicación de ofertas en la página Parámetros API del canal Amazon V.2.

Luego espera la primera publicación automática de la oferta: Si ves errores en la publicación de la oferta, revisa el reporte y mapea los campos necesarios o corrige los valores mapeados (algunos atributos tienen una lista de valores válidos).

Una vez que no tengas errores en la publicación de la oferta, felicitaciones 🎉. Ahora puedes desactivar las publicaciones de inventario y precios en el(los) canal(es) V.1.

Después de activar la publicación de ofertas, puedes comenzar a migrar las publicaciones de productos.

Mapea al menos los atributos mencionados aquí y aquí si tiene variaciones. A continuación, desactiva las publicaciones de producto, imágenes y relaciones (variaciones) en el(los) canal(es) V.1.

Ahora puedes activar la publicación de productos en la página Parámetros API del canal Amazon V.2.

Espera a la primera publicación automática del producto: Si ves errores técnicos en la publicación de productos, revisa el reporte y mapea los campos necesarios o corrige los valores mapeados (algunos atributos tienen una lista de valores válidos). Ve a esta sección para tener más información sobre estos errores técnicos.

Una vez que no veas errores técnicos en el reporte de publicación de productos, felicitaciones 🎉.

7. Una vez que hayas activado con éxito ambos tipos de publicación en el canal V.2 siguiendo los pasos anteriores, está todo listo 🙌. Desactiva el(los) canal(es) V.1.

Amazon Direct es un canal V.1 que permite publicar productos que ya existen en la base de datos de Amazon. Utiliza el número ASIN (Amazon Standard Identification Number) para asociar el SKU a la ficha del producto de Amazon, con un esfuerzo mínimo (sin categorización y sin mapeo de atributos específicos).

Para publicar los productos con Amazon V.2 utilizando el mismo enfoque, debes categorizar todos los productos en la categoría "Amazon Direct".

Al categorizar productos con Amazon Direct, verás los atributos mínimos requeridos en la página de Mapeo de columnas (similar al canal V.1).

Amazon requiere la creación de una ficha de producto para el producto "padre" y para luego poder asociar todas las fichas de productos de variación a dicho padre.

Siga la siguiente tabla para mapear (o no) los atributos necesarios para crear una variación:

Aquí tienes un ejemplo concreto:

Es posible que en el reporte de publicación de productos aparezcan algunos atributos como obligatorios, sin embargo, no están marcados como obligatorios en la página de Mapeo de columnas.

Ten en cuenta que en BeezUP marcamos los atributos como obligatorios si también están marcados de esta manera en el esquema de Amazon para el tipo de producto especificado.

Sin embargo, Amazon también aplica los requisitos condicionales: un atributo puede convertirse en obligatorio si mapeas un valor específico en un atributo o grupo de atributos. No mostramos estos requisitos condicionales en la página de mapeo.

⚠️ Por favor, monitorea las publicaciones de productos, ya que algunos atributos marcados como opcionales en el mapeo pueden ser obligatorios dependiendo de la información que estes enviando.

Si lanzas publicaciones justo después de activar el canal Amazon V.2, es posible que estén en error.

Hay acciones que se realizan automáticamente después de la activación que tardan unos minutos, por lo que es normal ver las publicaciones en error cuando se lanzan.

Ten en cuenta que recomendamos esperar a las publicaciones automáticas en lugar de lanzar manualmente las publicaciones durante la migración a la V.2.