Guia técnico de emissão de NFS-e em São Paulo/SP pela API da Focus NFe
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.
Ambientes Disponíveis
Ambiente
Disponível
Portal de Acesso
Produção
Sim
Não disponível
Homologação
Sim
Não disponível
Campos Importantes
| Campo | Obrigatoriedade | Observação |
|---|
| CPF/CNPJ do Tomador | | |
| Endereço do Tomador | | |
| Item Lista Serviço | | |
| Código CNAE | | |
| Código Tributário Município | | |
Campos Exclusivos
NIF
$.tomador.nif
Reforma
Tipo NIF (Número de Identificação Fiscal) fornecido por um órgão de administração tributária no exterior
Motivo ausência NIF
$.tomador.motivo_ausencia_nif
Reforma
- Tipo do motivo para não informação do NIF
- 0 - Não informado na nota de origem
- 1 - Dispensado do NIF
- 2 - Não exigência do NIF
Valor Inicial
$.servico.valor_inicial_cobrado
Reforma
Valor Final
$.servico.valor_final_cobrado
Reforma
Valor Multa
$.servico.valor_multa
Reforma
Valor Juros
$.servico.valor_juros
Reforma
Valor IPI
$.servico.valor_ipi
Reforma
Exigibilidade Suspensa
$.exigibilidade_suspensa
ObrigatórioReforma
- Informe se é uma emissão com exigibilidade suspensa.
- 0 - Não
- 1 - Sim
Pag. Parc. Antecipado
$.pagamento_parcelado_antecipado
ObrigatórioReforma
- Informe se a nota teve pagamento parcelado antecipado
- 0 - Não
- 1 - Sim
NCM
$.servico.codigo_ncm
Reforma
Nomenclatura Comum do Mercosul
NBS
$.servico.codigo_nbs
Reforma
Nomenclatura Brasileira de Serviços
Grupo de informações sobre o evento
Nome do evento
$.evento.nome
Reforma
Nome do evento cultural, artístico, esportivo
Data de início do evento
$.evento.data_inicio
Reforma
Data de início da atividade de evento. Ano, Mês e Dia (AAAA-MM-DD)
Data de fim do evento
$.evento.data_fim
Reforma
Data de fim da atividade de evento. Ano, Mês e Dia (AAAA-MM-DD)
Endereço do evento
$.evento.endereco
Reforma
Grupo de informações do endereço do evento
CEP
$.evento.endereco.cep
Reforma
Código de Endereçamento Postal
Código do país
$.evento.endereco.codigo_pais_ext
Reforma
CEP no exterior
$.evento.endereco.cep_ext
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Nome da cidade no exterior
$.evento.endereco.nome_cidade_ext
Reforma
Nome da cidade no exterior
Região no exterior
$.evento.endereco.regiao_ext
Reforma
Estado, província ou região da cidade no exterior
Código município prestação
$.servico.codigo_municipio_prestacao
Reforma
Código da cidade do município da prestação do serviço
Código do país prestação
$.servico.codigo_pais_prestacao
Reforma
Código do país da prestação do serviço
Indicador da finalidade da emissão
$.finalidade_emissao
ObrigatórioReforma
- Valores possíveis:
- 0 - NFS-e regular
- 1 - NFS-e complementar
Indicador Consumo Final
$.consumidor_final
ObrigatórioReforma
- Valores possíveis:
- 0 - Não
- 1 - Sim
Código indicador da operação de fornecimento
$.servico.codigo_indicador_operacao
ObrigatórioReforma
Conforme tabela "código indicador de operação"
Tipo de Op. Entes Gov.
$.tipo_operacao_governamental
Reforma
- Tipo de Operação com Entes Governamentais 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
Chaves de acesso da NFS-e referenciada
$.notas_referenciadas
Reforma
Lista de objetos do tipo chave_nfse
Chave da NFS-e referenciada
$.notas_referenciadas[].chave_nfse
Reforma
Tipo do ente da compra governamental
$.tipo_compra_governamental
Reforma
- Valores possíveis:
- 1 - União
- 2 - Estados
- 3 - Distrito Federal
- 4 - Municípios
Indicador Destinatário
$.indicador_destinatario
Reforma
- Valores possíveis:
- 0 - O destinatário é o próprio tomador identificado na NFS-e (tomador = destinatário)
- 1 - O destinatário não é o próprio tomador, podendo ser o intermediário ou outra pessoa, física ou jurídica (ou equiparada), ou um estabelecimento diferente do indicado como tomador (tomador != destinatário)
Destinatário
$.destinatario
Reforma
Grupo de informações do destinatário
CPF
$.destinatario.cpf
Reforma
CNPJ
$.destinatario.cnpj
Reforma
NIF
$.destinatario.nif
Reforma
Número de Identificação Fiscal fornecido por um órgão de administração tributária no exterior
Motivo ausência NIF
$.destinatario.motivo_ausencia_nif
Reforma
- Tipo do 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
Razão Social
$.destinatario.razao_social
Reforma
Endereço
$.destinatario.endereco
Reforma
Grupo de informações do endereço
CEP
$.destinatario.endereco.cep
Reforma
Código de Endereçamento Postal
Código do país
$.destinatario.endereco.codigo_pais_ext
Reforma
CEP no exterior
$.destinatario.endereco.cep_ext
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Nome da cidade no exterior
$.destinatario.endereco.nome_cidade_ext
Reforma
Nome da cidade no exterior
Região no exterior
$.destinatario.endereco.regiao_ext
Reforma
Estado, província ou região da cidade no exterior
Email
$.destinatario.email
Reforma
Documentos Referenciados
$.documentos_referenciados
Reforma
Lista de objetos do tipo documentos_referenciados
Tipo chave DFE
$.documentos_referenciados[].tipo_chave_dfe
Reforma
- Tipo de documento do repositório nacional. Valores possíveis:
- 1 - NFS-e
- 2 - NF-e
- 3 - CT-e
- 9 - Outro
Descrição chave DFE
$.documentos_referenciados[].descricao_chave_dfe
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 DFE
$.documentos_referenciados[].chave_dfe
Reforma
Chave do Documento Fiscal eletrônico do repositório nacional referenciado para os casos de operações já tributadas
Código município emissor
$.documentos_referenciados[].codigo_municipio_doc_fiscal_outro
Reforma
Código do município emissor do documento fiscal que não se encontra no repositório nacional
Número do documento fiscal
$.documentos_referenciados[].numero_doc_fiscal_outro
Reforma
Número do documento fiscal que não se encontra no repositório nacional
Descrição do documento fiscal
$.documentos_referenciados[].descricao_doc_fiscal_outro
Reforma
Número do documento não fiscal
$.documentos_referenciados[].numero_doc_nao_fiscal
Reforma
Descrição do documento não fiscal
$.documentos_referenciados[].descricao_doc_nao_fiscal
Reforma
CPF do fornecedor
$.documentos_referenciados[].cpf_fornecedor
Reforma
CNPJ do fornecedor
$.documentos_referenciados[].cnpj_fornecedor
Reforma
NIF do fornecedor
$.documentos_referenciados[].nif_fornecedor
Reforma
Tipo NIF (Número de Identificação Fiscal) - fornecido por um órgão de administração tributária no exterior
Motivo ausência NIF do fornecedor
$.documentos_referenciados[].motivo_ausencia_nif
Reforma
- Tipo do 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
Razão Social do fornecedor
$.documentos_referenciados[].razao_social_fornecedor
Reforma
Data emissão doc. ded.
$.documentos_referenciados[].data_emissao_doc_dedutivel
Reforma
Data da emissão do documento dedutível. Ano, mês e dia (AAAA-MM-DD)
Data competência doc. ded.
$.documentos_referenciados[].data_competencia_doc_dedutivel
Reforma
Data da competência do documento dedutível. Ano, mês e dia (AAAA-MM-DD)
Tipo valor incluído
$.documentos_referenciados[].tipo_ree_rep_res
Reforma
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 referenciado
Descrição reembolso ou ressarcimento
$.documentos_referenciados[].descricao_ree_rep_res
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 monetário reembolso ou ressarcimento
$.documentos_referenciados[].valor_ree_rep_res
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$)
Código Class. Trib. IBS/CBS
$.servico.codigo_classificacao_tributaria_ibs_cbs
ObrigatórioReforma
Código de classificação Tributária do IBS e da CBS principal
Código Class. Trib. IBS/CBS Regular
$.servico.codigo_classificacao_tributaria_ibs_cbs_regular
Reforma
Código de classificação Tributária do IBS e da CBS de tributação regular
Código CIB
$.servico.codigo_cib
Reforma
Cadastro de imóveis. Obrigatório para construção civil
Código Obra
$.servico.codigo_obra
Reforma
Identificação da obra, do Cadastro Nacional de Obras, ou do Cadastro Específico do INSS
Endereço obra
$.servico.endereco_obra
Reforma
Grupo de informações do endereço da obra
CEP
$.servico.endereco_obra.cep
Reforma
Código de Endereçamento Postal
Código do país
$.servico.endereco_obra.codigo_pais_ext
Reforma
CEP no exterior
$.servico.endereco_obra.cep_ext
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Nome da cidade no exterior
$.servico.endereco_obra.nome_cidade_ext
Reforma
Nome da cidade no exterior
Região no exterior
$.servico.endereco_obra.regiao_ext
Reforma
Estado, província ou região da cidade no exterior
Inscrição Imobiliária Fiscal
$.servico.inscricao_imobiliaria_fiscal
Reforma
Inscrição Imobiliária fiscal (código fornecido pela prefeitura para identificação da obra ou para fins de recolhimento do IPTU)