Guia técnico de emissão de NFS-e em Nova Pádua/RS pela API da Focus NFe

Saiba como emitir NFS-e em Nova Pádua (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
Homologação
Sim

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

Cód. moeda
$.codigo_moeda /TipoMoeda
Reforma
Identifica a moeda da transação comercial
Indicador de Consumidor Final, art. 57
$.consumidor_final /IndicadorConsumidorFinal
Reforma
  • Valores possíveis:
  • 0 - Não;
  • 1 - Sim;
Data fato gerador
$.data_fato_gerador /DataFatoGerador
Reforma
Destinatario
$.destinatario
CNPJ
$.destinatario.cnpj /Cnpj
Reforma
CPF
$.destinatario.cpf /Cpf
Reforma
Email
$.destinatario.email /email
Reforma
Endereco
$.destinatario.endereco
Bairro
$.destinatario.endereco.bairro /bairro
Reforma
CEP
$.destinatario.endereco.cep /cep
Reforma
CEP Exterior
$.destinatario.endereco.cep_ext /codigo_postal_exterior
Reforma
Código município
$.destinatario.endereco.codigo_municipio /codigo_municipio
Reforma
Código País Exterior
$.destinatario.endereco.codigo_pais_ext /codigo_pais
Reforma
Complemento
$.destinatario.endereco.complemento /complemento
Reforma
Logradouro
$.destinatario.endereco.logradouro /endereco
Reforma
Nome da cidade Exterior
$.destinatario.endereco.nome_cidade_ext /cidade_exterior
Reforma
Número
$.destinatario.endereco.numero /numero
Reforma
Região/Estado Exterior
$.destinatario.endereco.regiao_ext /estado_exterior
Reforma
Motivo Não NIF
$.destinatario.motivo_ausencia_nif /motivoNaoNif
Reforma
  • Motivo para não informação do NIF
  • Valores possíveis:
  • 0 - Não informado na nota de origem
  • 1 - Dispensado do NIF
  • 2 - Não exigência do NIF
NIF
$.destinatario.nif /nif
Reforma
Razão Social
$.destinatario.razao_social /nome
Reforma
Telefone
$.destinatario.telefone /fone
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
Imovel
$.imovel /Imovel
Reforma
Código CIB
$.imovel.codigo_cib /cib
Reforma
Código do Cadastro Imobiliário Brasileiro - CIB
Endereco
$.imovel.endereco
Bairro
$.imovel.endereco.bairro /bairro
Reforma
CEP
$.imovel.endereco.cep /cep
Reforma
CEP Exterior
$.imovel.endereco.cep_ext /codigo_postal_exterior
Reforma
Código País Exterior
$.imovel.endereco.codigo_pais_ext /codigo_pais
Reforma
Complemento
$.imovel.endereco.complemento /complemento
Reforma
Logradouro
$.imovel.endereco.logradouro /logradouro
Reforma
Nome da cidade Exterior
$.imovel.endereco.nome_cidade_ext /cidade_exterior
Reforma
Número
$.imovel.endereco.numero /numero
Reforma
Região/Estado Exterior
$.imovel.endereco.regiao_ext /estado_exterior
Reforma
Inscrição Imobiliária fiscal
$.imovel.inscricao_imobiliaria /inscImobFisc
Reforma
Indic. destinatário
$.indicador_destinatario /IndicadorDestinatarioServico
Reforma
  • A respeito do Destinatário dos serviços
  • Valores possíveis:
  • 0 - O destinatário é o próprio tomador/adquirente identificado na NFS-e;
  • 1 - O destinatário não é o próprio adquirente, podendo ser outra pessoa, física ou jurídica (ou equiparada), ou um estabelecimento diferente do indicado como tomador;
MDIC
$.mdic /EnviarMdic
Reforma
  • Compartilhar as informações da NFS-e gerada a partir desta DPS com a Secretaria de Comércio Exterior
  • Valores possíveis:
  • 0 - Não enviar para o MDIC;
  • 1 - Enviar para o MDIC;
Apoio prestador ext.
$.mecanismo_comercio_ext_prestador /MecanismoApoioPrestador
Reforma
Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo prestador do serviço
Apoio tomador ext.
$.mecanismo_comercio_ext_tomador /MecanismoApoioTomador
Reforma
Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo tomador do serviço
Modo prestação
$.modo_prestacao /ModoPrestacao
Reforma
  • Valores possíveis:
  • 0 - Desconhecido;
  • 1 - Transfronteiriço;
  • 2 - Consumo no Brasil;
  • 3 - Movimento Temporário de Pessoas Físicas;
  • 4 - Consumo no Exterior;
Movimentação Temporária
$.movimentacao_temporaria_bens /MovimentacaoTemporariaBens
Reforma
Vínculo da Operação à Movimentação Temporária de Bens
Número da Declaração de Importação
$.numero_declaracao_importacao /NumeroDeclaracaoImportacao
Reforma
Número do Registro de Exportação
$.numero_registro_exportacao /NumeroRegistroExportacao
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
Perc. total UF
$.percentual_total_tributos_estaduais /PercentualCargaTributariaEstadual
Reforma
Percentual da carga tributária municipal sobre a nota conforme fonte IPBT
Perc. total Federal
$.percentual_total_tributos_federais /PercentualCargaTributaria
Reforma
Percentual da carga tributária federal sobre a nota conforme fonte IPBT
Perc. total Mun.
$.percentual_total_tributos_municipais /PercentualCargaTributariaMunicipal
Reforma
Percentual da carga tributária municipal sobre a nota conforme fonte IPBT
Servico
$.servico /Servico
Reforma
Alíq. CBS
$.servico.cbs_aliquota /Cbs
Reforma
Valor CBS
$.servico.cbs_valor /ValorCbs
Reforma
Cód. indic. Operação
$.servico.codigo_indicador_operacao /IndicadorOperacao
Reforma
Código indicador da operação de fornecimento, conforme tabela 'código indicador de operação'
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;
Tipo governamental
$.tipo_ente_governamental /TipoEnteGovernamental
Reforma
  • Tipo de ente governamental. Para administração pública direta e suas autarquias e fundações
  • Valores possíveis:
  • 0 - Nenhum -> Enviar quando o tomador não for ente publico;
  • 1 - União;
  • 2 - Estado;
  • 3 - Distrito Federal;
  • 4 - Município.
Tipo Ope. gov.
$.tipo_operacao_governamental /TipoOperacao
Reforma
  • Tipo de Operação com Entes Governanementais ou outros serviços sobre bens imóveis
  • Valores possíveis:
  • 1 - Fornecimento com pagamento posterior;
  • 2 - Recebimento do pagamento com fornecimento já realizado;
  • 3 - Fornecimento com pagamento já realizado;
  • 4 - Recebimento do pagamento com fornecimento posterior;
  • 5 - Fornecimento e recebimento do pagamento concomitantes.
Tomador
$.tomador
Número do Cadastro de Atividade Econômica da Pessoa Física
$.tomador.caepf /CAEPF
Reforma
Motivo Não NIF
$.tomador.motivo_ausencia_nif /CodigoMotivoAusenciaNIF
Reforma
  • Motivo para não informação do NIF
  • Valores possíveis:
  • 0 - Não informado na nota de origem
  • 1 - Dispensado do NIF
  • 2 - Não exigência do NIF
NIF
$.tomador.nif /NIF
Reforma
Valor serv. ext.
$.valor_servico_ext /ValorServicoMoeda
Reforma
Valor do serviço prestado expresso em moeda estrangeira especificada em tpmoeda
Valor total tributos UF
$.valor_total_tributos_estaduais /ValorCargaTributariaEstadual
Reforma
Valor total tributos Federal
$.valor_total_tributos_federais /ValorCargaTributaria
Reforma
Valor total tributos Mun.
$.valor_total_tributos_municipais /ValorCargaTributariaMunicipal
Reforma
Vínculo negócio
$.vinculo_negocio /VinculoPrestacao
Reforma
  • Vínculo entre as partes no negócio
  • Valores possíveis:
  • 0 - Sem vínculo com o Tomador/Prestador
  • 1 - Controlada;
  • 2 - Controladora;
  • 3 - Coligada;
  • 4 - Matriz;
  • 5 - Filial ou sucursal;
  • 6 - Outro vínculo;

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": 4313086
  },
  "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": 3.64,
    "item_lista_servico": "9.01",
    "codigo_cnae": "5510801",
    "iss_retido": false,
    "codigo_tributacao_nacional_iss": "090101",
    "codigo_nbs": "1.0303.11.00"
  }
}