@greatapps/common 1.1.798 → 1.1.800

package/dist/modules/accounts/hooks/use-required-billing-data.hook.mjs

@@ -1,6 +1,6 @@
 "use client";
 import { useCurrentAccount } from "./current-account.hook";
-import { useActiveSubscription } from "../../subscriptions/hooks/find-active-subscription.hook";
+import { useCurrentSubscription } from "../../subscriptions/hooks/use-current-subscription.hook";
 import { hasPaidSubscription } from "../../subscriptions/utils/has-paid-subscription";
 import { useManagementPermissions } from "../../auth/hooks/useManagementPermissions";
 import { hasCompleteBillingData, isBrazilianBillingAccount } from "../utils/billing-data";
@@ -10,7 +10,7 @@ function useRequiredBillingData() {
   const {
     data: { data: [subscription] = [] } = {},
     isPending: isSubscriptionPending
-  } = useActiveSubscription();
+  } = useCurrentSubscription();
   const isLoading = isAccountPending || isSubscriptionPending;
   const isRequired = !isLoading && isOwnerOrAdmin && isBrazilianBillingAccount(account) && hasPaidSubscription(subscription) && !hasCompleteBillingData(account);
   return {

package/dist/modules/accounts/hooks/use-required-billing-data.hook.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/modules/accounts/hooks/use-required-billing-data.hook.ts"],"sourcesContent":["'use client';\n\nimport { useCurrentAccount } from './current-account.hook';\nimport { useActiveSubscription } from '../../subscriptions/hooks/find-active-subscription.hook';\nimport { hasPaidSubscription } from '../../subscriptions/utils/has-paid-subscription';\nimport { useManagementPermissions } from '../../auth/hooks/useManagementPermissions';\nimport { hasCompleteBillingData, isBrazilianBillingAccount } from '../utils/billing-data';\n\n/**\n * Contas que já pagaram mas nunca preencheram o cadastro de cobrança ficam sem\n * nota fiscal (chamado \"Nota fiscal não emitida em pagamentos confirmados\").\n * Este hook diz quando o preenchimento vira obrigatório — o modal que ele\n * alimenta é bloqueante, então só liga com os dados já carregados e só para\n * quem consegue resolver: owner/admin de conta brasileira.\n */\nexport function useRequiredBillingData() {\n  const { isOwnerOrAdmin } = useManagementPermissions();\n  const { data: account, isPending: isAccountPending } = useCurrentAccount();\n  const {\n    data: { data: [subscription] = [] } = {},\n    isPending: isSubscriptionPending,\n  } = useActiveSubscription();\n\n  const isLoading = isAccountPending || isSubscriptionPending;\n\n  const isRequired =\n    !isLoading &&\n    isOwnerOrAdmin &&\n    isBrazilianBillingAccount(account) &&\n    hasPaidSubscription(subscription) &&\n    !hasCompleteBillingData(account);\n\n  return {\n    isRequired,\n    isLoading,\n    account,\n  };\n}\n"],"mappings":";AAEA,SAAS,yBAAyB;AAClC,SAAS,6BAA6B;AACtC,SAAS,2BAA2B;AACpC,SAAS,gCAAgC;AACzC,SAAS,wBAAwB,iCAAiC;AAS3D,SAAS,yBAAyB;AACvC,QAAM,EAAE,eAAe,IAAI,yBAAyB;AACpD,QAAM,EAAE,MAAM,SAAS,WAAW,iBAAiB,IAAI,kBAAkB;AACzE,QAAM;AAAA,IACJ,MAAM,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC,EAAE,IAAI,CAAC;AAAA,IACvC,WAAW;AAAA,EACb,IAAI,sBAAsB;AAE1B,QAAM,YAAY,oBAAoB;AAEtC,QAAM,aACJ,CAAC,aACD,kBACA,0BAA0B,OAAO,KACjC,oBAAoB,YAAY,KAChC,CAAC,uBAAuB,OAAO;AAEjC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../../../src/modules/accounts/hooks/use-required-billing-data.hook.ts"],"sourcesContent":["'use client';\n\nimport { useCurrentAccount } from './current-account.hook';\nimport { useCurrentSubscription } from '../../subscriptions/hooks/use-current-subscription.hook';\nimport { hasPaidSubscription } from '../../subscriptions/utils/has-paid-subscription';\nimport { useManagementPermissions } from '../../auth/hooks/useManagementPermissions';\nimport { hasCompleteBillingData, isBrazilianBillingAccount } from '../utils/billing-data';\n\n/**\n * Contas que já pagaram mas nunca preencheram o cadastro de cobrança ficam sem\n * nota fiscal (chamado \"Nota fiscal não emitida em pagamentos confirmados\").\n * Este hook diz quando o preenchimento vira obrigatório — o modal que ele\n * alimenta é bloqueante, então só liga com os dados já carregados e só para\n * quem consegue resolver: owner/admin de conta brasileira.\n *\n * A assinatura vem de `useCurrentSubscription`, não de `useActiveSubscription`:\n * o segundo é `GET /subscriptions?limit=1` sem regra de escolha, então numa conta\n * com trial antiga a trial volta na frente da assinatura paga e o gate se cala.\n * Foi o que aconteceu na conta 428409, que pagou R$ 1.918 sem nota e nunca viu o\n * modal. O `current` aplica o ranqueamento do backend (cliente viva > trial viva >\n * free > encerrada) e devolve a mesma forma paginada.\n */\nexport function useRequiredBillingData() {\n  const { isOwnerOrAdmin } = useManagementPermissions();\n  const { data: account, isPending: isAccountPending } = useCurrentAccount();\n  const {\n    data: { data: [subscription] = [] } = {},\n    isPending: isSubscriptionPending,\n  } = useCurrentSubscription();\n\n  const isLoading = isAccountPending || isSubscriptionPending;\n\n  const isRequired =\n    !isLoading &&\n    isOwnerOrAdmin &&\n    isBrazilianBillingAccount(account) &&\n    hasPaidSubscription(subscription) &&\n    !hasCompleteBillingData(account);\n\n  return {\n    isRequired,\n    isLoading,\n    account,\n  };\n}\n"],"mappings":";AAEA,SAAS,yBAAyB;AAClC,SAAS,8BAA8B;AACvC,SAAS,2BAA2B;AACpC,SAAS,gCAAgC;AACzC,SAAS,wBAAwB,iCAAiC;AAgB3D,SAAS,yBAAyB;AACvC,QAAM,EAAE,eAAe,IAAI,yBAAyB;AACpD,QAAM,EAAE,MAAM,SAAS,WAAW,iBAAiB,IAAI,kBAAkB;AACzE,QAAM;AAAA,IACJ,MAAM,EAAE,MAAM,CAAC,YAAY,IAAI,CAAC,EAAE,IAAI,CAAC;AAAA,IACvC,WAAW;AAAA,EACb,IAAI,uBAAuB;AAE3B,QAAM,YAAY,oBAAoB;AAEtC,QAAM,aACJ,CAAC,aACD,kBACA,0BAA0B,OAAO,KACjC,oBAAoB,YAAY,KAChC,CAAC,uBAAuB,OAAO;AAEjC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;","names":[]}

package/dist/modules/accounts/utils/billing-data.mjs

@@ -1,3 +1,4 @@
+import { isValidCNPJ, isValidCPF } from "../../../utils/validators/common";
 const REQUIRED_BILLING_FIELDS = [
   "financial_document",
   "financial_name",
@@ -17,12 +18,18 @@ function isBrazilianBillingAccount(account) {
 function isFilled(value) {
   return typeof value === "string" && value.trim().length > 0;
 }
+function hasValidDocument(document) {
+  const digits = (document ?? "").replace(/\D/g, "");
+  if (digits.length === 11) return isValidCPF(digits);
+  if (digits.length === 14) return isValidCNPJ(digits);
+  return false;
+}
 function hasCompleteBillingData(account) {
   if (!account) return false;
   for (const field of REQUIRED_BILLING_FIELDS) {
     if (!isFilled(account[field])) return false;
   }
-  return true;
+  return hasValidDocument(account.financial_document);
 }
 export {
   hasCompleteBillingData,

package/dist/modules/accounts/utils/billing-data.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/modules/accounts/utils/billing-data.ts"],"sourcesContent":["import type { Account } from '../types';\n\nexport type BillingDataSnapshot = Pick<\n  Account,\n  | 'financial_document'\n  | 'financial_name'\n  | 'financial_email'\n  | 'zipcode'\n  | 'address'\n  | 'address_number'\n  | 'neighborhood'\n  | 'city'\n  | 'state'\n  | 'country'\n>;\n\ntype BillingField = keyof BillingDataSnapshot;\n\n/**\n * Campos exigidos pra emitir a NF-e — sem qualquer um deles a nota não sai.\n *\n * `financial_email` NÃO entra: o backend cai no e-mail do usuário quando ele está\n * vazio (`financial_email || userDocument.email`, accounts/services.js), então a\n * nota sai do mesmo jeito. Exigi-lo aqui bloquearia 4.7k contas pagantes da wl 1\n * em vez das ~460 que de fato estão sem cadastro fiscal. O campo continua no\n * formulário, pré-preenchido — só não é critério de bloqueio.\n *\n * `address_complement` é opcional de verdade.\n */\nconst REQUIRED_BILLING_FIELDS: readonly BillingField[] = [\n  'financial_document',\n  'financial_name',\n  'zipcode',\n  'address',\n  'address_number',\n  'neighborhood',\n  'city',\n  'state',\n  'country',\n];\n\n/**\n * Conta sujeita à NF-e brasileira. Só ela entra no bloqueio: o formulário pede\n * CPF/CNPJ e CEP de 8 dígitos, que um cliente de fora não tem como fornecer —\n * e o modal é bloqueante, então seria tranca sem saída.\n *\n * País vazio conta como Brasil: é o default do cadastro e a origem da esmagadora\n * maioria da base (155 contas pagas da wl 1 estão assim).\n */\nexport function isBrazilianBillingAccount(\n  account: Pick<BillingDataSnapshot, 'country'> | null | undefined,\n): boolean {\n  if (!account) return false;\n  const country = account.country?.trim().toUpperCase();\n  return !country || country === 'BR';\n}\n\nfunction isFilled(value: string | null | undefined): boolean {\n  return typeof value === 'string' && value.trim().length > 0;\n}\n\n/**\n * A conta tem todos os dados de cobrança/fiscais necessários pra emissão de nota.\n * Retorna `false` quando a conta ainda não carregou — quem decide bloquear é o\n * chamador, que checa o loading antes (ver `useRequiredBillingData`).\n */\nexport function hasCompleteBillingData(\n  account: BillingDataSnapshot | null | undefined,\n): boolean {\n  if (!account) return false;\n\n  for (const field of REQUIRED_BILLING_FIELDS) {\n    if (!isFilled(account[field])) return false;\n  }\n\n  return true;\n}\n"],"mappings":"AA6BA,MAAM,0BAAmD;AAAA,EACvD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAUO,SAAS,0BACd,SACS;AACT,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,UAAU,QAAQ,SAAS,KAAK,EAAE,YAAY;AACpD,SAAO,CAAC,WAAW,YAAY;AACjC;AAEA,SAAS,SAAS,OAA2C;AAC3D,SAAO,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS;AAC5D;AAOO,SAAS,uBACd,SACS;AACT,MAAI,CAAC,QAAS,QAAO;AAErB,aAAW,SAAS,yBAAyB;AAC3C,QAAI,CAAC,SAAS,QAAQ,KAAK,CAAC,EAAG,QAAO;AAAA,EACxC;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../../../../src/modules/accounts/utils/billing-data.ts"],"sourcesContent":["import type { Account } from '../types';\nimport { isValidCNPJ, isValidCPF } from '../../../utils/validators/common';\n\nexport type BillingDataSnapshot = Pick<\n  Account,\n  | 'financial_document'\n  | 'financial_name'\n  | 'financial_email'\n  | 'zipcode'\n  | 'address'\n  | 'address_number'\n  | 'neighborhood'\n  | 'city'\n  | 'state'\n  | 'country'\n>;\n\ntype BillingField = keyof BillingDataSnapshot;\n\n/**\n * Campos exigidos pra emitir a NF-e — sem qualquer um deles a nota não sai.\n *\n * `financial_email` NÃO entra: o backend cai no e-mail do usuário quando ele está\n * vazio (`financial_email || userDocument.email`, accounts/services.js), então a\n * nota sai do mesmo jeito. Exigi-lo aqui bloquearia 4.7k contas pagantes da wl 1\n * em vez das ~460 que de fato estão sem cadastro fiscal. O campo continua no\n * formulário, pré-preenchido — só não é critério de bloqueio.\n *\n * `address_complement` é opcional de verdade.\n */\nconst REQUIRED_BILLING_FIELDS: readonly BillingField[] = [\n  'financial_document',\n  'financial_name',\n  'zipcode',\n  'address',\n  'address_number',\n  'neighborhood',\n  'city',\n  'state',\n  'country',\n];\n\n/**\n * Conta sujeita à NF-e brasileira. Só ela entra no bloqueio: o formulário pede\n * CPF/CNPJ e CEP de 8 dígitos, que um cliente de fora não tem como fornecer —\n * e o modal é bloqueante, então seria tranca sem saída.\n *\n * País vazio conta como Brasil: é o default do cadastro e a origem da esmagadora\n * maioria da base (155 contas pagas da wl 1 estão assim).\n */\nexport function isBrazilianBillingAccount(\n  account: Pick<BillingDataSnapshot, 'country'> | null | undefined,\n): boolean {\n  if (!account) return false;\n  const country = account.country?.trim().toUpperCase();\n  return !country || country === 'BR';\n}\n\nfunction isFilled(value: string | null | undefined): boolean {\n  return typeof value === 'string' && value.trim().length > 0;\n}\n\n/**\n * Documento preenchido não é documento bom. O caso que originou isto: uma conta pagava desde\n * junho/2025 com um CNPJ de um dígito trocado, a prefeitura recusava a NFS-e todo mês e o modal\n * nunca abria, porque o campo estava preenchido. Conferir o dígito verificador aqui é o que faz\n * o cliente ser levado a corrigir — o backend já recusa a escrita de um documento inválido desde\n * 28/05/2026, então o formulário não tem como salvar um valor ruim por cima.\n */\nfunction hasValidDocument(document: string | null | undefined): boolean {\n  const digits = (document ?? '').replace(/\\D/g, '');\n  if (digits.length === 11) return isValidCPF(digits);\n  if (digits.length === 14) return isValidCNPJ(digits);\n  return false;\n}\n\n/**\n * A conta tem todos os dados de cobrança/fiscais necessários pra emissão de nota.\n * Retorna `false` quando a conta ainda não carregou — quem decide bloquear é o\n * chamador, que checa o loading antes (ver `useRequiredBillingData`).\n */\nexport function hasCompleteBillingData(\n  account: BillingDataSnapshot | null | undefined,\n): boolean {\n  if (!account) return false;\n\n  for (const field of REQUIRED_BILLING_FIELDS) {\n    if (!isFilled(account[field])) return false;\n  }\n\n  return hasValidDocument(account.financial_document);\n}\n"],"mappings":"AACA,SAAS,aAAa,kBAAkB;AA6BxC,MAAM,0BAAmD;AAAA,EACvD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAUO,SAAS,0BACd,SACS;AACT,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,UAAU,QAAQ,SAAS,KAAK,EAAE,YAAY;AACpD,SAAO,CAAC,WAAW,YAAY;AACjC;AAEA,SAAS,SAAS,OAA2C;AAC3D,SAAO,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,SAAS;AAC5D;AASA,SAAS,iBAAiB,UAA8C;AACtE,QAAM,UAAU,YAAY,IAAI,QAAQ,OAAO,EAAE;AACjD,MAAI,OAAO,WAAW,GAAI,QAAO,WAAW,MAAM;AAClD,MAAI,OAAO,WAAW,GAAI,QAAO,YAAY,MAAM;AACnD,SAAO;AACT;AAOO,SAAS,uBACd,SACS;AACT,MAAI,CAAC,QAAS,QAAO;AAErB,aAAW,SAAS,yBAAyB;AAC3C,QAAI,CAAC,SAAS,QAAQ,KAAK,CAAC,EAAG,QAAO;AAAA,EACxC;AAEA,SAAO,iBAAiB,QAAQ,kBAAkB;AACpD;","names":[]}

package/dist/modules/subscriptions/utils/has-paid-subscription.mjs

@@ -5,7 +5,7 @@ function hasPaidSubscription(subscription) {
     return false;
   }
   if (subscription.type === "trial") return false;
-  return subscription.charged === true;
+  return true;
 }
 export {
   hasPaidSubscription

package/dist/modules/subscriptions/utils/has-paid-subscription.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/modules/subscriptions/utils/has-paid-subscription.ts"],"sourcesContent":["import type { Subscription } from '../types/subscription.type';\nimport { FREE_PLAN_ID } from '../constants/subscription.constants';\n\ntype PaidSubscriptionSnapshot = Pick<Subscription, 'type' | 'id_plan' | 'charged'>;\n\n/**\n * A conta já teve pagamento confirmado numa assinatura paga.\n *\n * Diferente de `hasActivePaidSubscription`, aqui NÃO importa se a assinatura\n * segue vigente: quem pagou e depois cancelou/atrasou continua precisando de\n * nota fiscal do que já foi cobrado. Por isso o sinal é `charged` (marcado pelo\n * backend no `bill_paid`), e não `active`/`date_due`.\n *\n * Free e trial ficam de fora — nunca houve cobrança a documentar.\n */\nexport function hasPaidSubscription(\n  subscription: PaidSubscriptionSnapshot | undefined | null,\n): boolean {\n  if (!subscription) return false;\n  if (subscription.type === 'free' || subscription.id_plan === FREE_PLAN_ID) {\n    return false;\n  }\n  if (subscription.type === 'trial') return false;\n\n  return subscription.charged === true;\n}\n"],"mappings":"AACA,SAAS,oBAAoB;AActB,SAAS,oBACd,cACS;AACT,MAAI,CAAC,aAAc,QAAO;AAC1B,MAAI,aAAa,SAAS,UAAU,aAAa,YAAY,cAAc;AACzE,WAAO;AAAA,EACT;AACA,MAAI,aAAa,SAAS,QAAS,QAAO;AAE1C,SAAO,aAAa,YAAY;AAClC;","names":[]}
+{"version":3,"sources":["../../../../src/modules/subscriptions/utils/has-paid-subscription.ts"],"sourcesContent":["import type { Subscription } from '../types/subscription.type';\nimport { FREE_PLAN_ID } from '../constants/subscription.constants';\n\ntype PaidSubscriptionSnapshot = Pick<Subscription, 'type' | 'id_plan'>;\n\n/**\n * A assinatura é de plano pago — o que basta para a conta precisar de cadastro\n * fiscal, porque a cobrança vem e a nota tem que sair com ela.\n *\n * Não olha mais `charged`. O campo é escrito no `bill_paid`, evento do fluxo\n * Vindi, e na prática só a Stripe o preenche: das 7.528 assinaturas ativas de\n * plano pago com cobrança paga, 812 estão sem ele, e 806 dessas são Vindi (96%\n * da base Vindi). Exigi-lo deixava o gate cego justamente para a parte antiga da\n * base — a conta 428409 pagou R$ 1.918 sem nota com `charged = false`.\n *\n * Não exigir pagamento confirmado também alcança a conta ANTES da primeira\n * cobrança, que é quando o dado fiscal ainda dá tempo de evitar nota perdida.\n *\n * Free e trial ficam de fora: não geram cobrança a documentar.\n */\nexport function hasPaidSubscription(\n  subscription: PaidSubscriptionSnapshot | undefined | null,\n): boolean {\n  if (!subscription) return false;\n  if (subscription.type === 'free' || subscription.id_plan === FREE_PLAN_ID) {\n    return false;\n  }\n  if (subscription.type === 'trial') return false;\n\n  return true;\n}\n"],"mappings":"AACA,SAAS,oBAAoB;AAmBtB,SAAS,oBACd,cACS;AACT,MAAI,CAAC,aAAc,QAAO;AAC1B,MAAI,aAAa,SAAS,UAAU,aAAa,YAAY,cAAc;AACzE,WAAO;AAAA,EACT;AACA,MAAI,aAAa,SAAS,QAAS,QAAO;AAE1C,SAAO;AACT;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@greatapps/common",
-  "version": "1.1.798",
+  "version": "1.1.800",
   "description": "Shared library for GreatApps frontend applications",
   "main": "./dist/index.mjs",
   "types": "./src/index.ts",

package/src/modules/accounts/hooks/use-required-billing-data.hook.ts

@@ -1,7 +1,7 @@
 'use client';
 
 import { useCurrentAccount } from './current-account.hook';
-import { useActiveSubscription } from '../../subscriptions/hooks/find-active-subscription.hook';
+import { useCurrentSubscription } from '../../subscriptions/hooks/use-current-subscription.hook';
 import { hasPaidSubscription } from '../../subscriptions/utils/has-paid-subscription';
 import { useManagementPermissions } from '../../auth/hooks/useManagementPermissions';
 import { hasCompleteBillingData, isBrazilianBillingAccount } from '../utils/billing-data';
@@ -12,6 +12,13 @@ import { hasCompleteBillingData, isBrazilianBillingAccount } from '../utils/bill
  * Este hook diz quando o preenchimento vira obrigatório — o modal que ele
  * alimenta é bloqueante, então só liga com os dados já carregados e só para
  * quem consegue resolver: owner/admin de conta brasileira.
+ *
+ * A assinatura vem de `useCurrentSubscription`, não de `useActiveSubscription`:
+ * o segundo é `GET /subscriptions?limit=1` sem regra de escolha, então numa conta
+ * com trial antiga a trial volta na frente da assinatura paga e o gate se cala.
+ * Foi o que aconteceu na conta 428409, que pagou R$ 1.918 sem nota e nunca viu o
+ * modal. O `current` aplica o ranqueamento do backend (cliente viva > trial viva >
+ * free > encerrada) e devolve a mesma forma paginada.
  */
 export function useRequiredBillingData() {
   const { isOwnerOrAdmin } = useManagementPermissions();
@@ -19,7 +26,7 @@ export function useRequiredBillingData() {
   const {
     data: { data: [subscription] = [] } = {},
     isPending: isSubscriptionPending,
-  } = useActiveSubscription();
+  } = useCurrentSubscription();
 
   const isLoading = isAccountPending || isSubscriptionPending;
 

package/src/modules/accounts/utils/billing-data.ts

@@ -1,4 +1,5 @@
 import type { Account } from '../types';
+import { isValidCNPJ, isValidCPF } from '../../../utils/validators/common';
 
 export type BillingDataSnapshot = Pick<
   Account,
@@ -59,6 +60,20 @@ function isFilled(value: string | null | undefined): boolean {
   return typeof value === 'string' && value.trim().length > 0;
 }
 
+/**
+ * Documento preenchido não é documento bom. O caso que originou isto: uma conta pagava desde
+ * junho/2025 com um CNPJ de um dígito trocado, a prefeitura recusava a NFS-e todo mês e o modal
+ * nunca abria, porque o campo estava preenchido. Conferir o dígito verificador aqui é o que faz
+ * o cliente ser levado a corrigir — o backend já recusa a escrita de um documento inválido desde
+ * 28/05/2026, então o formulário não tem como salvar um valor ruim por cima.
+ */
+function hasValidDocument(document: string | null | undefined): boolean {
+  const digits = (document ?? '').replace(/\D/g, '');
+  if (digits.length === 11) return isValidCPF(digits);
+  if (digits.length === 14) return isValidCNPJ(digits);
+  return false;
+}
+
 /**
  * A conta tem todos os dados de cobrança/fiscais necessários pra emissão de nota.
  * Retorna `false` quando a conta ainda não carregou — quem decide bloquear é o
@@ -73,5 +88,5 @@ export function hasCompleteBillingData(
     if (!isFilled(account[field])) return false;
   }
 
-  return true;
+  return hasValidDocument(account.financial_document);
 }

package/src/modules/subscriptions/utils/has-paid-subscription.ts

@@ -1,17 +1,22 @@
 import type { Subscription } from '../types/subscription.type';
 import { FREE_PLAN_ID } from '../constants/subscription.constants';
 
-type PaidSubscriptionSnapshot = Pick<Subscription, 'type' | 'id_plan' | 'charged'>;
+type PaidSubscriptionSnapshot = Pick<Subscription, 'type' | 'id_plan'>;
 
 /**
- * A conta já teve pagamento confirmado numa assinatura paga.
+ * A assinatura é de plano pago — o que basta para a conta precisar de cadastro
+ * fiscal, porque a cobrança vem e a nota tem que sair com ela.
  *
- * Diferente de `hasActivePaidSubscription`, aqui NÃO importa se a assinatura
- * segue vigente: quem pagou e depois cancelou/atrasou continua precisando de
- * nota fiscal do que já foi cobrado. Por isso o sinal é `charged` (marcado pelo
- * backend no `bill_paid`), e não `active`/`date_due`.
+ * Não olha mais `charged`. O campo é escrito no `bill_paid`, evento do fluxo
+ * Vindi, e na prática só a Stripe o preenche: das 7.528 assinaturas ativas de
+ * plano pago com cobrança paga, 812 estão sem ele, e 806 dessas são Vindi (96%
+ * da base Vindi). Exigi-lo deixava o gate cego justamente para a parte antiga da
+ * base — a conta 428409 pagou R$ 1.918 sem nota com `charged = false`.
  *
- * Free e trial ficam de fora — nunca houve cobrança a documentar.
+ * Não exigir pagamento confirmado também alcança a conta ANTES da primeira
+ * cobrança, que é quando o dado fiscal ainda dá tempo de evitar nota perdida.
+ *
+ * Free e trial ficam de fora: não geram cobrança a documentar.
  */
 export function hasPaidSubscription(
   subscription: PaidSubscriptionSnapshot | undefined | null,
@@ -22,5 +27,5 @@ export function hasPaidSubscription(
   }
   if (subscription.type === 'trial') return false;
 
-  return subscription.charged === true;
+  return true;
 }