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
Padrão
ABRASF 2.04 (com variações)
Autenticação
Certificado digital
Cancelamento
Ativo
A solicitação de cancelamento será analisada e depende da aprovação prévia da prefeitura.

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
  }
}