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

Saiba como emitir NFS-e em Paulínia (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

Padrão

ABRASF 2.04

Autenticação

Certificado digital

Cancelamento

Ativo

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	Variação do Código CNAE com 9 dígitos

Campos Exclusivos

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 Tributável da Contribuição;
08 - Operação sem Incidência da Contribuição;
09 - Operação com Suspensão da Contribuição;

BC PIS/COFINS

$.servico.base_calculo_pis_cofins /p1:vBCPisCofins

Reforma

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

Alíq. PIS

$.servico.aliquota_pis /p1:pAliqPis

Reforma

Valor da Alíquota do PIS (%)

Alíq. COFINS

$.servico.aliquota_cofins /p1:pAliqCofins

Reforma

Valor da Alíquota da COFINS (%)

Valor PIS

$.servico.valor_pis /p1:vPis

Reforma

Valor monetário do PIS (R$)

Valor COFINS

$.servico.valor_cofins /p1:vCofins

Reforma

Valor monetário do COFINS (R$)

Tipo ret. PIS/COFINS

$.servico.tipo_retencao_pis_cofins /p1:tpRetPisCofins

Reforma

Tipo de retencao do Pis/Cofins
Valores possíveis:
1 - Retido;
2 - Não Retido;

Perc. total Federal

$.percentual_total_tributos_federais /p1:pTotTribFed

Reforma

Valor percentual total aproximado dos tributos federais (%)

Perc. total UF

$.percentual_total_tributos_estaduais /p1:pTotTribEst

Reforma

Valor percentual total aproximado dos tributos estaduais (%)

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 (%)

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. 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;

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'

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.

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

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;

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);

DocumentosDfe

$.documentos_referenciados /p1:gReeRepRes

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;

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)'

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

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

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

Desc. Doc. Fiscal

$.documentos_referenciados[].descricao_documento_fiscal_outro /p1:xDocFiscal

Reforma

Descrição do documento fiscal

Num. Doc. Fiscal

$.documentos_referenciados[].numero_documento_nao_fiscal_outro /p1:nDoc

Reforma

Número do documento não fiscal

Desc. Doc. Fiscal

$.documentos_referenciados[].descricao_documento_nao_fiscal_outro /p1:xDoc

Reforma

Descrição do documento não fiscal

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

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

NIF Fornecedor

$.documentos_referenciados[].nif_fornecedor /p1:NIF

Reforma

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

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;

Nome Fornecedor

$.documentos_referenciados[].razao_social_fornecedor /p1:xNome

Reforma

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

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)

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)

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;

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'

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$)

CST IBS/CBS

$.servico.ibs_cbs_situacao_tributaria /p1:CST

Reforma

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

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

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)

Perc. red. alíq. gov.

$.servico.perc_reducao_aliquota_compra_governamental /p1:pRedutor

Reforma

Percentual de redução de aliquota em compra governamental

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. NBS

$.servico.codigo_nbs /p1:CodigoNbs

Reforma

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

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;

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;

Cód. moeda

$.codigo_moeda /p1:tpMoeda

Reforma

Identifica a moeda da transação comercial

Valor serv. ext.

$.valor_servico_ext /p1:vServMoeda

Reforma

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

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;

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

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;

Nome Evento

$.evento.nome /p1:IdentificacaoEvento

Reforma

Descrição Evento

$.evento.descricao /p1:DescricaoEvento

Reforma

JSONs de Exemplo

{
  "data_emissao": "2026-01-16T07:34:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3536505
  },
  "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": 3536505,
      "uf": "SP",
      "cep": "13140-580"
    },
    "telefone": "11 1111-1111",
    "email": "test@example.com"
  },
  "servico": {
    "discriminacao": "Nota emitida em caráter de TESTE de integração com Webservice \n Quebra de linha 1 | Quebra de linha 2",
    "valor_servicos": 1.0,
    "aliquota": 2.0,
    "item_lista_servico": "4.03",
    "codigo_tributario_municipio": "863050200",
    "codigo_nbs": "1.2301.11.00",
    "codigo_indicador_operacao": "030101",
    "ibs_cbs_situacao_tributaria": "200",
    "ibs_cbs_classificacao_tributaria": "200029",
    "codigo_municipio_incidencia": 3536505,
    "iss_retido": false
  },
  "percentual_total_tributos_simples_nacional": 0.0,
  "consumidor_final": 0,
  "indicador_destinatario": 0
}