Editar un pedido PrestaShop con DataFirefly Order Editor

Presentación

DataFirefly Order Editor añade un editor en la página de cada pedido del back-office, justo debajo del bloque Productos. Permite editar un pedido validado como un carrito: añadir o quitar productos, cambiar una combinación, corregir una cantidad o un precio, cambiar la dirección o el transportista, quitar o añadir un descuento. Cada cambio se recalcula con el motor del carrito de PrestaShop, y la factura se anula con una factura rectificativa y se vuelve a emitir, o se actualiza, según su elección.

El módulo funciona en PrestaShop 8.0 a 9.x. Está traducido al español, inglés, francés, alemán, italiano, neerlandés, polaco y portugués.

Instalación

1. En Módulos > Gestor de módulos, haga clic en Subir un módulo y suelte el archivo dforderedit-1.0.0.zip.
2. Al instalarse, el módulo concede sus permisos a los perfiles que ya pueden modificar pedidos (por ejemplo SuperAdmin, Comercial, Logístico).
3. Abra un pedido: el bloque Editor de pedidos aparece bajo el bloque Productos.

Configuración

La página de configuración del módulo ofrece cinco ajustes:

• Estados de pedido editables: el editor solo se ofrece para los pedidos en estos estados. Cancelado, Reembolsado y Error de pago están excluidos por defecto.
• Tratamiento de la factura por defecto: factura rectificativa y nueva factura (recomendado), o actualización de la factura existente con el mismo número. Se puede cambiar en cada modificación.
• Reponer en stock las cantidades retiradas por defecto.
• Avisar al cliente por correo electrónico por defecto.
• Añadir una nota privada al pedido tras cada modificación.

Editar un pedido

Abrir el editor

En la página del pedido, haga clic en Modificar este pedido. Mientras no confirme nada, el pedido no se toca: el botón Restablecer anula todos los cambios en curso y el navegador le avisa si sale de la página con cambios sin aplicar.

Productos

• Añadir un producto: escriba un nombre, una referencia, un EAN o un ID en la búsqueda (varias palabras, en cualquier orden). Las flechas y la tecla Intro permiten elegir con el teclado. Para un producto con combinaciones, elija la combinación en la lista que aparece.
• Cambiar la combinación: la lista indica el stock de cada combinación. El precio de la nueva combinación se rellena automáticamente y sigue siendo editable.
• Corregir la cantidad o el precio: el precio pagado por el cliente se conserva por defecto. El enlace Aplicar el precio de catálogo toma el precio actual para ese cliente (grupo, precios específicos, descuentos por cantidad).
• Introducción sin o con IVA: el botón sobre la tabla elige el modo. Por defecto sigue 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: el icono de papelera tacha la línea, el icono de flecha la restaura.

Direcciones

Elija otra dirección del cliente en la lista o haga clic en Editar los campos de esta dirección para corregir una calle o un código postal. Una dirección editada 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.

Descuentos

Desmarque un descuento para quitarlo del pedido. La búsqueda añade una regla de carrito existente por nombre o código. El enlace Añadir un descuento libre crea un descuento en importe con IVA o en porcentaje con la etiqueta que elija, sin pasar por el catálogo de reglas de carrito. Este descuento se guarda como una regla de carrito desactivada, reservada al cliente y ya consumida: no puede reutilizarse en el carrito.

Envío

La lista de transportistas solo ofrece los que pueden entregar el carrito editado en la dirección elegida, con su precio y plazo. 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 cambia de transportista.
• Fijar unos gastos de envío (con IVA).

Opciones

• Estado del pedido tras la modificación: el estado cambia mediante el historial nativo de PrestaShop, con sus correos habituales.
• Reponer en stock las cantidades retiradas.
• Enviar al cliente el resumen del pedido modificado, en su idioma.
• Factura: rectificativa y nueva factura, o actualización de la factura existente.
• Nota interna, guardada en el historial de modificaciones.

Nuevos totales y confirmación

Unos instantes después de cada cambio, la barra fija en la parte inferior de la pantalla muestra el total con IVA antes y después, la diferencia, y lo que el cliente aún debe o el importe cobrado de más que hay que devolverle. El enlace Detalles abre la comparación línea por línea (cantidades, precios, tipos impositivos), los descuentos, las direcciones y todos los totales. Las alertas aparecen encima: stock insuficiente, regla de carrito cuyo mínimo ya no se alcanza, transportista que ya no entrega.

Haga clic en Aplicar los cambios: la confirmación enumera las líneas afectadas, los descuentos, el cambio de transportista, los documentos que se crearán y el nuevo estado. Haga clic en Confirmar y aplicar y la página se recarga con el pedido actualizado.

Factura y factura rectificativa

Modo rectificativa y nueva factura (por defecto)

1. El PDF de la factura se archiva tal como estaba, antes de cualquier escritura.
2. Una factura rectificativa anula la factura por su importe total. Su PDF también se archiva.
3. Se emite una nueva factura con el número siguiente. Las líneas, los descuentos, el transportista y los pagos se vinculan a ella.

El enlace de descarga de la factura anulada, en el back-office y en la cuenta del cliente, siempre devuelve su PDF original. La factura anulada ya no se ofrece en el formulario para añadir un pago.

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 igualmente. Un pedido con varias facturas siempre pasa por el modo rectificativa y nueva factura.

Pagos y reembolsos

El pago ya recibido permanece en el pedido. Cuando el nuevo total es mayor, PrestaShop muestra el importe pendiente como en cualquier pago parcial. Cuando es menor, el importe cobrado de más se muestra en el editor y la devolución se hace con su proveedor de pago.

Cuando un pedido pasa después a un estado pagado, PrestaShop añade normalmente un pago por cada factura no saldada. El módulo impide ese pago ficticio en las facturas anuladas por una rectificativa.

Stock

El stock se ajusta por diferencia. Una cantidad que pasa de 2 a 3 consume una unidad, una línea quitada devuelve su cantidad al stock si la opción está marcada, una combinación cambiada devuelve la antigua y consume la nueva. Las cantidades reservadas se recalculan al final.

Líneas bloqueadas

• Línea reembolsada o devuelta: no se puede modificar ni quitar, para no falsear las rectificativas existentes. Las demás líneas del pedido siguen siendo editables.
• Línea personalizada (texto, archivo enviado por el cliente): puede quitarse pero no modificarse. El texto de la personalización se muestra bajo la línea y los archivos del cliente nunca se tocan.
• Producto eliminado del catálogo: la línea solo puede quitarse.

Historial y trazabilidad

El historial, bajo el editor, enumera cada modificación: fecha, empleado, líneas, descuentos, direcciones, transportista y estado modificados, total antes y después, nota interna y enlaces a los PDF archivados. Una nota privada resume también la modificación en los mensajes del pedido.

Al desinstalar, el historial y los PDF archivados se conservan para que las facturas anuladas sigan identificadas si el módulo se vuelve a instalar.

Para desarrolladores

• actionOrderEdited: hook nativo de PrestaShop, llamado con order tras cada modificación.
• actionDfOrderEditAfter: llamado con order, id_dforderedit_log, changes (líneas, descuentos, direcciones, transportista, totales) e id_order_slips.

El recálculo usa 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 se anula.

Solución de problemas

El editor no aparece en el pedido

Compruebe que el estado del pedido está entre los estados editables de la configuración, y que el perfil del empleado puede modificar pedidos y ver el módulo.

El transportista no puede entregar el nuevo carrito

El peso, el importe o la zona quedan fuera de los tramos del transportista. Elija otro transportista de la lista o fije los gastos de envío a mano.

No se pudo fijar exactamente el precio de una línea

Una regla del catálogo (una reducción de grupo, por ejemplo) se aplica sobre el precio introducido. Compruebe el precio en los detalles antes de confirmar.

Pedido procedente de un carrito multitransportista

Cuando un carrito se dividió en varios pedidos, las reglas de carrito se recalculan solo en el pedido editado. Un aviso lo recuerda en la vista previa.