Instalación, configuración y atributos del producto

Alcance del documento

Este documento describe la instalación del módulo Estimated Delivery Date, la configuración en el panel de administración de Magento 2 y la gestión de los atributos añadidos al producto. La descripción de los campos se basa en la implementación actual del módulo.

Instalación

El paquete está destinado a instalarse mediante Composer.

Ejemplo de instalación desde un repositorio VCS:

composer config repositories.kowal.estimated.delivery.date vcs https://github.com/kowalco/estimated-delivery-datecomposer require kowal/module-estimated-delivery-datebin/magento module:enable Kowal_EstimatedDeliveryDatebin/magento setup:upgradebin/magento cache:flush

Tras el despliegue en producción, debe ejecutarse el proceso estándar de compilación y despliegue de recursos estáticos conforme al proyecto Magento:

bin/magento setup:di:compilebin/magento setup:static-content:deploybin/magento cache:flush

Ubicación de la configuración

La configuración del módulo está disponible en el panel de administración:

Stores > Configuration > Sales > Estimated Delivery Date

Los ajustes están disponibles en los niveles default, website y store view, de acuerdo con el mecanismo de configuración de Magento.

General

Enabled

Activa o desactiva el módulo para el ámbito de configuración correspondiente. Cuando el campo está desactivado, los mensajes en el frontend no deberían mostrarse.

Valor predeterminado: Yes.

Calculation Timezone

Zona horaria utilizada para calcular las fechas y la hora de cut-off. Si el campo se deja vacío, el módulo utiliza la zona horaria de la tienda configurada en Magento.

Ejemplo de valor:

Europe/Warsaw

Uso: útil cuando la tienda opera en varios store view o cuando el almacén que gestiona los envíos trabaja en una zona horaria distinta de la configuración predeterminada de la tienda.

Fallback Message

Mensaje alternativo utilizado como texto de respaldo cuando la tienda quiere mostrar una información general en lugar de una fecha concreta.

Valor predeterminado:

Termin dostawy potwierdzimy po złożeniu zamówienia.

Date Format

Formato de fecha utilizado al renderizar los mensajes para el cliente. El campo utiliza el patrón ICU compatible con el formato de fechas de Magento.

Valor predeterminado:

EEEE, d MMMM

Ejemplo de resultado:

poniedziałek, 18 maja

Date Calculation

Processing Days Min

Número mínimo de días laborables necesarios para preparar el pedido antes del envío.

Valor predeterminado: 1.

Uso: determina la fecha de envío más temprana posible.

Processing Days Max

Número máximo de días laborables necesarios para preparar el pedido.

Valor predeterminado: 1.

Uso: permite crear un rango de fechas de envío cuando la preparación puede tardar más que el tiempo mínimo.

Transport Days Min

Número mínimo de días laborables de transporte desde el envío hasta la entrega.

Valor predeterminado: 1.

Uso: determina la fecha de entrega más temprana posible tras el envío.

Transport Days Max

Número máximo de días laborables de transporte.

Valor predeterminado: 2.

Uso: permite mostrar un rango de entrega, por ejemplo, cuando el transportista suele entregar en 1-2 días laborables.

Same-day Shipping Cut-off Time

Hora límite para el envío el mismo día. El valor debe introducirse en formato HH:MM.

Valor predeterminado:

14:00

Si la hora actual es posterior al cut-off, el módulo desplaza el inicio del cálculo al siguiente día laborable.

Non-working Weekdays

Lista de días de la semana considerados no laborables. Los valores deben indicarse como números ISO separados por comas:

• 1 - lunes,
• 2 - martes,
• 3 - miércoles,
• 4 - jueves,
• 5 - viernes,
• 6 - sábado,
• 7 - domingo.

Valor predeterminado:

6,7

Uso: de forma estándar, omite sábados y domingos al contar los días laborables.

Safety Buffer Days

Búfer de seguridad adicional añadido al tiempo de transporte.

Valor predeterminado: 0.

Uso: útil en periodos de aumento del número de pedidos, con funcionamiento inestable de los transportistas o con productos que requieren una promesa de entrega más prudente.

Display Settings

Show on Product Page

Activa la visualización de la fecha estimada en la ficha de producto.

Valor predeterminado: Yes.

Show in Cart

Activa la visualización de la fecha estimada en el carrito.

Valor predeterminado: Yes.

Show in Admin Order

Activa la sección Estimated Delivery Date en la vista del pedido del panel de administración.

Valor predeterminado: Yes.

Show Cut-off Widget on Product Page

Activa el widget de cuenta atrás hasta la hora de cut-off en la ficha de producto.

Valor predeterminado: Yes.

Show Cut-off Widget in Cart

Activa el widget cut-off en el carrito.

Valor predeterminado: No.

Cut-off Widget Mode

Define la forma de presentación del widget cut-off.

Valores disponibles:

• Inline - el widget se muestra en el lugar donde se inserta el bloque,
• Fixed - el widget queda fijado en la esquina de la pantalla seleccionada,
• Inline + Fixed - el widget funciona simultáneamente como elemento inline y fixed.

Valor predeterminado: Inline.

Fixed Widget Position

Define la posición del widget fixed.

Valores disponibles:

• Bottom Right - esquina inferior derecha,
• Bottom Left - esquina inferior izquierda,
• Top Right - esquina superior derecha,
• Top Left - esquina superior izquierda.

Valor predeterminado: Bottom Right.

Fixed Widget Devices

Define el tipo de dispositivos en los que debe ser visible el widget fixed.

Valores disponibles:

• Desktop,
• Mobile,
• Desktop + Mobile.

Valor predeterminado: Desktop + Mobile.

After Cut-off Behavior

Define el comportamiento del widget después de superar la hora de cut-off.

Valores disponibles:

• Hide Widget - el widget se ocultará,
• Show After Cut-off Message - el widget mostrará un mensaje después del cut-off.

Valor predeterminado: Show After Cut-off Message.

Customer Messages

Los mensajes admiten variables simples con el formato {{nazwa_zmiennej}}.

Variables disponibles para los mensajes de entrega:

• {{ship_date}},
• {{ship_date_from}},
• {{ship_date_to}},
• {{delivery_date}},
• {{delivery_date_from}},
• {{delivery_date_to}}.

Variables disponibles para los mensajes cut-off:

• {{cutoff_time}},
• {{cutoff_countdown}}.

Delivery Range Message

Plantilla de mensaje utilizada cuando el cálculo devuelve un rango de fechas de entrega.

Valor predeterminado:

Przewidywana dostawa: {{delivery_date_from}} - {{delivery_date_to}}

Single Delivery Date Message

Plantilla de mensaje utilizada cuando la fecha de entrega más temprana y la más tardía son iguales.

Valor predeterminado:

Przewidywana dostawa: {{delivery_date}}

Cut-off Countdown Message

Mensaje mostrado antes de superar la hora de cut-off.

Valor predeterminado:

Zamów w ciągu {{cutoff_countdown}}, a wyślemy jeszcze dzisiaj.

After Cut-off Message

Mensaje mostrado después de superar la hora de cut-off, si el campo After Cut-off Behavior está configurado para mostrar el mensaje.

Valor predeterminado:

Dzisiejsza wysyłka już zamknięta. Wyślemy w następny dzień roboczy.

Emails

Send Separate Email After Payment

Activa un correo electrónico independiente enviado después del pago del pedido.

Valor predeterminado: No.

Uso: permite confirmar al cliente que el pago ha sido recibido y que el pedido ha pasado a preparación.

Payment Confirmation Template

Plantilla del correo electrónico enviado después del pago.

Valor predeterminado:

estimated_delivery_date_emails_payment_template

Payment Confirmation Sender

Remitente del mensaje después del pago. El campo utiliza las identidades de correo electrónico configuradas en Magento.

Valor predeterminado:

sales

Allow Email After Delivery Date Change

Permite enviar al cliente un mensaje después de un cambio manual en la fecha de entrega desde el panel de administración.

Valor predeterminado: Yes.

Delivery Date Change Template

Plantilla del correo electrónico enviado tras el cambio de fecha de entrega.

Valor predeterminado:

estimated_delivery_date_emails_date_change_template

Delivery Date Change Sender

Remitente del mensaje sobre el cambio de fecha de entrega.

Valor predeterminado:

sales

Default Apology Message

Texto de disculpa predeterminado utilizado en el mensaje sobre el cambio de fecha de entrega.

Valor predeterminado:

Przepraszamy, termin realizacji Twojego zamówienia uległ zmianie.

Require Delay Reason

Exige indicar el motivo del retraso al cambiar manualmente la fecha en la vista del pedido.

Valor predeterminado: No.

Uso: impone una mejor disciplina operativa y facilita aclarar posteriormente los cambios de fecha.

Send Automatically After Manual Date Change

Envía automáticamente un mensaje al cliente después de un cambio manual en la fecha de entrega.

Valor predeterminado: No.

Si el campo está desactivado, el administrador puede decidir el envío marcando la casilla correspondiente en la vista del pedido.

Gestión de atributos del producto

El módulo añade al producto un grupo de atributos Estimated Delivery Date. Los atributos son opcionales y tienen alcance store view. Si no se completan, el módulo utiliza las reglas o la configuración global.

Los atributos del producto tienen prioridad sobre las reglas calculadas para el producto. Esto permite sobrescribir rápidamente el plazo para un SKU concreto sin cambiar la configuración global.

Dónde editar los atributos

Los atributos están disponibles en el panel de administración de Magento:

Catalog > Products > Edit Product > Estimated Delivery Date

Si el grupo no es visible en un determinado attribute set, debe comprobarse la configuración del conjunto de atributos de producto en Magento.

EDD Processing Days Min

Código del atributo:

edd_processing_days_min

Número mínimo de días laborables necesarios para preparar un producto concreto.

Uso: un producto disponible de inmediato puede tener el valor 0, y un producto solicitado al proveedor, por ejemplo, 3.

EDD Processing Days Max

Código del atributo:

edd_processing_days_max

Número máximo de días laborables de preparación de un producto concreto.

Uso: si la preparación es variable, puede establecerse, por ejemplo, un mínimo de 2 y un máximo de 5 para que el mensaje muestre un rango más seguro.

EDD Transport Days Min

Código del atributo:

edd_transport_days_min

Número mínimo de días laborables de transporte para un producto concreto.

Uso: para productos enviados con otro transportista o desde otro almacén.

EDD Transport Days Max

Código del atributo:

edd_transport_days_max

Número máximo de días laborables de transporte para un producto concreto.

Uso: para productos voluminosos, paletizados o que requieren una logística especial.

EDD Static Customer Message

Código del atributo:

edd_static_text

Mensaje propio para el cliente mostrado en lugar del mensaje de la configuración global.

Ejemplos:

Produkt wykonywany na zamówienie. Termin dostawy potwierdzimy po zakupie.

Przewidywana dostawa: {{delivery_date_from}} - {{delivery_date_to}}

El atributo puede utilizar las mismas variables de fecha que están disponibles en los mensajes globales de entrega.

EDD Confidence

Código del atributo:

edd_confidence

Nivel de confianza del plazo guardado junto con la promesa de entrega.

Valores recomendados:

• guaranteed - plazo garantizado,
• likely - plazo probable,
• estimated - plazo orientativo,
• unknown - sin estimación fiable.

La implementación actual guarda este valor en el resultado del cálculo y en los snapshots. Puede utilizarse en plantillas, integraciones o una mayor personalización de los mensajes.

Disable Estimated Delivery Date

Código del atributo:

edd_disable

Desactiva la visualización de la entrega estimada para un producto concreto en la ficha de producto y también desactiva para él el widget cut-off.

Uso: productos no disponibles, productos que requieren presupuesto individual de entrega, servicios, productos en preventa o artículos para los que la tienda no quiere hacer una promesa de plazo.

Práctica de cumplimentación de atributos

Para la mayoría de productos, los atributos pueden dejarse vacíos y utilizar la configuración global. Conviene completarlos solo cuando un producto concreto realmente difiere del proceso logístico estándar.

Enfoque de ejemplo:

• productos disponibles de inmediato: dejarlos vacíos o establecer un tiempo de preparación más corto,
• productos solicitados al proveedor: establecer un rango de preparación más largo,
• productos voluminosos: establecer un transporte más largo,
• productos personalizados: usar un mensaje estático propio,
• productos sin un plazo fiable: activar Disable Estimated Delivery Date o establecer un mensaje explicativo.

Tras cambiar los atributos del producto, debe actualizarse la caché de Magento si la tienda utiliza full page cache u otros mecanismos de caché adicionales en el tema.

Importación de festivos y días no laborables

La importación está disponible en el panel de administración:

Sales > Estimated Delivery Date > Import Holidays

El archivo CSV debe contener las columnas:

code,name,type

Columnas opcionales:

date_from,date_to,month,day,country,region,postcode_pattern,shipping_method,source_code,store_id,scope,is_active

Tipos admitidos en la columna type:

• single - fecha única, requiere date_from,
• range - rango de fechas, requiere date_from y date_to,
• recurring - fecha recurrente, requiere month y day.

Descripción de los campos de importación seleccionados:

• code - código único del festivo o día no laborable,
• name - nombre visible a nivel administrativo,
• type - tipo de entrada: día único, rango o fecha recurrente,
• date_from - fecha de inicio en formato YYYY-MM-DD,
• date_to - fecha de fin en formato YYYY-MM-DD,
• month - mes para una entrada recurrente,
• day - día del mes para una entrada recurrente,
• country - código de país,
• region - región,
• postcode_pattern - patrón de código postal,
• shipping_method - método de entrega,
• source_code - código de fuente MSI,
• store_id - identificador de store view,
• scope - ámbito de aplicación, por defecto shipping_delivery,
• is_active - estado de actividad de la entrada.

Ejemplo:

code,name,type,date_from,date_to,month,day,country,store_id,is_activechristmas_2026,Christmas Break,range,2026-12-24,2026-12-26,,,,,1new_year,New Year,recurring,,,1,1,,,1

Gestión del plazo en el pedido

La sección Estimated Delivery Date está disponible en la vista del pedido si se ha activado el campo Show in Admin Order.

El administrador puede editar:

• fecha de envío desde,
• fecha de envío hasta,
• fecha de entrega desde,
• fecha de entrega hasta,
• mensaje para el cliente,
• motivo del retraso.

Si el correo electrónico tras el cambio de fecha está activado, el administrador puede marcar el envío del mensaje con disculpas y la nueva fecha. El módulo guarda el historial de cambios junto con la fecha anterior y la nueva, el motivo y la información del envío del correo electrónico.

REST API

El módulo proporciona los endpoints:

GET /rest/V1/estimated-delivery/product/:skuGET /rest/V1/estimated-delivery/cart/:cartIdGET /rest/V1/estimated-delivery/guest-cart/:cartIdGET /rest/V1/estimated-delivery/order/:orderId

La API devuelve, entre otros, la fecha de envío, la fecha de entrega, el mensaje, el nivel de confianza, el código de la regla, la fecha de cálculo y la fuente de datos. Para el pedido, el módulo devuelve el snapshot guardado, si existe.