Dova Docs22.0.5
Suporte

Catálogo versionado e ofertas por tenant

Crie versões comerciais revisadas e ofertas com vigência sem reescrever os termos históricos de pedidos e assinaturas.

Manual completo em PDF
Nesta página
  1. Entender o modelo comercial
  2. Entidades e unidades
  3. Criar ou revisar condições do catálogo
  4. Configurar uma oferta de tenant
  5. Exemplo e recuperação

Entender o modelo comercial

Subscription & billing → Global catalog define produtos, planos, versões publicadas e preços compartilhados. Tenant offers aplica condições ao tenant selecionado por referência a essas entidades, sem duplicar o catálogo. Confirme a autoridade de gerenciamento global e o tenant antes de alterar qualquer registro.

Os termos publicados permanecem associados à sua versão. Uma revisão começa como rascunho, e um preço já usado pode exigir New price em vez da edição do valor histórico. Versão comercial, versão de concorrência do registro e versão Dova 22.0.5 representam conceitos diferentes. O manual não estabelece uma tabela de preços fixa: prevalecem o plano e o contrato vigentes.

Entidades e unidades

Entidade ou campoO que revisar
ProductIdentidade e apresentação do produto, disponibilidade e versão atual do registro.
Plan / Published plan versionIdentidade estável do plano e termos da revisão comercial publicada.
PriceVersão vinculada, moeda, intervalo, tratamento tributário, disponibilidade e valor.
TenantOfferTenant, preço publicado, tipo de oferta, vigência e estado.
Order / SubscriptionTermos contratuais preservados para o pedido ou assinatura.
Amount (minor units)Unidades monetárias menores inteiras. Para PEN, 12.300 representam S/ 123,00.
Tax rate / discount (basis points)Pontos-base: 100 correspondem a 1%; 1.000 correspondem a 10%.

Criar ou revisar condições do catálogo

  1. Abra Global catalog e consulte produtos, planos, versões e preços usando busca, filtros, Columns e View.
  2. Quando autorizado, use New product ou New plan e preencha identidade e descrição.
  3. Em um plano ou versão elegível, escolha New draft para preparar a revisão.
  4. Revise limites e direitos do rascunho. Nos campos JSON, respeite o formato de objeto e os tipos de valor indicados pelo editor.
  5. Salve, consulte o rascunho e compare com a revisão anterior. Use Publish ou Publish version somente após a revisão.
  6. Use New price para a Published plan version correta.
  7. Revise Amount (minor units), Currency, Billing interval, Tax behavior e Tax rate (basis points); confirme o preço salvo.

Não corrija condições publicadas sobrescrevendo contratos históricos. Crie uma nova revisão e um novo preço quando necessário. Retirar disponibilidade pelo fluxo Retire não equivale a apagar o histórico. Antes de publicar, confira o resumo do pedido completo, pois um valor isolado não informa o total final com tributos.

Configurar uma oferta de tenant

  1. Selecione o Tenant e abra Tenant offers.
  2. Leia o escopo e use Reload offers se outro administrador puder ter alterado registros.
  3. Escolha New offer ou edite uma oferta elegível.
  4. Selecione Published price e confira a moeda apresentada como somente leitura.
  5. Escolha Offer type: desconto em pontos-base ou valor negociado em unidades menores.
  6. Defina Valid from (UTC), Valid until (UTC) quando necessário e Status. Confira a janela e a combinação comercial.
  7. Salve, recarregue as ofertas do mesmo tenant e valide o preço efetivo na visão comercial aplicável.

Sem oferta elegível, aplicam-se os preços públicos correspondentes. Uma oferta não modifica o preço de outro cliente nem altera retroativamente um pedido anterior. Condições de vigência e sobreposição são validadas pelo fluxo; revise o conflito apresentado em vez de alterar identificadores ou versões manualmente.

Exemplo e recuperação

Em um catálogo de laboratório, publique uma revisão A e um preço fictício em PEN. Crie uma oferta para apenas um tenant e um pedido simulado com esses termos. Prepare uma revisão B e confira que o pedido A preserva as condições originais e que outro tenant continua com o preço aplicável a ele. Use apenas fixtures ou sandbox, sem dados de cartão ou cobrança real.

Se o editor informar mudança concorrente, preserve o que estava sendo proposto, feche, recarregue o catálogo ou as ofertas e revise o registro atual. Se acesso ou tenant mudaram, reabra no escopo autorizado. Uma condição legada incompleta exige revisão comercial, não preenchimento histórico com padrões atuais. Diante de resultado financeiro incerto, confira a operação aceita antes de iniciar outra.

Consulte também: Subscription & billing, Tenants, Audit.