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

Saiba como emitir NFS-e em Itapeva (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

Etransparencia

Padrão

Próprio

Autenticação

Token

O token deve ser gerado no portal da prefeitura conforme orientado em Outras Informações e inserido no campo senha do cadastro do cliente na API, aba Documentos Fiscais

Cancelamento

Ativo

Ambientes Disponíveis

Ambiente

Disponível

Portal de Acesso

Produção

Sim

Acessar

Homologação

Sim

Acessar

Campos Importantes

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

Campos Exclusivos

Cód. Indic. Ope.

$.codigo_indicador_operacao

Reforma

Indicador do código da operação de fornecimento

Indic. Cons. Final

$.consumidor_final

Reforma

Indica se Nota a ser gerada para consumo final do tomador/adquirente
Valores possíveis:
SIM
NAO

Destinatário

$.destinatario

Reforma

CNPJ Destinatário

$.destinatario.cnpj

Reforma

CPF Destinatário

$.destinatario.cpf

Reforma

Endereço

$.destinatario.endereco

Reforma

Bairro do Endereço

$.destinatario.endereco.bairro

Reforma

CEP

$.destinatario.endereco.cep

Reforma

CEP ext.

$.destinatario.endereco.cep_ext

Reforma

Código alfanumérico do Endereçamento Postal no exterior.

Cidade ext.

$.destinatario.endereco.cidade_ext

Reforma

Nome da cidade no exterior

Cód. Pais ext.

$.destinatario.endereco.codigo_pais_ext

Reforma

Quando o endereço é do Exterior, informar o código do país, segundo a tabela de países ISO

Complemento

$.destinatario.endereco.complemento

Reforma

Complemento do Endereço

Estado, província ou região

$.destinatario.endereco.epr_ext

Reforma

Estado, província ou região da cidade no exterior do tomador de serviços

Logradouro

$.destinatario.endereco.logradouro

Reforma

Número

$.destinatario.endereco.numero

Reforma

Número do Endereço do Logradouro

Não NIF Destinatário

$.destinatario.motivo_ausencia_nif

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 Destinatário

$.destinatario.nif

Reforma

Nome Destinatário

$.destinatario.nome

Reforma

Finalidade emissão

$.finalidade_emissao

Reforma

Indica a finalidade da emissão de NFS-e(caso o campo não seja enviado, será atribuido o valor 0)
Valores possíveis:
0 - NFS-e regular
1 - NFS-e de crédito Opção não disponível para a versão 4.0
2 - NFS-e de débito Opção não disponível para a versão 4.0

Imóvel

$.imovel

Reforma

CIB

$.imovel.codigo_cib

Reforma

Código do Cadastro Imobiliário Brasileiro

Endereço

$.imovel.endereco

Reforma

Bairro do Endereço

$.imovel.endereco.bairro

Reforma

CEP

$.imovel.endereco.cep

Reforma

CEP ext.

$.imovel.endereco.cep_ext

Reforma

Código alfanumérico do Endereçamento Postal no exterior.

Cidade ext.

$.imovel.endereco.cidade_ext

Reforma

Nome da cidade no exterior

Cód. Pais ext.

$.imovel.endereco.codigo_pais_ext

Reforma

Quando o endereço é do Exterior, informar o código do país, segundo a tabela de países ISO

Complemento

$.imovel.endereco.complemento

Reforma

Complemento do Endereço

Estado, província ou região

$.imovel.endereco.epr_ext

Reforma

Estado, província ou região da cidade no exterior do tomador de serviços

Logradouro

$.imovel.endereco.logradouro

Reforma

Número

$.imovel.endereco.numero

Reforma

Número do Endereço do Logradouro

Indic. Destonatário

$.indicador_destinatario

Reforma

Identifica se o destinatário é o tomador/Adquirente ou não
Valores possíveis:
SIM
NAO

Núm. processo suspensão

$.numero_processo_suspensao

Reforma

Número do processo judicial ou administrativo de suspensão da exigibilidade

Obra

$.obra

Reforma

CEI/CNO

$.obra.cei_cno

Reforma

Número de identificação da obra. Cadastro Nacional de Obras (CNO) ou CadastroEspecífico do INSS (CEI).

Cód. Obra

$.obra.codigo

Reforma

Código Interno da obra no prestador

Data Início da obra

$.obra.data_inicio

Reforma

Endereço

$.obra.endereco

Reforma

Bairro do Endereço

$.obra.endereco.bairro

Reforma

CEP

$.obra.endereco.cep

Reforma

CEP ext.

$.obra.endereco.cep_ext

Reforma

Código alfanumérico do Endereçamento Postal no exterior.

Cidade ext.

$.obra.endereco.cidade_ext

Reforma

Nome da cidade no exterior

Cód. Pais ext.

$.obra.endereco.codigo_pais_ext

Reforma

Quando o endereço é do Exterior, informar o código do país, segundo a tabela de países ISO

Complemento

$.obra.endereco.complemento

Reforma

Complemento do Endereço

Estado, província ou região

$.obra.endereco.epr_ext

Reforma

Estado, província ou região da cidade no exterior do tomador de serviços

Logradouro

$.obra.endereco.logradouro

Reforma

Número

$.obra.endereco.numero

Reforma

Número do Endereço do Logradouro

Localidade Obra

$.obra.local

Reforma

Identifica a localidade da obra
Valores possíveis:
1 - Local da obra é no município do prestador
2 - Local da obra é fora do município do prestador
3 - Local da obra é no exterior

Indic. Ope. Onerosa

$.operacao_onerosa

Reforma

Indica se a operação é Onerosa ou não, tendo contraprestação ou não
Valores possíveis:
SIM
NAO

Reg. Trib. SN

$.regime_tributario_simples_nacional

Reforma

Campo que indica o Regime de Apuração Tributária pelo SN no exercício informado
Valores possíveis:
1 - Tributos Federais e Municipais (SS) pelo SN
2 - Tributos Federais pelo SN e ISSQN pelo NFSE
3 - Regime de apuração dos tributos federais e municipais pela NFS-e conformerespectivaslegislações federal e municipal de cada tributo.

BC PIS/COFINS

$.servico.base_calculo_pis_cofins

Reforma

Base de Cálculo do

Perc. dife. IBS para CBS

$.servico.cbs_percentual_diferimento

Reforma

Percentual de diferimento para a CBS

Cód. Anexo CNAE

$.servico.codigo_anexo_cnae

Reforma

Código do Anexo do código CNAE informado, quando ocontribuinteédo SN. Informe os códigos: I, II, III, IV ou V

Cód. moeda

$.servico.codigo_moeda

Reforma

Identifica a moeda da transação comercial

Cód. NBS

$.servico.codigo_nbs

Reforma

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

Cód. trib. Nacional

$.servico.codigo_tributacao_nacional_iss

Reforma

Código de tributação nacional

Cód. Trib. IBS/CBS

$.servico.ibs_cbs_classificacao_tributaria

Reforma

Código da Classificação Tributária

Cód. Trib. Reg. IBS/CBS

$.servico.ibs_cbs_classificacao_tributaria_regular

Reforma

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

Cód. Créd. presumido IBS/CBS

$.servico.ibs_cbs_credito_codigo_classificacao

Reforma

Código e classificação do crédito presumido: IBS e CBS

CST IBS/CBS

$.servico.ibs_cbs_situacao_tributaria

Reforma

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

CST Reg. IBS/CBS

$.servico.ibs_cbs_situacao_tributaria_regular

Reforma

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

Perc. dife. IBS Mun

$.servico.ibs_mun_percentual_diferimento

Reforma

Percentual de diferimento para o IBS Municipal

Perc. dife. IBS UF

$.servico.ibs_uf_percentual_diferimento

Reforma

Percentual de diferimento para o IBS estadual

CST PIS/COFINS

$.servico.situacao_tributaria_pis_cofins

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;

Ret. PIS/COFINS

$.servico.tipo_retencao_pis_cofins

Reforma

Identifica se o PIS/COFINS é Retido ou não
Valores possíveis:
SIM
NAO

Valor serv. ext.

$.servico.valor_servico_ext

Reforma

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

Tipo Suspensão Valores possíveis: 1 - Por decisão Judicial 2 - Por Processo Administrativo

$.tipo_exigibilidade_suspensao

Reforma

Valor reembolso

$.valor_repasse

Reforma

Valor monetário utilizado para não inclusão na base de cálculo do IBS e da CBSda NFS-equeestásendo emitida (R$). Corresponde aos valores relativos ao fornecimento próprio de bensmateriaisourelacionados a operações de terceiros, objeto de reembolso, repasse ou ressarcimentopelorecebedor.

Outras Informações

A autenticação do webservice é feita usando dois tokens (códigos):
- O código do Usuário cadastrado e código do Contribuinte (empresa).
- Para o Login: Sistema > Segurança > Editar Perfil > Código do usuário para login em Webservices
- Para a senha: Contribuintes > Cadastro de Contribuintes > Consultar > Código (abaixo de Razão Social)
- Para consultar os códigos no cadastro do cliente na prefeitura (são diferentes do login e senha de acesso ao portal)

{
  "data_emissao": "2026-01-06T10:52:15-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 1,
  "codigo_indicador_operacao": "030101",
  "regime_tributario_simples_nacional": "1",
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3522406
  },
  "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": 3522406,
      "uf": "SP",
      "cep": "18400-450"
    },
    "telefone": "41 3256-8060",
    "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": 4.38,
    "valor_iss": 0.04,
    "item_lista_servico": "09.01",
    "codigo_cnae": "5510801",
    "codigo_anexo_cnae": "I",
    "codigo_nbs": "1.0303.11.00",
    "codigo_tributacao_nacional_iss": "090101000",
    "ibs_cbs_classificacao_tributaria": "200048",
    "ibs_cbs_situacao_tributaria": "200",
    "iss_retido": false
  }
}