Exportación CSV para pedidos¶

Este plugin permite la exportación flexible de pedidos de Shopware 6 como archivo CSV – completamente o filtrado por período, estado, método de pago y más. Con perfiles individuales, puede definir campos libremente y adaptar las exportaciones a sus requisitos específicos.

❓ Preguntas frecuentes¶

🔧 Instalación¶

• Requisitos previos (Plugin CNK Foundation)
• Instalación a través de la tienda o ZIP
• Activación & Visibilidad en el Backend

🕒 Envío automático (Programación)¶

La exportación basada en tiempo (Automatización) se ejecuta a través del Worker en segundo plano de Shopware – exactamente como todas las otras tareas programadas en Shopware. En una tienda correctamente operada, la exportación se ejecuta por lo tanto completamente automáticamente, sin intervención manual.

*/5 * * * * /usr/bin/php /ruta/a/tienda/bin/console scheduled-task:run-single cnk_order_csv_export.task

🧩 Gestionar perfiles¶

Los perfiles de exportación definen qué datos están en el archivo CSV y en qué orden aparecen. Los perfiles se encuentran en el área de administración de Shopware en Pedidos > Exportación CSV > Perfiles.

Dentro de un perfil, puede determinar precisamente qué campos deben incluirse en el archivo CSV exportado. A través del botón « Agregar campo », puede seleccionar y organizar individualmente campos de pedido, cliente, producto y dirección. El orden de los campos en el perfil corresponde al orden de las columnas en el archivo CSV.

🗂️ Formatos de exportación & Plantillas ERP¶

Además del formato estándar CSV, también puede exportar sus perfiles de exportación como Excel (XLSX), JSON o XML.

El formato de exportación se establece por perfil en la pestaña Configuración a través del campo « Formato de archivo » y se aplica del lado del servidor a todas las rutas de exportación (manual, exportación rápida, programación, Flow Builder y CLI). Si la compra en la aplicación no está activa, la exportación vuelve automáticamente a CSV.

Activar un formato Pro¶

1. Abra un perfil en Pedidos > Exportación CSV > Perfiles y vaya a la pestaña Configuración.
2. Seleccione un formato Pro (XLSX, JSON o XML) en Formato de archivo. Si la compra aún no está activa, aparece un mensaje con el botón « Activar ».
3. Después de la compra, el formato está inmediatamente disponible y se aplica al guardar.

Aplicar plantillas ERP¶

Las plantillas ERP precargan con un clic la selección de campos apropiada así como la configuración de separador, número, fecha y codificación para el sistema de destino:

Para aplicar una plantilla:

1. Asegúrese de que la compra en la aplicación « Formatos Pro & Plantillas ERP » está activa.
2. Seleccione el sistema deseado en Plantilla ERP en el perfil y haga clic en « Aplicar plantilla ».
3. La selección de campos y la configuración de formato se aplican. El Formato de archivo elegido se conserva – por ejemplo, puede exportar una selección de campos DATEV también como XLSX.

💡 La aplicación de una plantilla sobrescribe la selección de campos actual del perfil. Adapte los campos después si es necesario y guarde el perfil.

🔄 Exportación incremental / Delta¶

Con la exportación delta, en cada ejecución solo se exportan los pedidos que se han creado o modificado desde la última exportación exitosa. Esto mantiene un sistema de gestión de almacenes o contabilidad sincronizado sin duplicados y – especialmente para grandes cantidades de pedidos – ahorra tiempo y volumen de datos.

• Activable por perfil a través del interruptor « Exportación Delta/Incremental » en la pestaña Configuración.
• Considera los pedidos sobre la base de la fecha de creación o modificación (createdAt/updatedAt), de modo que incluso los pedidos modificados posteriormente se reexportan.
• El Delta-Stand (Wasserzeichen) solo se actualiza después de una exportación exitosa – si una ejecución falla, no se pierden pedidos.
• Funciona a través de todas las rutas de exportación: Programación, Flow Builder y CLI (Perfil Config).

Configurar exportación Delta¶

1. Abra un perfil y vaya a la pestaña Configuración.
2. Active el interruptor « Exportación Delta/Incremental ». Si la compra aún no está activa, aparece un mensaje con el botón « Activar ».
3. Guarde el perfil. A partir de la siguiente ejecución, solo se exportarán los pedidos nuevos o modificados.

Restablecer Delta-Stand¶

Si desea reexportar todos los pedidos (por ejemplo, para una sincronización inicial completa), restablezca el Wasserzeichen:

1. Abra el perfil en la pestaña Configuración.
2. Haga clic en « Restablecer » en el mensaje Delta y guarde el perfil.
3. La siguiente ejecución reexporta todos los pedidos coincidentes y luego establece un nuevo Wasserzeichen.

💡 La exportación Delta utiliza la hora de inicio de la exportación como Wasserzeichen. De esta manera, en el peor de los casos, se exportan algunos pedidos dos veces en lugar de omitirse – ideal para importaciones idempotentes (Upserts) en la gestión de almacenes.

Variables¶

💡 Los nombres de campo deben aceptarse exactamente como se especifica en la columna izquierda.

La siguiente descripción general muestra todas las variables disponibles que se pueden usar en un perfil de exportación. Estos determinan qué datos aparecen en el archivo CSV – por ejemplo, datos generales de pedidos, información del cliente, campos de dirección o detalles del producto. Los nombres de campo en la columna izquierda se configuran en el perfil, la columna derecha describe el contenido.

🧾 Datos generales de pedidos¶

📦 Líneas de pedido¶

👤 Datos del cliente¶

🚚 Dirección de envío¶

🧾 Dirección de facturación¶

🛒 Datos del producto¶

🧬 Detalles de posición (Carga útil)¶

Datos de instantánea almacenados en el momento de la compra en la línea de pedido.

📄 Documentos¶

Campos de documentos generados (Factura, Albarán y – si el plugin Pickware está instalado – Lista de surtido Pickware / Recibo PdV). Los valores solo se rellenan una vez que el documento respectivo se haya creado para el pedido.

Factura¶

Albarán¶

Lista de surtido Pickware ERP¶

Recibo Pickware PdV¶

⚡ Exportación rápida a través de la descripción general de pedidos¶

• Exportación directa de pedidos seleccionados
• Exportación directa de pedidos filtrados

• Selección de un perfil en la lista desplegable

🔁 Trabajos (Automatización)¶

• Explicación: Scheduled Task / Cronjob
• Opciones configurables:
  • Intervalo de tiempo o días de la semana fijos + hora
  • Destino FTP / Correo electrónico
  • Selección de perfil (incluido formato, plantilla ERP y exportación delta del perfil elegido)

📊 Actividad & Registro¶

• Historial de exportación & Estado (Éxito/Error)
• Archivo CSV-Log: Destinatario, Ruta FTP, Marca de tiempo

• Los registros se encuentran en Pedidos > Exportación CSV > Actividad

• El resultado se ve así

🖥️ Exportación por línea de comandos (CLI)¶

Exportación rápida de actividades en curso¶

La exportación de grandes cantidades de datos – incluso más de 10.000 pedidos – es posible. Una barra de progreso integrada muestra el progreso de la exportación.

Para no esperar la cola, puede desencadenar la exportación manualmente – por ejemplo, para descargar CSV inmediatamente después de crear una exportación:

#[AsCommand(
    name: 'cnk:csv-order-log:consume',
    description: 'Export all the activities in progress',
)]

La exportación puede iniciarse entonces directamente a través de la consola:

bin/console cnk:csv-order-log:consume

Este comando inicia todas las exportaciones en curso directamente a través de la consola.

Exportar con perfil Shopware¶

bin/console cnk:csv-orders:export --fromDate 2023-05-15 --toDate 2025-02-01 --exportType sw_profile --mode order --profileName "Default orders" --limit 500

Exportar con perfil personalizado¶

bin/console cnk:csv-orders:export --fromDate 2023-05-15 --toDate 2025-02-01 --exportType config --mode line_items --profileName "WAWI" --limit 500

• fromDate: Pedidos de, formato Y-m-d
• toDate: Pedidos hasta, formato Y-m-d
• exportType: Opción entre sw_profile y config
• mode: Opción entre order y line_items
• profileName: Perfil estándar o perfil creado por el usuario
• limit: Límite de pedidos a exportar (Valor estándar: 100)

📬 Support¶

Para preguntas, sugerencias de mejora o personalizaciones, contáctenos por correo electrónico en support@cnk-plugins.de.