Editar un pedido PrestaShop con DataFirefly Order Editor
Instalar el módulo, elegir los ajustes y modificar un pedido validado en el editor a pantalla completa: productos, cliente, direcciones, descuentos, envío, factura rectificativa y nueva factura, historial y reversión.
Presentación
DataFirefly Order Editor permite modificar un pedido validado como si fuera un carrito: añadir o quitar productos, cambiar una combinación, corregir una cantidad o un precio, cambiar la dirección, el transportista o incluso el cliente, quitar o añadir un descuento. La modificación se hace en un espacio a pantalla completa, con un resumen antes / después a la derecha que se actualiza mientras trabajas. No se guarda nada antes de tu confirmación.
Cada modificación la recalcula el motor de carrito de PrestaShop. La factura ya emitida se anula con una factura rectificativa y se sustituye por una nueva factura, o se actualiza si lo prefieres, y cada modificación queda registrada en un historial con comparación y posibilidad de revertirla.
El módulo funciona en PrestaShop 8.0 a 9.x con PHP 7.4 a 8.5. Está traducido al español, francés, inglés, alemán, italiano, neerlandés, polaco y portugués.

Instalación
- En Módulos > Gestor de módulos, haz clic en Subir un módulo y suelta el archivo
dforderedit-2.0.0.zip. - Al instalarse, el módulo concede sus permisos a los perfiles que ya pueden modificar pedidos (por ejemplo SuperAdmin, Comercial, Logística).
- Abre un pedido en Pedidos > Pedidos: el bloque Editor de pedidos aparece bajo la lista de productos, con el botón Modificar este pedido y el historial de modificaciones.
Un perfil que puede ver los pedidos pero no modificarlos ve el bloque en solo lectura: el historial y los PDF archivados, sin el botón de modificación. Para abrir el editor a un nuevo perfil, dale el permiso de modificación sobre los pedidos y marca los permisos del módulo en Parámetros avanzados > Equipo > Permisos.

Ajustes
La página del módulo tiene tres pestañas: Panel, Registro de modificaciones y Ajustes. Los ajustes se agrupan en tres bloques.
¿Cuándo se puede modificar un pedido?
- Estados de pedido en los que se permite la modificación: los estados Cancelado, Reembolsado y Error en el pago están excluidos por defecto.
- Ventana de modificación: número de días tras la fecha del pedido durante los que se puede modificar. 0 = sin límite.
Facturas y stock
- Tratamiento de la factura por defecto: factura rectificativa y nueva factura (recomendado cuando la factura ya se ha enviado), o actualización de la factura existente con el mismo número. Esta elección se puede cambiar en cada modificación.
- Reponer en stock las cantidades retiradas por defecto.
Equipo y trazabilidad
- Avisar al cliente por correo electrónico por defecto.
- Añadir una nota privada al pedido tras cada modificación.
- Exigir una nota interna que explique cada modificación.
- Permitir asignar el pedido a otro cliente.

Modificar un pedido
Abrir el editor
En la página del pedido, haz clic en Modificar este pedido. El editor se abre a pantalla completa. A la izquierda, las secciones Productos, Cliente y direcciones, Descuentos, Envío y Factura, stock y notificación. A la derecha, el resumen: número de cambios pendientes, nuevos totales, impuestos, pagos y alertas. La tecla Esc o el botón Cerrar salen del editor; si quedan cambios sin aplicar, se te pide confirmación.
Productos
- Añadir un producto: escribe un nombre, una referencia, un EAN o un ID en la búsqueda. Las flechas y la tecla Intro permiten elegir con el teclado. Se muestran el stock y el precio de catálogo del cliente. Para un producto con combinaciones, elige la combinación.
- Cambiar la combinación: la lista indica el stock de cada combinación, y la combinación anterior se recuerda bajo la línea.
- Corregir la cantidad o el precio: botones − / + para la cantidad. El precio pagado por el cliente se conserva y se recuerda bajo el precio; el enlace Aplicar el precio de catálogo toma el precio actual para este cliente (grupo, precios específicos, descuentos por cantidad).
- Introducción de precios sin IVA o con IVA: el selector encima de la tabla sigue por defecto la visualización de precios del grupo del cliente. Un precio introducido con IVA se convierte a sin IVA, que sigue siendo la referencia del pedido.
- Quitar una línea: la línea se tacha y puede restablecerse hasta la confirmación.
Cada línea lleva una etiqueta: Modificado, Añadido, Combinación cambiada o Quitado. Una línea regalada por una regla de carrito se señala con la etiqueta Regalo de la regla de carrito.

Cliente y direcciones
Elige otra dirección del cliente en la lista, o haz clic en Editar los campos de esta dirección para corregir una calle o un código postal. Una dirección modificada se guarda como nueva dirección vinculada solo a este pedido: los pedidos anteriores y la libreta de direcciones del cliente no cambian. Si cambia el país, se recalcula el IVA de los productos y del envío.
Si el ajuste está activado, Asignar a otro cliente permite buscar un cliente por nombre, correo electrónico o ID y elegir sus direcciones de entrega y facturación. Se emite una nueva factura a su nombre. El cambio de cliente se rechaza si el pedido ya tiene facturas rectificativas de reembolso.

Descuentos y envío
Desmarca un descuento para quitarlo del pedido. La búsqueda añade una regla de carrito existente por nombre o por código. Añadir un descuento libre crea un descuento en importe con IVA o en porcentaje, con la etiqueta que elijas. Se guarda como una regla de carrito desactivada, reservada al cliente y ya utilizada: no puede reutilizarse.
Los transportistas se presentan en tarjetas, con su precio y su plazo para el carrito modificado; los que no pueden entregar este carrito se señalan. Hay tres modos para los gastos de envío:
- Mantener los gastos de envío del pedido: se conserva el importe sin IVA, el impuesto sigue a la dirección si cambia de país.
- Recalcular con el transportista elegido: obligatorio cuando cambias de transportista.
- Fijar unos gastos de envío (con IVA).

Factura, stock y notificación
- Factura: anular con una factura rectificativa y emitir una nueva factura, o actualizar la factura existente (mismo número).
- Reponer en stock las cantidades retiradas.
- Enviar al cliente el resumen del pedido modificado, en su idioma.
- Estado del pedido tras la modificación: el estado cambia mediante el historial nativo de PrestaShop, con sus correos habituales.
- Nota interna, guardada en el historial de modificaciones (obligatoria si el ajuste lo exige).
Resumen y confirmación
Un instante después de cada cambio, el resumen muestra el total con IVA antes y después con la diferencia, el detalle de productos, descuentos, envío e impuestos, y el saldo de pago: Pendiente de pago por el cliente, Exceso cobrado a reembolsar al cliente o pagos que cubren exactamente el nuevo total. Las alertas se agrupan en Comprobar antes de aplicar: stock insuficiente, factura ya emitida, pedido ya enviado, producto de regalo, regla de carrito cuyo mínimo ya no se alcanza, transportista que ya no entrega.
Haz clic en Revisar y aplicar (o Ctrl + Intro): la confirmación enumera todo lo que se guardará, los documentos que se crearán y el nuevo estado. Haz clic en Confirmar y aplicar y la página se recarga con el pedido actualizado.

Factura y factura rectificativa
Modo factura rectificativa y nueva factura (por defecto)
- El PDF de la factura se archiva tal como estaba, antes de cualquier escritura.
- Una factura rectificativa anula la factura por su importe total. Su PDF también se archiva.
- Se emite una nueva factura con el número siguiente. Las líneas, los descuentos, el transportista y los pagos quedan vinculados a ella.
La factura anulada se descarga siempre con su PDF original, en el back office y en la cuenta del cliente, y lleva una mención de anulación. También sale tal como se emitió en la exportación masiva de Pedidos > Facturas (por fecha o por estado), y nunca recibe un pago ficticio cuando el pedido pasa después a un estado pagado.
Si el pedido tiene varias facturas, todas se anulan con facturas rectificativas y se sustituyen por una sola factura nueva.
Modo actualización
Los importes de la factura existente se actualizan y conserva su número, como hace PrestaShop de forma nativa. El PDF anterior a la modificación se archiva de todos modos.
Si todavía no se ha emitido ninguna factura, no hay nada que regenerar: solo se actualiza el pedido.
Pagos y reembolsos
El pago ya recibido permanece en el pedido y se vincula a la nueva factura. Tras la modificación, un aviso indica el importe pendiente de pago o pagado de más, con los botones Registrar un pago y Reembolso parcial que abren las herramientas nativas de PrestaShop. El módulo nunca cobra ni reembolsa dinero por sí mismo: el reembolso se hace con tu proveedor de pago.
Stock
El stock se ajusta por diferencia, con los movimientos de stock nativos. Una cantidad que pasa de 2 a 3 consume una unidad, una línea quitada vuelve al stock si la opción está marcada, una combinación cambiada devuelve la antigua y consume la nueva. Si el pedido ya se ha enviado, una alerta te pide comprobar que la mercancía ha vuelto realmente.
Líneas bloqueadas
- Línea reembolsada o devuelta: no se puede modificar ni quitar, para no falsear las facturas rectificativas existentes.
- Línea personalizada (texto, archivo enviado por el cliente): solo se puede quitar. Los archivos del cliente nunca se tocan.
- Producto eliminado del catálogo: la línea solo se puede quitar.
Correo al cliente
Si marcas la notificación, el cliente recibe un correo en su idioma con la lista de cambios, el nuevo contenido del pedido y el importe pendiente de pago o a reembolsar. El correo genérico «pedido modificado» de PrestaShop no se envía además. Sin notificación, el cliente no recibe nada.

Historial y reversión
El historial, en el bloque del pedido, presenta cada modificación en una línea de tiempo: fecha, empleado, total antes y después, tipo de documento, nota interna. Ver detalles abre la comparación línea por línea (cantidades, precios, combinaciones), los descuentos, las direcciones, el transportista y los enlaces a los PDF archivados: factura anulada (PDF original), factura antes de la modificación y factura rectificativa de anulación.

La última modificación de un pedido puede revertirse con Revertir esta modificación, siempre que el pedido no haya cambiado desde entonces. Los cambios inversos se cargan en el editor: compruebas la vista previa y aplicas como una modificación normal, con sus documentos. La reversión también queda registrada.

Si dos empleados trabajan en el mismo pedido, el segundo queda bloqueado: cuando el pedido ha cambiado desde que se abrió el editor (otra modificación, un pago, un reembolso), la vista previa y la aplicación se rechazan con un botón Recargar.
Al desinstalar, el historial y los PDF archivados se conservan para que las facturas anuladas sigan identificadas si se reinstala el módulo.
Panel y registro
El Panel resume los últimos 30 días: modificaciones, pedidos modificados, variación neta de los totales (convertida a la moneda por defecto), facturas rectificativas y nuevas facturas emitidas, modificaciones revertidas, últimas modificaciones y modificaciones por empleado.

El Registro de modificaciones enumera todas las modificaciones de la tienda con pedido, cliente, empleado, fecha, totales antes / después, diferencia, tipo de factura y nota. Se filtra por ID o referencia de pedido, por empleado y por periodo, y se exporta a CSV.

Actualización desde la versión 1.0.0
Sube dforderedit-2.0.0.zip sobre la versión anterior desde el gestor de módulos. La actualización añade sus columnas y sus nuevos ajustes sin tocar el historial ni los PDF archivados. Las facturas anuladas con la 1.0.0 conservan su PDF original en el historial; las modificaciones hechas con la 1.0.0 no pueden revertirse automáticamente.
Para desarrolladores
actionOrderEdited: hook nativo de PrestaShop, llamado conordertras cada modificación (el módulo ps_emailalerts no se llama, para evitar el correo genérico al cliente).actionDfOrderEditAfter: llamado conorder,id_dforderedit_log,changes(líneas, descuentos, direcciones, transportista, totales) eid_order_slips.
El recálculo pasa por un carrito temporal que nunca se vincula a un pedido y se elimina al final. La vista previa se calcula en una transacción que siempre se anula. El desglose del IVA de las líneas se recalcula con el método nativo de PrestaShop.
Solución de problemas
El botón Modificar este pedido no aparece
El bloque indica el motivo: estado del pedido fuera de los estados modificables, pedido más antiguo que la ventana de modificación, cliente eliminado o perfil en solo lectura. Ajusta los ajustes del módulo o los permisos del perfil.
«Este pedido se ha modificado desde que se abrió el editor»
Otro empleado, un pago o un reembolso ha cambiado el pedido. Haz clic en Recargar para partir de la última versión.
El transportista no puede entregar el nuevo carrito
El peso, el importe o la zona quedan fuera de los rangos del transportista. Elige otro transportista o fija los gastos de envío manualmente.
El precio de una línea no se ha podido fijar exactamente
Una regla del catálogo (un descuento de grupo, por ejemplo) se aplica sobre el precio introducido. Comprueba el precio en el resumen antes de confirmar.
Pedido procedente de un carrito multitransportista
Cuando un carrito se dividió en varios pedidos, las reglas de carrito se recalculan solo sobre el pedido modificado. Una alerta lo recuerda en el resumen.