Extensión Magento 2Documentos de cliente

Entrega de documentos en la cuenta del cliente y en páginas de producto con control de acceso preciso, protección por contraseña, ventanas de tiempo y asignación basada en reglas a pedidos.

Documentos de cliente para Magento 2 centraliza la entrega de documentos importantes en su tienda. Puede proporcionar facturas, contratos, manuales y comprobantes de forma estructurada y controlar el acceso para distintos segmentos de clientes tanto en escenarios B2B como B2C.

Control de acceso preciso: Asigne documentos a clientes individuales, grupos de clientes o acceso público. Con periodos de vigencia, controla exactamente cuándo los documentos están visibles y disponibles para descarga.

Documentos vinculados al producto: Los documentos pueden asignarse directamente a productos y aparecer en la página de detalle del producto dentro del área de descargas. Así, la documentación técnica está disponible justo donde el cliente la necesita.

Proceso de descarga seguro: Los documentos sensibles pueden protegerse con contraseña. La ofuscación opcional del nombre del archivo dificulta que se adivinen archivos. Los documentos se entregan mediante enlaces de descarga protegidos en la tienda en lugar de rutas de archivo visibles públicamente.

Vinculación con procesos de pedido: Los documentos pueden vincularse automáticamente a pedidos, facturas o envíos. De este modo, los clientes encuentran los archivos relevantes directamente en el contexto correspondiente.

Operación y servicio: Las notificaciones automáticas por correo informan a los clientes sobre nuevos documentos. La descarga masiva ZIP facilita la descarga rápida de varios archivos.

Control de acceso preciso por cliente y grupo

Defina el acceso por documento según cliente o grupo de clientes. Así protege contenido sensible y mantiene disponibles los archivos autorizados.

Documentos directamente en la página de producto

Asigne documentos a productos para que los clientes descarguen manuales, fichas técnicas e indicaciones directamente en la página de producto cuando se cumplan las reglas de visibilidad y acceso.

Asignación automática a pedidos, facturas y envíos

Vincule documentos automáticamente con los datos del pedido. Esto reduce consultas y acelera los procesos de servicio.

Protección por contraseña y ventanas de tiempo para contenido sensible

Proteja documentos individuales con contraseña y controle su disponibilidad mediante periodos de vigencia.

Notificaciones automáticas de documentos

Informe automáticamente por correo cuando haya nuevos documentos y mantenga visibilidad del estado de envío y de posibles errores.

Descarga masiva ZIP de varios documentos

Los clientes pueden descargar varios documentos aprobados en un solo archivo ZIP, mejorando la experiencia con grandes volúmenes de archivos.

  • Versión actual1.8.1
  • Compatible con Magento 2.4.6 - 2.4.8
  • Compatible con PHP 8.1 - 8.5

Si su entorno difiere de los requisitos indicados, podemos verificar la compatibilidad con antelación. Contáctenos por el formulario de contacto.

customerdocuments

Version 1.8.1 - 2026-02-17

Added
  • Added mass action "Resend" in notification grid to requeue selected notifications
Changed
  • Changed notification grid column from "Document ID" to "Document" and display document name
  • Standardized customer account protection for frontend account pages
  • Highlight selected tag filter in frontend "My Documents" tag cloud
Fixed
  • Fixed email notification recipient filtering when both specific customers and customer groups are assigned

Version 1.8.0 - 2026-02-13

Added
  • Added product-level document assignments with store view scoping and new Downloads tab at product detail page
Fixed
  • Private documents now enforce access rights and download limits before delivery
  • Fixed cron notification timestamps and error handling when a document no longer exists
  • Fixed document linking cron to process in batches and avoid heavy memory usage
Changed
  • Unified download validation logic across endpoints for more consistent behavior

Version 1.7.5 - 2025-12-12

Fixed
  • Fixed error on admin Customer Documents grid when categories are empty
  • Fixed admin Customer Documents grid filters for "Customer Emails" and "Customer Groups" columns not working

Version 1.7.4 - 2025-12-08

Added
  • Added website scoping for customer documents (Website Field and "All Websites" Option)
Changed
  • Added Export and Filter to Customer ->Documents section
Fixed
  • Fixed PHP 8.4 deprecation warning by explicitly marking the `$pool` constructor parameter in `Ui\DataProvider\Document\DataProvider` as nullable

Version 1.7.3 - 2025-12-07

Added
  • Added Customer ->Documents section in admin area to view assigned documents
  • Added tag management system with admin CRUD interface, tag chips in document form, and frontend tag cloud filtering
  • Added column visibility configuration for frontend document grid (multiselect in admin to show/hide columns)

Version 1.7.2 - 2025-11-13

Fixed
  • Fixed config path enable_sidebar in Block/Sidebar class

Version 1.7.1 - 2025-11-09

Fixed
  • My documents layout: use cards on mobile viewport
  • Escaping: sanitized unescaped values (name, category, description, and category headers) in frontend grid templates to prevent XSS
  • Configuration scope: ensured store/website scope is respected by using SCOPE_STORE for frontend config reads (links, grid options, upload path, allowed extensions, external domain whitelist, email settings)
  • Sidebar visibility: customer account navigation link now respects "Enable at sidebar" via layout `ifconfig` and additionally hidden when module is disabled
  • Head link visibility: header "My Documents" link is hidden unless both the module is active and the head link is enabled
  • Disabled module redirects: improved grammar for the disabled-extension message and ensured controllers read module status per store scope

Version 1.7.0 - 2025-11-02

Added
  • Added rate limiting for document downloads (5 downloads per hour) using cache-based implementation with IP tracking for guest users and customer ID tracking for logged-in users
  • Added CSRF protection for POST requests in CheckDownload controller using FormKeyValidator
  • Added request-level caching for access rights checks to prevent redundant database queries during the same request
  • Added composite database indexes to optimize queries on relation tables (document_id + customer_id, document_id + customer_group_id, document_id + customer_id + downloaded_at)
  • Added configuration option for maximum upload file size (MB) in system config
  • Added configuration option for maximum email attachment size (MB) in system config
  • Added MIME type validation using setValidateCallback() in file uploader for better security
  • Added security warning for external URL configuration in admin system config
  • Added temporary directory writability check for ZIP download functionality
  • Added PathColumn UI component to display external URL when path is empty in admin grid
  • Added delete confirmation dialogs for admin grid actions in both documents and categories listing
Changed
  • Replaced all date() calls with Magento DateTime helper (gmtDate) for proper timezone handling and consistency
  • Improved admin documents grid to show customer emails instead of customer IDs
  • Improved admin documents grid to show customer group codes instead of customer group IDs
  • Changed admin grid path column label to "Path / External URL" to better reflect its dual purpose
  • Email attachment logic now respects configurable maximum attachment size
Fixed
  • Fixed N+1 query issue in document collection by implementing eager loading using GROUP_CONCAT and _afterLoad() hook
  • Fixed 12-hour time format bug (h:i:s) in document creation timestamp, now correctly uses 24-hour format (H:i:s)
  • Fixed URL encoding in frontend search functionality
  • Improved error messages throughout the extension to be more specific instead of generic

Version 1.6.0 - 2025-10-17

Added
  • Added feature to use external links for document downloads instead of uploaded documents
Fixed
  • Fixed issue on fresh installation with obsolete customer group colum check

Version 1.5.3 - 2025-08-08

Fixed
  • Fixed small issues with PHP 8.4 compatibility

Version 1.5.2 - 2025-07-27

Added
  • Added PHP 8.4 compatibility
Fixed
  • Fixed an issue with incrementDownloadsCounter

Version 1.5.1 - 2025-07-22

Added
  • Added suggest entry to composer.json referencing the CustomerDocuments Sample Data package for easier onboarding
Fixed
  • Show download as ZIP file option only if customer has access to at least one document

Version 1.5.0 - 2025-06-22

Added
  • Added a configuration obscure_filename to obscure the filename (e.g., `file_64e1f8a9c3b4a.pdf`) when downloading a document - this adds an additional layer of security to prevent direct access to files by their original names
  • Added feature to restrict a document within dates (valid from date & valid to date) - disabled by default
  • Added instructions in README.md for web server configuration to block direct access to the document folder for enhanced security
Changed
  • Changed the public download path to `/customerdocuments/download/file?id=document_id&password=password` , please make sure to update your public download links accordingly
  • Removed the resync upload path functionality and config button, as it is replaced by observer logic
  • Improved display for public download URL in customer document form in admin area, now it shows the full URL with the document ID and password dynamically
  • Removed some redundant functions and methods in the codebase to streamline the extension
Fixed
  • Fixed issue with back button in admin area (customer documents form, customer documents category form)

Version 1.4.5 - 2025-06-11

Fixed
  • Fixed issue accessing the customer documents category menu in admin area

Version 1.4.4 - 2025-06-06

Fixed
  • Fixed issue when creating document and customers/customer groups within the same request

Version 1.4.3 - 2025-05-28

Added
  • Added feature to download all documents as ZIP file (the password protected files, if any, will be automatically excluded) - disabled by default

Version 1.4.2 - 2025-05-22

Added
  • Added link "My Documents" in the customer head section (store config, enabled by default)

Version 1.4.1 - 2025-05-07

Added
  • Added Public URL on Admin UI Form to copy & paste the URL easily
Changed
  • Added DB column created_at to email notification table
Fixed
  • Fixed error message shown when customer document file was deleted in edit form
  • Fixed wrong error message on public download when password was not provided
  • Fixed sorting issue under My Documents
  • Fixed incorrect value display for "Is Public" under My Documents

Version 1.4.0 - 2025-04-29

Added
  • Added "Max Downloads" attribute to define a maximum number of allowed downloads per document
  • Added added email notification table to check if any errors occured during sending process
  • Added system store config option to directly add document as attachment inside the email
Changed
  • Changed email to queue processing using cronjob
  • Refactored complete Admin UI using UI forms
  • Changed Category, Customer and CustomerGroup Classes/Models to add prefix "Document" (CustomerRepository -> DocumentCustomerRepository)

Version 1.3.2 - 2024-12-30

Fixed
  • Fixed issue with sorting parameters in frontend My Documents section

Version 1.3.1 - 2024-10-25

Changed
  • Changed logic of email store: Now, the store for the selected template will be fetched from the customer's store_id
Fixed
  • PHP 8.3 compatibility bugfixes
  • Fixed ambigious column issue in customer documents grid
  • Fixed sorting issue in customer documents grid

Version 1.3.0 - 2024-10-07

Added
  • Added fulltext search in customer documents admin grid
  • Added pager and limit feature for frontend customer documents grid
Changed
  • Moved the customer_group values (previously stored as comma-separated values) into a dedicated relation table customer_document_customer_group for better data management
  • Added a data migration patch to transfer existing customer group data into the new relation table
  • Improved performance when handling large datasets by optimizing database queries and reducing memory usage
  • Changed System class for displaying extension information
Fixed
  • Fixed issue with Cronjob DeleteMissingFiles

Version 1.2.0 - 2024-09-24

Added
  • Added link entity: Now customer documents can be linked to any entity in Magento 2, e.g. orders or invoices
  • Added automatic cronjob to connect the documents based on defined patterns (defined in the system configuration)
  • Added functionality to both use password protection and public document (see README.md for further instructions)
  • Added feature to show documents per category, added system configuration
  • Added system configuration: Show Document Name
  • Added system configuration: Show Password Notice
  • Added system configuration: Delete Missing Files (Cronjob)
  • Added support for Magento_RemoteStorage (by using Filesystem method of Magento 2)
  • Added Magento_CSP Compatibility (works for Magento 2.4.7 onwards)
Changed
  • Changed to a more secure approach for password protected documents
  • Changed config paths (a Patch will automatically move your settings)
  • Removed MageB2B\CustomerDocuments\Helper\Common (in favor of Helper\Data class)
  • Removed MageB2B\CustomerDocuments\Helper\Config (in favor of Magento\Framework\App\Config\ScopeConfigInterface class)
  • Removed MageB2B\CustomerDocuments\Helper\Logger (in favor of \Psr\Log\LoggerInterface class)
  • Renamed "Publicly Available" to "Is Public"
  • Use yesnoSource Class for Customer Document Form
Fixed
  • Removed action columns for Download Report menu

Version 1.1.6 - 2024-08-07

Fixed
  • Fixed icon issue on Download Report menu in admin area

Version 1.1.5 - 2024-07-22

Added
  • Updated README.md

Version 1.1.4 - 2024-05-17

Added
  • Added patch to add General category if it doesnt exist (to avoid issue when accessing category grid in admin with empty categories)

Version 1.1.3 - 2024-04-22

Fixed
  • PHP 8.2 compatibility bugfixes
Changed
  • Improved email template

Version 1.1.2 - 2024-03-06

Changed
  • PHP docs

Version 1.1.1 - 2023-09-24

Version 1.1.0 - 2023-08-29

Added
  • Added a store config "Enable Sidebar" - only if store config is enabled, sidebar block will be rendered
Fixed
  • Fixed various issues around grid filter, added category dropdown filter instead of text
  • Fixed mass action delete on grid

Version 1.0.11 - 2023-03-03

Added
  • Added a button "resync upload path" to resync the upload path after changed, so every file will be moved automatically

Version 1.0.10 - 2023-01-24

Changed
  • replaced setFrom() method with setFromByScope()

Version 1.0.9 - 2022-10-14

Fixed
  • Added uninstall routine

Version 1.0.8 - 2022-08-03

Fixed
  • PHP8 Compatibility bugfixes

Version 1.0.7 - 2022-05-17

Added
  • Field updated_at added
  • Added password on document grid
Fixed
  • Removed new button from report grid

Version 1.0.6 - 2022-04-23

Fixed
  • Composer.json bugfixes
customerdocuments-importexport

Version 1.6.1 - 2026-03-11

Fixed
  • Fixed export to properly handle `customer_ids` and `customer_group_ids` as arrays (not strings) in Document model

Version 1.6.0 - 2026-02-13

Added
  • Added CSV column `product_links` to import and export product assignments in format `sku@store_code@position|...`
  • Added validation for product links (SKU/store-code checks)
Fixed
  • Fixed import updates with existing `id` and empty `path` (keeps current document file path)
  • Replaced direct `date()` usage with Magento DateTime helper timestamps for import defaults

Version 1.5.3 - 2025-12-07

Added
  • Added compatibility to mageb2b/customerdocuments 1.7.3 (tag implementation)
Fixed
  • Fixed issue on export.xml file

Version 1.5.2 - 2025-10-28

Fixed
  • Return a proper download response for the sample file so the browser saves the file instead of rendering it inline

Version 1.5.1 - 2025-07-06

Added
  • Added README.md and CHANGELOG.md

Version 1.5.0 - 2025-06-20

Added
  • Added compatibility with customerdocuments 1.5.0

Version 1.4.0 - 2025-04-29

Added
  • Added compatibility with customerdocuments 1.4.0, added send_email flag and functionality to queue emails from import

Version 1.3.1 - 2025-04-16

Changed
  • Downgraded to version 1.3.1

Version 1.3.0 - 2024-10-03

Changed
  • Changed version constraint for new version
  • Import changes especially for customer group table change

Version 1.2.0 - 2024-08-07

Changed
  • Version 1.2.0 which will support new MageB2B_CustomerDocuments 1.2.0 (classes were removed)

Version 1.0.4 - 2024-03-06

Changed
  • Changed homepage in composer.json

Version 1.0.3 - 2023-11-09

Fixed
  • Fixed undefined issue on variable

Version 1.0.2 - 2022-12-28

Fixed
  • Fixed undefined constant issue on sample file download

Version 1.0.1 - 2022-07-29

Fixed
  • fixed composer.json, bump version to 1.0.1

Version 1.0.0 - 2022-05-14

Added
  • Added dependency for package mageb2b/customerdocuments inside composer.json
  • Output validation errors on CLI import
Changed
  • Updated import class to add updated_at column
  • Replaced MageBTB->MageB2B
  • MageBTB_CustomerDocumentsImportExport ->MageB2B_CustomerDocumentsImportExport
customerdocuments-api

Version 1.4.3 - 2026-02-13

Added
  • Added new endpoints for document product assignment feature

Version 1.4.2 - 2025-07-05

Fixed
  • Fixed CHANGELOG.md

Version 1.4.1 - 2025-07-05

Version 1.4.0 - 2025-05-20

Version 1.3.0 - 2024-10-03

Added
  • Added new webapi routes
Changed
  • Add version constraint for new api definitions

Version 1.2.0 - 2024-08-08

Added
  • Added new API routes for customer link feature

Version 1.0.1 - 2024-03-06

Fixed
  • Fixed homepage on composer.json
Changed
  • Updated copyright info

Version 1.0.0 - 2022-05-12

Added
  • Initial version of mageb2b/customerdocuments-api
customerdocuments-graph-ql

Version 1.0.0 - 2026-02-23

Added
  • Initial release
customerdocuments-hyva

Version 1.1.2 - 2026-02-24

Added
  • Added dedicated view models for product downloads, linked documents, and tag URL handling in Hyva templates
Fixed
  • Fixed Hyva linked document download flow by aligning template bindings with the Hyva download component
  • Fixed tag filter URL handling to keep a single `search[tags]` parameter

Version 1.1.1 - 2026-02-18

Added
  • Hyva compatibility for product page document downloads
Changed
  • Updated compatibility baseline for mageb2b/customerdocuments 1.8.1
  • Aligned module dependency sequencing for Hyva compatibility fallback loading

Version 1.1.0 - 2025-12-07

Added
  • Compability to mageb2b/customerdocuments 1.7.3
  • Added tag search field and visual tag cloud with Tailwind CSS styling
  • Added column visibility support for frontend document grid (conditional rendering based on configuration)

Version 1.0.0 - 2025-06-13

Added
  • Initial version
Preguntas específicas del módulo
¿Cómo restrinjo documentos a clientes o grupos específicos?

Use la configuración de acceso del documento para asignar clientes individuales y/o grupos de clientes. Los documentos privados solo son visibles después de iniciar sesión.

¿Puedo compartir enlaces públicos de descarga?

Sí. Active la opción Es público para generar un enlace público de descarga. También puede definir una contraseña adicional.

¿Cómo añado protección adicional a documentos sensibles?

Active la protección por contraseña en cada documento. Opcionalmente, la ofuscación del nombre de archivo dificulta adivinar archivos.

¿Puedo limitar documentos por periodo de tiempo?

Sí. Use Válido desde y Válido hasta para definir cuándo un documento está visible y disponible para descarga.

¿Existe descarga masiva para varios archivos?

Sí. Con la descarga ZIP activada, los clientes pueden descargar varios documentos aprobados y alojados internamente en un solo archivo.

¿Dónde ven los clientes sus documentos?

En la cuenta del cliente, en Mis documentos. También puede mostrar documentos en la navegación o en áreas adicionales de la página.

¿Cómo vinculo documentos con pedidos, facturas o envíos?

Use reglas de vinculación por patrón de nombre para que los documentos coincidentes aparezcan automáticamente en el contexto del pedido.

¿Cómo muestro documentos en la página de detalle del producto?

Asigne documentos directamente a los productos. Los archivos aprobados aparecerán en la sección de documentos de la página de producto.

¿Se registran las descargas?

Sí. Los eventos de descarga se registran para poder trazar y evaluar los accesos.

¿Puedo usar URLs externas en lugar de subir archivos?

Sí. Los documentos pueden guardarse como URLs externas. Si es necesario, puede restringir los dominios permitidos en la configuración.

¿Cómo evito el acceso directo a archivos en el servidor?

Bloquee la carpeta de documentos a nivel del servidor web, por ejemplo en Apache o Nginx. Los documentos deben entregarse solo mediante enlaces de descarga protegidos de la tienda.

Preguntas generales
¿Para cuántas instalaciones de Magento es válida la licencia?

La licencia es válida para una instalación de Magento, incluido el funcionamiento multisitio. Además, el módulo puede instalarse en cualquier número de servidores de desarrollo o staging. Encontrará más detalles en nuestros términos de licencia.

¿La instalación está incluida en el precio?

La instalación y la configuración no están incluidas en el precio. Si lo desea, le apoyamos en una integración fluida en su sistema.

¿Qué métodos de pago están disponibles?

Puede pagar con tarjeta de crédito (Stripe) o por transferencia bancaria (pago por adelantado). En pagos con tarjeta, el pedido se procesa de inmediato y las credenciales de acceso se envían directamente en un correo electrónico de seguimiento.

¿Cómo es el proceso de pedido?

Después del pago con tarjeta de crédito, recibirá de inmediato las credenciales para obtener el módulo mediante Composer. En caso de transferencia bancaria, el acceso se concede una vez abonada la factura.

Necesito una modificación personalizada del módulo. ¿Es posible?

Las solicitudes personalizadas no son un problema. Adaptamos nuestros módulos de Magento 2 a su proyecto y mantenemos una versión interna dedicada para saber exactamente qué se ejecuta en su sistema durante el soporte.

¿Puedo instalar una versión demo localmente?

En la página de detalle de cada módulo, puede solicitar su propia instancia de demostración y probar el módulo a fondo durante 7 días. Sin embargo, no ofrecemos una versión de demo local.

¿Está encriptado el código fuente?

No, el código fuente de nuestros módulos no está encriptado. Si necesita una personalización, puede enviarnos una solicitud. Le responderemos en breve con una propuesta sin compromiso.

¿Cómo funcionan las actualizaciones y el soporte?

Puede añadir un paquete de soporte a su pedido. Incluye asistencia, así como actualizaciones y mejoras relacionadas con el módulo. No se requiere una suscripción continua.

Ya tengo una licencia. ¿Cómo hago una actualización?

Puede completar la actualización de licencia aquí. Si tiene un paquete de soporte activo, recibirá las actualizaciones automáticamente mediante Composer. Si su paquete de soporte ha vencido, puede renovar su licencia aquí o en su cuenta.

Tengo otra pregunta, ¿cómo puedo contactarlos?

Puede contactarnos en cualquier momento a través de Correo electrónico.

Documentos de cliente

×

Ideal para estas industrias y casos de uso

Distribución automatizada de facturas

Vincule facturas a pedidos automáticamente mediante patrones de archivo. Los clientes acceden a sus documentos desde una zona central de cuenta.

Entrega segura de contratos

Entregue contratos confidenciales con protección por contraseña y acceso limitado en el tiempo. Las descargas quedan registradas de forma trazable.

Documentos técnicos en páginas de producto

Publique manuales, fichas técnicas e instrucciones directamente en la página de detalle del producto y reduzca consultas al soporte.

Historial de descargas trazable para procesos de revisión

Registre descargas de documentos de forma transparente y apoye procesos internos de revisión con historiales claros. Los requisitos completos de cumplimiento requieren políticas organizativas adicionales.

Confirmaciones de pedido y albaranes

Vincule documentos de pedido con pedidos, facturas y envíos para que los clientes encuentren toda la información en un solo lugar.

Onboarding con documentos digitales

Proporcione materiales de configuración, guías de proceso e instrucciones para nuevos clientes de forma estructurada y reduzca el tiempo de incorporación.

Pruébelo sin riesgo

Solicite una instancia de demostración personal y evalúe el módulo directamente en backend y frontend en condiciones reales, sin instalación local.

Para desarrolladores

Guías prácticas de Magento 2, documentación técnica para desarrolladores y referencias de API (REST, SOAP, GraphQL) para instalación, configuración y solución de problemas.

Ir a la base de conocimiento