Guia técnico de emissão de NFS-e em Itapoá/SC pela API da Focus NFe

Saiba como emitir NFS-e em Itapoá (SC) 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
AtendeNet
Padrão
Próprio
Autenticação
Login e Senha
Login e senha de acesso na prefeitura
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órioUtiliza 6 dígitos numéricos (2 para Item, 2 para Subitem e 2 para Desdobro Nacional, conforme Código de Tributação Nacional)
Código CNAENão utilizado
Código Tributário MunicípioObrigatório

Campos Exclusivos

Chaves de acesso da NFS-e referenciada
$.chaves_nfse_referenciadas /gRefNFSe
Reforma
Lista de objetos do tipo chave_nfse
Chave da NFS-e referenciada
$.chaves_nfse_referenciadas[].chave_nfse /refNFSe
Reforma
Indicador de consumidor final
$.consumidor_final /indFinal
Reforma
  • Valores possíveis:
  • 0 - Não
  • 1 - Sim
Indicador da finalidade da emissão de NFS-e
$.finalidade_emissao /finNFSe
Reforma
Informações do imóvel
$.imovel /imovel
Reforma
Grupo de informações do imóvel
Código CIB
$.imovel.codigo_cib /cCIB
Reforma
Código do Cadastro Imobiliário Brasileiro - CIB
Grupo de informações do endereço do imóvel
$.imovel.endereco /imovel
Reforma
Bairro do endereço do imóvel
$.imovel.endereco.bairro /xBairro
Reforma
CEP imóvel
$.imovel.endereco.cep /CEP
Reforma
Código de Endereçamento Postal numérico do endereço nacional do imóvel
Código endereço exterior imóvel
$.imovel.endereco.cep_ext /cEndPost
Reforma
Código de Endereçamento Postal alfanumérico do endereço no exterior do imóvel
Complemento do endereço do imóvel
$.imovel.endereco.complemento /xCpl
Reforma
Logradouro imóvel
$.imovel.endereco.logradouro /xLgr
Reforma
Tipo e nome do logradouro do endereço do imóvel
Cidade exterior imóvel
$.imovel.endereco.nome_cidade_ext /xCidade
Reforma
Nome da cidade no exterior, local do imóvel
Número no logradouro do endereço do imóvel
$.imovel.endereco.numero /nro
Reforma
Est./prov./reg. exterior imóvel
$.imovel.endereco.regiao_ext /xEstProvReg
Reforma
Estado, província ou região da cidade no exterior, local do imóvel
Inscrição imobiliária fiscal
$.imovel.inscricao_imobiliaria /inscImobFisc
Reforma
Inscrição imobiliária fiscal (código fornecido pela prefeitura para identificação da obra ou recolhimento do IPTU)
CEI
$.obra.codigo /cno
Reforma
Número de identificação da obra. Cadastro Nacional de Obras (CNO)
Alíquota CB
$.servico.cbs_aliquota /pCBS
Reforma
Alíquota CBS parametrizada no sistema (Valor 0,9%)
Alíquota efetiva CBS
$.servico.cbs_aliquota_efetiva /pAliqEfetCBS
Reforma
Alíquota efetiva de trib. regular CBS
$.servico.cbs_aliquota_efetiva_regular /pAliqEfeRegCBS
Reforma
Alíq. CBS compra gov.
$.servico.cbs_aliquota_governamental /pCBS
Reforma
Alíquota CBS parametrizada no sistema em compras governamentais
Alíquota de crédito presumido para CBS
$.servico.cbs_percentual_credito_presumido /pCredPresCBS
Reforma
Percentual de diferimento para a CBS
$.servico.cbs_percentual_diferimento /pDifCBS
Reforma
Perc. red. alíq. CBS
$.servico.cbs_percentual_reducao_aliquota /pRedAliqCBS
Reforma
Percentual da redução de alíquota da CBS
Total valor da CBS da União
$.servico.cbs_valor /vCBS
Reforma
Valor do Crédito Presumido para CBS
$.servico.cbs_valor_credito_presumido /vCredPresCBS
Reforma
Total do Diferimento CBS
$.servico.cbs_valor_diferimento /vDifCBS
Reforma
Val. CBS compra gov.
$.servico.cbs_valor_governamental /vCBS
Reforma
Valor do Tributo da CBS calculado em compras governamentais
Valor da tributação regular da CBS
$.servico.cbs_valor_regular /vTribRegCBS
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"
Cod. NBS
$.servico.codigo_nbs /codigo_nbs
Reforma
Código de Nomenclatura Brasileira de Serviços
Valor base de cálculo IBS/CBS
$.servico.ibs_cbs_base_calculo /vBC
Reforma
Valor da base de cálculo (BC) do IBS/CBS antes das reduções para cálculo do tributo bruto
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
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
Valor total da NF
$.servico.ibs_cbs_valor_total /vTotNF
Reforma
Valor Total da NF considerando os impostos por fora: IBS e CBS. vTotNF = vLiq (em 2026). vTotNF = vLiq + vCBS + vIBSTot (a partir de 2027)
Cód. créd. pres. IBS/CBS
$.servico.ibs_credito_codigo_classificacao /cCredPres
Reforma
Código e classificação do crédito presumido: IBS e CBS
Cód. créd. reg. IBS/CBS
$.servico.ibs_credito_codigo_classificacao_regular /cClassTribReg
Reforma
Código da Classificação Tributária do IBS e da CBS de tributação regular
Alíquota IBS Município
$.servico.ibs_mun_aliquota /pIBSMun
Reforma
Alíquota do município para IBS da localidade de incidência parametrizada no sistema (Valor 0,1%)
Alíquota efetiva Município
$.servico.ibs_mun_aliquota_efetiva /pAliqEfetMun
Reforma
Alíq. efet. trib. regular IBS Mun.
$.servico.ibs_mun_aliquota_efetiva_regular /pAliqEfeRegIBSMun
Reforma
Alíq. IBS Mun. compra gov.
$.servico.ibs_mun_aliquota_governamental /pIBSMun
Reforma
Alíquota do IBS de competência do Município em compras governamentais
Perc. de diferimento para IBS Mun.
$.servico.ibs_mun_percentual_diferimento /pDifMun
Reforma
Perc. red. alíq. Mun.
$.servico.ibs_mun_percentual_reducao_aliquota /pRedAliqMun
Reforma
Percentual de redução de alíquota municipal
Total valor do IBS Mun.
$.servico.ibs_mun_valor /vIBSMun
Reforma
Total do Diferimento do IBS Mun.
$.servico.ibs_mun_valor_diferimento /vDifMun
Reforma
Val. IBS Mun. compra gov.
$.servico.ibs_mun_valor_governamental /vIBSMun
Reforma
Valor do Tributo do IBS do Município calculado em compras governamentais
Valor da trib. regular do IBS Mun.
$.servico.ibs_mun_valor_regular /vTribRegIBSMun
Reforma
Alíq. de crédito presumido IBS
$.servico.ibs_percentual_credito_presumido /pCredPresIBS
Reforma
Alíquota IBS UF
$.servico.ibs_uf_aliquota /pIBSUF
Reforma
Alíquota da UF para IBS da localidade de incidência parametrizada no sistema (Valor 0,1%)
Alíquota efetiva UF
$.servico.ibs_uf_aliquota_efetiva /pAliqEfetUF
Reforma
Alíq. efet. trib. reg. IBS UF
$.servico.ibs_uf_aliquota_efetiva_regular /pAliqEfeRegIBSUF
Reforma
Alíquota efetiva de tributação regular do IBS estadual
Alíq. IBS UF compra gov.
$.servico.ibs_uf_aliquota_governamental /pIBSUF
Reforma
Alíquota do IBS de competência do Estado em compras governamentais
Perc. de diferimento para IBS UF
$.servico.ibs_uf_percentual_diferimento /pDifUF
Reforma
Perc. de redução de alíquota UF
$.servico.ibs_uf_percentual_reducao_aliquota /pRedAliqUF
Reforma
Total valor do IBS UF
$.servico.ibs_uf_valor /vIBSUF
Reforma
Val. IBS UF compra gov.
$.servico.ibs_uf_valor_governamental /vIBSUF
Reforma
Valor do Tributo do IBS da UF calculado em compras governamentais
Valor da tributação regular do IBS UF
$.servico.ibs_uf_valor_regular /vTribRegIBSUF
Reforma
Total do Diferimento do IBS UF
$.servico.ibs_uf_valor_total_diferimento /vDifUF
Reforma
Valor do Crédito Presumido para IBS
$.servico.ibs_valor_credito_presumido /vCredPresIBS
Reforma
Valor total do IBS
$.servico.ibs_valor_total /vIBSTot
Reforma
Perc. alíq. compra gov.
$.servico.perc_reducao_aliquota_compra_governamental /pRedutor
Reforma
Percentual de redução de alíquota em compra governamental
Descrição ente governamental
$.tipo_compra_governamental /tpEnteGov
Reforma
Descrição do ente governamental quando tpEnteGov for igual a 9. Exemplo: "Comitê Gestor do IBS"
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.

Outras Informações

  • Requer liberação de RPS no portal da prefeitura:
    • Autorização > Utilização de NFSe > Consultar

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": 4208450
  },
  "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": 4208450,
      "uf": "SC",
      "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": 3.0,
    "item_lista_servico": "110401",
    "codigo_tributario_municipio": "521179900",
    "iss_retido": false
  }
}