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

Saiba como emitir NFS-e em Surubim (PE) 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
Hm2
Formato
Próprio
Autenticação
Login e Senha
Login e senha de acesso na prefeitura
Cancelamento
Ativo

Ambientes Disponíveis

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

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorObrigatório
Endereço do TomadorObrigatório
Item Lista ServiçoObrigatórioUtiliza o padrão da Lei Complementar 116/2003
Código CNAEObrigatório
Código Tributário MunicípioNão utilizado

Campos do Provedor

Serviço
$.servico /Servico
Código NBS correspondente ao serviço prestado.
$.servico.codigo_nbs /cNBS
Reforma
Código de tributação nacional do ISSQN.
$.servico.codigo_tributacao_nacional_iss /cTribNac
Reforma
Tipos de Imunidades:
$.servico.tipo_imunidade /tpImunidade
Reforma
  • Valores possíveis:
  • 1 - Patrimônio, renda ou serviços, uns dos outros (CF88, Art 150, VI, a);
  • 2 - Templos de qualquer culto (CF88, Art 150, VI, b);
  • 3 - Patrimônio, renda ou serviços dos partidos políticos, inclusive suas fundações, das entidades sindicais dos trabalhadores, das instituições de educação e de assistência social, sem fins lucrativos, atendidos os requisitos da lei (CF88, Art 150, VI, c);
  • 4 - Livros, jornais, periódicos e o papel destinado a sua impressão (CF88, Art 150, VI, d);
  • 5 - Fonogramas e videofonogramas musicais produzidos no Brasil contendo obras musicais ou literomusicais de autores brasileiros e/ou obras em geral interpretadas por artistas brasileiros bem como os suportes materiais ou arquivos digitais que os contenham, salvo na etapa de replicação industrial de mídias ópticas de leitura a laser. (CF88, Art 150, VI, e);
Tributação do ISSQN sobre o serviço prestado
$.tributacao_iss /tribISSQN
Reforma
  • Valores possíveis:
  • 1 - Operação tributável;
  • 2 - Imunidade;
  • 3 - Exportação de serviço;
  • 4 - Não Incidência.

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 2614501
  },
  "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.29,
    "item_lista_servico": "4.12",
    "codigo_cnae": "8513802",
    "iss_retido": false,
    "codigo_tributacao_nacional_iss": "140101",
    "codigo_nbs": "1.2301.23.00"
  }
}