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

Saiba como emitir NFS-e em Videira (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
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
Não
Não disponível

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorObrigatório
Endereço do TomadorObrigatório
Item Lista ServiçoObrigatórioUtiliza o padrão nacional da Lei Complementar 116/2003
Código CNAENão utilizado
Código Tributário MunicípioNão utilizado

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
    • Logado no portal da prefeitura, buscar "Emissão de NFS-e por WebService": Acessar > Liberar Acesso ao Usuário

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 4219309
  },
  "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": 3.0,
    "item_lista_servico": "4.12",
    "iss_retido": false
  }
}