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

Saiba como emitir NFS-e em Fortaleza (CE) 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
Próprio
Formato
Próprio (ABRASF)
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 TomadorOpcional
Endereço do TomadorOpcional
Item Lista ServiçoObrigatórioUtiliza o padrão da Lei Complementar 116/2003
Código CNAEObrigatório
Código Tributário MunicípioObrigatórioUtiliza um formato próprio que é uma extensão do código CNAE de 9 dígitos. Consulte uma nota já emitida pela empresa.
Inscrição MunicipalObrigatório

Campos do Provedor

Categoria Serviço
$.categoria_servico /CategoriaServico
Reforma
  • Código do Tipo de Categoria do Serviço Prestado(Locação/Sublocação)
  • Valores possíveis:
  • 1 - Locação
  • 2 - Sublocação
  • 3 - Arrendamento
  • 4 - Direito de Passagem
  • 5 - Permissão de Uso
NFSes Referênciadas
$.chaves_nfse_referenciadas /GrupoNFSeReferenciada
Chave da NFS-e referenciada
$.chaves_nfse_referenciadas[].chave_nfse /ChaveNFSeReferenciada
Reforma
Cód. Moeda
$.codigo_moeda /TipoMoeda
Reforma
Código da Moeda que identifica a transação comercial
Cód. operação final
$.consumidor_final /CodigoIndicadorOperacaoUsoConsumoPessoal
Reforma
  • Código que Indica a Operação de Uso ou Consumo Pessoal
  • Valores possíveis:
  • 0 - Não
  • 1 - Sim
Destinatário
$.destinatario /Destinatario
CNPJ Destinatário
$.destinatario.cnpj /Cnpj
Reforma
CPF Destinatário
$.destinatario.cpf /Cpf
Reforma
Email Destinatário
$.destinatario.email /Email
Reforma
Endereço Destinatário
$.destinatario.endereco /Endereco
Bairro
$.destinatario.endereco.bairro /Bairro
Reforma
CEP
$.destinatario.endereco.cep /Cep
Reforma
Código Município
$.destinatario.endereco.codigo_municipio /CodigoMunicipio
Reforma
Complemento
$.destinatario.endereco.complemento /Complemento
Reforma
Logradouro
$.destinatario.endereco.logradouro /Endereco
Reforma
Número
$.destinatario.endereco.numero /Numero
Reforma
UF
$.destinatario.endereco.uf /Uf
Reforma
NãoNIF Destinatário
$.destinatario.motivo_ausencia_nif /NaoNif
Reforma
  • Código do Motivo para não informação do NIF
  • Valores possíveis:
  • 0 - Não informado na nota de origem
  • 1 - Dispensado do NIF
  • 2 - Não exigência do NIF
NIF Destinatário
$.destinatario.nif /Nif
Reforma
Nome Destinatário
$.destinatario.razao_social /Nome
Reforma
Telefone Destinatário
$.destinatario.telefone /Telefone
Reforma
Documentos
$.documentos_referenciados /GrupoReeRepRes
Chave DF-e
$.documentos_referenciados[].chave_dfe /ChaveDFe
Reforma
Chave do Documento Fiscal eletrônico do repositório nacional referenciado para os casos de operações já tributadas
CNPJ Fornecedor
$.documentos_referenciados[].cnpj_fornecedor /Cnpj
Reforma
Cod. Mun. Emissor
$.documentos_referenciados[].codigo_municipio_documento_fiscal_outro /CodigoMunicipioDocFiscal
Reforma
Código IBGE do município emissor do documento fiscal que não se encontra no repositório nacional
CPF Fornecedor
$.documentos_referenciados[].cpf_fornecedor /Cpf
Reforma
Dt. Comp. Doc.
$.documentos_referenciados[].data_competencia_documento_dedutivel /DataCompetenciaDocumento
Reforma
Data da competência do documento dedutível. Ano, mês e dia (AAAA-MM-DD)
Dt. Emissão Doc.
$.documentos_referenciados[].data_emissao_documento_dedutivel /DataEmissaoDocumento
Reforma
Data da emissão do documento dedutível. Ano, mês e dia (AAAA-MM-DD)
Descrição DF-e
$.documentos_referenciados[].descricao_chave_dfe /DescTipoChaveDFe
Reforma
Descrição da DF-e a que se refere a chaveDfe que seja um dos documentos do Repositório Nacional. Deve ser preenchido apenas quando tipoChaveDFe = 9 (Outro)
Desc. Doc. Fiscal
$.documentos_referenciados[].descricao_documento_fiscal_outro /DescTipoChaveDFe
Reforma
Descrição do documento fiscal
Desc. Doc. não Fiscal
$.documentos_referenciados[].descricao_documento_nao_fiscal_outro /DescDocumentoOutro
Reforma
Descrição do documento não fiscal
Desc. tipo valor incluido
$.documentos_referenciados[].descricao_tipo_valor_incluido /DescTipoReeRepRes
Reforma
Descrição do reembolso ou ressarcimento quando a opção é '99 – Outros reembolsos ou ressarcimentos recebidos por valores pagos relativos a operações por conta e ordem de terceiro'
NãoNIF Fornecedor
$.documentos_referenciados[].motivo_ausencia_nif_fornecedor /NaoNif
Reforma
  • Código do Motivo para não informação do NIF
  • Valores possíveis:
  • 0 - Não informado na nota de origem
  • 1 - Dispensado do NIF
  • 2 - Não exigência do NIF
NIF Fornecedor
$.documentos_referenciados[].nif_fornecedor /Nif
Reforma
Num. Doc. Fiscal
$.documentos_referenciados[].numero_documento_fiscal_outro /NumeroDocumentoFiscal
Reforma
Número do documento fiscal que não se encontra no repositório nacional
Num. Doc. não Fiscal
$.documentos_referenciados[].numero_documento_nao_fiscal_outro /NumeroDocumentoOutro
Reforma
Número do documento não fiscal
Nome Fornecedor
$.documentos_referenciados[].razao_social_fornecedor /Nome
Reforma
Tipo Chave DF-e
$.documentos_referenciados[].tipo_chave_dfe /TipoChaveDFe
Reforma
  • Código do Documento fiscal a que se refere a chaveDfe que seja um dos documentos do Repositório Nacional
  • Valores possíveis:
  • 1: NFS-e
  • 2: NF-e
  • 3: CT-e
  • 9: Outro
Tipo valor incluido
$.documentos_referenciados[].tipo_valor_incluido /TipoReeRepRes
Reforma
  • Tipo de valor incluído neste documento, recebido por motivo de estarem relacionadas a operações de terceiros, objeto de reembolso, repasse ou ressarcimento pelo recebedor, já tributados e aqui referenciados
  • Valores possíveis:
  • 01 - Repasse de remuneração por intermediação de imóveis a demais corretores envolvidos na operação
  • 02 - Repasse de valores a fornecedor relativo a fornecimento intermediado por agência de turismo
  • 03 - Reembolso ou ressarcimento recebido por agência de propaganda e publicidade por valores pagos relativos a serviços de produção externa por conta e ordem de terceiro
  • 04 - Reembolso ou ressarcimento recebido por agência de propaganda e publicidade por valores pagos relativos a serviços de mídia por conta e ordem de terceiro
  • 99 - Outros reembolsos ou ressarcimentos recebidos por valores pagos relativos a perações por conta e ordem de terceiro
Valor reembolso
$.documentos_referenciados[].valor_reembolso_repasse_ressarcimento /ValorReeRepRes
Reforma
Valor monetário (total ou parcial, conforme documento informado) utilizado para não inclusão na base de cálculo do ISS e do IBS e da CBS da NFS-e que está sendo emitida (R$)
Evento
$.evento /Eventos
Cód. Evento
$.evento.codigo /IdentificacaoEvento
Reforma
Código Identificador do Evento
Data Fim Evento
$.evento.data_fim /DataFimEvento
Reforma
Data Fim do Evento. Formato: AAAA-MMDDThh:mm:ss
Data Inicio Evento
$.evento.data_inicio /DataInicioEvento
Reforma
Data de Início do Evento. Formato: AAAA-MMDDThh:mm:ss
Endereço Evento
$.evento.endereco /Endereco
Bairro
$.evento.endereco.bairro /Bairro
Reforma
CEP
$.evento.endereco.cep /Cep
Reforma
Código Município
$.evento.endereco.codigo_municipio /CodigoMunicipio
Reforma
Complemento
$.evento.endereco.complemento /Complemento
Reforma
Logradouro
$.evento.endereco.logradouro /Endereco
Reforma
Número
$.evento.endereco.numero /Numero
Reforma
UF
$.evento.endereco.uf /Uf
Reforma
Nome Evento
$.evento.nome /NomeEvento
Reforma
Descrição/nome do Evento
Extensão Obj.
$.extensao_objeto /Extensao
Reforma
Extensão totalda ferrovia, rodovia, cabos, dutos ou condutos
Finalidade emissão
$.finalidade_emissao /CodigoIndicadorFinalidadeNFSe
Reforma
  • Código Indicador da finalidade da emissão da NFS-e
  • Valores possíveis:
  • 0 - NFSe Regular
Imóvel
$.imovel /Imovel
Cód. CIB
$.imovel.codigo_cib /CodigoCIB
Reforma
Endereço Imóvel
$.imovel.endereco /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 /Endereco
Reforma
Número
$.imovel.endereco.numero /Numero
Reforma
UF
$.imovel.endereco.uf /Uf
Reforma
Insc. Imobiliária fiscal
$.imovel.inscricao_imobiliaria_fiscal /InscImobFisc
Reforma
Inscrição imobiliária fiscal (código fornecido pela prefeitura para a identificação da obra ou para fins de recolhimento do IPTU)
Cód. tipo de Destinatário
$.indicador_destinatario /IndDest
Reforma
  • Código do Tipo de Destinatário dos Serviços
  • Valores possíveis:
  • 0 - O destinatário é o próprio tomador/adquirente identificado na NFS-e (tomador=adquirente=destinatário)
  • 1 - O destinatário não é o próprio adquirente, podendo ser outra pessoa, física ou jurídica (ou equiparada), ou um estabelecimento diferente do indicado como tomador (tomador=adquirente≠destinatário)
Apoio prestador ext.
$.mecanismo_comercio_ext_prestador /MecanismoComexPrestador
Reforma
  • Código do Mecanismo de Apoio/fomento ao Comércio Exterior utilizado pelo prestador do serviço
  • Valores possíveis:
  • 00 - Desconhecido (tipo não informado na nota de origem)
  • 01 - Nenhum
  • 02 - ACC - Adiantamento sobre Contrato de Câmbio – Redução a Zero do IR e do IOF
  • 03 - ACE – Adiantamento sobre Cambiais Entregues - Redução a Zero do IR e do IOF
  • 04 - BNDES-Exim Pós-Embarque – Serviços
  • 05 - BNDES-Exim Pré-Embarque - Serviços
  • 06 - FGE - Fundo de Garantia à Exportação
  • 07 - PROEX - EQUALIZAÇÃO
  • 08 - PROEX - Financiamento
Apoio tomador ext.
$.mecanismo_comercio_ext_tomador /MecanismoComexTomador
Reforma
  • Código do Mecanismo de Apoio/Fomento ao Comércio Exterior utilizado pelo tomador do serviço
  • Valores possíveis:
  • 00 - Desconhecido (tipo não informado na nota de origem)
  • 01 - Nenhum
  • 02 - Adm. Pública e Repr. Internacional
  • 03 - Alugueis e Arrend. Mercantil de maquinas, equip., embarc. e aeronaves
  • 04 - Arrendamento Mercantil de aeronave para empresa de transporte aéreo público
  • 05 - Comissão a agentes externos na exportação
  • 06 - Despesas de armazenagem, mov. e transporte de carga no exterior
  • 07 - Eventos FIFA (subsidiária)
  • 08 - Eventos FIFA
  • 09 - Fretes, arrendamentos de embarcações ou aeronaves e outros
  • 10 - Material Aeronáutico
  • 11 - Promoção de Bens no Exterior
  • 12 - Promoção de Dest. Turísticos Brasileiros
  • 13 - Promoção do Brasil no Exterior
  • 14 - Promoção Serviços no Exterior
  • 15 - RECINE
  • 16 - RECOPA
  • 17 - Registro e Manutenção de marcas, patentes e cultivares
  • 18 - REICOMP
  • 19 - REIDI
  • 20 - REPENEC
  • 21 - REPES
  • 22 - RETAERO
  • 23 - RETID
  • 24 - Royalties, Assistência Técnica, Científica e Assemelhados
  • 25 - Serviços de avaliação da conformidade vinculados aos Acordos da OMC
  • 26 - ZPE
Modo prestação
$.modo_prestacao /ModoPrestacao
Reforma
  • Código do Modo de Prestação do Serviço
  • Valores possíveis:
  • 0 - Desconhecido (tipo não informado na nota de origem)
  • 1 - Transfronteiriço
  • 2 - Consumo no Brasil
  • 3 - Movimento Temporário de Pessoas Físicas
  • 4 - Consumo no Exterior
Movimentação Temp. Bens
$.movimentacao_temporaria_bens /MovimentacaoTempBens
Reforma
  • Código do Vínculo da Operação à Movimentação Temporária de Bens
  • Valores possíveis:
  • 0 - Desconhecido (tipo não informado na nota de origem)
  • 1 - Não
  • 2 - Vinculada - Declaração de Importação
  • 3 - Vinculada - Declaração de Exportação
Núm. Declaração Imp.
$.numero_declaracao_importacao /NumeroDeclaracao
Reforma
Número da Declaração de Importação (DI/DSI/DA/DRIE) averbado
Núm. Total de Postes
$.numero_postes /NumeroPostes
Reforma
Núm. Registro Exp.
$.numero_registro_exportacao /NumeroRegistro
Reforma
Número do Registro de Exportação (RE) averbado
Obra
$.obra /ContrucaoCivil
Art Obra
$.obra.art /Art
Reforma
Cadastro Nacional Obra
$.obra.cno /CadNacObra
Reforma
Número de identificação da obra pelo Cadastro Nacional de Obras ou Cadastro Específico do INSS
Cód. Obra
$.obra.codigo /CodigoObra
Reforma
Endereço Obra
$.obra.endereco /Endereco
Bairro
$.obra.endereco.bairro /Bairro
Reforma
CEP
$.obra.endereco.cep /Cep
Reforma
Código Município
$.obra.endereco.codigo_municipio /CodigoMunicipio
Reforma
Complemento
$.obra.endereco.complemento /Complemento
Reforma
Logradouro
$.obra.endereco.logradouro /Endereco
Reforma
Número
$.obra.endereco.numero /Numero
Reforma
UF
$.obra.endereco.uf /Uf
Reforma
Insc. imobiliária da obra
$.obra.inscricao_imobiliaria /InscImobFiscal
Reforma
Perc. dife. IBS para CBS
$.servico.cbs_percentual_diferimento /PercentualDiferimentoCbs
Reforma
Percentual de diferimento para o IBS municipal
Cód. Indic. Ope.
$.servico.codigo_indicador_operacao /CodigoIndicadorOperacao
Reforma
Código Indicador da Operação de Fornecimento
Cód. NBS
$.servico.codigo_nbs /CodigoNbs
Reforma
Código da lista de Nomenclatura Brasileira de Serviços (NBS)
Cód. Trib. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria /CodigoClassTrib
Reforma
Código de Classificação Tributária (cClassTrib) do IBS e da CBS
Cód. Trib. Reg. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria_regular /CodigoClassTribReg
Reforma
Código de Classificação Tributária do IBS e da CBS
Cód. Créd. presumido IBS/CBS
$.servico.ibs_cbs_credito_codigo_classificacao /CodigoCreditoPresumido
Reforma
Código e classificação do crédito presumido: IBS e CBS
CST IBS/CBS
$.servico.ibs_cbs_situacao_tributaria /CST
Reforma
Código de Situação Tributária (CST) do IBS e da CBS
CST Reg. IBS/CBS
$.servico.ibs_cbs_situacao_tributaria_regular /CodigoSitTribReg
Reforma
Código de Situação Tributária do IBS e da CBS de tributação regular
Perc. dife. IBS Mun
$.servico.ibs_mun_percentual_diferimento /PercentualDiferimentoIbsMun
Reforma
Percentual de diferimento para o IBS municipal
Perc. dife. IBS UF
$.servico.ibs_uf_percentual_diferimento /PercentualDiferimentoIbsUf
Reforma
Percentual de diferimento para o IBS estadual
Tipo de ente governamental
$.tipo_ente_governamental /TipoEnteGovernamental
Reforma
  • Código do Tipo de Ente Governamental para Administração Pública e suas autarquias e fundações
  • Valores possíveis:
  • 1 - União
  • 2 - Estado
  • 3 - Distrito Federal
  • 4 - Município
Tipo Obj.
$.tipo_objeto /TipoObjeto
Reforma
  • Código do Tipo de Objeto do Serviço Prestado(Locação/Sublocação)
  • Valores possíveis:
  • 1 - Ferrovia
  • 2 - Rodovia
  • 3 - Postes
  • 4 - Cabos
  • 5 - Dutos
  • 6 - Condutos de qualquer natureza
Cód. tipo Ope.
$.tipo_operacao_governamental /TipoOp
Reforma
  • Código do Tipo de Operação com Entes Governamentais ou outros serviços sobre bens imóveis
  • Valores possíveis:
  • 1 - Fornecimento com pagamento posterior
  • 2 - Recebimento do pagamento com fornecimento já realizado
  • 3 - Fornecimento com pagamento já realizado
  • 4 - Recebimento do pagamento com fornecimento posterior
  • 5 - Fornecimento e recebimento do pagamento concomitantes.
Valor serv. ext.
$.valor_servico_ext /ValorServicoExportacao
Reforma
Valor do Serviço Prestado expresso em moeda estrangeira especificada em Tipo Moeda
Vínculo negócio
$.vinculo_negocio /VinculoPrestacao
Reforma
  • Código do Vínculo Entre as Partes no Negócio
  • Valores possíveis:
  • 0 - Sem vínculo com o Tomador/Prestador
  • 1 - Controlada
  • 2 - Controladora
  • 3 - Coligada
  • 4 - Matriz
  • 5 - Filial ou sucursal
  • 6 - Outro vínculo

Outras Informações

  • O cadastro da Inscrição Municipal não deve ser cadastrado com o dígito verificador. Caso contrário a prefeitura irá devolver um erro. A inscrição municipal do emitente deve ser informada sem o dígito verificador. Caso contrário você irá receber a mensagem de erro “E70 – Inscrição Municipal do prestador especificada no lote não confere com o prestador informado no RPS”.
  • Para poder emitir NFSe, você deve acessar site e habilitar o ambiente de homologação em Controle de Acesso -> Solicitar homologação de Lotes de RPS. Com isso você poderá emitir notas nos dois ambientes.
  • As notas podem ser consultadas em ambiente de produção e no ambiente de homologação

JSONs de Exemplo

{
  "data_emissao": "2026-02-03T07:56:55-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "regime_especial_tributacao": 2,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 2304400
  },
  "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": 2304400,
      "uf": "CE",
      "cep": "60851190"
    },
    "telefone": "11 1111-1111",
    "email": "test@example.com"
  },
  "servico": {
    "item_lista_servico": "07.09",
    "codigo_cnae": "3822000",
    "codigo_tributario_municipio": "382200001",
    "codigo_nbs": "1.2403.11.00",
    "codigo_indicador_operacao": "050102",
    "ibs_cbs_situacao_tributaria": "000",
    "ibs_cbs_classificacao_tributaria": "000001",
    "iss_retido": false,
    "valor_servicos": 1.0,
    "aliquota": 5.0,
    "discriminacao": "Nota emitida em caráter de TESTE de integração com Webservice"
  },
  "finalidade_emissao": 0,
  "indicador_destinatario": 0,
  "consumidor_final": 0
}