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

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

Acessar

Homologação

Não

Não disponível

Campos Importantes

Campo	Obrigatoriedade	Observação
CPF/CNPJ do Tomador	Opcional
Endereço do Tomador	Opcional
Item Lista Serviço	Obrigatório	Utiliza 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 CNAE	Obrigatório
Código Tributário Município	Não utilizado

Campos do Provedor

Evento

$.evento /Evento

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)

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

Email do intermediário

$.intermediario.email /email

Reforma

Endereço

$.intermediario.endereco /Intermediario

Bairro

$.intermediario.endereco.bairro /xBairro

Reforma

Bairro

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.

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).

Complemento do endereço

$.intermediario.endereco.complemento /xCpl

Reforma

Logradouro

$.intermediario.endereco.logradouro /xLgr

Reforma

Tipo e nome do logradouro da localização do imóvel

Nome da cidade no exterior

$.intermediario.endereco.nome_cidade_ext /xCidade

Reforma

Nome da cidade no exterior do intermediário do serviço.

Número do imóvel

$.intermediario.endereco.numero /nro

Reforma

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.

Fone do intermediário

$.intermediario.fone /fone

Reforma

NIF

$.intermediario.nif /NIF

Reforma

Número de identificação fiscal fornecido por órgão de administração tributária no exterior

Serviço

$.servico /Servico

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.

CST PIS/COFINS

$.servico.situacao_tributaria_pis_cofins /CSTPisCofins

Reforma

Obrigatória quando informado o PIS/COFINS. Código de Situação Tributária do PIS/COFINS (CST) conforme padrão nacional:
Valores possíveis:
00 - Nenhum;
01 - Operação Tributável com Alíquota Básica;
02 - Operação Tributável com Alíquota Diferenciada;
03 - Operação Tributável com Alíquota por Unidade de Medida de Produto;
04 - Operação Tributável monofásica - Revenda a Alíquota Zero;
05 - Operação Tributável por Substituição Tributária;
06 - Operação Tributável a Alíquota Zero;
07 - Operação Isenta da Contribuição;
08 - Operação sem Incidência da Contribuição;
09 - Operação com Suspensão da Contribuição;
49 - Outras Operações de Saída;
50 - Operação com Direito a Crédito – Vinculada Exclusivamente a Receita Tributada no Mercado Interno;
51 - Operação com Direito a Crédito – Vinculada Exclusivamente a Receita Não-Tributada no Mercado Interno;
52 - Operação com Direito a Crédito – Vinculada Exclusivamente a Receita de Exportação;
53 - Operação com Direito a Crédito – Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno;
54 - Operação com Direito a Crédito – Vinculada a Receitas Tributadas no Mercado Interno e de Exportação;
55 - Operação com Direito a Crédito – Vinculada a Receitas Não Tributadas no Mercado Interno e de Exportação;
56 - Operação com Direito a Crédito – Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno e de Exportação;
60 - Crédito Presumido – Operação de Aquisição Vinculada Exclusivamente a Receita Tributada no Mercado Interno;
61 - Crédito Presumido – Operação de Aquisição Vinculada Exclusivamente a Receita Não-Tributada no Mercado Interno;
62 - Crédito Presumido – Operação de Aquisição Vinculada Exclusivamente a Receita de Exportação;
63 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno;
64 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Tributadas no Mercado Interno e de Exportação;
65 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Não Tributadas no Mercado Interno e de Exportação;
66 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno e de Exportação;
67 - Crédito Presumido – Outras Operações;
70 - Operação de Aquisição sem Direito a Crédito;
71 - Operação de Aquisição com Isenção;
72 - Operação de Aquisição com Suspensão;
73 - Operação de Aquisição a Alíquota Zero;
74 - Operação de Aquisição sem Incidência da Contribuição;
75 - Operação de Aquisição por Substituição Tributária;
98 - Outras Operações de Entrada;
99 - Outras Operações.

Tipo de retenção do PIS/COFINS:

$.servico.tipo_retencao_pis_cofins /TpRetPisCofins

Reforma

Obrigatória quando informado o PIS/COFINS ou CSLL. Tipo de Retenção PIS/COFINS e CSLL conforme padrão nacional:
Valores possíveis:
0 - PIS/COFINS/CSLL Não Retidos;
1 - PIS/COFINS Retidos;
2 - PIS/COFINS Não Retidos;
3 - PIS/COFINS/CSLL Retidos;
4 - PIS/COFINS Retidos, CSLL Não Retido;
5 - PIS Retido, COFINS/CSLL Não Retido;
6 - COFINS Retido, PIS/CSLL Não Retido;
7 - PIS Não Retido, COFINS/CSLL Retidos;
8 - PIS/COFINS Não Retidos, CSLL Retido;
9 - COFINS Não Retido, PIS/CSLL Retidos.

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)

Tomador

$.tomador /TomadorServico

Endereço

$.tomador.endereco /Endereco

Bairro exterior

$.tomador.endereco.bairro_ext /xBairro

Reforma

CEP no exterior

$.tomador.endereco.cep_ext /cEndPost

Reforma

Código alfanumérico do Endereçamento Postal no exterior

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).

Logradouro exterior

$.tomador.endereco.logradouro_ext /xLgr

Reforma

Tipo e nome do logradouro da localização do imóvel

Nome da cidade no exterior

$.tomador.endereco.nome_cidade_ext /xCidade

Reforma

Nome da cidade no exterior

Número do imóvel exterior

$.tomador.endereco.numero_ext /nro

Reforma

Região no exterior

$.tomador.endereco.regiao_ext /xEstProvReg

Reforma

Estado, província ou região da cidade no exterior

Endereço Exterior

$.tomador.endereco_exterior /EnderecoExterior

NIF

$.tomador.nif /NIF

Reforma

Número de identificação fiscal fornecido por órgão de administração tributária no exterior

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