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á diseñado para instalarse mediante Composer.

Instalación desde el repositorio Composer de Kowal:

Recibirás por correo electrónico los datos de acceso al repositorio Composer, es decir, la dirección de correo electrónico del cliente y el token de licencia, después de la compra. También están disponibles en el panel de cliente tras iniciar sesión en kowal.store. Sustituye TWOJ_EMAIL_KLIENTA por la dirección de e-mail de tu cuenta y TWOJ_TOKEN por el token recibido. Ejecuta los comandos en el directorio raíz de Magento.

composer config repositories.kowal composer https://repo.kowal.store
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
composer require kowal/module-estimated-delivery-date
bin/magento module:enable Kowal_EstimatedDeliveryDate
bin/magento setup:upgrade
bin/magento cache:flush

Después del 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:compile
bin/magento setup:static-content:deploy
bin/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 a nivel 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 no deberían mostrarse en el frontend.

Valor predeterminado:Yes.

Calculation Timezone

Zona horaria utilizada para calcular las fechas y la hora 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 a la configuración predeterminada de la tienda.

Fallback Message

Mensaje de sustitución utilizado como texto de emergencia 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 formateo 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: define 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 intervalo 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: define la fecha de entrega más temprana posible después del envío.

Transport Days Max

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

Valor predeterminado:2.

Uso: permite mostrar un intervalo 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 en el mismo día. El valor debe introducirse en formatoHH: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 tratados como 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

Buffer de seguridad adicional añadido al tiempo de transporte.

Valor predeterminado:0.

Uso: útil en periodos de mayor volumen de pedidos, con un 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 presentación de la fecha prevista en la ficha de producto.

Valor predeterminado:Yes.

Show in Cart

Activa la presentación de la fecha prevista en el carrito.

Valor predeterminado:Yes.

Show in Admin Order

Activa la sección Estimated Delivery Date en la vista de 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 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 cómo se presenta el widget cut-off.

Valores disponibles:

• Inline- el widget se presenta en el lugar donde está insertado el bloque,
• Fixed- el widget queda fijado en la esquina seleccionada de la pantalla,
• 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 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 en 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 intervalo 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 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 cut-off si el campoAfter Cut-off Behaviorestá 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 separado enviado después del pago del pedido.

Valor predeterminado:No.

Uso: permite confirmar al cliente que el pago ha sido aceptado y que el pedido ha entrado en proceso de 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 posterior al pago. El campo utiliza las identidades de correo electrónico configuradas en Magento.

Valor predeterminado:

sales

Allow Email After Delivery Date Change

Permite enviar un mensaje al cliente tras cambiar manualmente la fecha de entrega en el panel de administración.

Valor predeterminado:Yes.

Delivery Date Change Template

Plantilla del correo electrónico enviado después de cambiar la 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

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

Valor predeterminado:

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

Require Delay Reason

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

Valor predeterminado:No.

Uso: impone una mayor disciplina operativa y facilita explicar posteriormente los cambios de fecha.

Send Automatically After Manual Date Change

Envía automáticamente un mensaje al cliente tras cambiar manualmente la fecha de entrega.

Valor predeterminado:No.

Si el campo está desactivado, el administrador puede decidir enviar el mensaje marcando el checkbox en la vista del pedido.

Gestión de atributos del producto

El módulo añade al producto el grupo de atributosEstimated Delivery Date. Los atributos son opcionales y tienen ámbito 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 la fecha para un SKU concreto sin cambiar los ajustes globales.

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 attribute set determinado, debe comprobarse la configuración del conjunto de atributos del 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 valor0, mientras que un producto traído de un proveedor puede tener, 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 configurarse, por ejemplo, un mínimo de2y un máximo de5para que el mensaje muestre un intervalo 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 por 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 personalizado 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 de entrega globales.

EDD Confidence

Código del atributo:

edd_confidence

Nivel de confianza de la fecha guardado con la promesa de entrega.

Valores recomendados:

• guaranteed- fecha garantizada,
• likely- fecha probable,
• estimated- fecha estimada,
• 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 para una posterior personalización de los mensajes.

Disable Estimated Delivery Date

Código del atributo:

edd_disable

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

Uso: productos no disponibles, productos que requieren una valoración individual del coste de entrega, servicios, productos en preventa o artículos para los que la tienda no quiere prometer una fecha.

Buenas prácticas para completar atributos

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

Enfoque de ejemplo:

• productos disponibles de inmediato: dejarlos vacíos o configurar un tiempo de preparación más corto,
• productos traídos de un proveedor: configurar un intervalo de preparación más largo,
• productos voluminosos: configurar un transporte más largo,
• productos personalizados: utilizar un mensaje estático propio,
• productos sin una fecha fiable: activarDisable Estimated Delivery Dateo configurar un mensaje explicativo.

Después de cambiar los atributos del producto, debe actualizarse la caché de Magento si la tienda utiliza caché de página completa o 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 columnatype:

• single- fecha única, requieredate_from,
• range- intervalo de fechas, requieredate_fromydate_to,
• recurring- fecha recurrente, requieremonthyday.

Descripción de 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, intervalo o fecha recurrente,
• date_from- fecha de inicio en formatoYYYY-MM-DD,
• date_to- fecha de fin en formatoYYYY-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 origen MSI,
• store_id- identificador de store view,
• scope- ámbito de aplicación, por defectoshipping_delivery,
• is_active- estado de actividad de la entrada.

Ejemplo:

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

Gestión de la fecha en el pedido

La sección Estimated Delivery Date está disponible en la vista del pedido si se ha activado el campoShow 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 sobre el envío del correo electrónico.

REST API

El módulo proporciona los endpoints:

GET /rest/V1/estimated-delivery/product/:sku
GET /rest/V1/estimated-delivery/cart/:cartId
GET /rest/V1/estimated-delivery/guest-cart/:cartId
GET /rest/V1/estimated-delivery/order/:orderId

La API devuelve, entre otros datos, 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 el origen de los datos. Para un pedido, el módulo devuelve el snapshot guardado si existe.