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 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 |
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
{
"borrower": {
"type": "LegalEntity",
"name": "Banco do Brasil SA",
"federalTaxNumber": 191,
"municipalTaxNumber": null,
"email": "[email protected]",
"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
federalTaxNumberdeve 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.codedeve 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 | 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 | [email protected] | 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_CNPJpode ser preenchido com ou sem formatação (pontos, traços, barras). - O campo
Valoraceita 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. 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.
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.
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 ou consulte seu contador para orientações sobre o enquadramento correto da sua empresa.
Relacionados: