Order export

El módulo de exportación de pedidos permite generar archivos CSV con datos de pedidos de WooCommerce. Admite más de 30 campos configurables, filtros de rango de fechas y filtros de estado de pedido. La configuración de la selección de campos se guarda en las opciones de WordPress.

Activar el módulo

Ve a Polski > Módulos y activa Order export (ID del módulo: order_export).

Panel de exportación

El panel de exportación está disponible en WooCommerce > Exportación de pedidos (admin.php?page=polski-order-export).

Filtros

Rango de fechas

Selecciona el período del que quieres exportar los pedidos:

Fecha desde - inicio del rango (campo selector de fecha)
Fecha hasta - fin del rango (campo selector de fecha)
Rangos predefinidos: Hoy, Últimos 7 días, Últimos 30 días, Mes actual, Mes anterior, Año actual

Las fechas se refieren a la fecha de creación del pedido (date_created).

Estado del pedido

Selecciona los estados de pedido que quieres exportar (selección múltiple):

Pendiente de pago (pending)
En proceso (processing)
En espera (on-hold)
Completado (completed)
Cancelado (cancelled)
Reembolsado (refunded)
Fallido (failed)

De forma predeterminada están seleccionados En proceso y Completado.

Selección de campos

Selecciona los campos que se incluirán en el archivo CSV. La configuración de campos se guarda en las opciones de WordPress y se recuerda entre exportaciones.

Campos del pedido

Campo	Columna CSV	Descripción
ID del pedido	`order_id`	Número de pedido
Fecha del pedido	`order_date`	Fecha y hora de creación
Estado	`order_status`	Estado del pedido
Moneda	`currency`	Código de moneda (p. ej. PLN)
Método de pago	`payment_method`	Nombre del método de pago
Título del método de pago	`payment_method_title`	Nombre de pago mostrado
Total del pedido	`order_total`	Importe total
Subtotal de productos	`order_subtotal`	Importe de productos (sin envío)
Importe de impuestos	`order_tax`	Importe total de impuestos
Coste de envío	`shipping_total`	Coste de envío
Método de envío	`shipping_method`	Nombre del método de envío
Descuento	`discount_total`	Importe total del descuento
Código de cupón	`coupon_codes`	Códigos de cupón utilizados
Nota del cliente	`customer_note`	Notas del cliente en el pedido
IP del cliente	`customer_ip`	Dirección IP del cliente

Campos de dirección - facturación

Campo	Columna CSV
Nombre (facturación)	`billing_first_name`
Apellidos (facturación)	`billing_last_name`
Empresa	`billing_company`
NIP	`billing_nip`
Línea de dirección 1	`billing_address_1`
Línea de dirección 2	`billing_address_2`
Ciudad	`billing_city`
Código postal	`billing_postcode`
Provincia	`billing_state`
País	`billing_country`
Correo electrónico	`billing_email`
Teléfono	`billing_phone`

Campos de dirección - envío

Campo	Columna CSV
Nombre (envío)	`shipping_first_name`
Apellidos (envío)	`shipping_last_name`
Empresa (envío)	`shipping_company`
Línea de dirección 1	`shipping_address_1`
Línea de dirección 2	`shipping_address_2`
Ciudad	`shipping_city`
Código postal	`shipping_postcode`
Provincia	`shipping_state`
País	`shipping_country`

Campos de producto

Campo	Columna CSV	Descripción
Nombre del producto	`product_name`	Nombre del producto en el pedido
SKU	`product_sku`	Código SKU del producto
Cantidad	`product_qty`	Cantidad pedida
Precio unitario	`product_price`	Precio por unidad
Total de la línea	`line_total`	Importe total de la línea

Cuando un pedido contiene varios productos, cada producto se exporta como una fila separada con los datos del pedido repetidos.

Formato del archivo CSV

Codificación: UTF-8 con BOM (para la correcta visualización de los caracteres polacos en Excel)
Separador: punto y coma (;) - el estándar para el Excel polaco
Calificador de texto: comilla doble (")
Fin de línea: \r\n (Windows)

Exportación

Después de configurar los filtros y los campos, haz clic en Exportar a CSV. El navegador descargará el archivo.

Para conjuntos de datos grandes (más de 10.000 pedidos), la exportación se ejecuta en segundo plano con una barra de progreso. Una vez finalizada, el archivo está disponible para su descarga durante 24 horas.

WP-CLI

Exporta pedidos desde la línea de comandos:

wp polski export orders --date-from=2025-01-01 --date-to=2025-12-31 --status=completed --output=/tmp/orders.csv

Parámetros:

--date-from - fecha de inicio (YYYY-MM-DD)
--date-to - fecha de fin (YYYY-MM-DD)
--status - estado del pedido (separados por comas)
--fields - lista de campos (separados por comas)
--output - ruta del archivo de salida

Hooks

// Añadir un campo personalizado a la exportación
add_filter('polski/order_export/fields', function (array $fields): array {
    $fields['custom_field'] = [
        'label'    => 'Campo personalizado',
        'callback' => function (\WC_Order $order): string {
            return $order->get_meta('_custom_field');
        },
    ];
    return $fields;
});

// Modificar la consulta de pedidos
add_filter('polski/order_export/query_args', function (array $args): array {
    $args['meta_key']   = '_billing_nip';
    $args['meta_compare'] = 'EXISTS';
    return $args;
});

Resolución de problemas

Los caracteres polacos se muestran incorrectamente en Excel - asegúrate de que la opción BOM esté activada (lo está de forma predeterminada). En versiones antiguas de Excel, utiliza la importación de datos con el ajuste de codificación UTF-8.

La exportación tarda demasiado - con un número muy elevado de pedidos, utiliza WP-CLI en lugar de la interfaz web. Considera reducir el rango de fechas.

Falta el campo NIP en la exportación - el campo billing_nip solo está disponible cuando el módulo NIP en la caja está activo.

Informar de problemas: github.com/wppoland/polski/issues

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