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

Saiba como emitir NFS-e em Rio de Janeiro (RJ) 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: RioDeJaneiro

Padrão: ABRASF 1.0

Autenticação: Certificado digital

Cancelamento: Ativo

Ambientes Disponíveis

Ambiente Disponível Portal de Acesso
ProduçãoSimAcessar
HomologaçãoSimAcessar

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorOpcional
Endereço do TomadorOpcional
Item Lista ServiçoObrigatórioUtiliza o padrão nacional da Lei Complementar 116/2003
Código CNAENão utilizado
Código Tributário MunicípioObrigatórioUtiliza uma versão estendida do campo item_lista_servico. Para mais informações, conferir em "Outras Informações"

Outras Informações

  • Campo codigo_tributario_municipio:
    • Informe apenas números sem formatação
    • Normalmente utiliza um padrão de 6 digitos, por exemplo: 080214
    • Caso o contribuinte possua benefício fiscal (natureza_operacao = 3), enviar a junção do código do beneficio + codigo tributario, por exemplo: 123080214.
    • O portal Nota Carioca disponibiliza uma tabela de benefícios fiscais na aba “Manuais de Ajuda”.
{
  "status": 1,
  "optante_simples_nacional": false,
  "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": 4106902,
      "uf": "PR",
      "cep": "82900-010"
    },
    "telefone": "11 1111-1111",
    "email": "test@example.com"
  },
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3304557
  },
  "data_emissao": "2025-07-16T11:13:00",
  "servico": {
    "codigo_tributario_municipio": "080202",
    "base_calculo": 3186.0,
    "valor_pis": 0.0,
    "aliquota": 0.0,
    "valor_cofins": 0.0,
    "valor_liquido": 3186.0,
    "valor_inss": 0.0,
    "iss_retido": false,
    "desconto_condicionado": 0.0,
    "valor_ir": 0.0,
    "item_lista_servico": "0802",
    "valor_iss_retido": 0.0,
    "valor_csll": 0.0,
    "valor_iss": 0.0,
    "outras_retencoes": 0.0,
    "discriminacao": "Referente a matrícula no curso Empreendedorismo Criativo (01/2018).",
    "valor_servicos": 3186.0,
    "desconto_incondicionado": 0.0,
    "percentual_total_tributos": 16.32
  },
  "regime_especial_tributacao": null,
  "natureza_operacao": 1,
  "incentivador_cultural": false
}