Voltar

Guia técnico de emissão de NFS-e em Terra de Areia/RS pela API da Focus NFe

Saiba como emitir NFS-e em Terra de Areia (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
Tecnos
Formato
Próprio (ABRASF)
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

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

Data fato gerador
$.data_fato_gerador /DataFatoGerador
Reforma
Evento
$.evento /Evento
Reforma
Cód. Evento
$.evento.codigo /CodigoIdentificador
Reforma
Código identificador do Evento
Data fim Evento
$.evento.data_fim /DataFim
Reforma
Data de finalização do Evento
Data inicio Evento
$.evento.data_inicio /DataInicio
Reforma
Data em que se inicia o Evento
Endereço Evento
$.evento.endereco /Endereco
Reforma
Hash com informações do endereço do Evento
Nome Evento
$.evento.nome /Nome
Reforma
Obra
$.obra /ConstrucaoCivil
Reforma
Art Obra
$.obra.art /Art
Reforma
Cód. Obra
$.obra.codigo /CodigoObra
Reforma
Cib da Obra
$.obra.codigo_cib /Cib
Reforma
Endereco
$.obra.endereco
Bairro da Obra
$.obra.endereco.bairro /BairroObra
Reforma
Cep da Obra
$.obra.endereco.cep /CepObra
Reforma
Cidade da Obra
$.obra.endereco.cidade /CidadeObra
Reforma
Nome da cidade onde está sendo feita a obra
Complemento Obra
$.obra.endereco.complemento /ComplementoObra
Reforma
Logradouro da Obra
$.obra.endereco.logradouro /EnderecoObra
Reforma
Número Obra
$.obra.endereco.numero /NumeroObra
Reforma
UF da Obra
$.obra.endereco.uf /EstadoObra
Reforma
Local Contrução
$.obra.local /LocalConstrucao
Reforma
Local da construção da Obra
Reforma Civil
$.obra.reforma_civil /ReformaCivil
Reforma
Código da reforma civil da Obra
Servico
$.servico /Servico
Reforma
Alíq. CBS
$.servico.cbs_aliquota /Cbs
Reforma
Valor CBS
$.servico.cbs_valor /ValorCbs
Reforma
Código NBS
$.servico.codigo_nbs /CodigoNBS
ObrigatórioReforma
Código de tributação nacional
$.servico.codigo_tributacao_nacional_iss /CodigoServicoNacional
ObrigatórioReforma
Alíq. Mun. IBS
$.servico.ibs_mun_aliquota /IbsMunicipal
Reforma
Valor Mun. IBS
$.servico.ibs_mun_valor /ValorIbsMunicipal
Reforma
Alíq. UF IBS
$.servico.ibs_uf_aliquota /IbsEstadual
Reforma
Valor UF IBS
$.servico.ibs_uf_valor /ValorIbsEstadual
Reforma
CST PIS/COFINS
$.servico.situacao_tributaria_pis_cofins /CodigoSituacaoTributariaPisCofins
Reforma
  • Código de Situação Tributária do PIS/COFINS (CST)
  • Valores possíveis:
  • 00 - Nenhum;
  • 01 - Operação Tributável com Alíquota Básica;
  • 02 - Operação Tributável com Alíquota Diferenciada;
  • 03 - Operação Tributável com Alíquota por Unidade de Medida de Produto;
  • 04 - Operação Tributável monofásica - Revenda a Alíquota Zero;
  • 05 - Operação Tributável por Substituição Tributária;
  • 06 - Operação Tributável a Alíquota Zero;
  • 07 - Operação Isenta da Contribuição;
  • 08 - Operação sem Incidência da Contribuição;
  • 09 - Operação com Suspensão da Contribuição;
  • 49 - Outras Operações de Saída;
  • 50 - Operação com Direito a Crédito – Vinculada Exclusivamente a Receita Tributada no Mercado Interno;
  • 51 - Operação com Direito a Crédito – Vinculada Exclusivamente a Receita Não-Tributada no Mercado Interno;
  • 52 - Operação com Direito a Crédito – Vinculada Exclusivamente a Receita de Exportação;
  • 53 - Operação com Direito a Crédito – Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno;
  • 54 - Operação com Direito a Crédito – Vinculada a Receitas Tributadas no Mercado Interno e de Exportação;
  • 55 - Operação com Direito a Crédito – Vinculada a Receitas Não Tributadas no Mercado Interno e de Exportação;
  • 56 - Operação com Direito a Crédito – Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno e de Exportação;
  • 60 - Crédito Presumido – Operação de Aquisição Vinculada Exclusivamente a Receita Tributada no Mercado Interno;
  • 61 - Crédito Presumido – Operação de Aquisição Vinculada Exclusivamente a Receita Não-Tributada no Mercado Interno;
  • 62 - Crédito Presumido – Operação de Aquisição Vinculada Exclusivamente a Receita de Exportação;
  • 63 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno;
  • 64 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Tributadas no Mercado Interno e de Exportação;
  • 65 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Não-Tributadas no Mercado Interno e de Exportação;
  • 66 - Crédito Presumido – Operação de Aquisição Vinculada a Receitas Tributadas e Não-Tributadas no Mercado Interno e de Exportação;
  • 67 - Crédito Presumido – Outras Operações;
  • 70 - Operação de Aquisição sem Direito a Crédito;
  • 71 - Operação de Aquisição com Isenção;
  • 72 - Operação de Aquisição com Suspensão;
  • 73 - Operação de Aquisição a Alíquota Zero;
  • 74 - Operação de Aquisição sem Incidência da Contribuição;
  • 75 - Operação de Aquisição por Substituição Tributária;
  • 98 - Outras Operações de Entrada;
  • 99 - Outras Operações;
Tipo ret. PIS/COFINS
$.servico.tipo_retencao_pis_cofins /TipoRetencaoPisCofins
Reforma
  • Tipo de retencao do Pis/Cofins
  • Valores possíveis:
  • 0 - PIS/COFINS/CSLL Não Retidos;
  • 1 - PIS/COFINS Retido;
  • 2 - PIS/COFINS Não Retido;
  • 3 - PIS/COFINS/CSLL Retidos;
  • 4 - PIS/COFINS Retidos, CSLL Não Retido;
  • 5 - PIS Retido, COFINS/CSLL Não Retido;
  • 6 - COFINS Retido, PIS/CSLL Não Retido;
  • 7 - PIS Não Retido, COFINS/CSLL Retidos;
  • 8 - PIS/COFINS Não Retidos, CSLL Retido;
  • 9 - COFINS Não Retido, PIS/CSLL Retidos;

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": 4321436
  },
  "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",
    "valor_servicos": 1.0,
    "aliquota": 4.0,
    "item_lista_servico": "14.01",
    "codigo_tributacao_nacional_iss": "140101",
    "codigo_cnae": "4520005",
    "iss_retido": false,
    "codigo_nbs": "1.2001.10.00",
    "valor_iss": 0.04
  }
}