Skip to content
CPQ DevKit™ for Salesforce
Salesforce CPQ

Cree scripts QCP de Salesforce 5X más rápido

Asistencia de IA para el desarrollo de QCP, además de diff, backup, importación/exportación, despliegue y automatización pull/push fiable.

macOS • Windows • Linux

La extensión de VS Code número 1 para desarrolladores de Salesforce CPQ. Desarrolle, sincronice, compare, respalde y despliegue scripts de Quote Calculator Plugin (QCP) y la configuración de CPQ, todo desde VS Code.

CPQ DevKit Commands

Inicio rápido

  1. Instale la extensión desde el VS Code Marketplace
  2. Abra una carpeta y ejecute CPQ DevKit™ for Salesforce: Initialize Project
  3. Autentíquese en su org de Salesforce mediante OAuth
  4. Comience a programar: descargue los archivos QCP a src/, realice cambios y vuelva a subirlos

La extensión también genera tsconfig.json, package.json, .env, archivos QCP de ejemplo y plantillas de pruebas unitarias para que pueda empezar a escribir y probar scripts QCP de inmediato.

Estructura del proyecto

Initialize Project crea y mantiene los archivos principales que utiliza la extensión:

  • .cpqdevkit/sfcpq/qcp-config.json para los metadatos del proyecto y de autenticación
  • .cpqdevkit/sfcpq/qcp-log.json para el historial de pull/push
  • src/ para los archivos fuente QCP locales
  • Plantillas en tests/ además de descargas de QuoteModel para pruebas locales
  • tsconfig.json, package.json, .env y archivos de ejemplo según sea necesario

La extensión también incluye un walkthrough integrado para que los nuevos workspaces puedan iniciar sesión, inicializarse y descargar sus primeros registros QCP con el mismo flujo de onboarding que se muestra en el sitio web.

Novedades de la versión 2.6.3

  • Comandos de conversión de archivos (JSON / XML / CSV) compartidos entre las extensiones de DevKit
  • Ayudas de análisis de copias de seguridad para obtener información más completa
  • Contenido del walkthrough renovado y nuevo conjunto de iconos del explorador

Consulte las notas de versión completas en CHANGELOG.md.

Funcionalidades

Sincronización QCP bidireccional

Suba y descargue scripts de Quote Calculator Plugin entre VS Code y Salesforce. Edite localmente con todas las prestaciones del IDE (IntelliSense, linting, formateo) y sincronice los cambios con un solo clic.

  • Pull QCP records — descargar todos los scripts QCP desde Salesforce
  • Pull active file — actualizar el archivo abierto actualmente desde Salesforce
  • Push QCP files — subir todos los cambios locales a Salesforce
  • Push active file — subir solo el archivo en el que está trabajando
  • Push on save — opcionalmente, preguntar si desea subir el archivo al guardarlo

Diff y comparación

Compare los archivos locales con sus equivalentes en Salesforce para revisar los cambios antes de subirlos, o compare dos archivos locales en paralelo.

Copia de seguridad y exportación

Cree copias de seguridad completas de toda su configuración de CPQ:

  • Create CPQ Configuration Backup — copia de seguridad completa de QCP, Price Rules, Product Rules y Discount Schedules
  • Export QCP Records — exportar todos los scripts QCP
  • Export Price Rules — exportar Price Rules con condiciones y acciones
  • Export Product Rules — exportar reglas de Selection, Validation y Alert
  • Export Discount Schedules — exportar schedules con niveles (tiers)
  • Export Products — exportar registros Product2 con campos de CPQ (CSV o JSON)

Importación y despliegue

Migre configuraciones de CPQ entre orgs. Exporte desde el sandbox e importe a producción.

  • Import Price Rules — importar desde archivos JSON exportados con lógica de upsert (crea registros nuevos y actualiza los existentes por Name)
  • Import Product Rules — desplegar Product Rules entre orgs
  • Import Discount Schedules — restaurar schedules desde una copia de seguridad con compatibilidad de niveles
  • Deploy CPQ Configuration — despliegue completo de la configuración a partir de archivos de copia de seguridad
  • Modo dry-run — previsualizar los cambios antes de aplicarlos

Inspección de orgs y revisión de desviaciones

Ofrezca a consultores y equipos de soporte una forma más rápida de entender una org antes de modificarla:

  • Inspect Org — generar un informe en Markdown con detalles de paquetes/versiones, configuración de CPQ, recuentos de configuración y complejidad de las reglas de pricing
  • Compare Snapshots — comparar dos archivos JSON de copia de seguridad/exportación de CPQ para detectar registros QCP, reglas, schedules y plantillas que falten o hayan cambiado

Autocompletado de código asistido por IA

Obtenga sugerencias de código inteligentes y contextuales para el desarrollo de QCP (plan Pro):

  • Sugerencias para onBeforeCalculate, onAfterCalculate y otros métodos de callback de QCP
  • Comprende QuoteModel, QuoteLineModel y los campos de Salesforce CPQ
  • Con tecnología de GPT-4o o Claude 3.5 Sonnet (configurable)
  • Al activarse las sugerencias se envía una pequeña ventana de código alrededor del cursor

Onboarding guiado

Utilice el walkthrough integrado para iniciar sesión, inicializar un proyecto y descargar sus primeros registros QCP sin tener que buscar comandos manualmente.

Pruebas unitarias

Pruebe sus scripts QCP localmente con datos reales de QuoteModel obtenidos desde Salesforce, y detecte problemas antes de desplegar.

Vista de tabla JSON

Abra cualquier archivo JSON como una tabla interactiva mediante el botón de la barra de título del editor (con tecnología de AG Grid).

Herramientas de solución de problemas

  • Validate Org Credentials — verificar que sus credenciales actuales de Salesforce siguen siendo válidas
  • Open Project Configuration — ir a .cpqdevkit/sfcpq/qcp-config.json
  • Open Sync Log — ir a .cpqdevkit/sfcpq/qcp-log.json
  • Copy Diagnostics — copiar la información del entorno y la configuración al portapapeles para depuración o soporte

Comandos

Todos los comandos están disponibles desde la Command Palette (Ctrl+Shift+P / Cmd+Shift+P) en la categoría CPQ DevKit™ for Salesforce.

ComandoDescripción
Sign InAutenticarse en los servicios de CPQ DevKit
Sign OutCerrar sesión en los servicios de CPQ DevKit
Initialize ProjectConfigurar la estructura del proyecto y autenticarse en Salesforce
Create Example QCP FilesGenerar scripts QCP de ejemplo en su proyecto
Pull QCP RecordsDescargar todos los scripts QCP desde Salesforce
Pull Active FileActualizar el archivo actual desde Salesforce
Push QCP FilesSubir todos los cambios locales a Salesforce
Push Active FileSubir el archivo actual a Salesforce
Compare RecordsComparar scripts QCP locales con los remotos
Compare Active FileComparar el archivo actual con su registro de Salesforce
View Transpiled CodeVer el JavaScript transpilado del archivo activo
Open QCP Record in SalesforceAbrir el registro en su navegador
Create BackupCrear una copia de seguridad local de los archivos QCP
Download QuoteModelObtener un QuoteModel desde Salesforce para pruebas locales
Export ProductsExportar registros Product2 a CSV o JSON
View as TableMostrar un archivo JSON en una tabla interactiva
Create CPQ Configuration BackupCopia de seguridad completa de QCP, Price Rules y Product Rules
Export QCP RecordsExportar todos los scripts QCP
Export Price RulesExportar Price Rules con condiciones/acciones
Export Product RulesExportar Product Rules
Export Discount SchedulesExportar Discount Schedules con niveles
List BackupsExplorar las copias de seguridad anteriores
Import Price RulesImportar Price Rules desde un archivo exportado
Import Product RulesImportar Product Rules desde un archivo exportado
Import Discount SchedulesImportar Discount Schedules desde un archivo exportado
Deploy CPQ ConfigurationDesplegar una configuración de CPQ completa en Salesforce
Inspect OrgGenerar un informe de inspección de la org orientado a consultores
Compare SnapshotsComparar dos copias de seguridad/exportaciones de CPQ para detectar desviaciones
Set AI API KeyConfigurar su clave de API para el autocompletado con IA
Toggle AI CompletionsActivar o desactivar las sugerencias de código con IA
Clear AI API KeyEliminar la clave de API almacenada
Open Project ConfigurationAbrir qcp-config.json
Open Sync LogAbrir qcp-log.json
Copy DiagnosticsCopiar la información del entorno al portapapeles
Validate Org CredentialsComprobar que sus credenciales de Salesforce son válidas

Configuración

Configure la extensión en sfdcQcp.* dentro de la configuración de VS Code.

ParámetroValor predeterminadoDescripción
sfdcQcp.pushOnSavefalsePreguntar si desea subir el archivo a Salesforce al guardarlo
sfdcQcp.saveLogtrueGuardar una entrada de registro por cada operación de push/pull
sfdcQcp.maxLogEntries150Número máximo de entradas en el registro de sincronización
sfdcQcp.prettiertrueCrear un archivo .prettierrc al inicializar el proyecto
sfdcQcp.prettierConfig(ver abajo)Objeto de configuración de Prettier
sfdcQcp.export.outputFormat"csv"Formato de exportación para las exportaciones de datos (csv o json)
sfdcQcp.debugModefalseActivar el registro de depuración detallado
sfdcQcp.enableTelemetryfalseActivar la telemetría anónima del producto (nunca incluye el contenido de los archivos ni los datos de CPQ)
sfdcQcp.aiCompletionsEnabledtrueActivar el autocompletado de código con IA (requiere el plan Pro)
sfdcQcp.aiModel"gpt-4o"Modelo de IA para el autocompletado (gpt-4o o claude-3-5-sonnet)
sfdcQcp.apiBaseUrl"https://app.cpqdevkit.com/api"URL base de la API de CPQ DevKit
sfdcQcp.requestTimeout30000Tiempo de espera en ms para las solicitudes a la API de Salesforce (5 000–120 000)
sfdcQcp.export.products.outputFormat"csv"Formato de exportación predeterminado para las exportaciones de Product2 (csv o json)
sfdcQcp.export.products.fields(lista de campos integrada)Campos predeterminados de Product2 y Salesforce CPQ que se incluyen al exportar productos

Requisitos

  • VS Code 1.105+
  • Org de Salesforce con el paquete gestionado de CPQ instalado
  • Acceso a los registros de Custom Script (QCP) en su org

Seguridad y privacidad

  • Autenticación OAuth — no se almacenan contraseñas
  • Las credenciales se cifran con una clave única por workspace y se almacenan localmente
  • .cpqdevkit/sfcpq y .env se agregan automáticamente a .gitignore
  • Las funciones de copia de seguridad/importación/despliegue y el autocompletado con IA se comunican con los servicios de CPQ DevKit (sfdcQcp.apiBaseUrl)
  • El autocompletado con IA envía únicamente una pequeña ventana de código alrededor del cursor cuando está activado

Política de privacidad

Documentación

Soporte

Licencia

Consulte LICENSE.md para más detalles.

Preguntas frecuentes

¿Qué es CPQ DevKit™ for Salesforce?

Una extensión de VS Code que agiliza el desarrollo de Quote Calculator Plugin (QCP) de Salesforce CPQ con flujos de trabajo de pull/push, herramientas de copia de seguridad y despliegue de la configuración, autocompletado con IA y utilidades de pruebas locales.

¿Cómo me conecto a mi org?

Utilice Initialize Project para autenticarse mediante OAuth, crear la estructura local del proyecto y guardar la configuración del workspace que necesita la extensión.

¿Puedo comparar, respaldar y desplegar la configuración de CPQ?

Sí. La extensión admite la comparación de registros, copias de seguridad locales y completas de CPQ, exportación de productos y flujos de trabajo de importación/exportación/despliegue para QCP, Price Rules, Product Rules y Discount Schedules.

¿Qué sistemas operativos son compatibles?

macOS, Windows y Linux.

Salesforce, Salesforce CPQ y las marcas relacionadas son marcas de Salesforce, Inc. CPQ DevKit™ no cuenta con el respaldo de Salesforce ni está afiliado a dicha empresa.