# ICMS-ST – Documentação Fiscal CapeSystem

## Bahia

---

## 📁 Estrutura da Pasta

```
fiscal/icms_st/
├── README.md                              # Este arquivo
├── icms_st_bahia.md                       # Relação de segmentos ST na BA
├── mapa_cest_cst_csosn_bahia.md           # Mapa CST × CSOSN por cenário
├── regra_automatica_icms_st_capesystem.md # Regras do motor fiscal
├── tabela_segmentos_st_bahia.md           # Tabela detalhada de segmentos
├── fluxo_decisao_icms_st.md               # Fluxograma de decisão ST
├── validacoes_fiscais_icms_st.sql         # Queries de validação SQL
└── config_icms_st_bahia.json              # Configuração JSON do motor

```

---

## 📋 Descrição dos Arquivos

| Arquivo | Descrição |
| --------- | ----------- |
| **icms_st_bahia.md** | Documento principal com todos os 20 segmentos de ST ativos na Bahia |
| **mapa_cest_cst_csosn_bahia.md** | Mapeamento completo de CST (RPA) e CSOSN (SN) por situação fiscal |
| **regra_automatica_icms_st_capesystem.md** | Regras de negócio para automação fiscal no CapeSystem |
| **tabela_segmentos_st_bahia.md** | Tabela resumida com estatísticas da base de dados |
| **fluxo_decisao_icms_st.md** | Diagramas de fluxo para decisão de aplicação de ST |
| **validacoes_fiscais_icms_st.sql** | Scripts SQL para validação e auditoria |
| **config_icms_st_bahia.json** | Configuração estruturada para integração com sistema |

---

## ⚖️ Base Legal

- **Federal:** Convênio ICMS nº 142/2018 (CONFAZ)

- **Estadual:** Decreto nº 13.780/2012 – RICMS-BA

- **Anexo:** X – Substituição Tributária

---

## 🔧 Integração com CapeSystem

### Modelo Python

```python
from app.models import CestNcm

# Verificar ST

tem_st = CestNcm.tem_st_no_estado('17.021.00', 'BA')

# Obter CST/CSOSN

cst = CestNcm.obter_cst_st('17.021.00', 'BA', regime='normal')   # '060'
csosn = CestNcm.obter_cst_st('17.021.00', 'BA', regime='simples') # '500'

```

### API REST

```bash

# Verificar ST de um CEST

GET /api/fiscal/verificar-st/1702100/BA

# Listar segmentos ST

GET /api/fiscal/segmentos-st/BA

# Buscar CEST por NCM

GET /api/fiscal/buscar-cest/04032000

```

---

## 📊 Estatísticas da Base

| Métrica | Valor |
| --------- | ------- |
| Total CEST/NCM cadastrados | 768 |
| Com ST ativa na Bahia | 614 (79.9%) |
| Segmentos mapeados | 20 |

---

## ✅ Regra Resumida

| Regime | CST/CSOSN | ICMS Próprio | ICMS-ST |
| -------- | ----------- | -------------- | --------- |
| Simples Nacional | **500** | Não destaca | Fora do DAS |
| Regime Normal | **060** | Não destaca | Informativo |

---

## 🔄 Manutenção

### Atualizar base de dados

```bash
python atualizar_base_fiscal_ba_20251230.py

```

### Validar sistema

```bash
python validar_sistema.py

```

---

## 📅 Histórico

| Data | Alteração |
| ------ | ----------- |
| 30/12/2025 | Criação inicial da documentação |
| 30/12/2025 | Adição de campos st_ba e segmento_descricao |
| 30/12/2025 | Criação dos endpoints de API |

---

**Mantido por:** Equipe CapeSystem  

**Última atualização:** 30/12/2025
