Radar
Revenue Cloud
Relevância
85
alta

"Certifique-se de que as marcas estejam na mesma hierarquia pai": o mapeamento automático errou

O botão Gerar marcações de contexto sugeriu marcas do ativo para uma etapa da linha da cotação. O construtor só percebe ao salvar, e a correção é variável por variável.

Por Guilherme Dornelas06 de outubro de 20264 min de leitura
// Compartilhar
Guia · Parte 4 de 9
Erros e soluções no Agentforce Revenue Management
Ver guia
"Certifique-se de que as marcas estejam na mesma hierarquia pai": o mapeamento automático errou

O erro do construtor de Pricing Procedure quando o mapeamento sugerido mistura marcas do ativo com marcas do item de linha, como ler a mensagem e qual marca usar em cada variável.

// Apresentação · 5 slides
← → para navegar · F para tela cheia
●Erros e soluções no ARM · 4
Marcas fora da hierarquia

O mapeamento automático escolheu a marca errada

Guilherme Dornelas
Solution Architect · Salesforce MVP
GD · Guilherme Dornelas · Solution Architect · Salesforce MVP01 / 05
1 / 5
  1. Marcas fora da hierarquia · Erros e soluções no ARM · 4
  2. A mensagem · Construtor do procedimento
  3. Mais de um nó com o mesmo nome · Causa: Quantidade e entrada de preço existem no ativo e na linha; A etapa da cotação trabalha em SalesTransactionItem; A sugestão escolheu pelo nome
  4. Remapear pela linha · Solução: Limpe a marca de cada variável citada; Escolha o caminho que começa em SalesTransactionItem; Salve de novo
  5. Confira o caminho da marca: Nome igual não é nó igual; Cotação usa o nó da linha

O construtor de procedimento de precificação tem um botão que parece resolver a parte chata: Gerar marcações de contexto. Ele preenche as marcas de todas as variáveis de uma etapa com um clique. Na minha org, ele acertou quase tudo e errou duas variáveis do Preço de lista. O erro só apareceu ao salvar.

A mensagem

Certifique-se de que as marcas [CurrentQuantity, AASPricebookEntryId] das variáveis [Quantity, Id] no elemento Preodelista estejam na mesma hierarquia pai que a marca de Item de linha na definição de contexto e tente novamente.

Aviso Encontramos um obstáculo citando as marcas CurrentQuantity e AASPricebookEntryId das variáveis Quantity e Id no elemento Preodelista
(1) a mensagem lista as marcas erradas, as variáveis afetadas e a etapa pelo nome interno. Print próprio, org Winter '27.

Como ler a mensagem

  • [CurrentQuantity, AASPricebookEntryId] são as marcas que estão erradas.
  • [Quantity, Id] são as variáveis da etapa que receberam essas marcas, pelo nome em inglês.
  • Preodelista é o nome interno da etapa Preço de lista, sem acento nem espaço.
  • Item de linha é a referência: todas as marcas da etapa precisam estar debaixo do mesmo nó da marca LineItem.

Por que acontece

A definição de contexto de vendas tem mais de um nó com quantidade e entrada de preço. CurrentQuantity e AASPricebookEntryId são marcas do lado do ativo (AssetTag e AssetActionSource). A etapa da cotação trabalha no nó SalesTransactionItem, o da linha. A sugestão automática escolheu a marca certa pelo nome e errada pelo lugar.

E ela não é determinística. Na mesma org, com as mesmas etapas, a Quantidade já saiu mapeada para LineItemQuantity numa tentativa e para CurrentQuantity em outra.

Como resolver

  1. Abra a etapa citada na mensagem.
  2. Em cada variável listada, limpe a marca (o X no campo) e busque pelo nome da marca da linha.
  3. Escolha a opção cujo caminho começa por SalesTransactionItem. A lista mostra o caminho de cada marca, por exemplo SalesTransactionItem > LineItemQuantity e AssetTag > CurrentQuantity.
  4. Salve de novo.
VariávelSugestão erradaMarca certa
Quantidade (Quantity)CurrentQuantityLineItemQuantity
ID da entrada da tabela de preços (Id)AASPricebookEntryIdItemPricebookEntry

Como evitar

Use Gerar marcações de contexto como rascunho e revise variável por variável antes de salvar. A regra prática: numa etapa que calcula preço de linha da cotação, toda marca tem que estar no SalesTransactionItem ou acima dele, nunca no ramo do ativo.

O mapeamento completo de cada etapa, conferido com a Trailhead, está na laboratório 2 do guia Agentforce Revenue Management.

Reproduzido numa scratch org Winter '27, API 68.0, em português, com uma definição de contexto estendida da SalesTransactionContext.

Pergunte sobre este artigo

A resposta sai do que está publicado aqui. Se não estiver, ele diz que não sabe em vez de inventar.

// Radar Salesforce — Newsletter

Releases, Flow, Revenue Cloud e Agentforce — com leitura de arquiteto, direto no seu e-mail.

Curadoria editorial em PT-BR, sem repost de notícia. Você recebe contexto, “por que importa” e como aplicar — assinada por mim.

Sem spam. Cancele quando quiser, em 1 clique.

// Sem spam · cancele quando quiser