Skip to content

feat(modules): Let stores refuse checkout from companies (CNPJ) - #882

Closed
vitorrgg wants to merge 1 commit into
mainfrom
feat/checkout-persons-only
Closed

vitorrgg wants to merge 1 commit into
mainfrom
feat/checkout-persons-only

Conversation

@vitorrgg

Copy link
Copy Markdown
Member

Problema

Algumas lojas vendem só para pessoa física e precisam recusar pedidos com CNPJ. Hoje o checkout aceita qualquer comprador, e esconder a opção "Pessoa jurídica" na vitrine não basta, porque o checkout pode ser chamado direto ou com um CNPJ marcado como pessoa física.

Solução

Novo gate opt-in checkout.personsOnly na config da loja (functions/config.json), ao lado de customersOnly, requireStaffSignature e minSubtotal:

{ "checkout": { "personsOnly": true } }
  • getCompanyGateError em functions-checkout/customer-gates.ts recusa quando o customer ou qualquer transaction.buyer tem registry_type: 'j' ou documento com 14 dígitos (CNPJ). O caso do CNPJ enviado com registry_type: 'p' também é recusado.
  • Responde 403 CKT807, com user_message em pt-BR e en-US. O checkout do Storefront já exibe essa mensagem: "Esta loja vende somente para pessoa física (CPF), compras com CNPJ não são permitidas".
  • Roda antes de readOrSaveCustomer: um comprador recusado não cria nem atualiza cliente. O transaction.buyer tem registry_type e doc_number obrigatórios no schema, então a checagem não depende dos campos mesclados do cliente salvo.
  • Sem personsOnly nada muda.

Verificação

  • packages/modules/tests/3-customer-gates.test.ts: novo caso cobrindo gate desligado, só pessoas físicas, PJ por registry_type, CNPJ marcado como p e CNPJ formatado.
  • Vitest de 3-customer-gates e 4-checkout-customer-guard: 13/13.
  • turbo run build --filter=./packages/modules... (tsc) e ESLint limpos.

Primeira loja a usar: Mundo Quadri (https://github.com/mundoquadri/mundoquadri/tree/main-bloqueio-cnpj).

🤖 Generated with Claude Code

New opt-in `checkout.personsOnly` gate in store config: checkout answers 403
CKT807 with a pt-BR/en-US user message when the customer or any transaction
buyer has `registry_type: 'j'` or a 14-digit document (CNPJ). Runs before the
customer is saved, so a refused company doesn't create or update a customer.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vitorrgg

Copy link
Copy Markdown
Member Author

Fechando: o bloqueio de CNPJ da Mundo Quadri vai ser resolvido só na frente de loja (input de documento aceitando apenas CPF), sem gate no servidor.

@vitorrgg vitorrgg closed this Nov 18, 2026
@vitorrgg
vitorrgg deleted the feat/checkout-persons-only branch November 18, 2026 14:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant