Guia técnico de emissão de NFS-e em Caxias do Sul/RS pela API da Focus NFe

Saiba como emitir NFS-e em Caxias do Sul (RS) 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

Infisc

Padrão

Próprio

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	Obrigatório	Utiliza padrão próprio. Necessário consultar no cadastro do prestador ou no XML de uma nota emitida (tag cServ)

Campos Exclusivos

Campo	Obrigatoriedade	Observação
informacoes_adicionais_contribuinte	Opcional	Este é um campo especial em Caxias do Sul para que o cliente possa informar dados adicionais (tag infAdic do xml) na nota. Fica na chave principal do json e permite um array de ocorrências, exemplo: "informacoes_adicionais_contribuinte": [ "info 1", "info 2" ]
regime_especial_tributacao	Opcional	Este campo utiliza um formato um pouco diferente do utilizado na API. Os valores possíveis seguem abaixo
1 - Simples
2 - SIMEI
3 - Normal

Outras Informações

A série da nota fiscal também deve ser consultada no login do prestador. É possível fazer o login no sistema da prefeitura utilizando o Certificado Digital da empresa.
É possível inserir as Informações Adicionais através do campo "informacoes_adicionais_contribuinte". Esse campo deve ser informado nos dados gerais do json.
É possível informar dados de faturas acrescentando uma seção especifica no json:
"faturas": [
{
"numero_item": 1,
"numero_fatura": 5649,
"data_vencimento": "2022-10-14",
"valor_fatura": 630.71,
"tipo_vencimento_fatura": 1,
"descricao_tipo_vencimento_fatura":"Verificar abaixo a descrição"
}
]
Onde:
numero_item: Número sequencial para ordenar faturas
numero_fatura: Número da fatura
data_vencimento: Data de vencimento da fatura
valor_fatura: Valor da fatura
tipo_vencimento_fatura = Indica o tipo de vencimento da fatura, podendo ter o valor “1” para Data Certa, “2” para Apresentação, “3” para à vista e “4” para outros.
descricao_tipo_vencimento_fatura = Descrição para o tipo de vencimento da fatura, quando esta for do tipo “4”, ou seja, do tipo outros (máximo 15 caracteres)
É possível emitir NFSe sem identificar o tomador, o array (coleção) do tomador deve ser enviado conforme exemplo:
"tomador": {
"cpf": "00000000000",
"endereco": {
"codigo_municipio": "4305108",
"uf": "RS",
"cep": "0"
}
}

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": "1",
  "regime_especial_tributacao": "5",
  "informacoes_adicionais_contribuinte": "Informações adicionais",
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": "4305108"
  },
  "servico": {
    "codigo_tributario_municipio": "1691",
    "item_lista_servico": "1401",
    "discriminacao": "Descrição do serviço",
    "iss_retido": false,
    "valor_servicos": 1.0
  },
  "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"
  }
}