Guia técnico de emissão de NFS-e em Arroio dos Ratos/RS pela API da Focus NFe

Saiba como emitir NFS-e em Arroio dos Ratos (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
Não permite por webservices Apenas via portal / requisição na prefeitura

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-08-12T07:34:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 4301107
  },
  "tomador": {
    "cnpj": "85.904.290/0001-50",
    "razao_social": "Fictício Tomador",
    "endereco": {
      "logradouro": "Rua Fictícia",
      "numero": "2",
      "complemento": "ap02",
      "bairro": "Centro",
      "codigo_municipio": 4301107,
      "uf": "RS",
      "cep": "82900-010"
    },
    "telefone": "41 3256-8060",
    "email": "test@example.com"
  },
  "servico": {
    "discriminacao": "Nota emitida em caráter de TESTE de integração com Webservice",
    "valor_servicos": 1.0,
    "aliquota": 3.0,
    "item_lista_servico": "4.12",
    "codigo_cnae": "8630504",
    "codigo_tributacao_nacional_iss": "041201",
    "codigo_nbs": "1.2301.23.00",
    "valor_iss": 0.03,
    "iss_retido": false
  }
}