Skip to content
CPQ DevKit™
CPQ DevKit™ for Salesforce
Salesforce CPQ

Construa scripts QCP para Salesforce 5X mais rápido

Assistência de IA para desenvolvimento de QCP, além de diff, backup, importação/exportação, implantação e automação confiável de pull/push.

Instalar no VS CodeEntrar para usar a IAVer recursosChangelog

macOS • Windows • Linux

A extensão nº 1 do VS Code para desenvolvedores Salesforce CPQ. Desenvolva, sincronize, compare, faça backup e deploy de scripts do Quote Calculator Plugin (QCP) e da configuração CPQ — tudo a partir do VS Code.

CPQ DevKit Commands

Início rápido

  1. Instale a extensão pelo VS Code Marketplace
  2. Abra uma pasta e execute CPQ DevKit™ for Salesforce: Initialize Project
  3. Autentique-se na sua org Salesforce via OAuth
  4. Comece a programar — puxe os arquivos QCP para src/, faça alterações e envie-as de volta!

A extensão também gera tsconfig.json, package.json, .env, arquivos QCP de exemplo e modelos de testes unitários para que você comece a escrever e testar scripts QCP imediatamente.

Estrutura do projeto

Initialize Project cria e mantém os arquivos principais usados pela extensão:

  • .cpqdevkit/sfcpq/qcp-config.json para os metadados do projeto e de autenticação
  • .cpqdevkit/sfcpq/qcp-log.json para o histórico de pull/push
  • src/ para os arquivos-fonte QCP locais
  • modelos em tests/ e downloads de QuoteModel para testes locais
  • tsconfig.json, package.json, .env e arquivos de exemplo conforme necessário

A extensão também inclui um walkthrough integrado para que novos workspaces possam fazer login, inicializar e puxar seus primeiros registros QCP com o mesmo fluxo de onboarding apresentado no site.

Novidades da versão 2.6.3

  • Comandos de conversão de arquivos (JSON / XML / CSV) compartilhados entre as extensões DevKit
  • Auxiliares de análise de backup para insights mais ricos sobre os backups
  • Conteúdo do walkthrough e conjunto de ícones do explorer atualizados

Consulte as notas de versão completas em CHANGELOG.md.

Funcionalidades

Sync bidirecional de QCP

Envie (push) e receba (pull) scripts do Quote Calculator Plugin entre o VS Code e o Salesforce. Edite localmente com suporte completo do IDE (IntelliSense, linting, formatação) e sincronize as alterações em um clique.

  • Pull QCP records — baixar todos os scripts QCP do Salesforce
  • Pull active file — atualizar o arquivo aberto atualmente a partir do Salesforce
  • Push QCP files — enviar todas as alterações locais para o Salesforce
  • Push active file — enviar apenas o arquivo em que você está trabalhando
  • Push on save — opcionalmente, perguntar se deve enviar ao salvar um arquivo

Diff e comparação

Compare arquivos locais com seus equivalentes no Salesforce para revisar as alterações antes do push, ou compare dois arquivos locais lado a lado.

Backup e exportação

Crie backups abrangentes de toda a sua configuração CPQ:

  • Create CPQ Configuration Backup — backup completo de QCP, Price Rules, Product Rules e Discount Schedules
  • Export QCP Records — exportar todos os scripts QCP
  • Export Price Rules — exportar Price Rules com condições e ações
  • Export Product Rules — exportar regras de Selection, Validation e Alert
  • Export Discount Schedules — exportar schedules com faixas (tiers)
  • Export Products — exportar registros Product2 com campos CPQ (CSV ou JSON)

Importação e deploy

Migre configurações CPQ entre orgs. Exporte do sandbox, importe na produção.

  • Import Price Rules — importar de arquivos JSON exportados com lógica de upsert (cria novos, atualiza os existentes por Name)
  • Import Product Rules — fazer deploy de Product Rules entre orgs
  • Import Discount Schedules — restaurar schedules a partir do backup, com suporte a faixas
  • Deploy CPQ Configuration — deploy completo da configuração a partir dos arquivos de backup
  • Modo dry-run — pré-visualizar as alterações antes de aplicá-las

Inspeção de org e revisão de divergências

Ofereça a consultores e equipes de suporte uma forma mais rápida de entender uma org antes de alterá-la:

  • Inspect Org — gerar um relatório em Markdown com detalhes de pacote/versão, configurações CPQ, contagens de configuração e complexidade das regras de pricing
  • Compare Snapshots — comparar dois arquivos JSON de backup/exportação CPQ para identificar registros QCP, regras, schedules e templates ausentes ou alterados

Completions de código com IA

Receba sugestões de código inteligentes e sensíveis ao contexto para o desenvolvimento QCP (plano Pro):

  • Completions para onBeforeCalculate, onAfterCalculate e outros métodos de callback do QCP
  • Entende QuoteModel, QuoteLineModel e os campos do Salesforce CPQ
  • Com tecnologia GPT-4o ou Claude 3.5 Sonnet (configurável)
  • Uma pequena janela de código ao redor do cursor é enviada quando as completions são acionadas

Onboarding guiado

Use o walkthrough integrado para fazer login, inicializar um projeto e puxar seus primeiros registros QCP sem precisar procurar pelos comandos manualmente.

Testes unitários

Teste seus scripts QCP localmente usando dados reais de QuoteModel obtidos do Salesforce — detecte problemas antes do deploy.

Visualização de JSON em tabela

Abra qualquer arquivo JSON como uma tabela interativa usando o botão da barra de título do editor (com tecnologia AG Grid).

Ferramentas de solução de problemas

  • Validate Org Credentials — verificar se suas credenciais atuais do Salesforce ainda funcionam
  • Open Project Configuration — ir para .cpqdevkit/sfcpq/qcp-config.json
  • Open Sync Log — ir para .cpqdevkit/sfcpq/qcp-log.json
  • Copy Diagnostics — copiar informações de ambiente e configurações para a área de transferência, para depuração ou suporte

Comandos

Todos os comandos estão disponíveis na Command Palette (Ctrl+Shift+P / Cmd+Shift+P) na categoria CPQ DevKit™ for Salesforce.

ComandoDescrição
Sign InAutenticar-se nos serviços do CPQ DevKit
Sign OutSair dos serviços do CPQ DevKit
Initialize ProjectConfigurar a estrutura do projeto e autenticar-se no Salesforce
Create Example QCP FilesGerar scripts QCP de exemplo no seu projeto
Pull QCP RecordsBaixar todos os scripts QCP do Salesforce
Pull Active FileAtualizar o arquivo atual a partir do Salesforce
Push QCP FilesEnviar todas as alterações locais para o Salesforce
Push Active FileEnviar o arquivo atual para o Salesforce
Compare RecordsComparar (diff) os scripts QCP locais com os remotos
Compare Active FileComparar (diff) o arquivo atual com seu registro no Salesforce
View Transpiled CodeVisualizar o JavaScript transpilado do arquivo ativo
Open QCP Record in SalesforceAbrir o registro no seu navegador
Create BackupCriar um backup local dos arquivos QCP
Download QuoteModelBuscar um QuoteModel do Salesforce para testes locais
Export ProductsExportar registros Product2 para CSV ou JSON
View as TableExibir um arquivo JSON em uma tabela interativa
Create CPQ Configuration BackupBackup completo de QCP, Price Rules e Product Rules
Export QCP RecordsExportar todos os scripts QCP
Export Price RulesExportar Price Rules com condições/ações
Export Product RulesExportar Product Rules
Export Discount SchedulesExportar Discount Schedules com faixas
List BackupsNavegar pelos backups anteriores
Import Price RulesImportar Price Rules de um arquivo exportado
Import Product RulesImportar Product Rules de um arquivo exportado
Import Discount SchedulesImportar Discount Schedules de um arquivo exportado
Deploy CPQ ConfigurationFazer deploy de uma configuração CPQ completa no Salesforce
Inspect OrgGerar um relatório de inspeção da org voltado a consultores
Compare SnapshotsComparar dois backups/exportações CPQ em busca de divergências
Set AI API KeyConfigurar sua chave de API para as completions de IA
Toggle AI CompletionsAtivar ou desativar as sugestões de código com IA
Clear AI API KeyRemover sua chave de API armazenada
Open Project ConfigurationAbrir qcp-config.json
Open Sync LogAbrir qcp-log.json
Copy DiagnosticsCopiar informações de ambiente para a área de transferência
Validate Org CredentialsTestar se suas credenciais do Salesforce são válidas

Configurações

Configure a extensão em sfdcQcp.* nas configurações do VS Code.

ConfiguraçãoPadrãoDescrição
sfdcQcp.pushOnSavefalsePerguntar se deve enviar o arquivo para o Salesforce ao salvar
sfdcQcp.saveLogtrueSalvar uma entrada de log para cada operação de push/pull
sfdcQcp.maxLogEntries150Número máximo de entradas no log de sync
sfdcQcp.prettiertrueCriar um arquivo .prettierrc na inicialização do projeto
sfdcQcp.prettierConfig(veja abaixo)Objeto de configuração do Prettier
sfdcQcp.export.outputFormat"csv"Formato de exportação para as exportações de dados (csv ou json)
sfdcQcp.debugModefalseAtivar logging de depuração detalhado
sfdcQcp.enableTelemetryfalseAtivar a telemetria anônima do produto (nunca inclui o conteúdo dos arquivos nem dados CPQ)
sfdcQcp.aiCompletionsEnabledtrueAtivar as completions de código com IA (requer o plano Pro)
sfdcQcp.aiModel"gpt-4o"Modelo de IA para as completions (gpt-4o ou claude-3-5-sonnet)
sfdcQcp.apiBaseUrl"https://app.cpqdevkit.com/api"URL base da API do CPQ DevKit
sfdcQcp.requestTimeout30000Tempo limite em ms para as requisições à API do Salesforce (5 000–120 000)
sfdcQcp.export.products.outputFormat"csv"Formato de exportação padrão para as exportações de Product2 (csv ou json)
sfdcQcp.export.products.fields(lista de campos integrada)Campos padrão de Product2 e do Salesforce CPQ a incluir ao exportar produtos

Requisitos

  • VS Code 1.105+
  • Org Salesforce com o pacote gerenciado CPQ instalado
  • Acesso aos registros de Custom Script (QCP) na sua org

Segurança e privacidade

  • Autenticação OAuth — nenhuma senha é armazenada
  • As credenciais são criptografadas com uma chave exclusiva do workspace e armazenadas localmente
  • .cpqdevkit/sfcpq e .env são adicionados automaticamente ao .gitignore
  • Backup/Import/Deploy e as completions de IA se comunicam com os serviços do CPQ DevKit (sfdcQcp.apiBaseUrl)
  • As completions de IA enviam apenas uma pequena janela de código ao redor do cursor quando ativadas

Política de Privacidade

Documentação

Suporte

Licença

Consulte LICENSE.md para mais detalhes.

Perguntas frequentes

O que é o CPQ DevKit™ for Salesforce?

Uma extensão do VS Code que simplifica o desenvolvimento do Quote Calculator Plugin (QCP) do Salesforce CPQ com workflows de pull/push, ferramentas de backup e deploy de configuração, completions de IA e utilitários de teste local.

Como me conecto à minha org?

Use Initialize Project para se autenticar via OAuth, criar a estrutura local do projeto e salvar a configuração do workspace de que a extensão precisa.

Posso comparar, fazer backup e deploy da configuração CPQ?

Sim. A extensão oferece suporte a comparação de registros, backups locais e completos de CPQ, exportação de produtos e workflows de importação/exportação/deploy para QCP, Price Rules, Product Rules e Discount Schedules.

Quais sistemas operacionais são suportados?

macOS, Windows e Linux.

Salesforce, Salesforce CPQ e marcas relacionadas são marcas da Salesforce, Inc. O CPQ DevKit™ não é endossado pela Salesforce nem afiliado a ela.