Guia técnico de emissão de NFS-e em Sengés/PR pela API da Focus NFe

Saiba como emitir NFS-e em Sengés (PR) 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
Equiplano
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 TomadorObrigatório
Endereço do TomadorObrigatório
Item Lista ServiçoNão utilizado
Código CNAENão utilizado
Código Tributário MunicípioNão utilizado

Campos do Provedor

Chave de acesso da NFS-e substituída
$.chave_nfse_substituida /chNFSeSubstituida
Reforma
Chave de acesso com 50 dígitos. Informar esta OU o número da NFS-e substituída
NFS-e referenciadas
$.chaves_nfse_referenciadas /listaNfseReferenciada
Obrigatório quando o tpOper exigir. Até 99 chaves
Chave de acesso da NFS-e referenciada
$.chaves_nfse_referenciadas[].chave_nfse /chNFSe
Reforma
Chave de acesso com 50 dígitos
Motivo da substituição
$.codigo_justificativa_substituicao /cdMotivo
Reforma
  • Valores possíveis:
  • 1 - Desenquadramento de NFS-e do Simples Nacional
  • 2 - Enquadramento de NFS-e no Simples Nacional
  • 3 - Inclusão retroativa de imunidade ou isenção para NFS-e
  • 4 - Exclusão retroativa de imunidade ou isenção para NFS-e
  • 5 - Rejeição de NFS-e pelo tomador ou pelo intermediário
  • 99 - Outros (ausente = 99)
Código da moeda
$.codigo_moeda /tpMoeda
Reforma
ISO 4217 - 3 letras, ex.: BR, USD, EUR
Indicador de operação para consumidor final
$.consumidor_final /indFinal
Reforma
  • Valores possíveis:
  • 0 - Não é operação para consumidor final
  • 1 - Operação para consumidor final
Evento
$.evento /evento
Código/identificador da atividade do evento
$.evento.codigo /codAtvEv
Reforma
Data de fim do evento
$.evento.data_fim /dtFim
Reforma
Data de início do evento
$.evento.data_inicio /dtInicio
Reforma
Endereço
$.evento.endereco /endereco
Bairro do endereço
$.evento.endereco.bairro /nmBairro
Reforma
CEP
$.evento.endereco.cep /cep
Reforma
CEP do endereço (somente para endereço nacional)
CEP Exterior
$.evento.endereco.cep_ext /cdEndPost
Reforma
Código postal do endereço (somente para endereço no exterior)
Complemento do endereço
$.evento.endereco.complemento /dsComplemento
Reforma
Logradouro/descrição do endereço
$.evento.endereco.logradouro /dsEndereco
Reforma
Nome da cidade no exterior
$.evento.endereco.nome_cidade_ext /nmCidadeExt
Reforma
Número do endereço
$.evento.endereco.numero /nrEndereco
Reforma
Nome do estado/província/região no exterior
$.evento.endereco.regiao_ext /nmEstProvRegExt
Reforma
Nome/descrição do evento
$.evento.nome /nmEvento
Reforma
Finalidade da NFS-e
$.finalidade_emissao /finNFSe
Reforma
  • Valores possíveis:
  • 0 - Regular
  • 1 - Crédito
  • 2 - Débito
Imóvel objeto do serviço
$.imovel /imovel
Obrigatório quando o serviço e o indOp exigirem; não informar junto com o grupo obra do serviço
Código do Cadastro Imobiliário Brasileiro (CIB)
$.imovel.codigo_cib /cdCib
Reforma
8 caracteres (7 do código e o dígito verificador), sem máscara. Informar esta OU o endereço do imóvel
Endereço do imóvel
$.imovel.endereco /endereco
Bairro do imóvel
$.imovel.endereco.bairro /nmBairro
Reforma
CEP do imóvel
$.imovel.endereco.cep /cep
Reforma
Complemento do endereço do imóvel
$.imovel.endereco.complemento /dsComplemento
Reforma
Logradouro do imóvel
$.imovel.endereco.logradouro /dsEndereco
Reforma
Número do endereço do imóvel
$.imovel.endereco.numero /nrEndereco
Reforma
Inscrição imobiliária fiscal
$.imovel.inscricao_imobiliaria /inscImobFisc
Reforma
Código da prefeitura que identifica o imóvel ou a obra (ou usado para o IPTU)
Indicador do Destinatário dos serviços
$.indicador_destinatario /indDest
Reforma
  • Valores possíveis:
  • 0 - destinatário é o próprio tomador/adquirente(tomador=adquirente=destinatário)
  • 1 - destinatário diferente do adquirente, podendo ser outra pessoa ou estabelecimento(tomador=adquirente≠destinatário)
MDIC
$.mdic /mdic
Reforma
  • Indicador de envio ao MDIC
  • Valores possíveis:
  • 0 - Não enviar para o MDIC
  • 1 - Enviar para o MDIC
Mecanismo de aferição (Prestador) no comércio exterior
$.mecanismo_comercio_ext_prestador /mecAFComexP
Reforma
  • Valores possíveis:
  • 00 - Desconhecido (somente no compartilhamento Município -> ADN)
  • 01 - Nenhum
  • 02 - ACC
  • 03 - ACE
  • 04 - BNDES-Exim Pós-Embarque – Serviços
  • 05 - BNDES-Exim Pré-Embarque – Serviços
  • 06 - FGE
  • 07 - PROEX - EQUALIZAÇÃO
  • 08 - PROEX - Financiamento
Mecanismo de aferição (Tomador) no comércio exterior
$.mecanismo_comercio_ext_tomador /mecAFComexT
Reforma
  • Valores possíveis:
  • 00 - Desconhecido (somente no compartilhamento Município -> ADN)
  • 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 de prestação vinculado ao exterior
$.modo_prestacao /mdPrestacao
Reforma
  • Valores possíveis:
  • 0 - Desconhecido (somente no compartilhamento Município -> ADN)
  • 1 - Transfronteiriço
  • 2 - Consumo no Brasil
  • 3 - Movimento Temporário de Pessoas Físicas
  • 4 - Consumo no Exterior
Descrição do motivo da substituição
$.motivo_substituicao /dsMotivo
Reforma
Obrigatório quando o motivo é 99 (Outros)
Indicador de movimentação temporária de bens
$.movimentacao_temporaria_bens /movTempBens
Reforma
  • Valores possíveis:
  • 0 - Desconhecido (somente no compartilhamento Município -> ADN)
  • 1 - Não
  • 2 - Vinculada - Declaração de Importação (DI)
  • 3 - Vinculada - Declaração de Exportação (RE)
Código do benefício municipal
$.numero_beneficio_municipal /cdBeneficio
Reforma
Código do benefício municipal com 14 dígitos: código IBGE do município (7), tipo de parametrização (2) e sequencial (5)
Número da Declaração de Importação (DI)
$.numero_declaracao_importacao /nDI
Reforma
Número da NFS-e substituída
$.numero_nfse_substituida /nrNfseSubstituida
Reforma
Número da NFS-e substituída, emitida pelo próprio prestador
Número do Registro de Exportação (RE)
$.numero_registro_exportacao /nRE
Reforma
Obra
$.obra /obra
Código/identificador da obra
$.obra.codigo /codObra
Reforma
Endereço
$.obra.endereco /endereco
Bairro do endereço
$.obra.endereco.bairro /nmBairro
Reforma
CEP
$.obra.endereco.cep /cep
Reforma
CEP do endereço (somente para endereço nacional)
CEP Exterior
$.obra.endereco.cep_ext /cdEndPost
Reforma
Código postal do endereço (somente para endereço no exterior)
Complemento do endereço
$.obra.endereco.complemento /dsComplemento
Reforma
Logradouro/descrição do endereço
$.obra.endereco.logradouro /dsEndereco
Reforma
Nome da cidade no exterior
$.obra.endereco.nome_cidade_ext /nmCidadeExt
Reforma
Número do endereço
$.obra.endereco.numero /nrEndereco
Reforma
Nome do estado/província/região no exterior
$.obra.endereco.regiao_ext /nmEstProvRegExt
Reforma
Serviço
$.servico /servico
Cód. indic. Operação
$.servico.codigo_indicador_operacao /indOp
Reforma
Código do Indicador da Operação, conforme tabela oficial
Código NBS
$.servico.codigo_nbs /cdNbs
Reforma
Código de tributação nacional
$.servico.codigo_tributacao_nacional_iss /nrServico
Reforma
Cód. Trib. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria /cClassTrib
Reforma
Código de Classificação Tributária do IBS e da CBS
Tipo de Ente Governamental
$.tipo_ente_governamental /tpEnteGov
Reforma
  • Valores possíveis:
  • 1 - União
  • 2 - Estado
  • 3 - Distrito Federal
  • 4 - Município
Tipo de imunidade
$.tipo_imunidade /tpImunidade
Reforma
  • Obrigatório quando a natureza da operação (tpTributacao) é 3 (Imune). Valores possíveis:
  • 1 - Patrimônio, renda ou serviços, uns dos outros (alínea a)
  • 2 - Entidades religiosas e templos de qualquer culto (alínea b)
  • 3 - Partidos políticos, entidades sindicais, instituições de educação e assistência social sem fins lucrativos (alínea c)
  • 4 - Livros, jornais, periódicos e o papel destinado à sua impressão (alínea d)
  • 5 - Fonogramas e videofonogramas musicais produzidos no Brasil (alínea e)
Tipo Ope. gov.
$.tipo_operacao_governamental /tpOper
Reforma
  • 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
Tomador
$.tomador
Endereco
$.tomador.endereco
CEP (endereço no exterior)
$.tomador.endereco.cep_ext /cdEndPost
Reforma
Código postal do endereço no exterior (somente para tomador no exterior)
Código do país (endereço no exterior)
$.tomador.endereco.codigo_pais_ext /cdPais
Reforma
Código do país com 2 letras maiúsculas (ISO 3166-1 alfa-2), ex.: US, PT. Somente para tomador no exterior
Nome da cidade no exterior
$.tomador.endereco.nome_cidade_ext /nmCidadeExt
Reforma
Somente para tomador no exterior
Estado/província/região no exterior
$.tomador.endereco.regiao_ext /nmEstProvRegExt
Reforma
Somente para tomador no exterior
Valor informado do benefício municipal
$.valor_reducao_base_calculo_beneficio_municipal /vlInformado
Reforma
Valor da redução do benefício de redução da base de cálculo, em reais (R$) na redução por valor e em percentual (%) na redução percentual
Valor do serviço informado na moeda indicada em tpMoeda
$.valor_servico_ext /vServMoeda
Reforma
Vínculo da prestação com o exterior
$.vinculo_negocio /vincPrest
Reforma
  • 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

  • Requer cadastro, liberação RPS e liberação para emissão, tanto em homologação quanto em produção
    • Portal > Solicitação de acesso
    • Login no Portal > Menu NFSe > Autorização para Emissão de NFS-e
  • Necessário emitir 1 nota em homologação antes da emissão em produção
  • Se informado, o campo valor_servicos deve ser uma totalização, inclusive com os impostos
  • Em caso de erro na emissão em homologação, tentar emitir utilizando um tomador cadastrado na prefeitura

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 4126306
  },
  "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",
    "valor_servicos": 1.0,
    "aliquota": 2.17,
    "codigo_tributacao_nacional_iss": "041201",
    "iss_retido": false,
    "codigo_nbs": "123012300",
    "ibs_cbs_classificacao_tributaria": "200029",
    "codigo_indicador_operacao": "030101"
  },
  "finalidade_emissao": 0,
  "indicador_destinatario": 0
}