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

Saiba como emitir NFS-e em Duque de Caxias (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.

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

Para emitir notas no ambiente de produção via webservice, deve-se anteriormente, solicitar autorização para emissão, enviando os dados da empresa prestadora para suporte@notacontrol.com.br
Caso mesmo solicitando a liberação não seja possível emitir, com a validação:
” A empresa não está habilitada no ambiente de integração”
- Será necessário alterar o plano de emissão de notas
- Para maiores informações basta solicitar nesse mesmo e-mail
Após liberarem para emissão via webservice, deverá liberar o RPS. Basta acessar https://www.issnetonline.com.br/duquedecaxias/online/login/Login.aspx, logar com usuário e senha do cliente, ir em Solicitação, selecionar o modelo do Documento Fiscal (no caso RPS – Recibo Provisório de Serviço) e a quantidade de notas a serem emitidas que desejará deixar configurado.

JSONs de Exemplo

{
  "data_emissao": "2026-07-30T07:34:56-0300",
  "data_competencia": "2026-07-30",
  "codigo_municipio_emissora": 3301702,
  "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": 3301702,
  "cep_tomador": "25070235",
  "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": 3301702,
  "codigo_tributacao_nacional_iss": "080201",
  "descricao_servico": "Teste NFSe reforma tributaria",
  "valor_servico": 1.0,
  "tributacao_iss": 1,
  "tipo_retencao_iss": 1,
  "codigo_nbs": "122051100",
  "codigo_tributacao_municipal_iss": "0802",
  "percentual_total_tributos_simples_nacional": "10",
  "codigo_indicador_operacao": "030101",
  "ibs_cbs_situacao_tributaria": "000",
  "ibs_cbs_classificacao_tributaria": "000001",
  "finalidade_emissao": 0,
  "consumidor_final": 1,
  "indicador_destinatario": 1
}