Cargar paquetes de productos desde un CSV

1. Propósito

Crear o reemplazar múltiples paquetes de productos en una sola operación cargando un CSV, y dar al archivo el formato correcto desde el principio. El formato no es el que la mayoría de las personas supone, y adivinarlo produce paquetes que parecen creados correctamente pero son erróneos.

2. Alcance

Cubre la creación y el reemplazo masivo de paquetes de ensamblaje mediante la carga de CSV en la página de Productos. No cubre la creación manual de un paquete individual en un registro de producto, las compilaciones de producción o fabricación bajo pedido, ni los trabajos de ensamblaje en el almacén.

3. Roles y responsabilidades

4. Cuándo necesita esto

Úselo al incorporar una marca que vende kits, cuando un catálogo cambia lo suficiente como para necesitar reconstruir los paquetes de forma masiva, o cuando una carga anterior pareció completarse con éxito pero todos los paquetes resultaron con un único componente.

5. Concepto clave: la columna de SKU del paquete es un delimitador, no una etiqueta

Este es el único factor que provoca que las cargas fallen, y es responsable de casi todos los tickets de soporte relacionados con esta función.

Por lo tanto, la regla es: nombre el paquete una sola vez, en su primera fila, y deje esa columna vacía en cada componente adicional.

6. Cómo debe estructurarse el archivo

Tres columnas, en minúsculas con guiones bajos, escritas exactamente así. La coincidencia de encabezados distingue entre mayúsculas y minúsculas, por lo que Bundle SKU o BUNDLE_SKU generará un error en cada fila.

bundle_sku,line_item_sku,quantity

KIT-ALPHA,COMPONENT-1,1

,COMPONENT-2,2

,COMPONENT-3,1

KIT-BETA,COMPONENT-1,4

,COMPONENT-9,1

Ese archivo crea dos paquetes. KIT-ALPHA contiene tres componentes y KIT-BETA contiene dos. Tenga en cuenta que COMPONENT-1 aparece en ambos, lo cual es correcto y habitual.

Reglas de columnas:

bundle_sku es obligatorio en la primera fila de cada paquete y debe estar vacío en todas las filas de continuación.

line_item_sku es obligatorio en cada fila, incluida la primera.

cantidad es obligatoria en cada fila, debe ser un número entero mayor que cero y no tiene valor predeterminado. Dejarla en blanco es un error, no un atajo para indicar uno.

7. Procedimiento

1. Confirme que cada SKU de paquete y cada SKU de componente ya existen en Ship Side Kick, y que ninguno está archivado. La carga no creará productos, y un producto archivado es indistinguible de uno inexistente en el informe de errores. Desarchive todo lo que necesite antes de continuar.

2. Vaya a Productos en la navegación izquierda. Asegúrese de que la pestaña Productos esté seleccionada en lugar de Variantes; de lo contrario, el menú Acciones no ofrecerá la opción de carga.

3. Abra el menú Acciones y elija Cargar paquetes.

4. Haga clic en Descargar plantilla CSV y construya su archivo a partir de ella. Comenzar desde la plantilla garantiza que los encabezados sean correctos.

5. Complete sus paquetes siguiendo la sección 6. Nombre cada paquete una sola vez y deje la columna de SKU de paquete vacía para sus componentes restantes.

6. Guarde el archivo como CSVsimple. En Excel, no elija «CSV UTF-8», ya que agrega un carácter invisible al encabezado de la primera columna y hace que todas las filas fallen al mismo tiempo. Elija «CSV» o «Valores separados por comas» en su lugar.

7. Seleccione el archivo y cárguelo. El archivo debe ser inferior a 5 MB.

8. Lea el mensaje de resultado. Si alguna fila falló, haga clic en Descargar CSV de paquetes con errores antes de cerrar el cuadro de diálogo y, a continuación, trabaje con la sección 9.

9. Corrija las filas que señala el informe y vuelva a cargar únicamente los paquetes corregidos. Volver a cargar un paquete reemplaza sus componentes por completo, por lo que un archivo corregido no crea duplicados.

8. Verificación

No confíe únicamente en el recuento de éxitos. Este cuenta las filas aceptadas, no los paquetes configurados correctamente.

Abra dos o tres de los productos cargados y compruebe la lista de componentes de cada uno. Elija el paquete con más componentes en su archivo, ya que es donde el error de delimitador se hace más evidente. Si un paquete que esperaba tener ocho componentes solo tiene uno, el SKU del paquete se repitió en cada fila y el archivo debe reformatearse según la sección 5.

Confirme también el total. Si el resultado reporta muchos más paquetes de los que describía su archivo, la carga dividió sus filas en paquetes independientes.

9. Qué le indica el archivo de errores

La descarga contiene todas las filas de cada paquete rechazado, en el orden original del archivo, con una columna error añadida. Registra todos los fallos a la vez en lugar de detenerse en el primero. Las filas que estaban bien pero pertenecen a un paquete rechazado también se incluyen, de modo que el archivo pueda volver a cargarse una vez corregido.

Importante: una fila incorrecta rechaza todo el paquete, no solo esa fila.

10. Restricciones y advertencias

Nunca incluya el SKU de un paquete como uno de sus propios componentes. Dependiendo de si ese paquete ya tenía una lista de componentes, esto se rechaza con un mensaje confuso o se guarda sin advertencias como un paquete que se contiene a sí mismo. Elimine esas filas en lugar de dejarlas y confiar en el informe de errores para detectarlas.

Volver a subir el archivo reemplaza, no combina. Un paquete existente tiene toda su lista de componentes sustituida por lo que indique el nuevo archivo. No existe un modo aditivo.

Volver a subir el archivo aplana un paquete creado manualmente. Si alguien ensambló un paquete en la aplicación con varios pasos con nombre, descripciones o ubicaciones de paso, una carga colapsa todo en un único paso llamado Ensamblaje y renombra la lista de componentes del paquete. Ese trabajo no puede recuperarse, por lo que debe evitarse volver a subir paquetes que hayan sido construidos cuidadosamente a mano.

Repetir el SKU de un paquete más abajo en el archivo no añade contenido a dicho paquete. El grupo posterior reemplaza silenciosamente al anterior, y la última aparición en el archivo prevalece. Mantenga cada paquete en un bloque contiguo.

Un paquete no puede contener otro paquete. El anidamiento de kits no es compatible.

Cada paquete cargado produce exactamente una unidad por fabricación. Si una fabricación debe producir más de una unidad terminada, eso debe configurarse en el registro del producto después de la carga.

Los componentes duplicados no se combinan. Incluir el mismo componente dos veces en un paquete crea dos líneas separadas en lugar de sumar las cantidades.

Si la estructura del archivo está mal formada, por ejemplo una fila con más o menos comas que el encabezado, la carga completa es rechazada y no se importa nada. Recibirá un mensaje sobre un formato CSV no válido y no se generará ningún informe de errores.

11. Ejemplo práctico

La lista de paquetes de una marca llega como una hoja de cálculo de varios cientos de filas, una por componente. La carga reporta éxito, crea menos paquetes de los que describe el archivo y deja cada kit de múltiples componentes con un único componente.

Restructurar el archivo con una fila por paquete, con sus componentes enumerados junto a él, es lo que hace que el proceso sea correcto. Hay que esperar un residuo en cualquier primera pasada: SKUs que la marca ha acordado ignorar, filas con autoreferencia que deben eliminarse, y algún SKU de componente que genuinamente no existe.

12. Documentos relacionados

• SWI-004 — Leer la pantalla de inventario, para saber cómo se muestra el stock de paquetes una vez que estos existen

• SWI-002 — Mover inventario entre ubicaciones