Guia técnico de emissão de NFS-e em Ribeirão Preto/SP pela API da Focus NFe

Saiba como emitir NFS-e em Ribeirão Preto (SP) 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.

A versão antiga da documentação deste município pode ser encontrada aqui.

Informações Gerais

Empresas MEI e optantes pelo Simples Nacional possuem prazos definidos para deixar de emitir utilizando este ambiente municipal. Consulte a obrigatoriedade de emissão no Ambiente Nacional.

Este município utiliza o formato nacional da NFSe, mas não opera no Ambiente Nacional.

Para emitir NFSe neste município, utilize o layout nacional e o endpoint v2/nfsen.

Não habilite a opção "Ambiente da NFSe Nacional" no painel da API.
A emissão deve ser feita pela API padrão de NFSe, mantendo apenas essa opção ativa no painel.

Provedor

IssNet

Formato

Nacional

Autenticação

Certificado digital

Cancelamento

Ativo

Ambientes Disponíveis

Ambiente

Disponível

Portal de Acesso

Produção

Sim

Acessar

Homologação

Sim

Acessar

Campos do Provedor

Código Município Evento

$.codigo_municipio_evento /cMun

Reforma

Código Município Imovel

$.codigo_municipio_imovel /cMun

Reforma

Código Município Obra

$.codigo_municipio_obra /cMun

Reforma

Outras Informações

É preciso pedir liberação do envio em homologação e após autorizar uma nota, pedir liberação do envio em produção.
- contato suporte: suporte@notaeletronica.com.br
- Informar CNPJ e IM da empresa.
É preciso solicitar liberação do número RPS antes de emitir notas:
- Antes de emitir as notas em produção, solicite RPS no sistema online da prefeitura:
- Login no portal, ir na aba “Solicitação de Documentos Fiscais” clicar em “Solicitação” e em seguida insira a quantidade de RPS à ser solicitado. Aguardar liberação.
Para verificar se já foi liberado o RPS, ir na aba “Solicitação de Documentos Fiscais” clique em “Consultar”.
Para verificar os RPS que a empresa possui e não foi utilizado, ir na aba “Declaração de Serviços Prestados” ou “Escrituração do Livro Fiscal” clicar na aba “Documentos não declarados” clique na lupa para verificar a numeração de RPS disponíveis.

JSONs de Exemplo

{
  "data_emissao": "2026-07-31T07:34:56-0300",
  "data_competencia": "2026-07-31",
  "codigo_municipio_emissora": 3543402,
  "cnpj_prestador": "00000000000000",
  "inscricao_municipal_prestador": "123445",
  "codigo_opcao_simples_nacional": 1,
  "regime_especial_tributacao": 0,
  "cnpj_tomador": "11.111.111/0001-11",
  "razao_social_tomador": "Fictício Tomador",
  "codigo_municipio_tomador": 3543402,
  "cep_tomador": "14025030",
  "logradouro_tomador": "Rua Fictícia",
  "numero_tomador": "1234",
  "complemento_tomador": "ap02",
  "bairro_tomador": "CENTRO",
  "telefone_tomador": "11 1111-1111",
  "email_tomador": "test@example.com",
  "codigo_municipio_prestacao": 3543402,
  "codigo_tributacao_nacional_iss": "040101",
  "codigo_tributacao_municipal_iss": "40101",
  "descricao_servico": "Teste NFSe reforma tributaria",
  "valor_servico": 1.0,
  "tributacao_iss": 1,
  "tipo_retencao_iss": 1,
  "codigo_nbs": "123012200",
  "percentual_total_tributos_simples_nacional": 0.0,
  "codigo_indicador_operacao": "030101",
  "ibs_cbs_situacao_tributaria": "200",
  "ibs_cbs_classificacao_tributaria": "200029",
  "finalidade_emissao": 0,
  "consumidor_final": 1,
  "indicador_destinatario": 1
}