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

Saiba como emitir NFS-e em Sapiranga (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
DbSeller
Formato
Próprio (ABRASF)
Autenticação
Certificado digital
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 TomadorOpcional
Endereço do TomadorOpcional
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 CNAEObrigatório
Código Tributário MunicípioNão utilizado

Campos do Provedor

Serviço
$.servico /Servico
Valor recebido pelo intermediário do serviço
$.servico.valor_recebido_intermediario /vReceb
Reforma
Valor recebido pelo intermediário do serviço (Somente deve ser preenchida quando houver intermediário e não é obrigatória)
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ódigo de Classificação Tributária (IBS/CBS)
$.servico.ibs_cbs_classificacao_tributaria /cClassTrib
Reforma
Código de Classificação Tributária do IBS e da CBS.
Tomador
$.tomador /TomadorServico
NIF
$.tomador.nif /NIF
Reforma
Número de identificação fiscal fornecido por órgão de administração tributária no exterior
Endereço Exterior
$.tomador.endereco_exterior /EnderecoExterior
Código do país exterior
$.tomador.endereco.codigo_pais_ext /CodigoPais
Reforma
Código do país do tomador do serviço (Tabela do de país do IBGE).
CEP no exterior
$.tomador.endereco.cep_ext /cEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Nome da cidade no exterior
$.tomador.endereco.nome_cidade_ext /xCidade
Reforma
Nome da cidade no exterior
Região no exterior
$.tomador.endereco.regiao_ext /xEstProvReg
Reforma
Estado, província ou região da cidade no exterior
Logradouro exterior
$.tomador.endereco.logradouro_ext /xLgr
Reforma
Tipo e nome do logradouro da localização do imóvel
Número do imóvel exterior
$.tomador.endereco.numero_ext /nro
Reforma
Bairro exterior
$.tomador.endereco.bairro_ext /xBairro
Reforma
Intermediário
$.intermediario /Intermediario
Código do município
$.intermediario.codigo_municipio /CodigoMunicipio
Reforma
Código do município onde o intermediário está estabelecido (Tabela do IBGE) preenchido com 9999999 se for estrangeiro
NIF
$.intermediario.nif /NIF
Reforma
Número de identificação fiscal fornecido por órgão de administração tributária no exterior
Endereço
$.intermediario.endereco /Intermediario
Código do país exterior
$.intermediario.endereco.codigo_pais /cPais
Reforma
Código do país do intermediário do serviço (Tabela de Países ISO).
CEP no exterior
$.intermediario.endereco.cep_ext /cEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior do intermediário do serviço.
Nome da cidade no exterior
$.intermediario.endereco.nome_cidade_ext /xCidade
Reforma
Nome da cidade no exterior do intermediário do serviço.
Região no exterior
$.intermediario.endereco.regiao_ext /xEstProvReg
Reforma
Estado, província ou região da cidade no exterior do intermediário do serviço.
Logradouro
$.intermediario.endereco.logradouro /xLgr
Reforma
Tipo e nome do logradouro da localização do imóvel
Número do imóvel
$.intermediario.endereco.numero /nro
Reforma
Complemento do endereço
$.intermediario.endereco.complemento /xCpl
Reforma
Bairro
$.intermediario.endereco.bairro /xBairro
Reforma
Bairro
Fone do intermediário
$.intermediario.fone /fone
Reforma
Email do intermediário
$.intermediario.email /email
Reforma
Identificação do evento
$.evento.codigo /IdentificacaoEvento
Identificação do evento (Obrigatório se DescricaoEvento não informado)
Descrição do evento
$.evento.descricao /DescricaoEvento
Descrição do evento (Obrigatório se IdentificacaoEvento não informado)

JSONs de Exemplo

{
  "data_emissao": "2026-01-15T09:00:00.000Z",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 4319901
  },
  "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": 4319901,
      "uf": "RS",
      "cep": "95300-000"
    },
    "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,
    "item_lista_servico": "01.05.01",
    "codigo_cnae": "6209100",
    "aliquota": 2.01
  }
}