---
title: "Emissão de NFS-e com Cálculo Automático de Impostos - NFE.io | Docs"
description: "Aprenda como emitir uma Nota Fiscal de Serviço Eletrônica (NFS-e) utilizando o cálculo automático de impostos da plataforma NFE.io."
source_url: https://nfe.io/docs/documentacao/nota-fiscal-servico-eletronica/duvidas/cenarios-de-emissao/calculo-automatico-impostos
last_updated: 2026-03-09
---

# Emissão de NFS-e com Cálculo Automático de Impostos

Nesta seção, iremos explicar como emitir uma **Nota Fiscal de Serviço Eletrônica (NFS-e)** utilizando o **cálculo automático de impostos** da plataforma NFE.io. Caso não encontre uma resposta para sua dúvida, fique à vontade para [entrar em contato](https://nfe.io/#contato) e enviar sua pergunta.

## O que é o Cálculo Automático de Impostos?

O **cálculo automático de impostos** é uma funcionalidade da plataforma NFE.io que realiza o cálculo dos tributos automaticamente com base no **código de serviço** informado. Isso significa que você não precisa preencher os campos de impostos manualmente — como valor da alíquota de ISS, por exemplo — pois a plataforma identifica os detalhes tributários e calcula os valores a serem enviados para a prefeitura.

Além disso, é possível **customizar o cálculo de impostos** para uma empresa específica utilizando o **CNPJ da empresa emissora**. Dessa forma, o cálculo automático pode ser ajustado de acordo com as particularidades tributárias de cada empresa.

### Quando utilizar este cenário?

- **Simplicidade na integração**: Quando você deseja emitir notas fiscais sem se preocupar com o preenchimento dos campos de impostos.

## Campos obrigatórios para emissão

Para emitir uma **nota fiscal com cálculo automático de impostos**, você deve informar apenas os campos básicos:

| Campo | Descrição | Obrigatório |
|-------|-----------|-------------|
| `borrower.type` | Tipo do tomador de serviço (`Undefined`, `NaturalPerson`, `LegalEntity`) | Sim |
| `borrower.name` | Nome ou Razão Social do tomador | Sim |
| `borrower.federalTaxNumber` | CPF ou CNPJ do tomador (somente números) | Sim |
| `borrower.email` | Email do tomador | Não |
| `borrower.address` | Endereço completo do tomador | Sim |
| `cityServiceCode` | Código do serviço no município | Sim |
| `description` | Descrição do serviço prestado | Sim |
| `servicesAmount` | Valor total do serviço | Sim |

:::info

**Nota:** Os campos de impostos (`issRate`, `issAmount`, retenções, etc.) **não devem ser informados** neste cenário. A plataforma calculará todos os valores automaticamente com base no código de serviço.

:::

---

## Emissão via API

Para emitir uma nota fiscal com cálculo automático de impostos via API, não informe nenhum campo de imposto na requisição. A plataforma calculará automaticamente com base no código de serviço.

### Exemplo de JSON

```json
{
  "borrower": {
    "type": "LegalEntity",
    "name": "Banco do Brasil SA",
    "federalTaxNumber": 191,
    "municipalTaxNumber": null,
    "email": "joao.silva@emaildobancodobrasil.com.br",
    "address": {
      "country": "BRA",
      "postalCode": "01430-000",
      "street": "Avenida Brasil",
      "number": "418",
      "additionalInformation": "ANDAR 1",
      "district": "Jardins",
      "city": {
        "code": "3550308",
        "name": "São Paulo"
      },
      "state": "SP"
    }
  },
  "cityServiceCode": "0101",
  "description": "Descrição do serviço prestado",
  "servicesAmount": 1000.00
}
```

### Observações importantes

- O campo `federalTaxNumber` deve conter **somente números** (sem pontos, traços ou barras).
- O campo `municipalTaxNumber` é opcional e deve ser informado somente quando exigido pela prefeitura da empresa emissora.
- O campo `borrower.address.city.code` deve conter o **código IBGE** do município (7 dígitos).

---

## Emissão via Planilha

Também é possível emitir notas fiscais com cálculo automático de impostos utilizando a **planilha básica** de importação. Neste cenário, utilize o modelo de planilha básica — nele, os impostos são calculados automaticamente pelo sistema.

### Campos da Planilha

| Coluna da Planilha | API | Descrição | Obrigatório |
|--------------------|-----|-----------|-------------|
| `Codigo_Servico` | `cityServiceCode` | Código do serviço no município | Sim |
| `Descricao` | `description` | Descrição do serviço prestado (máx. 2000 caracteres) | Sim |
| `Valor` | `servicesAmount` | Valor total do serviço (ex: 1000.50 ou 1.000,50) | Sim |
| `CPF_CNPJ` | `borrower.federalTaxNumber` | CPF ou CNPJ do tomador | Sim |
| `Nome` | `borrower.name` | Nome ou Razão Social do tomador | Sim |
| `Email` | `borrower.email` | Email do tomador (múltiplos separados por vírgula) | Não |
| `Endereco_Pais` | `borrower.address.country` | Sigla do país (ISO 3166-1, ex: BRA) | Sim |
| `Endereco_Cep` | `borrower.address.postalCode` | CEP do endereço | Sim |
| `Endereco_Logradouro` | `borrower.address.street` | Nome da rua, avenida, etc. | Sim |
| `Endereco_Numero` | `borrower.address.number` | Número do endereço | Sim |
| `Endereco_Bairro` | `borrower.address.district` | Bairro | Sim |
| `Endereco_Cidade_Codigo` | `borrower.address.city.code` | Código IBGE da cidade (7 dígitos) | Sim |
| `Endereco_Cidade_Nome` | `borrower.address.city.name` | Nome da cidade | Sim |
| `Endereco_Estado` | `borrower.address.state` | Sigla do estado (ex: SP) | Sim |

### Exemplo de preenchimento

| Codigo_Servico | Descricao | Valor | CPF_CNPJ | Nome | Email | Endereco_Pais | Endereco_Cep | Endereco_Logradouro | Endereco_Numero | Endereco_Bairro | Endereco_Cidade_Codigo | Endereco_Cidade_Nome | Endereco_Estado |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 0101 | Descrição do serviço prestado | 1000.00 | 00000000000191 | Banco do Brasil SA | joao.silva@email.com.br | BRA | 01430-000 | Avenida Brasil | 418 | Jardins | 3550308 | São Paulo | SP |

### Observações

- Para utilizar o cálculo automático, utilize o modelo de **planilha básica**. Nela, nenhum campo de imposto precisa ser preenchido.
- O campo `CPF_CNPJ` pode ser preenchido com ou sem formatação (pontos, traços, barras).
- O campo `Valor` aceita tanto o formato brasileiro (1.000,50) quanto o americano (1000.50).

---

## Perguntas Frequentes (FAQ)

### Como a plataforma sabe qual alíquota aplicar?

A plataforma utiliza o **código de serviço** (`cityServiceCode`) informado para identificar as alíquotas de impostos configuradas na prefeitura do município da empresa emissora.

### Posso customizar o cálculo automático para minha empresa?

Sim. É possível customizar o cálculo de impostos utilizando o **CNPJ da empresa emissora**, permitindo que o cálculo automático seja ajustado de acordo com as particularidades tributárias de cada empresa.

### Como cadastrar, atualizar ou customizar um imposto?

Para **cadastro de imposto**, **atualização de imposto** ou **cadastro de imposto customizado** para sua empresa, [entre em contato com nosso suporte](https://nfe.io/#contato). A equipe de suporte será responsável por realizar essas configurações na plataforma.

### Posso informar campos de impostos mesmo usando cálculo automático?

Não é recomendado. Se você informar qualquer campo de imposto (como `issRate`), a plataforma entenderá que você deseja controlar os valores manualmente e passará a utilizar os valores informados. Para cálculo manual, consulte o cenário [Cálculo Manual de Impostos](./calculo-manual-impostos).

### O cálculo automático funciona para todas as prefeituras?

Sim, o cálculo automático de impostos funciona para todas as prefeituras integradas à plataforma NFE.io.

### E se o valor calculado automaticamente estiver diferente do esperado?

Recomendamos verificar o código de serviço informado e consultar a tabela de alíquotas da prefeitura. Caso o problema persista, [entre em contato com nosso suporte](https://nfe.io/#contato).

---

## Dúvidas adicionais

Caso tenha dúvidas específicas sobre a emissão de notas fiscais com cálculo automático de impostos, [entre em contato com nosso suporte](https://nfe.io/contato) ou consulte seu contador para orientações sobre o enquadramento correto da sua empresa.

---

**Relacionados:**
- [Dúvidas na Integração da NFS-e](/docs/documentacao/nota-fiscal-servico-eletronica/duvidas/)
- [Cálculo de Impostos na NFE.io](/docs/documentacao/nota-fiscal-servico-eletronica/duvidas/calculo-de-impostos)
- [Emitir NFS-e em Lote via Planilha](/docs/documentacao/nossa-plataforma/nota-fiscal-servico/emitir-em-lote)