# Identificação de empresas no Simples Nacional (questionamento da documentação)

## Resposta ao questionamento

> "Após importação dos clientes e fornecedores, identificar, se possível, quais empresas estão no SIMPLES. Como? Integração com SEFAZ?"

### Fonte dos dados: **Receita Federal (RFB), não SEFAZ**

- A informação **"opção pelo Simples Nacional"** (e MEI) é **federal**, da **Receita Federal do Brasil (RFB)**.
- **SEFAZ** é estadual (cada estado): trata de **ICMS**, **inscrição estadual**, etc. Não é a fonte oficial para “está no Simples?”.

### Como o sistema faz hoje

1. **Brasil API** (`BrasilApiService`): consulta `https://brasilapi.com.br/api/cnpj/v1/{cnpj}` (dados públicos da RFB) e retorna:
   - `opcao_pelo_simples` (boolean)
   - `data_opcao_pelo_simples`
   - `opcao_pelo_mei`
   - entre outros (abertura, CNAE, etc.).

2. **GovBrService**: método `simplesStatus()` que hoje usa a mesma fonte (Brasil API) e normaliza para o front (regime sugerido: MEI / Simples Nacional).

3. **Cadastro (Pessoa)**: campos `regimetributario`, `dataopcaosimples`, `dataabertura`, `cnae_principal_*` são preenchidos pela consulta.

### Funcionalidade implementada

- Na listagem de **Clientes** ou **Fornecedores** há o botão **"Identificar Simples (Receita)"**.
- Ao clicar, o sistema:
  - Considera todas as pessoas da lista com **CNPJ de 14 dígitos**.
  - Para cada uma, chama a **Brasil API** (Receita Federal).
  - Atualiza no cadastro: **data de opção pelo Simples**, **regime tributário** (Simples Nacional ou MEI), **data de abertura**, **CNAE principal**.
  - Exibe quantas foram atualizadas e quantas estão no Simples/MEI; falhas (ex.: CNPJ inexistente ou API fora) são listadas em aviso.
- A coluna **Regime** na tabela passa a mostrar **Simples Nacional** ou **MEI** (e data da opção, quando houver) para quem já foi consultado.

### Integração oficial (futuro)

- A documentação do **GovBrService** comenta a troca futura por **endpoint oficial gov.br/Receita** (OAuth2 / mTLS), quando disponível.
- Até lá, a **Brasil API** segue como fonte de dados públicos da RFB para desenvolvimento e MVP.

### Resumo

| Pergunta                         | Resposta                                                                 |
|----------------------------------|---------------------------------------------------------------------------|
| Como identificar no Simples?     | Consulta CNPJ à Receita Federal (hoje via Brasil API).                   |
| É SEFAZ?                         | Não. É Receita Federal (dado nacional do Simples/MEI).                  |
| Onde usar no sistema?            | Listagem de Clientes/Fornecedores → botão **"Identificar Simples (Receita)"**. |