Procedimento não ativa: "a data e hora de início da versão" e a definição de contexto
O procedimento está certo, a simulação passa, e o botão Ativar recusa. O problema é uma data: a versão começa antes da definição de contexto que ela usa.
Ao ativar um procedimento de precificação ligado a uma definição de contexto estendida, a org pede para a versão começar depois da definição de contexto. Por que acontece com contexto recém-criado e como acertar a data.
A versão começa antes do contexto
- Procedimento não ativa · Erros e soluções no ARM · 6
- O contexto vem primeiro · Regra: Início da versão depois do início do contexto; Extensão recém-criada começa na hora da criação; Tela no fuso do usuário, metadado em UTC
- A vigência do contexto · Definições personalizadas
- Dois caminhos · Solução: Versão do procedimento para depois; Vigência do contexto para antes; No metadado: startDate em UTC
- Contexto antes, procedimento depois: Ative a extensão primeiro; Recriou o contexto? Revise as versões
Você estende a SalesTransactionContext, aponta o procedimento de precificação para a definição nova, a simulação passa e, no construtor do procedimento, clica em Ativar. A org recusa.
A mensagem
Encontramos um obstáculo. Modifique as propriedades dessa versão para garantir que a data e hora de início da versão sejam posteriores à data de início da definição de contexto usada na versão.
Onde aparece
Ao ativar uma versão de procedimento de precificação que usa uma definição de contexto estendida. Na org do guia, aconteceu com o procedimento Precificação Órbita, ligado à extensão OrbitaSalesTransaction.
Por que acontece
A versão do procedimento e a definição de contexto têm, cada uma, sua data de início. A regra é que o contexto já exista quando a versão começa: a data e hora de início da versão precisam ser posteriores ao início da vigência da definição de contexto.
O caso típico é o da org do guia: a extensão foi criada no mesmo dia, e o início da vigência dela ficou na hora da criação. A versão do procedimento tinha uma data de início anterior a essa hora.
Como resolver
Há dois caminhos, e a ajuda da Salesforce indica o segundo como regra ao estender o contexto:
- Mover a versão para depois. Nas propriedades da versão do procedimento, ajuste a data e hora de início para depois do início da vigência do contexto. Na org do guia, a versão passou a começar às 01:05, cinco minutos depois do contexto.
- Mover o contexto para antes. Ao editar a definição estendida, defina o início da vigência antes da data de início do procedimento. É o passo que a ajuda inclui no roteiro de extensão.
Se você mantém o procedimento em metadado, a data fica no campo startDate da versão, em UTC. As 01:05 da org em português viraram:
<startDate>2026-10-06T04:05:00.000Z</startDate>Atenção ao fuso: a tela mostra o horário do usuário, o metadado guarda UTC. No Brasil, três horas de diferença bastam para a versão parecer depois na tela e estar antes no metadado.
Como evitar
Crie e ative a extensão do contexto antes de criar o procedimento, e só então crie a versão. Se a extensão for recriada, revise a data de todas as versões que usam essa definição. O passo a passo está no laboratório 5 do guia Agentforce Revenue Management.
Fontes
- Salesforce Help, Extend the Sales Transaction Context Definition.
- Configurações observadas na org Winter '27 usada no guia.
Reproduzido numa scratch org Winter '27, API 68.0, em português.
A resposta sai do que está publicado aqui. Se não estiver, ele diz que não sabe em vez de inventar.