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

Saiba como emitir NFS-e em Cabreúva (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

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	Opcional
Código Tributário Município	Não utilizado

Campos Exclusivos

Cód. Indic. Ope.

$.codigo_indicador_operacao /IndCodOpe

Reforma

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

Indic. Cons. Final

$.consumidor_final /IndConsFin

Reforma

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

Destinatário

$.destinatario /Reg50

Reforma

CNPJ Destinatário

$.destinatario.cnpj /DestCpfCnpj

Reforma

CPF Destinatário

$.destinatario.cpf /DestCpfCnpj

Reforma

Endereço

$.destinatario.endereco /Endereco

Reforma

Bairro do Endereço

$.destinatario.endereco.bairro /EndBairro

Reforma

CEP

$.destinatario.endereco.cep /EndCEP

Reforma

CEP ext.

$.destinatario.endereco.cep_ext /EndExtCodPost

Reforma

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

Cidade ext.

$.destinatario.endereco.cidade_ext /EndExtCidade

Reforma

Nome da cidade no exterior

Cód. Pais ext.

$.destinatario.endereco.codigo_pais_ext /EndExtPais

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 /EndCompl

Reforma

Complemento do Endereço

Estado, província ou região

$.destinatario.endereco.epr_ext /EndExtEstProvReg

Reforma

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

Logradouro

$.destinatario.endereco.logradouro /EndLog

Reforma

Número

$.destinatario.endereco.numero /EndNum

Reforma

Número do Endereço do Logradouro

Não NIF Destinatário

$.destinatario.motivo_ausencia_nif /DestNaoNIF

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 /DestNIF

Reforma

Nome Destinatário

$.destinatario.nome /DestNome

Reforma

Finalidade emissão

$.finalidade_emissao /Finalidade

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 /Reg50

Reforma

CIB

$.imovel.codigo_cib /BensImobCIB

Reforma

Código do Cadastro Imobiliário Brasileiro

Endereço

$.imovel.endereco /Endereco

Reforma

Bairro do Endereço

$.imovel.endereco.bairro /EndBairro

Reforma

CEP

$.imovel.endereco.cep /EndCEP

Reforma

CEP ext.

$.imovel.endereco.cep_ext /EndExtCodPost

Reforma

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

Cidade ext.

$.imovel.endereco.cidade_ext /EndExtCidade

Reforma

Nome da cidade no exterior

Cód. Pais ext.

$.imovel.endereco.codigo_pais_ext /EndExtPais

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 /EndCompl

Reforma

Complemento do Endereço

Estado, província ou região

$.imovel.endereco.epr_ext /EndExtEstProvReg

Reforma

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

Logradouro

$.imovel.endereco.logradouro /EndLog

Reforma

Número

$.imovel.endereco.numero /EndNum

Reforma

Número do Endereço do Logradouro

Indic. Destonatário

$.indicador_destinatario /IndDest

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 /TribProcSusp

Reforma

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

Obra

$.obra /Reg50

Reforma

CEI/CNO

$.obra.cei_cno /ObraCEICNO

Reforma

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

Cód. Obra

$.obra.codigo /ObraCodPre

Reforma

Código Interno da obra no prestador

Data Início da obra

$.obra.data_inicio /ObraDtInicio

Reforma

Endereço

$.obra.endereco /Endereco

Reforma

Bairro do Endereço

$.obra.endereco.bairro /EndBairro

Reforma

CEP

$.obra.endereco.cep /EndCEP

Reforma

CEP ext.

$.obra.endereco.cep_ext /EndExtCodPost

Reforma

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

Cidade ext.

$.obra.endereco.cidade_ext /EndExtCidade

Reforma

Nome da cidade no exterior

Cód. Pais ext.

$.obra.endereco.codigo_pais_ext /EndExtPais

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 /EndCompl

Reforma

Complemento do Endereço

Estado, província ou região

$.obra.endereco.epr_ext /EndExtEstProvReg

Reforma

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

Logradouro

$.obra.endereco.logradouro /EndLog

Reforma

Número

$.obra.endereco.numero /EndNum

Reforma

Número do Endereço do Logradouro

Localidade Obra

$.obra.local /ObraIdLocal

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 /IndOpeOne

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 /RegApTribSN

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 /TributoBaseCalc

Reforma

Base de Cálculo do

Perc. dife. IBS para CBS

$.servico.cbs_percentual_diferimento /PDifCBS

Reforma

Percentual de diferimento para a CBS

Cód. Anexo CNAE

$.servico.codigo_anexo_cnae /ConteudoCpoAdc

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 /MoedaTrnExt

Reforma

Identifica a moeda da transação comercial

Cód. NBS

$.servico.codigo_nbs /ConteudoCpoAdc

Reforma

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

Cód. trib. Nacional

$.servico.codigo_tributacao_nacional_iss /ConteudoCpoAdc

Reforma

Código de tributação nacional

Cód. Trib. IBS/CBS

$.servico.ibs_cbs_classificacao_tributaria /CClassTrib

Reforma

Código da Classificação Tributária

Cód. Trib. Reg. IBS/CBS

$.servico.ibs_cbs_classificacao_tributaria_regular /CClassTrib

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 /CCodCredPres

Reforma

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

CST IBS/CBS

$.servico.ibs_cbs_situacao_tributaria /CST

Reforma

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

CST Reg. IBS/CBS

$.servico.ibs_cbs_situacao_tributaria_regular /CST

Reforma

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

Perc. dife. IBS Mun

$.servico.ibs_mun_percentual_diferimento /PDifMun

Reforma

Percentual de diferimento para o IBS Municipal

Perc. dife. IBS UF

$.servico.ibs_uf_percentual_diferimento /PDifUF

Reforma

Percentual de diferimento para o IBS estadual

CST PIS/COFINS

$.servico.situacao_tributaria_pis_cofins /TributoCST

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 /TributoIdRet

Reforma

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

Valor serv. ext.

$.servico.valor_servico_ext /ValTrnExt

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 /TribTpSusp

Reforma

Valor reembolso

$.valor_repasse /VlReeRepRes

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-13T10:25:00-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_tributario_simples_nacional": "1",
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3508405
  },
  "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": 3508405,
      "uf": "SP",
      "cep": "13318-112"
    },
    "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,
    "valor_iss": 0.04,
    "aliquota": 4.28,
    "item_lista_servico": "4.12",
    "codigo_cnae": "8630504",
    "codigo_anexo_cnae": "I",
    "codigo_nbs": "1.2301.23.00",
    "codigo_tributacao_nacional_iss": "041201000",
    "ibs_cbs_classificacao_tributaria": "200048",
    "ibs_cbs_situacao_tributaria": "200",
    "iss_retido": false,
    "endereco": {
      "logradouro": "Avenida Vereador José Donato",
      "numero": "863",
      "bairro": "Jacaré",
      "codigo_municipio": "3508405",
      "uf": "SP",
      "cep": "13318-112"
    }
  }
}