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

Saiba como emitir NFS-e em Cariacica (ES) 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

Smarapd

Padrão

ABRASF 2.03

Autenticação

Certificado digital

Cancelamento

Ativo

Ambientes Disponíveis

Ambiente

Disponível

Portal de Acesso

Produção

Sim

Acessar

Homologação

Sim

Acessar

Campos Importantes

Campo	Obrigatoriedade	Observação
CPF/CNPJ do Tomador	Obrigatório
Endereço do Tomador	Obrigatório
Item Lista Serviço	Obrigatório	Utiliza o padrão nacional da Lei Complementar 116/2003
Código CNAE	Não utilizado
Código Tributário Município	Não utilizado

Campos Exclusivos

Campo	Obrigatoriedade	Observação
quantidade	Opcional	Se omitido, será utilizado o valor padrão 1
valor_unitario	Opcional	Se omitido, será utilizado o mesmo valor do campo valor_servicos

Outras Informações

É possível informar mais de um serviço por nota, basta trocar a chave “servico” por “servicos” e informar um array de servicos (json exemplo abaixo);
Campos da NFSe:
- natureza_operacao: Alguns municípios utilizam um padrão próprio. Necessário confirmar na interface do portal da prefeitura.

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3201308
  },
  "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.03",
    "iss_retido": false
  }
}

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3201308
  },
  "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"
  },
  "servicos": [
    {
      "discriminacao": "Nota emitida em caráter de TESTE de integração com Webservice 1",
      "valor_servicos": 1.0,
      "aliquota": 3.0,
      "item_lista_servico": "4.03",
      "iss_retido": false
    },
    {
      "discriminacao": "Nota emitida em caráter de TESTE de integração com Webservice 2",
      "valor_servicos": 1.0,
      "aliquota": 3.0,
      "item_lista_servico": "4.03",
      "iss_retido": false
    }
  ]
}