Preços interativos

Seu cliente escolhe no link o que inclui, qual alternativa quer e quanto, vê o total na hora e aprova o que escolheu.

O que é

Com os preços interativos, um único orçamento oferece opções. Em vez de enviar três versões da mesma proposta, você deixa seu cliente decidir no link:

Opção	O que faz no link	Exemplo
Opcional	Uma caixa para incluir ou tirar o item.	Treinamento, instalação ou garantia estendida.
Escolha um (grupo)	Os itens com o mesmo grupo são alternativas: seu cliente escolhe exatamente um.	Plano Básico, Profissional ou Premium.
Seu cliente ajusta a quantidade	Um seletor com − e + dentro do intervalo que você define.	Licenças de usuário de 5 a 50.

Um item pode combinar a quantidade com qualquer uma das outras duas: um item opcional ou uma alternativa de um grupo também podem deixar ajustar a quantidade. O que ele não pode é ser opcional e de um grupo ao mesmo tempo.

O total, os impostos, a entrada e o plano de pagamentos são recalculados no link na hora, com o mesmo motor que o Cord usa ao salvar, e ao aprovar fica assinado o que seu cliente escolheu. O preço unitário nunca muda: seu cliente escolhe o quê e quanto, não a que preço.

Requisitos

Plano: todos os planos. Não tem limite próprio.
Permissão: Orçamentos.
Documento: só orçamentos. As faturas não têm opções.
País: os 12 mercados.

Configure as opções no editor

No passo 2 do editor, O que você vai orçar?, adicione os itens como sempre (veja Produtos e preços).
No item que seu cliente poderá escolher, clique no botão Opções para seu cliente da linha, o do ícone de controles deslizantes. Abre o painel O que seu cliente pode escolher no link.
Marque o que seu cliente pode decidir: Opcional: seu cliente decide se inclui, Escolha um (grupo) ou Seu cliente ajusta a quantidade. Cada uma é explicada abaixo.
Clique em Pronto. A linha mostra suas etiquetas (por exemplo Opcional, Escolha um: Plano ou Quantidade 5–50) e o link Opções para seu cliente para abrir o painel de novo.
Salve ou envie o orçamento como sempre.

Tirar opções, no mesmo painel, transforma o item de volta em um item fixo.

Abaixo do total do resumo, o editor avisa: “O total é o da seleção com que o link abre; seu cliente pode mudá-lo.” O total salvo, a entrada e o plano de pagamentos são calculados com essa seleção inicial. A Prévia, no mesmo resumo, mostra o link como seu cliente vai vê-lo, com as opções e o total da seleção com que ele abre.

Opcional

Marque Opcional: seu cliente decide se inclui. Abaixo aparece Incluído ao abrir o link:

Marcado, o item abre incluído e seu cliente o tira se não quiser.
Desmarcado, o item abre de fora e seu cliente o adiciona se quiser. A linha do editor o marca como Não incluído ao abrir.

Escolha um (grupo)

Digite o mesmo nome em Escolha um (grupo) em cada alternativa, por exemplo “Plano”. O campo sugere os grupos que você já usa no orçamento e aceita até 80 caracteres. Na alternativa que deve abrir escolhida, marque Abre selecionado: o Cord desmarca as demais do mesmo grupo.

Para montar um grupo rápido, use Duplicar item em um item que já tem grupo: a cópia é outra alternativa do mesmo grupo e não abre selecionada. Digitar um grupo em um item opcional tira o Opcional, porque um item de um grupo já é uma escolha.

Seu cliente ajusta a quantidade

Marque Seu cliente ajusta a quantidade e digite o Mínimo e o Máximo. A quantidade do item é a que você propõe: o link abre com ela e ela precisa ficar dentro do intervalo. Se o mínimo, o máximo e a quantidade são inteiros, seu cliente ajusta de um em um; se algum tiver decimais, ele pode pedir uma quantidade com até quatro casas decimais.

O que o Cord verifica ao salvar

O Cord valida as opções ao salvar ou enviar, com a mesma regra no editor, na API e no link, para que seu cliente nunca receba uma escolha impossível. Se algo não fechar, o editor abre o painel do item e diz o que corrigir:

Um item de um grupo não pode ser também opcional.
Um grupo precisa de pelo menos dois itens e exatamente um que abra selecionado.
O mínimo e o máximo vão juntos. O mínimo é maior que zero e não passa do máximo, com até quatro casas decimais.
A quantidade do item fica dentro do seu intervalo.
Um item que não é opcional nem de um grupo sempre vai incluído.
Pelo menos um item fica incluído na seleção com que o link abre.

O que seu cliente vê no link

Acima dos itens, o link diz “Escolha o que você quer: o total é atualizado na hora e é o que você aprova.” Depois:

Item opcional: uma caixa ao lado do nome e a etiqueta Opcional.
Grupo: o título Escolha um com o nome do grupo e um botão de opção em cada alternativa; escolher uma desmarca a anterior.
Quantidade: um seletor com − e + e o intervalo abaixo, por exemplo “De 5 a 50”. Ao sair do campo, uma quantidade fora do intervalo é ajustada ao mínimo ou ao máximo.
Os demais itens ficam fixos: seu cliente não pode tirá-los.

Cada mudança recalcula na hora o valor da linha, o subtotal, o desconto no documento, os impostos, as retenções, o total, a entrada e o plano de pagamentos. Se o orçamento tem um plano de pagamentos com juros de financiamento e seu cliente muda a seleção, a tabela mostra só o total e o detalhamento fica no bloco do plano.

O que acontece ao aprovar

Ao aprovar, o link envia a escolha do seu cliente e o Cord a valida de novo no servidor contra o que você permitiu e recalcula o total. Uma escolha fora do permitido não é assinada: o link avisa ao seu cliente que a proposta mudou e recarrega a página para que ele escolha com as opções atuais.

Ao assinar:

O orçamento passa para Aprovado com o total do que foi escolhido: subtotal, impostos por item, retenções e desconto no documento, recalculados.
Cada item fica incluído ou não. Os que seu cliente deixou de fora ficam como Não incluído no link e no detalhe.
A quantidade escolhida é salva no item, e a que você propôs fica como “Proposta: 10”.
A atividade registra, por exemplo: “Assinado por “Ana Souza” com as opções que escolheu (BRL 21.500,00) (IP 203.0.113.24)”.
A impressão digital SHA-256 da assinatura eletrônica cobre os itens assinados com a sua quantidade e a seleção. Veja Aprovação e evidências.
A entrada é calculada sobre o total aprovado (veja Entrada e saldo).
Um plano de pagamentos por etapas é recalculado com o total aprovado, com as mesmas proporções e prazos. A linha de juros, se houver, não é escolhida: o Cord a recalcula com o que seu cliente aprova.
A cobrança e a fatura saem só do que foi escolhido.

O que você vê no detalhe e no PDF

No detalhe do orçamento, cada item com opções leva suas etiquetas: Opcional, Escolha um: Plano, Quantidade de 5 a 50 e, quando seu cliente mudou a quantidade, Proposta: 10. Antes que seu cliente decida, os itens que não abrem incluídos dizem Não escolhido.

Abaixo dos itens, uma nota diz o que acontece com eles. Antes de aprovar: “No link, seu cliente escolhe os itens opcionais, um de cada grupo e a quantidade onde você permite. O total é o da seleção com que o link abre.” Depois: “O cliente aprovou com as opções que escolheu: o total, a cobrança e a fatura incluem só o que foi escolhido.”

O PDF do orçamento leva as mesmas etiquetas ao lado da unidade de cada item.

Aprovações internas

Se a sua organização usa aprovações internas, o Cord mede a escolha que mais cobra: todos os itens opcionais incluídos, a alternativa de maior valor de cada grupo e cada quantidade no máximo. O limite de valor é comparado com o total dessa escolha, e os de desconto e margem com os itens dela. Assim seu cliente nunca escolhe algo que a gerência não viu.

Versões, duplicados e renovações

Modificar e reenviar: a nova versão abre com as opções da anterior e você pode mudá-las como qualquer item. O Cord as valida de novo ao enviá-la.
Duplicar orçamento: o rascunho conserva as opções e parte da seleção salva: a que o link abria ou, se seu cliente já aprovou, a que ele escolheu, com as quantidades.
Renovar: como no duplicado, a renovação conserva as opções e parte do que seu cliente escolheu.

Sem opções, um duplicado ou uma renovação levam todos os itens, como sempre.

Pela API, MCP e webhooks

POST /api/v1/cotizaciones e PATCH /api/v1/cotizaciones/{id} (este, só em um rascunho) aceitam em cada linha opcional, grupo, cantidad_min, cantidad_max e incluida, que diz se a linha abre selecionada (padrão true). Em um grupo, só uma linha vai com incluida: true e as demais com incluida: false; senão, a resposta é 400 invalid_options.
Opções que seu cliente não poderia escolher respondem 400 invalid_options e nada é salvo; a mensagem diz qual linha.
O detalhe traz em cada linha o id, as opções, incluida e cantidad_propuesta: a quantidade que você propôs se seu cliente a mudou, ou null.
No servidor MCP, crear_cotizacion_borrador aceita os mesmos campos e detalle_cotizacion os devolve.
O webhook quote.approved traz seleccion: cada item com id, descripcion, cantidad, cantidad_propuesta, incluida, opcional e grupo. É null se o orçamento não deixa escolher nada. Se o orçamento é marcado como aprovado no Cord, seleccion é a seleção com que o link abria.
Uma chave publicável (pk_), a que o Cord Elements usa, não define opções: o que seu cliente pode escolher é você quem decide.

Detalhes de cada campo na Referência da API, na API de Orçamentos e em Webhooks.

O que não faz

Não muda preços. Seu cliente escolhe o quê e quanto, nunca a que preço. Para negociar o preço existe a contraproposta.
Não convive com a aprovação parcial. Com alguma opção definida, os demais itens ficam fixos e seu cliente já não pode desmarcar qualquer item. Sem opções, o orçamento segue com a aprovação parcial de sempre.
Não vai em faturas. Só em orçamentos.

Limites por plano

Os preços interativos estão em todos os planos e não têm limite próprio. Cada orçamento mantém seu limite de 200 itens. As aprovações internas exigem Scale ou Developer.

Problemas comuns

Não vejo Opções para seu cliente. Você está no editor de uma fatura: as opções são só de orçamentos.

“O grupo “Plano” tem um só item.” Adicione outra alternativa com o mesmo nome de grupo (Duplicar item cria uma) ou apague o nome do grupo.

“Escolha qual item do grupo “Plano” abre selecionado.” Marque Abre selecionado em uma das alternativas.

“A quantidade do item 2 está fora do intervalo que você permite ao seu cliente.” Mude a quantidade do item ou o intervalo.

Meu cliente não consegue aprovar. O botão fica desativado se uma quantidade fica fora do intervalo ou se, com um plano de pagamentos, algum pagamento fica abaixo do valor mínimo de cobrança com essa escolha. Se você mudou a proposta enquanto ele a lia, primeiro ele precisa clicar em Ver alterações.

O total do resumo não soma todos os itens. É o esperado: é o total da seleção com que o link abre.