Paquete gestionado (managed package)

Un paquete gestionado (managed package) es la forma estándar en que se empaqueta, distribuye y versiona una aplicación o componente sobre Salesforce. Agrupa código Apex, componentes Lightning, objetos personalizados, flujos y metadatos en una unidad instalable que un cliente puede agregar a su org con unos pocos clics, normalmente desde AppExchange.

Lo que distingue a un paquete gestionado de uno "no gestionado" es el control que retiene el desarrollador (ISV o partner): el código fuente queda oculto, los componentes llevan un prefijo de espacio de nombres reservado y el editor puede publicar versiones actualizables que se propagan sin romper las personalizaciones del cliente. Es el modelo que usan los partners para construir productos comerciales sobre la plataforma, y es parte del trabajo de desarrollo que aborda Vantegrate.

Un paquete gestionado resuelve un problema concreto: cómo entregar software construido sobre Salesforce a muchos clientes manteniendo la capacidad de versionar, proteger y actualizar ese software de forma centralizada. En lugar de copiar y pegar componentes org por org, el desarrollador empaqueta todo (Apex, Lightning Web Components, objetos, campos, flujos, páginas, conjuntos de permisos) en una unidad firmada y publicable.

Cómo funciona en la práctica

El editor desarrolla en una org especial llamada Developer Edition con un espacio de nombres (namespace) registrado, por ejemplo "acme". Todos los componentes del paquete quedan prefijados (acme__Factura__c) para evitar colisiones con los objetos del cliente o de otros paquetes instalados en la misma org. Cuando el paquete está listo, se publica una versión (1.0, 1.1, 2.0) y se obtiene un enlace de instalación o un listado en AppExchange. El cliente instala esa versión en su org; más adelante, cuando el editor publica una mejora, puede enviar una actualización (push o pull) que respeta los datos y las personalizaciones existentes.

Por qué importa

El valor central es el modelo de actualización controlada. En un paquete gestionado, el editor decide qué componentes son modificables por el cliente y cuáles quedan bloqueados; así puede corregir un bug o agregar una función sin que el cliente pierda lo que configuró encima. Para una empresa que compra una app en AppExchange, esto significa que recibe mejoras continuas sin reinstalar nada. Para el partner que la vende, significa proteger su propiedad intelectual y mantener una base de clientes con una sola línea de código.

Gestionado vs no gestionado

La diferencia es decisiva y conviene tenerla clara antes de elegir el formato:

En resumen: si el objetivo es distribuir un producto y mantenerlo, se usa gestionado; si es compartir un punto de partida que cada quien va a modificar libremente, se usa no gestionado.

Ejemplo concreto en LATAM

Una empresa argentina de software construye un módulo de facturación electrónica que conecta Salesforce con AFIP. Lo empaqueta como paquete gestionado con el namespace "factarg", lo publica en AppExchange y lo instalan distribuidoras de Córdoba, Rosario y Buenos Aires. Cuando AFIP cambia el esquema de la factura, el editor publica la versión 2.3 del paquete y la actualización llega a las tres distribuidoras sin que ninguna toque su configuración de objetos ni pierda sus reglas de validación propias. Sin el modelo gestionado, cada cambio normativo exigiría una intervención manual cliente por cliente.

Errores comunes

• Confundir un paquete gestionado con una simple exportación de metadatos: el gestionado implica registrar un namespace, lo cual es irreversible una vez asociado a la org de desarrollo.
• Pensar que el cliente puede editar el código instalado: en un gestionado, el Apex queda protegido y solo es modificable lo que el editor expone como configurable.
• Olvidar las pruebas: Salesforce exige cobertura de tests de Apex para poder empaquetar, y los governor limits del cliente siguen aplicando al código del paquete.
• Subestimar la revisión de seguridad: publicar en AppExchange requiere pasar el Security Review de Salesforce, que puede tardar semanas.

Hoy conviven dos generaciones de empaquetado: los paquetes gestionados de primera generación (1GP, atados a una org de empaquetado) y los unlocked/second-generation (2GP), basados en código fuente y mejor integrados con control de versiones moderno. Para productos comerciales nuevos, el camino recomendado por Salesforce es el de segunda generación.