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

Saiba como emitir NFS-e em Ipojuca (PE) 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
Tinus
Padrão
ABRASF 2.3 (com variações)
Autenticação
Certificado digital
Cancelamento
Ativo

Ambientes Disponíveis

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

Campos Importantes

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

Campos Exclusivos

Chaves de acesso das NFS-e referenciadas
$.chaves_nfse_referenciadas /gRefNFSe
Reforma
Lista de objetos do tipo chave_nfse
Chave da NFS-e referenciada
$.chaves_nfse_referenciadas[].chave_nfse /refNFSe
Reforma
Indica operação de uso ou consumo pessoal (art. 57)
$.consumidor_final /indFinal
Reforma
  • Valores possíveis:
  • 0 - Não
  • 1 - Sim
Destinatário
$.destinatario /dest
Reforma
Grupo de informações do destinatário. O destinatário só deve ser informado quando [indicador_destinatario = 1]
CNPJ
$.destinatario.cnpj /CNPJ
Reforma
Número do CNPJ
CPF
$.destinatario.cpf /CPF
Reforma
Número do CPF
Email
$.destinatario.email /email
Reforma
Endereço
$.destinatario.endereco /end
Reforma
Grupo de informações do endereço
Bairro do endereço
$.destinatario.endereco.bairro /xBairro
Reforma
CEP
$.destinatario.endereco.cep /CEP
Reforma
CEP no exterior
$.destinatario.endereco.cep_ext /cEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Código município
$.destinatario.endereco.codigo_municipio /cMun
Reforma
Código do país
$.destinatario.endereco.codigo_pais_ext /cPais
Reforma
Tabela de Países ISO
Complemento do endereço
$.destinatario.endereco.complemento /xCpl
Reforma
Logradouro
$.destinatario.endereco.logradouro /xLgr
Reforma
Nome da cidade no exterior
$.destinatario.endereco.nome_cidade_ext /xCidade
Reforma
Nome da cidade no exterior
Número no logradouro do endereço
$.destinatario.endereco.numero /nro
Reforma
Região no exterior
$.destinatario.endereco.regiao_ext /xEstProvReg
Reforma
Estado, província ou região da cidade no exterior
Motivo ausência NIF
$.destinatario.motivo_ausencia_nif /cNaoNIF
Reforma
  • Tipo 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
$.destinatario.nif /NIF
Reforma
Número de Identificação Fiscal fornecido por um órgão de administração tributária no exterior
Razão Social
$.destinatario.razao_social /xNome
Reforma
Nome ou Razão Social
Telefone
$.destinatario.telefone /fone
Reforma
Documentos Referenciados
$.documentos_referenciados /gReeRepRes
Reforma
Lista de objetos do tipo documentos_referenciados
Chave DFe
$.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 do fornecedor
$.documentos_referenciados[].cnpj_fornecedor /CNPJ
Reforma
Código município
$.documentos_referenciados[].codigo_municipio_documento_fiscal_outro /cMunDocFiscal
Reforma
Cód. do município emissor do doc. fiscal que não se encontra no repositório nacional
CPF do fornecedor
$.documentos_referenciados[].cpf_fornecedor /CPF
Reforma
Data comp. doc. ded.
$.documentos_referenciados[].data_competencia_documento_dedutivel /dtCompDoc
Reforma
Data da comp. do documento dedutível. (AAAA-MM-DD)
Data emissão doc. ded.
$.documentos_referenciados[].data_emissao_documento_dedutivel /dtEmiDoc
Reforma
Data da emissão do documento dedutível. (AAAA-MM-DD)
Descrição chave DFe
$.documentos_referenciados[].descricao_chave_dfe /xTipoChaveDFe
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)
Descrição do doc.
$.documentos_referenciados[].descricao_documento_fiscal_outro /xDocFiscal
Reforma
Desc. doc. não fiscal
$.documentos_referenciados[].descricao_documento_nao_fiscal_outro /xDoc
Reforma
Desc. repasse
$.documentos_referenciados[].descricao_tipo_valor_incluido /xTpReeRepRes
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"
Motivo ausência NIF do forn.
$.documentos_referenciados[].motivo_ausencia_nif_fornecedor /cNaoNIF
Reforma
  • Tipo 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 do fornecedor
$.documentos_referenciados[].nif_fornecedor /NIF
Reforma
Tipo NIF (Número de Identificação Fiscal) - fornecido por um órgão de administração tributária no exterior
Número do documento fiscal
$.documentos_referenciados[].numero_documento_fiscal_outro /nDocFiscal
Reforma
Número do documento fiscal que não se encontra no repositório nacional
Número do documento não fiscal
$.documentos_referenciados[].numero_documento_nao_fiscal /nDoc
Reforma
Razão Social do fornecedor
$.documentos_referenciados[].razao_social_fornecedor /xNome
Reforma
Nome ou Razão Social
Tipo chave DFe
$.documentos_referenciados[].tipo_chave_dfe /tipoChaveDFe
Reforma
  • Tipo de documento do repositório nacional. Valores possíveis:
  • 1 - NFS-e
  • 2 - NF-e
  • 3 - CT-e
  • 9 - Outro
Tipo valor incluído
$.documentos_referenciados[].tipo_valor_incluido /tpReeRepRes
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 referenciado
Val. reemb./ressarc.
$.documentos_referenciados[].valor_repasse /vlrReeRepRes
Reforma
Valor monetário reembolso ou ressarcimento(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$)
Indicador da finalidade da emissão de NFS-e
$.finalidade_emissao /finNFSe
Reforma
  • Valores possíveis:
  • 0 - NFS-e regular
Imóvel
$.imovel /imovel
Reforma
Grupo de informações de operações relacionadas a bens imóveis, exceto obras
CIB
$.imovel.codigo_cib /cCIB
Reforma
Código do Cadastro Imobiliário Brasileiro - CIB
Endereço do imóvel
$.imovel.endereco /end
Reforma
Grupo de informações do endereço do imóvel
Bairro do endereço
$.imovel.endereco.bairro /xBairro
Reforma
CEP
$.imovel.endereco.cep /CEP
Reforma
CEP no exterior
$.imovel.endereco.cep_ext /cEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Complemento do endereço
$.imovel.endereco.complemento /xCpl
Reforma
Logradouro
$.imovel.endereco.logradouro /xLgr
Reforma
Nome da cidade no exterior
$.imovel.endereco.nome_cidade_ext /xCidade
Reforma
Nome da cidade no exterior
Número no logradouro do endereço
$.imovel.endereco.numero /nro
Reforma
Região no exterior
$.imovel.endereco.regiao_ext /xEstProvReg
Reforma
Estado, província ou região da cidade no exterior
Inscrição imobiliária fiscal
$.imovel.inscricao_imobiliaria /inscImobFisc
Reforma
Ind. Destinatário
$.indicador_destinatario /indDest
Reforma
  • Indica o destinatário do serviço. 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)
Percentual de diferimento para a CBS
$.servico.cbs_percentual_diferimento /pDifCBS
Reforma
Código indicador da operação
$.servico.codigo_indicador_operacao /cIndOp
Reforma
Código indicador da operação de fornecimento, conforme tabela "código indicador de operação"
Cód. NBS
$.servico.codigo_nbs /CodigoNbs
Reforma
Código da lista de Nomenclatura Brasileira de Serviços (NBS)
Cód. class. trib. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria /cClassTrib
Reforma
Código de Classificação Tributária do IBS e da CBS
Cód. class. trib. reg. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria_regular /cClassTribReg
Reforma
Código de Classificação Tributária do IBS e da CBS de tributação regular
Cód. créd. pres. IBS/CBS
$.servico.ibs_cbs_credito_codigo_classificacao /cCredPres
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 do IBS e da CBS
CST trib. reg. IBS/CBS
$.servico.ibs_cbs_situacao_tributaria_regular /CSTReg
Reforma
Código de Situação Tributária do IBS e da CBS de tributação regular
Perc. de diferimento para IBS Mun.
$.servico.ibs_mun_percentual_diferimento /pDifMun
Reforma
Perc. de diferimento para IBS UF
$.servico.ibs_uf_percentual_diferimento /pDifUF
Reforma
Valor Total Tributos
$.servico.valor_total_tributos /ValTotTributos
Reforma
Tipo de ente governamental
$.tipo_compra_governamental /tpEnteGov
Reforma
  • Tipo de ente governamental. Para administração pública direta e suas autarquias e fundações.
  • Valores possíveis:
  • 1 - União
  • 2 - Estado
  • 3 - Distrito Federal
  • 4 - Município
Tipo Operação Entes Governamentais
$.tipo_operacao_governamental /tpOper
Reforma
  • Tipo de Operação com Entes Governamentais ou outros serviços sobre bens imó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.
NIF
$.tomador.nif /NifTomador
Reforma
Número de identificação fiscal fornecido por órgão de administração tributária no exterior

JSONs de Exemplo

{
  "data_emissao": "2026-01-13T23:33:35-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123456",
    "codigo_municipio": 2607208
  },
  "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": 2607208,
      "uf": "PE",
      "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": 5.0,
    "item_lista_servico": "09.01",
    "codigo_cnae": "5510801",
    "codigo_nbs": "105011130",
    "iss_retido": false
  }
}