Stock export

El módulo de exportación de existencias genera archivos CSV con datos de stock de los productos de WooCommerce. Admite 10 campos configurables, el filtrado por umbral de cantidad, compatibilidad total con productos variables y un modo de vista previa en una tabla HTML.

Activar el módulo

Ve a WooCommerce > Polski > Herramientas y activa Stock export (ID del módulo: stock_export).

Panel de exportación

El panel de exportación está disponible en Productos > Stock export (edit.php?post_type=product&page=polski-stock-export).

Filtro de umbral

Filtra los productos por la cantidad en stock:

Operador	Descripción	Ejemplo
<=	Menor o igual	<= 5 - productos con stock de hasta 5 unidades
>=	Mayor o igual	>= 100 - productos con stock alto
=	Exactamente igual	= 0 - productos sin stock

El filtro de umbral permite identificar rápidamente los productos que necesitan reposición o los productos con exceso de stock.

Deja el campo de umbral vacío para exportar todos los productos independientemente del nivel de stock.

Selección de campos

Selecciona los campos que se incluirán en la exportación. La configuración se guarda en las opciones de WordPress.

Campo	Columna CSV	Descripción
ID del producto	product_id	ID de la entrada del producto (post ID)
SKU	sku	Código SKU del producto
Nombre del producto	product_name	Nombre completo del producto
Estado del stock	stock_status	instock, outofstock, onbackorder
Cantidad en stock	stock_quantity	Cantidad actual (null si no se gestiona)
Gestión de stock	manage_stock	yes o no
Umbral de stock bajo	low_stock_threshold	Umbral de notificación de stock bajo
Pedidos pendientes permitidos	backorders	no, notify, yes
Categoría	category	Categorías del producto (separadas por comas)
Precio	price	Precio actual del producto

Compatibilidad con variaciones

Los productos variables se exportan con compatibilidad total con las variaciones:

• Producto principal - se exporta con el stock agregado (si la gestión de stock está a nivel de producto)
• Variaciones - cada variación se exporta como una fila independiente con sus propios datos de stock

El nombre de la variación incluye los atributos entre paréntesis, por ejemplo Polo shirt (Red, XL).

Cuando la gestión de stock está configurada a nivel de variación, el producto principal muestra el stock combinado de todas las variaciones.

Modo de vista previa

Haz clic en Vista previa en lugar de Exportar para mostrar los datos en una tabla HTML directamente en el panel de administración. La vista previa te permite:

• Comprobar los datos antes de exportar
• Verificar que los filtros son correctos
• Revisar rápidamente los niveles de stock sin descargar un archivo

La tabla de vista previa se puede ordenar por cada columna (haz clic en el encabezado). Las filas con stock cero se resaltan en rojo. Las filas con stock bajo (por debajo del umbral) se resaltan en amarillo.

Formato del archivo CSV

El archivo CSV está optimizado para abrirse en Microsoft Excel con la configuración regional polaca:

• BOM (Byte Order Mark) - el archivo comienza con el marcador BOM de UTF-8 (\xEF\xBB\xBF), de modo que Excel reconoce correctamente la codificación
• Separador: punto y coma (;) - Excel con la configuración regional polaca reconoce el punto y coma como separador de columnas de forma predeterminada
• Codificación: UTF-8
• Calificador de texto: comillas dobles (")
• Finales de línea: \r\n (Windows)

Gracias al BOM y al punto y coma, el archivo CSV se puede abrir en Excel con un doble clic - sin necesidad de importar con una configuración de codificación.

Exportación

Tras configurar los filtros y los campos, haz clic en Exportar a CSV. El navegador descargará el archivo con el nombre stock-export-YYYY-MM-DD.csv.

WP-CLI

Exporta los niveles de stock desde la línea de comandos:

wp polski export stock --threshold="<=5" --output=/tmp/low-stock.csv

Parámetros:

• --threshold - filtro de umbral (por ejemplo <=5, >=100, =0)
• --fields - lista de campos (separados por comas)
• --include-variations - incluir variaciones (por defecto yes)
• --output - ruta del archivo de salida

Hooks

// Añadir un campo personalizado a la exportación
add_filter('polski/stock_export/fields', function (array $fields): array {
    $fields['warehouse_location'] = [
        'label'    => 'Warehouse location',
        'callback' => function (\WC_Product $product): string {
            return $product->get_meta('_warehouse_location');
        },
    ];
    return $fields;
});

// Modificar la consulta de productos
add_filter('polski/stock_export/query_args', function (array $args): array {
    $args['category'] = ['electronics'];
    return $args;
});

// Cambiar el separador del CSV
add_filter('polski/stock_export/csv_separator', function (): string {
    return ','; // coma en lugar de punto y coma
});

Resolución de problemas

Excel muestra los caracteres polacos como texto ilegible - asegúrate de que la exportación genere un archivo con BOM (activado de forma predeterminada). En versiones antiguas de Excel (anteriores a 2016), utiliza la función de importación de datos con la codificación configurada manualmente en UTF-8.

Las variaciones no aparecen en la exportación - comprueba que las variaciones tengan el estado “Publicado”. Las variaciones en borrador se omiten.

El filtro de umbral no funciona - el filtro solo funciona en productos con la gestión de stock activada (manage_stock = yes). Los productos sin gestión de stock tienen stock_quantity = null.

La vista previa se carga demasiado lento - con más de 5.000 productos, la vista previa puede ser lenta. Utiliza el filtro de umbral para limitar el número de resultados, o exporta directamente a CSV.

Notificación de problemas: github.com/wppoland/polski/issues

Esta página tiene únicamente fines informativos y no constituye asesoramiento legal. Polski for WooCommerce es software de código abierto (GPLv2) proporcionado sin garantía.