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

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

GissOnline

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

Acessar

Homologação

Sim

Não disponível

Campos Importantes

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

Campos do Provedor

Cód. moeda

$.codigo_moeda /p1:tpMoeda

Reforma

Identifica a moeda da transação comercial

Indic. Operação

$.consumidor_final /p1:indFinal

Reforma

Indica operação de uso ou consumo pessoal (art. 57)
Valores possíveis:
0 - Não;
1 - Sim;

Documentos Referenciados

$.documentos_referenciados /p1:gReeRepRes

Chave DF-e

$.documentos_referenciados[].chave_dfe /p1:chaveDFe

Reforma

Chave do Documento Fiscal eletrônico do repositório nacional referenciado para os casos de operações já tributadas

CNPJ Fornecedor

$.documentos_referenciados[].cnpj_fornecedor /p1:CNPJ

Reforma

Número da inscrição no Cadastro Nacional de Pessoa Jurídica (CNPJ) do Fornecedor do serviço

Cod.Mun. Emissor

$.documentos_referenciados[].codigo_municipio_documento_fiscal_outro /p1:cMunDocFiscal

Reforma

Código do município emissor do documento fiscal que não se encontra no repositório nacional

CPF Fornecedor

$.documentos_referenciados[].cpf_fornecedor /p1:CPF

Reforma

Número da inscrição no Cadastro de Pessoa Física (CPF) do Fornecedor do serviço

Dt. Comp. Doc.

$.documentos_referenciados[].data_competencia_documento_dedutivel /p1:dtCompDoc

Reforma

Data da competência do documento dedutível. Ano, mês e dia (AAAA-MM-DD)

Dt. Emissão Doc.

$.documentos_referenciados[].data_emissao_documento_dedutivel /p1:dtEmiDoc

Reforma

Data da emissão do documento dedutível. Ano, mês e dia (AAAA-MM-DD)

Descrição DF-e

$.documentos_referenciados[].descricao_chave_dfe /p1:xTipoChaveDFe

Reforma

Descrição da DF-e a que se refere a chaveDfe que seja um dos documentos do Repositório Nacional. Deve ser preenchido apenas quando 'tipoChaveDFe = 9 (Outro)'

Desc. Doc. Fiscal

$.documentos_referenciados[].descricao_documento_fiscal_outro /p1:xDocFiscal

Reforma

Descrição do documento fiscal

Desc. Doc. Fiscal

$.documentos_referenciados[].descricao_documento_nao_fiscal_outro /p1:xDoc

Reforma

Descrição do documento não fiscal

Des. tipo valor incluido

$.documentos_referenciados[].descricao_tipo_valor_incluido /p1:xTpReeRepRes

Reforma

Descrição do reembolso ou ressarcimento quando a opção é '99 - Outros reembolsos ou ressarcimentos recebidos por valores pagos relativos a operações por conta e ordem de terceiro'

Não NIF Fornecedor

$.documentos_referenciados[].motivo_ausencia_nif_fornecedor /p1:cNaoNIF

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 Fornecedor

$.documentos_referenciados[].nif_fornecedor /p1:NIF

Reforma

Este elemento só deverá ser preenchido para fornecedores não residentes no Brasil

Num. Doc. Fiscal

$.documentos_referenciados[].numero_documento_fiscal_outro /p1:nDocFiscal

Reforma

Número do documento fiscal que não se encontra no repositório nacional

Num. Doc. Fiscal

$.documentos_referenciados[].numero_documento_nao_fiscal_outro /p1:nDoc

Reforma

Número do documento não fiscal

Nome Fornecedor

$.documentos_referenciados[].razao_social_fornecedor /p1:xNome

Reforma

Nome / Razão Social do do Fornecedor do serviço

Tipo Chave DF-e

$.documentos_referenciados[].tipo_chave_dfe /p1:tipoChaveDFe

Reforma

Documento fiscal a que se refere a chaveDfe que seja um dos documentos do Repositório Nacional
Valores possíveis:
1 - NFS-e;
2 - NF-e;
3 - CT-e;
9 - Outro;

Tipo valor incluido

$.documentos_referenciados[].tipo_valor_incluido /p1:tpReeRepRes

Tipo de valor incluído neste documento, recebido por motivo de estarem relacionadas a operações de terceiros, objeto de reembolso, repasse ou ressarcimento pelo recebedor, já tributados e aqui referenciados
Valores possíveis:
01 - Repasse de remuneração por intermediação de imóveis a demais corretores envolvidos na operação;
02 - Repasse de valores a fornecedor relativo a fornecimento intermediado por agência de turismo;
03 - Reembolso ou ressarcimento recebido por agência de propaganda e publicidade por valores pagos relativos a serviços de produção externa por conta e ordem de terceiro;
04 - Reembolso ou ressarcimento recebido por agência de propaganda e publicidade por valores pagos relativos a serviços de mídia por conta e ordem de terceiro;
99 - Outros reembolsos ou ressarcimentos recebidos por valores pagos relativos a operações por conta e ordem de terceiro;

Valor repasse

$.documentos_referenciados[].valor_repasse /p1:vlrReeRepRes

Reforma

Valor monetário (total ou parcial, conforme documento informado) utilizado para não inclusão na base de cálculo do ISS e do IBS e da CBS da NFS-e que está sendo emitida (R$)

Evento

$.evento /p1:Evento

Descrição Evento

$.evento.descricao /p1:DescricaoEvento

Reforma

Nome Evento

$.evento.nome /p1:IdentificacaoEvento

Reforma

Indic. Emissão

$.finalidade_emissao /p1:finNFSe

Reforma

Indicador da finalidade da emissão de NFS-e
Valores possíveis:
0 - NFS-e regular;

Indic. destinatário

$.indicador_destinatario /p1:indDest

Reforma

A respeito do Destinatário dos serviços
Valores possíveis:
0 - O tomador identificado na NFS-e é o adquirente e o destinatário do fornecimento (tomador = adquirente = destinatário);
1 - O tomador e o adquirente são a mesma pessoa, mas o destinatário é uma pessoa física ou jurídica ou equiparada diversa do indicado como tomador/adquirente ou se trata de um estabelecimento do adquirente diferente do indicado no campo “tomador” (tomador = adquirente ≠ destinatário);

MDIC

$.mdic /p1:mdic

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 /p1:mecAFComexP

Reforma

Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo prestador do serviço
Valores possíveis:
00 - Desconhecido (tipo não informado na nota de origem);
01 - Nenhum;
02 - ACC - Adiantamento sobre Contrato de Câmbio - Redução a Zero do IR e do IOF;
03 - ACE - Adiantamento sobre Cambiais Entregues - Redução a Zero do IR e do IOF;
04 - BNDES-Exim Pós-Embarque - Serviços;
05 - BNDES-Exim Pré-Embarque - Serviços;
06 - FGE - Fundo de Garantia à Exportação;
07 - PROEX - EQUALIZAÇÃO
08 - PROEX - Financiamento;

Apoio tomador ext.

$.mecanismo_comercio_ext_tomador /p1:mecAFComexT

Reforma

Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo tomador do serviço
Valores possíveis:
00 - Desconhecido (tipo não informado na nota de origem);
01 - Nenhum;
02 - Adm. Pública e Repr. Internacional;
03 - Alugueis e Arrend. Mercantil de maquinas, equip., embarc. e aeronaves;
04 - Arrendamento Mercantil de aeronave para empresa de transporte aéreo público;
05 - Comissão a agentes externos na exportação;
06 - Despesas de armazenagem, mov. e transporte de carga no exterior;
07 - Eventos FIFA (subsidiária);
08 - Eventos FIFA;
09 - Fretes, arrendamentos de embarcações ou aeronaves e outros;
10 - Material Aeronáutico;
11 - Promoção de Bens no Exterior;
12 - Promoção de Dest. Turísticos Brasileiros;
13 - Promoção do Brasil no Exterior;
14 - Promoção Serviços no Exterior;
15 - RECINE;
16 - RECOPA;
17 - Registro e Manutenção de marcas, patentes e cultivares;
18 - REICOMP;
19 - REIDI;
20 - REPENEC;
21 - REPES;
22 - RETAERO;
23 - RETID;
24 - Royalties, Assistência Técnica, Científica e Assemelhados;
25 - Serviços de avaliação da conformidade vinculados aos Acordos da OMC;
26 - ZPE;

Modo prestação

$.modo_prestacao /p1:mdPrestacao

Reforma

Valores possíveis:
0 - Desconhecido (tipo não informado na nota de origem);
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 /p1:movTempBens

Reforma

Vínculo da Operação à Movimentação Temporária de Bens
Valores possíveis:
0 - Desconhecido (tipo não informado na nota de origem);
1 - Não;
2 - Vinculada - Declaração de Importação;
3 - Vinculada - Declaração de Exportação;

Núm. Declaração Imp.

$.numero_declaracao_importacao /p1:nDI

Reforma

Número da Declaração de Importação (DI/DSI/DA/DRI-E) averbado

Núm. Registro Exp.

$.numero_registro_exportacao /p1:nRE

Reforma

Número do Registro de Exportação (RE) averbado

Perc. total UF

$.percentual_total_tributos_estaduais /p1:pTotTribEst

Reforma

Valor percentual total aproximado dos tributos estaduais (%)

Perc. total Federal

$.percentual_total_tributos_federais /p1:pTotTribFed

Reforma

Valor percentual total aproximado dos tributos federais (%)

Perc. total Mun.

$.percentual_total_tributos_municipais /p1:pTotTribMun

Reforma

Valor percentual total aproximado dos tributos municipais (%)

Perc. total SN

$.percentual_total_tributos_simples_nacional /p1:pTotTribSN

Reforma

Valor percentual aproximado do total dos tributos da alíquota do Simples Nacional (%)

Servico

$.servico /p1:Servico

Alíq. COFINS

$.servico.aliquota_cofins /p1:pAliqCofins

Reforma

Valor da Alíquota da COFINS (%)

Alíq. PIS

$.servico.aliquota_pis /p1:pAliqPis

Reforma

Valor da Alíquota do PIS (%)

BC PIS/COFINS

$.servico.base_calculo_pis_cofins /p1:vBCPisCofins

Reforma

Valor da Base de Cálculo do PIS/COFINS (R$)

NFSeReferenciada

$.servico.chaves_nfse_referenciadas /p1:gRefNFSe

Chave NFS-e Ref.

$.servico.chaves_nfse_referenciadas[].chave_nfse /p1:refNFSe

Reforma

Chave da NFS-e referenciada

Cód. indic. Operação

$.servico.codigo_indicador_operacao /p1:cIndOp

Reforma

Código indicador da operação de fornecimento, conforme tabela 'código indicador de operação'

Doc. Mun. Incidencia

$.servico.codigo_municipio_incidencia /p1:cLocalidadeIncid

Reforma

Código IBGE da localidade de incidência do IBS/CBS (local da operação)

Cód. NBS

$.servico.codigo_nbs /p1:CodigoNbs

Reforma

Código da lista de Nomenclatura Brasileira de Serviços (NBS)

BC IBS/CBS

$.servico.ibs_cbs_base_calculo /p1:vBC

Reforma

Valor da Base de Cálculo do ISSQN (R$) = Valor do Serviço - Desconto Incondicionado - Deduções/Reduções - Benefício Municipal. vBC = vServ - descIncond - (vDR ou vCalcDR + vCalcReeRepRes) - (vRedBCBM ou VCalcBM)

Cód. Trib. IBS/CBS

$.servico.ibs_cbs_classificacao_tributaria /p1:cClassTrib

Reforma

Código de Classificação Tributária do IBS e da CBS

CST IBS/CBS

$.servico.ibs_cbs_situacao_tributaria /p1:CST

Reforma

Código de Situação Tributária do IBS e da CBS

Perc. red. alíq. gov.

$.servico.perc_reducao_aliquota_compra_governamental /p1:pRedutor

Reforma

Percentual de redução de aliquota em compra governamental

CST PIS/COFINS

$.servico.situacao_tributaria_pis_cofins /p1:CST

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 /p1:tpRetPisCofins

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;

Valor COFINS

$.servico.valor_cofins /p1:vCofins

Reforma

Valor monetário do COFINS (R$)

Valor PIS

$.servico.valor_pis /p1:vPis

Reforma

Valor monetário do PIS (R$)

Tipo governamental

$.tipo_ente_governamental /p1:tpEnteGov

Reforma

Tipo de ente governamental. Para administração pública direta e suas autarquias e fundações
Valores possíveis:
1 - União;
2 - Estado;
3 - Distrito Federal;
4 - Município;
9 - Outro;

Tipo Ope. gov.

$.tipo_operacao_governamental /p1:tpOper

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 /p1:TomadorServico

Endereco

$.tomador.endereco

CEP Exterior

$.tomador.endereco.cep_ext /p1:cEndPost

Reforma

Código País Exterior

$.tomador.endereco.codigo_pais_ext /p1:CodigoPais

Reforma

Endereço completo Exterior

$.tomador.endereco.endereco_completo_ext /p1:EnderecoCompletoExterior

Reforma

Nome da cidade Exterior

$.tomador.endereco.nome_cidade_ext /p1:xCidade

Reforma

Região/Estado Exterior

$.tomador.endereco.regiao_ext /p1:xEstProvReg

Reforma

Valor serv. ext.

$.valor_servico_ext /p1:vServMoeda

Reforma

Valor do serviço prestado expresso em moeda estrangeira especificada em tpmoeda

Vínculo negócio

$.vinculo_negocio /p1:vincPrest

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;
9 - Desconhecido (tipo não informado na nota de origem);

JSONs de Exemplo

{
  "data_emissao": "2026-05-12T07:34:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3552502
  },
  "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": 3552502,
      "uf": "SP",
      "cep": "08690-000"
    },
    "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": 0.0,
    "item_lista_servico": "7.12",
    "codigo_tributario_municipio": "3821100",
    "codigo_nbs": "1.2404.21.00",
    "codigo_indicador_operacao": "100301",
    "ibs_cbs_situacao_tributaria": "000",
    "ibs_cbs_classificacao_tributaria": "000001",
    "codigo_municipio_incidencia": 3552502,
    "iss_retido": false
  },
  "percentual_total_tributos_simples_nacional": 0.0,
  "consumidor_final": 0,
  "indicador_destinatario": 0
}