Saiba como emitir NFS-e em São Paulo (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.
| Campo | Obrigatoriedade | Observação |
|---|---|---|
| CPF/CNPJ do Tomador | Desconhecido | |
| Endereço do Tomador | Desconhecido | |
| Item Lista Serviço | Obrigatório | Utiliza um formato próprio. Consulte a lista aqui. Eventualmente, o código pode ser alterado conforme a vigência |
| Código CNAE | Não utilizado | |
| Código Tributário Município | Não utilizado |
$.chaves_nfse_referenciadas
/IBSCBS
$.chaves_nfse_referenciadas[].chave_nfse
/refNFSe
$.consumidor_final
/indFinal
$.destinatario
/dest
$.destinatario.cnpj
/CNPJ
$.destinatario.cpf
/CPF
$.destinatario.email
/email
$.destinatario.endereco
/end
$.destinatario.endereco.cep
/CEP
$.destinatario.endereco.cep_ext
/cEndPost
$.destinatario.endereco.codigo_pais_ext
/cPais
$.destinatario.endereco.nome_cidade_ext
/xCidade
$.destinatario.endereco.regiao_ext
/xEstProvReg
$.destinatario.motivo_ausencia_nif
/NaoNIF
$.destinatario.nif
/NIF
$.destinatario.razao_social
/xNome
$.documentos_referenciados
/gReeRepRes
$.documentos_referenciados[].chave_dfe
/chaveDFE
$.documentos_referenciados[].cnpj_fornecedor
/CNPJ
$.documentos_referenciados[].codigo_municipio_doc_fiscal_outro
/cMunDocFiscal
$.documentos_referenciados[].cpf_fornecedor
/CPF
$.documentos_referenciados[].data_competencia_documento_dedutivel
/dtCompDoc
$.documentos_referenciados[].data_emissao_documento_dedutivel
/dtEmiDoc
$.documentos_referenciados[].descricao_chave_dfe
/xTipoChaveDFe
$.documentos_referenciados[].descricao_doc_fiscal_outro
/xDocFiscal
$.documentos_referenciados[].descricao_doc_nao_fiscal
/xDoc
$.documentos_referenciados[].descricao_tipo_valor_incluido
/xTpReeRepRes
$.documentos_referenciados[].motivo_ausencia_nif_fornecedor
/NaoNIF
$.documentos_referenciados[].nif_fornecedor
/NIF
$.documentos_referenciados[].numero_doc_fiscal_outro
/nDocFiscal
$.documentos_referenciados[].numero_doc_nao_fiscal
/nDoc
$.documentos_referenciados[].razao_social_fornecedor
/xNome
$.documentos_referenciados[].tipo_chave_dfe
/tipoChaveDFE
$.documentos_referenciados[].tipo_valor_incluido
/tpReeRepRes
$.documentos_referenciados[].valor_repasse
/vlrReeRepRes
$.evento
/atvEvento
$.evento.data_fim
/dtFimEvt
$.evento.data_inicio
/dtIniEvt
$.evento.endereco
/end
$.evento.endereco.cep
/CEP
$.evento.endereco.cep_ext
/cEndPost
$.evento.endereco.codigo_pais_ext
/cPais
$.evento.endereco.nome_cidade_ext
/xCidade
$.evento.endereco.regiao_ext
/xEstProvReg
$.evento.nome
/xNomeEvt
$.exigibilidade_suspensa
/ExigibilidadeSuspensa
$.finalidade_emissao
/finNFSe
$.imovel.codigo_cib
/cCIB
$.imovel.endereco
/end
$.imovel.endereco.cep
/CEP
$.imovel.endereco.cep_ext
/cEndPost
$.imovel.endereco.codigo_pais_ext
/cPais
$.imovel.endereco.nome_cidade_ext
/xCidade
$.imovel.endereco.regiao_ext
/xEstProvReg
$.imovel.inscricao_imobiliaria
/inscImobFisc
$.indicador_destinatario
/indDest
$.obra.codigo
/cObra
$.obra.codigo_cib
/cCIB
$.obra.endereco
/end
$.obra.endereco.cep
/CEP
$.obra.endereco.cep_ext
/cEndPost
$.obra.endereco.codigo_pais_ext
/cPais
$.obra.endereco.nome_cidade_ext
/xCidade
$.obra.endereco.regiao_ext
/xEstProvReg
$.obra.inscricao_imobiliaria
/inscImobFisc
$.pagamento_parcelado_antecipado
/PagamentoParceladoAntecipado
$.servico.codigo_indicador_operacao
/cIndOp
$.servico.codigo_municipio_prestacao
/cLocPrestacao
$.servico.codigo_nbs
/NBS
$.servico.codigo_ncm
/NCM
$.servico.codigo_pais_prestacao
/cPaisPrestacao
$.servico.fonte_total_tributos
/FonteCargaTributaria
$.servico.ibs_cbs_classificacao_tributaria
/cClassTrib
$.servico.ibs_cbs_classificacao_tributaria_regular
/cClassTribReg
$.servico.percentual_total_tributos
/PercentualCargaTributaria
$.servico.valor_final_cobrado
/ValorFinalCobrado
$.servico.valor_inicial_cobrado
/ValorInicialCobrado
$.servico.valor_ipi
/ValorIPI
$.servico.valor_juros
/ValorJuros
$.servico.valor_multa
/ValorMulta
$.tipo_compra_governamental
/tpEnteGov
$.tipo_operacao_governamental
/tpOper
$.tomador.endereco
/EnderecoTomador
$.tomador.endereco.bairro
/Bairro
$.tomador.endereco.cep
/CEP
$.tomador.endereco.codigo_municipio
/Cidade
$.tomador.endereco.complemento
/ComplementoEndereco
$.tomador.endereco.logradouro
/Logradouro
$.tomador.endereco.numero
/NumeroEndereco
$.tomador.endereco.tipo_logradouro
/TipoLogradouro
$.tomador.endereco.uf
/UF
$.tomador.motivo_ausencia_nif
/NaoNIF
$.tomador.nif
/NIF
$.tributacao_rps
/TributacaoRPS
{
"data_emissao": "2025-12-17T00:00:00",
"natureza_operacao": "1",
"prestador": {
"cnpj": "00000000000",
"inscricao_municipal": "12345",
"codigo_municipio": "3550308"
},
"tomador": {
"cnpj": "85.904.290/0001-50",
"razao_social": "Fictício Tomador",
"endereco": {
"logradouro": "Rua Fictícia",
"numero": "2",
"complemento": "ap02",
"bairro": "Centro",
"uf": "SP",
"cep": "05608040"
},
"telefone": "41 3256-8060",
"email": "test@example.com"
},
"servico": {
"discriminacao": "NFSe reforma tributária teste",
"item_lista_servico": "07498",
"valor_servicos": "1",
"valor_final_cobrado": "1",
"base_calculo": "1",
"aliquota": "5",
"iss_retido": "0",
"valor_ipi": 0,
"codigo_nbs": "000000000",
"codigo_indicador_operacao": "000000",
"ibs_cbs_classificacao_tributaria": "000001"
},
"exigibilidade_suspensa": 0,
"pagamento_parcelado_antecipado": 0,
"finalidade_emissao": 0,
"consumidor_final": 0,
"indicador_destinatario": 0
}