Guia técnico de emissão de NFS-e em Ivoti/RS pela API da Focus NFe

Saiba como emitir NFS-e em Ivoti (RS) pela API da Focus NFe. Este guia é voltado para clientes e para quem está testando a nossa API. Aqui, você encontra os campos obrigatórios, exemplos e observações específicas para desenvolvedores.

Informações Gerais

Provedor
Tecnos
Padrão
ABRASF 2.00 (com muitas variações)
Autenticação
Certificado digital
Cancelamento
Ativo

Ambientes Disponíveis

Ambiente
Disponível
Portal de Acesso
Produção
Sim
Homologação
Sim

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorObrigatório
Endereço do TomadorObrigatório
Item Lista ServiçoObrigatórioUtiliza o padrão nacional da Lei Complementar 116/2003
Código CNAEObrigatório
Código Tributário MunicípioNão utilizado

Campos Exclusivos

Serviço
$.servico
Reforma
Cód. CST
$.servico.situacao_tributaria_pis_cofins
Reforma
  • Código de Situação Tributária do PIS/COFINS (CST)
  • Valores possíveis:
  • 00 - Nenhum
  • 01 - Operação Tributável com Alíquota Básica
  • 02 - Operação Tributável com Alíquota Diferenciada
  • 03 - Operação Tributável com Alíquota por Unidade de Medida de Produto
  • 04 - Operação Tributável monofásica - Revenda a Alíquota Zero
  • 05 - Operação Tributável por Substituição Tributária
  • 06 - Operação Tributável a Alíquota Zero
  • 07 - Operação Tributável da Contribuição
  • 08 - Operação sem Incidência da Contribuição
  • 09 - Operação com Suspensão da Contribuição
Base Cálculo PIS/COFINS
$.servico.base_calculo_pis_cofins
Reforma
Valor da Base de Cálculo do PIS/COFINS (R$)
Alíq. PIS
$.servico.aliquota_pis
Reforma
Valor da Alíquota do PIS (%)
Alíq. COFINS
$.servico.aliquota_cofins
Reforma
Valor da Alíquota do COFINS (%)
Tipo Retenção PIS/COFINS
$.servico.tipo_retencao_pis_cofins
Reforma
  • Tipo de Retenção do PIS/COFINS
  • Valores possíveis:
  • 1 - Retido
  • 2 - Não Retido
Tipo Imunidade
$.servico.tipo_imunidade
Reforma
  • Identificação da Imunidade do ISSQN - somente para o caso de Imunidade
  • Valores possíveis:
  • 0 - Imunidade (tipo não informado na nota de origem)
  • 1 - Patrimônio, renda ou serviços, uns dos outros (CF88, Art 150, VI, a)
  • 2 - Templos de qualquer culto (CF88, Art 150, VI, b)
  • 3 - Patrimônio, renda ou serviços dos partidos políticos, inclusive suas fundações, das entidades sindicais dos trabalhadores, das instituições de educação e de assistência social, sem fins lucrativos, atendidos os requisitos da lei (CF88, Art 150, VI, c);
  • 4 - Livros, jornais, periódicos e o papel destinado a sua impressão (CF88, Art 150, VI, d)
  • 5 - Fonogramas e videofonogramas musicais produzidos no Brasil contendo obras musicais ou literomusicais de autores brasileiros e/ou obras em geral interpretadas por artistas brasileiros bem como os suportes materiais ou arquivos digitais que os contenham, salvo na etapa de replicação industrial de mídias ópticas de leitura a laser. (CF88, Art 150, VI, e)
Cód. NBS
$.servico.codigo_nbs
Reforma
Código da lista de Nomenclatura Brasileira de Serviços (NBS)
Tomador do Serviço
$.tomador
Reforma
NIF
$.tomador.nif
Reforma
Número de identificação fiscal fornecido por órgão de administração tributária no exterior
Intermediário do Serviço
$.intermediario
Reforma
NIF
$.intermediario.nif
Reforma
Número de identificação fiscal fornecido por órgão de administração tributária no exterior
Endereço
$.intermediario.endereco
Reforma
Informações de Endereço do Intermediário
CEP
$.intermediario.endereco.cep
Reforma
Logradouro
$.intermediario.endereco.logradouro
Reforma
Número
$.intermediario.endereco.numero
Reforma
Bairro
$.intermediario.endereco.bairro
Reforma
Complemento
$.intermediario.endereco.complemento
Reforma
Cód. País
$.intermediario.endereco.codigo_pais
Reforma
Código do País conforme tabela do BACEN
UF
$.intermediario.endereco.uf
Reforma
Sigla da Unidade da Federação - Estado
Cód. Município
$.intermediario.endereco.codigo_municipio
Reforma
Código do Município conforme tabela do IBGE
Atividade Evento
$.evento
Reforma
Informações de Serviço de Atividades e Eventos
Data de Início
$.evento.data_inicio
Reforma
Data de Fim
$.evento.data_fim
Reforma
Endereço
$.evento.endereco
Reforma
Informações de Endereço da Atividade/Evento
CEP
$.evento.endereco.cep
Reforma
Logradouro
$.evento.endereco.logradouro
Reforma
Número
$.evento.endereco.numero
Reforma
Bairro
$.evento.endereco.bairro
Reforma
Complemento
$.evento.endereco.complemento
Reforma
Cód. País
$.evento.endereco.codigo_pais
Reforma
Código do País conforme tabela do BACEN
UF
$.evento.endereco.uf
Reforma
Sigla da Unidade da Federação - Estado
Cód. Município
$.evento.endereco.codigo_municipio
Reforma
Código do Município conforme tabela do IBGE
Destinatário do Serviço
$.destinatario
Reforma
CPF
$.destinatario.cpf
Reforma
CNPJ
$.destinatario.cnpj
Reforma
NIF
$.destinatario.nif
Reforma
Tipo Serviço
$.destinatario.tipo_servico
Reforma
  • Tipo do Destinatário do Serviço
  • Valores possíveis:
  • 0 - Em branco / Não informado
  • 1 - Próprio adquirente do serviço
  • 2 - Outro adquirente (intermediário ou terceiro)
Razão Social
$.destinatario.razao_social
Reforma
Nome ou Razão Social
Telefone
$.destinatario.telefone
Reforma
Email
$.destinatario.email
Reforma
Endereço
$.destinatario.endereco
Reforma
Informações de Endereço do Destinatário
CEP
$.destinatario.endereco.cep
Reforma
Logradouro
$.destinatario.endereco.logradouro
Reforma
Número
$.destinatario.endereco.numero
Reforma
Bairro
$.destinatario.endereco.bairro
Reforma
Complemento
$.destinatario.endereco.complemento
Reforma
Cód. País
$.destinatario.endereco.codigo_pais
Reforma
Código do País conforme tabela do BACEN
UF
$.destinatario.endereco.uf
Reforma
Sigla da Unidade da Federação - Estado
Cód. Município
$.destinatario.endereco.codigo_municipio
Reforma
Código do Município conforme tabela do IBGE
Construção Civil
$.obra
Reforma
Informações de Serviço de Construção Civil
Cód. Obra
$.obra.codigo
Reforma
Código de identificação da obra
ART
$.obra.art
Reforma
Anotação de Responsabilidade Técnica
Endereço Completo
$.obra.endereco
Reforma
Informações de Endereço da Obra
CEP
$.obra.endereco.cep
Reforma
Logradouro
$.obra.endereco.logradouro
Reforma
Número
$.obra.endereco.numero
Reforma
Bairro
$.obra.endereco.bairro
Reforma
Cód. Município
$.obra.endereco.codigo_municipio
Reforma
Código do Município conforme tabela do IBGE
Complemento
$.obra.endereco.complemento
Reforma
UF
$.obra.endereco.uf
Reforma
Sigla da Unidade da Federação - Estado
Cód. País
$.obra.endereco.codigo_pais
Reforma
Código do País conforme tabela do BACEN
Endereço Simplificado
$.obra.endereco_simplificado
Reforma
Endereço por extenso (antigo, condensado em apenas uma string)
Numero Ano
$.obra.numero_ano
Reforma
Tipo Alvará
$.obra.tipo_alvara
Reforma
Inscrição Municipal
$.obra.inscricao_municipal
Reforma
Cód. CIB
$.obra.codigo_cib
Reforma
Código do Cadastro Imobiliário Brasileiro

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 4310801
  },
  "tomador": {
    "cnpj": "11.111.111/0001-11",
    "razao_social": "Fictício Tomador",
    "endereco": {
      "logradouro": "Rua Fictícia",
      "numero": "2",
      "complemento": "ap02",
      "bairro": "Centro",
      "codigo_municipio": 4310801,
      "uf": "RS",
      "cep": "93900-000"
    },
    "telefone": "11 1111-1111",
    "email": "test@example.com"
  },
  "servico": {
    "discriminacao": "Nota emitida em caráter de TESTE de integração com Webservice \n Quebra de linha 1 | Quebra de linha 2",
    "valor_servicos": 1.0,
    "aliquota": 5.0,
    "item_lista_servico": "1.07",
    "codigo_tributacao_nacional_iss": "010701",
    "codigo_cnae": "6209100",
    "codigo_nbs": "1.1501.30.00",
    "iss_retido": false,
    "valor_iss": 0.05
  }
}