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

Saiba como emitir NFS-e em Gramado (RS) 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
ABRASF 2.04
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 TomadorOpcional
Endereço do TomadorObrigatório
Item Lista ServiçoObrigatórioUtiliza o padrão nacional da Lei Complementar 116/2003
Código CNAEOpcional
Código Tributário MunicípioNão utilizado

Campos Exclusivos

CST PIS/COFINS
$.servico.situacao_tributaria_pis_cofins
Reforma
Código da Situação Tributária do PIS e COFINS
Tipo retenção PIS/COFINS
$.servico.tipo_retencao_pis_cofins
Reforma
  • Deverá indicar se o serviço terá retenção de PIS e COFINS
  • Valores possíveis:
  • 1 - PIS/COFINS Retido
  • 2 - PIS/COFINS Não Retido
  • 3 - PIS Retido/COFINS Não Retido
  • 4 - PIS Não Retido/COFINS retido
BC PIS/COFINS
$.servico.base_calculo_pis_cofins
Reforma
Valor da Base de Cálculo de PIS e COFINS
Alíquota do PIS
$.servico.aliquota_pis
Reforma
Alíquota do COFINS
$.servico.aliquota_cofins
Reforma
Cód. NBS
$.servico.codigo_nbs
Reforma
Código da lista de Nomenclatura Brasileira de Serviços (NBS)
Perc. red. alíq. gov.
$.servico.perc_reducao_aliquota_compra_governamental
Reforma
Percentual de redução de alíquota em compra governamental
BC IBS/CBS
$.servico.ibs_cbs_base_calculo
Reforma
Valor da base de cálculo IBS/CBS
Alíquota UF para IBS
$.servico.ibs_uf_aliquota
Reforma
Alíquota da UF para IBS da localidade de incidência parametrizada no sistema
Perc. red. alíq. UF
$.servico.ibs_uf_percentual_reducao_aliquota
Reforma
Percentual de redução de alíquota estadual
Alíquota efetiva IBS UF
$.servico.ibs_uf_aliquota_efetiva
Reforma
Alíquota Mun. para IBS
$.servico.ibs_mun_aliquota
Reforma
Alíquota do município para IBS da localidade de incidência parametrizada no sistema
Perc. red. alíq. mun.
$.servico.ibs_mun_percentual_reducao_aliquota
Reforma
Percentual de redução de alíquota municipal
Alíquota efetiva municipal
$.servico.ibs_mun_aliquota_efetiva
Reforma
Alíquota da CBS
$.servico.cbs_aliquota
Reforma
Perc. red. alíq. CBS
$.servico.cbs_percentual_reducao_aliquota
Reforma
Percentual de redução de alíquota CBS
Alíquota efetiva CBS
$.servico.cbs_aliquota_efetiva
Reforma
Valor Total da NF fora IBS/CBS
$.servico.ibs_cbs_valor_total
Reforma
Valor Total da NF considerando os impostos por fora: IBS e CBS
Alíq. efetiva reg. IBS UF
$.servico.ibs_uf_aliquota_efetiva_regular
Reforma
Alíquota efetiva de tributação regular do IBS estadual
Valor trib. reg. IBS UF
$.servico.ibs_uf_valor_regular
Reforma
Valor da tributação regular do IBS estadual
Alíq. efetiva reg. IBS Mun.
$.servico.ibs_mun_aliquota_efetiva_regular
Reforma
Alíquota efetiva de tributação regular do IBS municipal
Valor trib. reg. IBS Mun.
$.servico.ibs_mun_valor_regular
Reforma
Valor da tributação regular do IBS municipal
Alíq. efetiva reg. CBS
$.servico.cbs_aliquota_efetiva_regular
Reforma
Alíquota efetiva de tributação regular da CBS
Valor trib. reg. CBS
$.servico.cbs_valor_tributo_regular
Reforma
Valor da tributação regular da CBS
Alíq. IBS comp. UF
$.servico.ibs_uf_aliquota_governamental
Reforma
Alíquota do IBS de competência do Estado
Valor trib. IBS UF
$.servico.ibs_uf_valor_governamental
Reforma
Valor do Tributo do IBS da UF calculado
Alíq. IBS comp. Mun.
$.servico.ibs_mun_aliquota_governamental
Reforma
Alíquota do IBS de competência do Município
Valor trib. IBS Mun.
$.servico.ibs_mun_valor_governamental
Reforma
Valor do Tributo do IBS do Município calculado
Alíq. da CBS
$.servico.cbs_aliquota_governamental
Reforma
Valor trib. CBS
$.servico.cbs_valor_governamental
Reforma
Valor do Tributo da CBS calculado
Valor total do IBS
$.servico.ibs_valor_total
Reforma
Alíq. créd. presumido IBS
$.servico.ibs_percentual_credito_presumido
Reforma
Alíquota do crédito presumido para o IBS
Valor do Crédito Presumido IBS
$.servico.ibs_valor_credito_presumido
Reforma
Total do Diferimento do IBS estadual
$.servico.ibs_uf_valor_total_diferimento
Reforma
Total valor do IBS estadual
$.servico.ibs_uf_valor
Reforma
Total do Diferimento do IBS municipal
$.servico.ibs_mun_valor_total_diferimento
Reforma
Total valor do IBS municipal
$.servico.ibs_mun_valor
Reforma
Alíquota do crédito presumido para a CBS
$.servico.cbs_credito_percentual
Reforma
Valor do Crédito Presumido da CBS
$.servico.cbs_valor_credito_presumido
Reforma
Total do Diferimento CBS
$.servico.cbs_valor_total_diferimento
Reforma
Total valor da CBS da União
$.servico.cbs_valor_total
Reforma
Obra
$.obra
Reforma
Código Obra
$.obra.codigo
Reforma
ART Obra
$.obra.art
Reforma
Evento
$.evento
Reforma
Identificação/Nome Evento
$.evento.nome
Reforma
Descrição do evento
$.evento.descricao
Reforma
Indic. Emissão
$.finalidade_emissao
Reforma
  • Indicador da finalidade da emissão de NFS-e
  • Valores possíveis:
  • 0 - NFS-e regular
Indic. Operação
$.consumidor_final
Reforma
  • Indica operação de uso ou consumo pessoal
  • Valores possíveis:
  • 0 - Não
  • 1 - Sim
Cód. indic. Operação
$.servico.codigo_indicador_operacao
Reforma
Código indicador da operação de fornecimento
Tipo Ope. gov.
$.tipo_operacao_governamental
Reforma
  • Tipo de Operação com Entes Governanementais 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
Chaves de acesso da NFS-e referenciada
$.chaves_nfse_referenciadas
Reforma
Lista de objetos do tipo chave_nfse
Chave da NFS-e referenciada
$.chaves_nfse_referenciadas[].chave_nfse
Reforma
Tipo governamental
$.tipo_ente_governamental
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
Imóvel
$.imovel
Reforma
Inscrição Imobiliária
$.imovel.inscricao_imobiliaria
Reforma
Código Imóvel
$.imovel.codigo_cib
Reforma
Endereço Imóvel
$.imovel.endereco
Reforma
CEP
$.imovel.endereco.cep
Reforma
Código postal
$.imovel.endereco.cep_ext
Reforma
Cidade
$.imovel.endereco.nome_cidade_ext
Reforma
Estado/Província/Região
$.imovel.endereco.regiao_ext
Reforma
Logradouro
$.imovel.endereco.logradouro
Reforma
Número
$.imovel.endereco.numero
Reforma
Complemento
$.imovel.endereco.complemento
Reforma
Bairro
$.imovel.endereco.bairro
Reforma
CST IBS/CBS
$.servico.ibs_cbs_situacao_tributaria
Reforma
Código de Situação Tributária do IBS e da CBS
Cód. Trib. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria
Reforma
Código de Classificação Tributária do IBS e da CBS
Cód/Class. créd. presumido IBS/CBS
$.servico.ibs_cbs_credito_codigo_classificacao
Reforma
Código e classificação do crédito presumido do IBS e CBS
Cód. Situação Trib. Regular IBS/CBS
$.servico.ibs_cbs_situacao_tributaria_regular
Reforma
Class. Trib. Regular IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria_regular
Reforma
Perc. de diferimento para IBS UF
$.servico.ibs_uf_percentual_diferimento
Reforma
Percentual de diferimento para o IBS estadual
Perc. de diferimento para IBS Mun.
$.servico.ibs_mun_percentual_diferimento
Reforma
Percentual de diferimento para o IBS municipal
Percentual de diferimento para a CBS
$.servico.cbs_percentual_diferimento
Reforma

JSONs de Exemplo

{
  "data_emissao": "2025-12-29T07:34:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "finalidade_emissao": 0,
  "consumidor_final": 1,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 4309100
  },
  "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": 4309100,
      "uf": "RS",
      "cep": "95670-012"
    },
    "telefone": "41 3256-8060",
    "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": "010501",
    "codigo_cnae": "6209100",
    "codigo_nbs": "1.1103.21.00",
    "codigo_indicador_operacao": "100501",
    "ibs_cbs_situacao_tributaria": "000",
    "ibs_cbs_classificacao_tributaria": "000001",
    "iss_retido": false
  }
}