# NFS-e (Nota de Serviço)

# 1. Imposto Aproximado Detalhado



# PROC001 – NFSe – Imposto Aproximado Detalhado (IBPT)

<table border="1" id="bkmrk-%C2%A0-projeto%2Fsistema%3Age" style="border-collapse: collapse; width: 100.123%; height: 68px;"><tbody><tr style="border-style: solid;"><td rowspan="3" style="width: 26.6667%; height: 68px; border-color: black; border-top-style: hidden; border-left-style: hidden; border-bottom-style: hidden;">  
[![image-1762776253666.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/image-1762776253666.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762776253666.png)

</td><td style="width: 49.9999%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Projeto/Sistema:**</span>  
<span style="color: #000000;">NFS-e/GerencieAqui</span></td><td class="align-center" style="width: 23.3333%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do *Template:***</span>  
<span style="color: #000000;">1.2</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Processo:**</span>  
PROC001 – NFSe – Imposto Aproximado Detalhado (IBPT)</td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do Documento:**</span>  
<span style="color: #000000;">1.0</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Responsável(eis):** </span>  
<span style="color: #000000;">Luís Leite - GPT</span></td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Data:** </span>

<span style="color: #000000;">26/02/2026</span>

</td></tr></tbody></table>

##### <span style="color: #000000;">**1. Introdução**</span>

<span style="color: #000000;">**Esta documentação visa descrever a mudança necessária para o envio do tributo aproximado detalhado da NFS-e via plugnotas.**</span>

<table cellpadding="9" cellspacing="0" id="bkmrk-processo-envolvidos-" width="100%"><tbody><tr valign="top"><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">**Processo**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="19%"><span style="font-size: small; color: #000000;">**Envolvidos**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Entrada**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Saída**</span>

</td></tr><tr valign="top"><td style="border-style: solid; border-color: black;" width="27%">PROC001 – NFSe – Imposto Aproximado Detalhado (IBPT)

</td><td style="border-style: solid; border-color: black;" width="19%"><span style="font-size: small; color: #000000;">GA; PlugNotas</span>

</td><td style="border-style: solid; border-color: black;" width="27%"><span style="font-size: small; color: #000000;">Tributos detalhados</span>

</td><td style="border-style: solid; border-color: black;" width="27%"><span style="color: #000000; font-size: small;">Informação enviada via JSON para PlugNotas</span>

</td></tr></tbody></table>

#### **Especificação Funcional**

- - - - - -

#### ***PROC001 – NFSe – Imposto Aproximado Detalhado (IBPT)***

##### Informações Gerais

**Nome da Funcionalidade:**

NFSe – Exibição e Persistência de Imposto Aproximado Detalhado (Estadual e Federal)

**Objetivo:**

Permitir o detalhamento do imposto aproximado (IBPT) na NFSe, segregando os valores Estadual (UF) e Federal, com renderização condicional baseada em parâmetro de configuração.

**Escopo:**

\- Inclusão de 2 novos campos na tela da NFSe.

\- Inclusão de 2 novas colunas na base de dados.

\- Renderização condicional mediante configuração sistêmica.

\- Adequação ao objeto de retorno JSON da integração IBPT.

#### ***Protótipo de Tela:***

[![image-1772110363714.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/scaled-1680-/image-1772110363714.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/image-1772110363714.png)

Imagem I - Nova Configuração

[![image-1772110258320.png](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/scaled-1680-/image-1772110258320.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2026-02/image-1772110258320.png)

Imagem II - Novos campos na NFSe

#### ***Descrição dos Campos:***

<table cellpadding="9" cellspacing="0" id="bkmrk-campo-tipo-m%C3%A1scara-o" style="height: 2305px; width: 810px;" width="807"><tbody><tr valign="top"><td style="width: 162px; border-style: solid; border-color: black;" width="126"><span style="color: #000000;">Campo</span>

</td><td style="width: 162px; border-style: solid; border-color: black;" width="126"><span style="color: #000000;">Tipo</span>

</td><td style="width: 162px; border-style: solid; border-color: black;" width="126"><span style="color: #000000;">Máscara</span>

</td><td style="width: 162px; border-style: solid; border-color: black;" width="126"><span style="color: #000000;">Obrigatório</span>

</td><td style="width: 162px; border-style: solid; border-color: black;" width="126"><span style="color: #000000;">Descrição</span>

</td></tr><tr valign="top"><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">Imposto aproximado NFSe detalhado</span>

</td><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">Checkbox</span>

</td><td style="width: 162px; border-style: solid; border-color: black;">-

</td><td style="width: 162px; border-style: solid; border-color: black;">-

</td><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">Define se os tributos aproximados devem ser exibidos de forma detalhada.</span></td></tr><tr valign="top"><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">Tributo Aproximado Estadual</span>

</td><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">Decimal(19,2)</span>

</td><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">0,00</span>

</td><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">Não</span>

</td><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">Valor aproximado referente ao imposto estadual (IBPT).</span>

</td></tr><tr valign="top"><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">Tributo Aproximado Federal</span>

</td><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">Decimal(19,2)</span>

</td><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">0,00</span>

</td><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">Não</span>

</td><td style="width: 162px; border-style: solid; border-color: black;"><span style="color: #000000;">Valor aproximado referente ao imposto federal (IBPT).</span>

</td></tr></tbody></table>

#### ***Regras de Interface:***

<span style="color: #000000;">**1.** Imposto aproximado NFSe detalhado: Deve ser adicionada em: Configurações &gt; Documentos Fiscais &gt; Card NFSe</span>  
<span style="color: #000000;">Por padrão deve vir desmarcado (False)</span>

<span style="color: #000000;">**2.** Tributo Aproximado Estadual: Somente deve ser permitido o preenchimento caso a configuração do tributo detalhado esteja feita</span>

<span style="color: #000000;">**3.** Tributo Aproximado Federal: Somente deve ser permitido o preenchimento caso a configuração do tributo detalhado esteja feita</span>

#### ***Regras de Negócio:***

**1.** Caso no cadastro do serviço os valores 'Aprox. Muni.', 'Aprox. Est'. e 'Aprox. Fed/ Nac.' na aba 'Tabela de Imposto' estejam preenchidos, devem ser calculados os valores no serviço dentro da NFS-e.

**2.** Sobre o envio das informações no JSON, caso a configuração esteja marcada, deve ser enviado como 'simplificado', caso esteja marcado, enviar como 'detalhado'

#### ***Questões Técnicas:***

**1.** Criação dos campos para armazenar os valores detalhados na nfce:

```SQL
ALTER TABLE gerencieaqui.nfseservico
ADD aproxUF DECIMAL(19,2) not null,
ADD aproxFed DECIMAL(19,2) not null;
```

**2.** Consulta do registro dos dados salvos no produto/serviço:

```SQL
SELECT aproxEstaduais, aproxNacional, aproxMunicipais FROM produto;
```

**3.** Estrutura JSON recebida:

```JSON
{
  "ibpt": {
    "simplificado": {
      "aliquota": 0
    },
    "detalhado": {
      "aliquota": {
        "municipal": 0,
        "estadual": 0,
        "federal": 0
      }
    }
  }
}
```

©SOFTEN SISTEMAS 2026