Voltar

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

Saiba como emitir NFS-e em Rio Grande (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
Sigiss
Formato
Próprio
Autenticação
Login e Senha
Login e senha de acesso na prefeitura
Cancelamento
Ativo
O cancelamento é enviado, mas depende de análise e aprovação da Sefin/ADN.

Ambientes Disponíveis

Ambiente
Disponível
Portal de Acesso
Produção
Sim
Acessar
Homologação
Sim
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 da Lei Complementar 116/2003
Código CNAENão utilizado
Código Tributário MunicípioNão utilizado

Campos do Provedor

Servico
$.servico
Cód. NBS
$.servico.codigo_nbs /dps_serv_cnbs
ObrigatórioReforma
Código da lista de Nomenclatura Brasileira de Serviços (NBS)
COFINS Retido
$.servico.cofins_retido /retencao_cofins
Reforma
  • Campo booleano utilizado para indicar o tipo de retenção do COFINS.
  • Utilizado apenas se o campo "tipo_retencao_pis_cofins" (padrão da API) for omitido.
CSLL Retido
$.servico.csll_retido /retencao_csll
Reforma
  • Campo booleano utilizado para indicar o tipo de retenção do CSLL.
  • Utilizado apenas se o campo "tipo_retencao_pis_cofins" (padrão da API) for omitido.
PIS Retido
$.servico.pis_retido /retencao_pis
Reforma
  • Campo booleano utilizado para indicar o tipo de retenção do PIS.
  • Utilizado apenas se o campo "tipo_retencao_pis_cofins" (padrão da API) for omitido.
Tipo de retenção do PIS/COFINS:
$.servico.tipo_retencao_pis_cofins /retencao_pis
Reforma
  • Obrigatória quando informado o PIS/COFINS ou CSLL.
  • Tipo de Retenção PIS/COFINS e CSLL, conforme padrão nacional (mesmo campo da API nfsen).
  • Se informado, sobrescreve valores individuais de pis_retido, cofins_retido e csll_retido.
  • 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.

Outras Informações

  • A série e o RPS não devem ser informados no cadastro da empresa na API.

JSONs de Exemplo

{
  "data_emissao": "2026-01-19T07:34:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 4315602
  },
  "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": 4315602,
      "uf": "SP",
      "cep": "96200-450"
    },
    "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.02,
    "item_lista_servico": "1.08",
    "codigo_nbs": "1.1502.30.00",
    "iss_retido": false
  }
}