Guia técnico de emissão de NFS-e em Itaboraí/RJ pela API da Focus NFe

Saiba como emitir NFS-e em Itaboraí (RJ) 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
ItaFacil
Formato
Próprio
Autenticação
Token
O token deve ser gerado no portal da prefeitura conforme orientado em Outras Informações e inserido no campo senha do cadastro do cliente na API, aba Documentos Fiscais
Cancelamento
Ativo

Ambientes Disponíveis

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

Campos do Provedor

Evento
$.evento
Data final do evento
$.evento.data_fim /DataFim
Reforma
Data de início do evento
$.evento.data_inicio /DataInicio
Reforma
Endereco
$.evento.endereco
Bairro
$.evento.endereco.bairro /Bairro
Reforma
CEP
$.evento.endereco.cep /Cep
Reforma
Complemento
$.evento.endereco.complemento /Complemento
Reforma
Logradouro
$.evento.endereco.logradouro /Logradouro
Reforma
Número
$.evento.endereco.numero /Numero
Reforma
Tipo Logradouro
$.evento.endereco.tipo_logradouro /TipoLogradouro
Reforma
Caso o campo não seja envia, será atribuido o valor "Rua"
Nome do evento
$.evento.nome /NomeEvento
Reforma
Imovel
$.imovel
Endereco
$.imovel.endereco
Bairro
$.imovel.endereco.bairro /Bairro
Reforma
CEP
$.imovel.endereco.cep /Cep
Reforma
Código Município
$.imovel.endereco.codigo_municipio /CodigoMunicipio
Reforma
Complemento
$.imovel.endereco.complemento /Complemento
Reforma
Logradouro
$.imovel.endereco.logradouro /Logradouro
Reforma
Número
$.imovel.endereco.numero /Numero
Reforma
Tipo Logradouro
$.imovel.endereco.tipo_logradouro /TipoLogradouro
Reforma
Caso o campo não seja envia, será atribuido o valor "Rua"
UF
$.imovel.endereco.uf /Uf
Reforma
Servico
$.servico
Cód. indic. Operação
$.servico.codigo_indicador_operacao /IndicadorOperacao
Reforma
Código indicador da operação de fornecimento, conforme tabela 'código indicador de operação'
Código NBS
$.servico.codigo_nbs /CodigoNbs
ObrigatórioReforma
Código da lista de Nomenclatura Brasileira de Serviços (NBS)
Código de tributação nacional
$.servico.codigo_tributacao_nacional_iss /CodigoLsnDesdobro
ObrigatórioReforma
Cód. Trib. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria /ClassificacaoTributaria
Reforma
Código de Classificação Tributária do IBS e da CBS
Tomador
$.tomador
Endereco
$.tomador.endereco
Nome da cidade Exterior
$.tomador.endereco.nome_cidade_ext /CidadeEstrangeiro
Reforma
NIF
$.tomador.nif /Nif
Reforma
Número de identificação fiscal fornecido por órgão de administração tributária no exterior

Outras Informações

  • Requer token para emissão via webservices através do passo a passo abaixo:
    • Login no Portal > Webservice NFS-e > Chave Privada Webservice

JSONs de Exemplo

{
  "data_emissao": "2026-01-24T08:40:57.7358629-03:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3301900
  },
  "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": 4106902,
      "uf": "PR",
      "cep": "82900-010"
    },
    "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": 2.0,
    "item_lista_servico": "04.12",
    "valor_iss": 0.02,
    "iss_retido": false,
    "codigo_nbs": "123012300",
    "codigo_tributacao_nacional_iss": "04.12.01",
    "codigo_indicador_operacao": "030101",
    "ibs_cbs_classificacao_tributaria": "200029"
  }
}