Skip to main content

​
Esquema

CampoTipoDescricao
organizationIdUUIDv7Identificador unico
billingThresholdIdUUIDv7FK para BillingThreshold
subscriptionIdUUIDv7?FK para Subscription
iamExternalRefstringReferencia da org no WorkOS
billingExternalRefstringReferencia do customer no Stripe
namestringNome, max 255 caracteres
emailstringEmail de cobranca, unico
currencyenumUSD, BRL, EUR
phonestring?Telefone
addressobject?Endereco de cobranca
taxIdstring?Documento fiscal
taxTypeenum?CPF ou CNPJ
createdByUUIDv7ID do usuario criador
createdAtdatetimeTimestamp de criacao
updatedByUUIDv7Ultimo atualizador
updatedAtdatetimeUltima atualizacao

​
Exemplo

{
  "organizationId": "019525fd-8b21-7d3c-a1f5-3c7e9b1d5f8a",
  "billingThresholdId": "019525fd-9c32-7e4d-b2a6-4d8f0c2e6a9b",
  "subscriptionId": "019525fd-ad43-7f5e-c3b7-5e9a1d3f7b0c",
  "iamExternalRef": "org_01JK8QWERTY67890FGHIJ",
  "billingExternalRef": "cus_Rk4x7mN2pL9qWs",
  "name": "TechBrasil Ltda",
  "email": "financeiro@techbrasil.com.br",
  "currency": "BRL",
  "phone": "+5511999887766",
  "address": {
    "line1": "Av. Paulista, 1000",
    "line2": "Sala 1201",
    "city": "Sao Paulo",
    "state": "SP",
    "postalCode": "01310-100",
    "country": "BR"
  },
  "taxId": "12.345.678/0001-90",
  "taxType": "CNPJ",
  "createdBy": "019525fd-7e40-7c5a-b2d8-4e6f8a0c2e4a",
  "createdAt": "2026-01-15T10:35:00Z",
  "updatedBy": "019525fd-7e40-7c5a-b2d8-4e6f8a0c2e4a",
  "updatedAt": "2026-03-20T14:22:00Z"
}

​
Relacionamentos

​
Regras de Negocio

  • Criada via padrao Saga: banco local -> WorkOS -> Stripe customer
  • Email, telefone e endereco sao sincronizados com o Stripe em atualizacoes
  • BillingThreshold deve corresponder a moeda da organizacao
  • Cacheada por ID
A criacao de uma Organization envolve tres sistemas (banco local, WorkOS e Stripe). A falha em qualquer etapa dispara o rollback das anteriores via Saga.
Cada Organization possui duas referencias externas: iamExternalRef para o WorkOS (autenticacao e RBAC) e billingExternalRef para o Stripe (cobranca e pagamentos).
O campo currency define a moeda base da organizacao e afeta todos os calculos de billing, incluindo conversao cambial de custos de tokens.