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
Próprio
Padrão
ABRASF 1.0
Autenticação
Certificado digital
Cancelamento
Ativo

Ambientes Disponíveis

Ambiente
Disponível
Portal de Acesso
Produção
Sim
Homologação
Sim

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorOpcional
Endereço do TomadorObrigatórioObrigatório apenas para tomador pessoa jurídica/CNPJ. Para Tomador PF é opcional
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”.

JSONs de Exemplo

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