A quienes compran código fuente les preocupa una cosa por encima de todas: ¿seguirá manteniéndose este producto después de pagar? Lo respondes con tres hábitos. Usa el versionado semántico para que el número de versión indique a los compradores lo arriesgada que es una actualización. Mantén un registro de cambios que explique cada versión en lenguaje claro. Y publica una política de soporte que diga qué ayuda se incluye, durante cuánto tiempo y qué no se incluye.
Estos hábitos convierten una venta única en una relación, y son una parte importante de lo que hace que los compradores confíen en un anuncio, como explicamos en nuestra guía sobre cómo vender el código fuente de tu aplicación web o SaaS. Este artículo trata la mecánica: numerar versiones, redactar entradas del registro de cambios, empaquetar actualizaciones para instalaciones personalizadas y fijar límites de soporte que protejan tu tiempo.
¿Cómo se aplica el versionado semántico a una aplicación web?
El versionado semántico (Semantic Versioning) usa tres números, MAJOR.MINOR.PATCH. La especificación se escribió para bibliotecas con una API pública, así que tienes que decidir cuál es tu «API pública» cuando vendes una aplicación completa. En un producto de código fuente, es todo aquello de lo que depende un comprador cuando instala, configura, personaliza y actualiza:
- Requisitos del servidor (versiones del lenguaje, de la base de datos y de las extensiones).
- Variables de entorno y claves de configuración.
- El esquema de base de datos que los compradores pueden consultar o ampliar.
- Puntos de extensión: hooks, eventos, carpetas de sobrescritura, archivos de tema, clases documentadas.
- Tu API REST, los webhooks y los formatos de importación o exportación.
Un cambio que obligue a los compradores a modificar cualquiera de estos elementos es un cambio incompatible, aunque la aplicación se vea igual.
| Cambio | Incremento de versión | Ejemplo |
|---|---|---|
| Corrección de errores sin cambios en requisitos, configuración ni puntos de extensión | PATCH (de 2.4.1 a 2.4.2) | Corregir totales erróneos en el informe mensual |
| Corrección de seguridad compatible con versiones anteriores | PATCH | Añadir la comprobación de autorización que faltaba en la ruta de exportación |
| Nueva función; las instalaciones existentes siguen funcionando tras las migraciones | MINOR (de 2.4.2 a 2.5.0) | Añadir recordatorios por SMS como módulo opcional |
| Nuevo ajuste o variable de entorno opcional con un valor por defecto seguro | MINOR | Añadir REPORTS_CACHE_MINUTES, por defecto 10 |
| Subida de la versión mínima de PHP o de la base de datos | MAJOR (de 2.5.0 a 3.0.0) | Exigir PHP 8.4 |
| Clave de configuración renombrada, hook eliminado, respuesta de la API modificada | MAJOR | Cambiar el manejo de MAIL_FROM; eliminar la API v1 obsoleta |
| Actualización mayor del framework que cambia las rutas de sobrescritura | MAJOR | Pasar a una nueva versión mayor del framework con una nueva estructura de carpetas |
Dos reglas prácticas ayudan: marca como obsoleto antes de eliminar (avisa en una versión MINOR y elimina en la siguiente MAJOR), y haz que las versiones MAJOR sean poco frecuentes y estén bien documentadas. Los compradores perdonan los cambios incompatibles; lo que no perdonan son las sorpresas.
Escribe un registro de cambios en el que los compradores confíen
Un registro de cambios se escribe para personas, no se genera a partir de los mensajes de commit. El formato Keep a Changelog, muy utilizado, agrupa los cambios en Added, Changed, Deprecated, Removed, Fixed y Security (añadido, cambiado, obsoleto, eliminado, corregido y seguridad), con la versión más reciente arriba y una fecha para cada versión. Este es un ejemplo de cómo son unas buenas entradas:
[3.0.0] — 2026-11-10
Notas de actualización: requiere PHP 8.4. Ejecuta las migraciones. El ajuste
MAIL_FROMse ha trasladado a Ajustes > Correo electrónico; los valores existentes se migran automáticamente. Si sobrescribesresources/views/invoices, compara tu copia con la nueva plantilla.Añadido — Facturas recurrentes con recordatorios automáticos. — Traducción al japonés.
Cambiado — El diseño del PDF de la factura ahora admite descripciones largas de artículos.
Eliminado — La API REST v1, marcada como obsoleta en la 2.6.0. Usa la v2.
Seguridad — Los archivos CSV exportados ahora solo están disponibles para usuarios con el permiso de Informes.
[2.6.1] — 2026-09-22
Corregido — El calendario mostraba las reservas con una hora de desfase tras un cambio de horario de verano.
Fíjate en los detalles: la fecha, las notas de actualización antes de la lista, el ajuste exacto que se trasladó, la carpeta que puede necesitar atención y el motivo por el que algo se eliminó. «Corrección de errores y mejoras» no le dice nada al comprador y transmite que quizá tú tampoco sabes qué ha cambiado.
Publica el registro de cambios en tres lugares: como archivo dentro de la descarga, en tu anuncio y dentro del área de administración de la aplicación, si tienes un aviso de actualización. Una entrada reciente y fechada en el anuncio es una de las señales más claras de que el producto está vivo.
Publica actualizaciones que los compradores puedan aplicar de verdad
Los compradores de código fuente personalizan. Si tu proceso de actualización da por hecho una instalación intacta, cada versión se convierte en una oleada de tickets de soporte. Diseña pensando en la personalización desde el principio.
Dale a las personalizaciones un lugar seguro
- Carpetas de sobrescritura para vistas, traducciones y temas que tu código consulta antes de usar sus propios valores por defecto.
- Eventos y hooks en los puntos importantes (factura creada, usuario registrado) para que los compradores puedan añadir comportamiento sin editar las clases del núcleo.
- Configuración y ajustes para todo lo que un comprador querría cambiar razonablemente.
- Un service provider personalizado o una carpeta de módulos que las actualizaciones nunca sobrescriban.
Documenta estos puntos de extensión; nuestra guía sobre documentación que reduce los tickets de soporte muestra cómo redactar la guía de personalización.
Empaqueta bien cada versión
- Paquete completo: el código completo para instalaciones nuevas y para los compradores que nunca lo personalizaron.
- Notas de actualización: cambios en los requisitos, migraciones, nuevos ajustes y archivos modificados que los compradores podrían haber sobrescrito.
- Una lista de archivos modificados desde la versión anterior, para que los compradores que editaron archivos del núcleo sepan qué comparar.
- Migraciones de base de datos que se ejecuten de forma segura sobre datos existentes y que se hayan probado en una copia de una base de datos realista.
- Un flujo de actualización recomendado: haz copia de seguridad de archivos y base de datos, pon la aplicación en modo mantenimiento, sustituye los archivos, ejecuta las migraciones, limpia las cachés, prueba y vuelve a ponerla en marcha.
A los compradores que usan Git, sugiéreles mantener tu versión original en una rama aparte y fusionar cada nueva versión en su rama personalizada. Así, los conflictos muestran exactamente dónde se cruzan sus cambios con los tuyos. Si tu producto está construido sobre Laravel, enlaza la propia guía de actualización del framework en tus notas cada vez que una versión pase a una nueva versión mayor del framework.
Avisa a los compradores de que hay una actualización
En AppTrovo, publicas una nueva versión de tu producto y los compradores pueden descargar las nuevas versiones mientras su periodo de soporte y actualizaciones esté activo. También puedes mostrar un aviso de actualización dentro de tu aplicación: la API pública de productos devuelve la versión actual, así que tu área de administración puede compararla con la versión instalada y enlazar al registro de cambios. Comprueba como máximo una vez al día y no bloquees nunca la aplicación si la comprobación falla. La guía de integración de licencias incluye un ejemplo.
Lista de comprobación para cada versión
- Elige el número de versión con la tabla anterior.
- Redacta la entrada del registro de cambios y las notas de actualización.
- Ejecuta las pruebas y luego instala la versión en un servidor limpio.
- Actualiza una copia de la versión anterior con datos realistas y algunas sobrescrituras aplicadas.
- Actualiza la documentación y las capturas de pantalla que hayan cambiado.
- Genera el paquete a partir de un commit etiquetado, sin archivos de desarrollo, logs ni secretos.
- Despliega esa misma compilación en tu demo en vivo.
- Sube la nueva versión y actualiza el registro de cambios del anuncio.
- Vigila de cerca los tickets durante 48 horas y ten lista una versión PATCH.
Redacta una política de soporte con límites justos
Sin una política escrita, el «soporte» acaba incluyendo desarrollo a medida, administración de servidores y formación. Una política breve en tu anuncio y en tu documentación lo evita, y los compradores agradecen saber qué esperar. En AppTrovo, cada producto tiene un periodo de soporte incluido que tú configuras (6 meses por defecto), y puedes permitir que los compradores adquieran un soporte más largo al pagar o lo amplíen más adelante.
Esta es una plantilla que puedes adaptar:
Política de soporte
Incluido: ayuda para instalar el producto en un servidor compatible; respuestas a preguntas sobre funciones y ajustes; corrección de errores en el código original; actualizaciones de seguridad; orientación sobre dónde hacer las personalizaciones habituales.
No incluido: desarrollo a medida o nuevas funciones para un solo comprador; resolución de problemas causados por modificaciones del código; configuración del servidor, del alojamiento o del proveedor de correo más allá de los requisitos documentados; plugins o servicios de terceros.
Cómo obtener ayuda: abre un ticket de soporte desde tu compra. Incluye la versión del producto, el entorno del servidor (versión de PHP y de la base de datos), el mensaje de error exacto y los pasos para reproducirlo.
Objetivo de respuesta: procuramos responder en un plazo de dos días laborables, de lunes a viernes, en inglés. Los problemas complejos pueden tardar más en resolverse.
Periodo de soporte: el soporte y las actualizaciones están incluidos durante el periodo indicado en la página del producto y pueden ampliarse desde tu panel.
Fija un objetivo de respuesta que realmente puedas cumplir, también en vacaciones. Una respuesta fiable en dos días es mejor que una respuesta prometida en una hora que no cumples. Si ofreces personalización de pago, menciónalo por separado para que los compradores sepan adónde dirigirse.
El tiempo de soporte es un coste real de cada venta. Como ejemplo ilustrativo, si un comprador medio abre tres tickets que te llevan veinte minutos cada uno, cada venta te cuesta una hora de trabajo durante el periodo de soporte. Estima esa cifra a partir de los tickets de tus primeros meses y tenla en cuenta en tu precio; nuestra guía sobre cómo poner precio al código fuente explica cómo. Asegúrate también de que la política no contradiga los términos de licencia del marketplace, que definen lo que los compradores pueden hacer con el código.
Haz que los tickets sean eficientes
- Pide la versión, el entorno, el error exacto y los pasos en el propio formulario del ticket.
- Añade al área de administración una página de información del sistema que los compradores puedan copiar en un ticket.
- Responde con un enlace a la documentación y un breve resumen, y mejora la página si el enlace no sirvió.
- Responde en público a reseñas y preguntas cuando la respuesta también ayude a futuros compradores.
Gestiona los problemas de seguridad de otra manera
Las correcciones de seguridad merecen su propio proceso, porque los compradores ejecutan tu código en sus servidores con los datos de sus clientes.
- Publica una vía para informar de vulnerabilidades, como una dirección de correo dedicada en tu documentación. Un archivo
security.txt, definido en el RFC 9116, es un lugar estándar para indicarla en tu sitio web. - Primero corrige, después divulga. Publica el PATCH y luego describe el problema en la sección de seguridad del registro de cambios con detalle suficiente para que los compradores valoren la urgencia, pero sin un exploit paso a paso.
- Corrige las versiones anteriores con soporte cuando sea viable, o indica claramente a los compradores a qué versión deben pasar.
- Pide a los compradores que actualicen por todos los canales que tengas: el anuncio, el aviso dentro de la aplicación y tus respuestas de soporte.
Planifica el fin de vida
Ningún producto se mantiene para siempre. Decide de antemano cómo terminarás el soporte de una versión mayor antigua o del producto completo. Anúncialo en el registro de cambios, da a los compradores un plazo de preaviso razonable y publica una versión final con todas las correcciones de seguridad conocidas. En AppTrovo, un producto que ha emitido licencias puede retirarse en lugar de eliminarse: deja de aparecer en el listado, pero todas las licencias existentes siguen verificándose, así que las instalaciones de los compradores no se ven afectadas.
Preguntas frecuentes
¿Qué es el versionado semántico, en pocas palabras?
Es un esquema de numeración, MAJOR.MINOR.PATCH, en el que cada número indica a los usuarios qué tipo de cambio contiene una versión. PATCH significa solo correcciones de errores, MINOR significa nuevas funciones que mantienen operativas las configuraciones existentes, y MAJOR significa que ha cambiado algo que puede requerir trabajo por parte del usuario al actualizar.
¿Qué debe incluir un registro de cambios?
Cada versión necesita un número de versión, una fecha y entradas agrupadas según lo que se añadió, cambió, marcó como obsoleto, eliminó, corrigió y reforzó en seguridad. En las aplicaciones que los compradores instalan por su cuenta, añade notas de actualización al principio de cada versión: nuevos requisitos, migraciones, ajustes trasladados y archivos que las instalaciones personalizadas deberían comparar.
¿Con qué frecuencia debería publicar actualizaciones?
Publica las correcciones PATCH en cuanto estén listas, sobre todo si son de seguridad. Muchos vendedores agrupan las funciones en versiones MINOR cada uno a tres meses, lo que da a los compradores un ritmo predecible. Las versiones regulares y fechadas importan más que las frecuentes.
¿Los compradores tienen que pagar por las actualizaciones?
En AppTrovo, los compradores pueden descargar nuevas versiones mientras su periodo de soporte y actualizaciones esté activo, y pueden ampliar ese periodo. Cuando termina, conservan la versión que tienen y pueden seguir usándola conforme a su licencia.
¿Debería el soporte incluir ayuda con las personalizaciones?
La mayoría de los vendedores incluyen orientación sobre dónde hacer los cambios habituales, pero excluyen escribir código a medida para compradores concretos. Dilo claramente en tu política de soporte. Si quieres ofrecer trabajos de personalización, preséntalos como un servicio de pago aparte.