Guia técnico de emissão de NFS-e em Natal/RN pela API da Focus NFe

Saiba como emitir NFS-e em Natal (RN) 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: Directa

Padrão: ABRASF 1.0

Autenticação: Certificado digital

Cancelamento: Ativo

O cancelamento via API não é aprovado imediatamente, ele é apenas uma requisição que precisa de aprovação na prefeitura

Ambientes Disponíveis

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

Campos Importantes

Campo	Obrigatoriedade	Observação
CPF/CNPJ do Tomador	Opcional
Endereço do Tomador	Opcional
Item Lista Serviço	Obrigatório	Utiliza o padrão nacional da Lei Complementar 116/2003 Só é permitido utilizar os códigos que foram informados no momento do cadastro da empresa
Código CNAE	Opcional
Código Tributário Município	Não utilizado

Outras Informações

Esta prefeitura não funciona bem com acentuação. Os acentos são removidos antes de enviar a requisição aos servidores da prefeitura.
Solicite o cadastramento em homologação enviando um email para semut.setinf@natal.rn.gov.br informando o CNPJ, inscrição municipal e razão social da empresa.
Para prestadores do Simples Nacional com ISS Homologado o regime tributário do cadastro da empresa na API deverá ser Simples Nacional - Excesso de sublimite de receita bruta.
Email de suporte: semut.setinf@natal.rn.gov.br (pouco responsivos).

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 2408102
  },
  "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"
  },
  "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.0,
    "item_lista_servico": "4.12",
    "iss_retido": false
  }
}