Skip to main content

​
Esquema

CampoTipoDescrição
billingThresholdIdUUIDv7Identificador único
namestringNome, máx 255
descriptiontextDescrição
valueintegerLimite em centavos (positivo)
currencyenumUSD, BRL, EUR
statusenumACTIVE, INACTIVE
createdByUUIDv7Criador
createdAtdatetimeCriação
updatedByUUIDv7Último atualizador
updatedAtdatetimeÚltima atualização
deletedByUUIDv7?Quem deletou
deletedAtdatetime?Soft delete
Billing thresholds são entidades globais reutilizáveis — uma mesma configuração de threshold pode ser aplicada a múltiplas organizações. Quando uma organização recebe um threshold, um snapshot é capturado na invoice para registro histórico (InvoiceBillingThreshold).

​
Relacionamentos

  • Referenced by Organization
  • Referenced by InvoiceBillingThreshold (snapshot no momento da invoice)

​
Regras de Negócio

  • Valor deve ser positivo
  • Usado no cálculo de invoices antecipadas de uso
  • Snapshot capturado na criação da invoice (InvoiceBillingThreshold)
Configure thresholds progressivos para diferentes perfis de cliente. Exemplo: R500paracontasnovas,R500 para contas novas, R2.000 para contas estabelecidas, R$10.000 para enterprise. Isso equilibra risco de inadimplência com experiência do cliente.
O valor do threshold é sempre em centavos. Um threshold de R$1.000,00 deve ser configurado como value: 100000. O snapshot na InvoiceBillingThreshold garante que alterações futuras no threshold não afetem invoices já emitidas.

​
Exemplo

{
  "billingThresholdId": "019529e6-8b90-7e0c-a9d7-3f5b1d7e9a2c",
  "name": "Threshold Padrão — PME",
  "description": "Limite de gasto para pequenas e médias empresas. Gera invoice antecipada ao atingir R$1.000 de consumo acumulado.",
  "value": 100000,
  "currency": "BRL",
  "status": "ACTIVE",
  "createdBy": "019525fc-1234-7a1b-8c2d-3e4f5a6b7c8d",
  "createdAt": "2026-01-05T10:00:00Z",
  "updatedBy": "019525fc-1234-7a1b-8c2d-3e4f5a6b7c8d",
  "updatedAt": "2026-01-05T10:00:00Z"
}