Saiba como emitir NFS-e em Natal (RN) 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 | Opcional | |
| Endereço do Tomador | Obrigatório | |
| Item Lista Serviço | Obrigatório | Utiliza 6 dígitos numéricos (2 para Item, 2 para Subitem e 2 para Desdobro Nacional, conforme Código de Tributação Nacional) Só é permitido utilizar os códigos que foram informados no momento do cadastro da empresa |
| Código CNAE | Opcional | |
| Código Tributário Município | Não utilizado |
$.servico.codigo_pais_ext
/PaisExterior
$.servico.codigo_nbs
/CodigoNbs
$.finalidade_emissao
/finNFSe
$.consumidor_final
/indFinal
$.codigo_indicador_operacao
/cIndOp
$.chaves_nfse_referenciadas
/gRefNFSe
$.chaves_nfse_referenciadas[].chave_nfse
/refNFSe
$.tipo_ente_governamental
/tpEnteGov
$.indicador_destinatario
/indDest
$.destinatario
/dest
$.destinatario.cpf
/Cpf
$.destinatario.cnpj
/Cnpj
$.destinatario.nif
/NIF
$.destinatario.motivo_ausencia_nif
/cNaoNif
$.destinatario.razao_social
/xNome
$.destinatario.endereco
/Endereco
$.destinatario.endereco.logradouro
/Endereco
$.destinatario.endereco.numero
/Numero
$.destinatario.endereco.complemento
/Complemento
$.destinatario.endereco.bairro
/Bairro
$.destinatario.endereco.codigo_municipio
/CodigoMunicipio
$.destinatario.endereco.uf
/Uf
$.destinatario.endereco.cep
/Cep
$.destinatario.endereco.codigo_pais_ext
/PaisExterior
$.destinatario.endereco.cep_ext
/CodigoPostalExterior
$.destinatario.endereco.nome_cidade_ext
/CidadeExterior
$.destinatario.endereco.regiao_ext
/EstadoRegiaoProvinciaExterior
$.destinatario.telefone
/Telefone
$.destinatario.email
/Email
$.imovel
/imovel
$.imovel.inscricao_imobiliaria
/inscImobFisc
$.imovel.codigo_cib
/cCIB
$.imovel.endereco
/end
$.imovel.endereco.logradouro
/Endereco
$.imovel.endereco.numero
/Numero
$.imovel.endereco.complemento
/Complemento
$.imovel.endereco.bairro
/Bairro
$.imovel.endereco.codigo_municipio
/CodigoMunicipio
$.imovel.endereco.uf
/Uf
$.imovel.endereco.cep
/Cep
$.imovel.endereco.codigo_pais_ext
/PaisExterior
$.imovel.endereco.cep_ext
/CodigoPostalExterior
$.imovel.endereco.nome_cidade_ext
/CidadeExterior
$.imovel.endereco.regiao_ext
/EstadoRegiaoProvinciaExterior
$.documentos_referenciados
/gReeRepRes
$.documentos_referenciados[].tipo_chave_dfe
/tipoChaveDFe
$.documentos_referenciados[].descricao_chave_dfe
/xTipoChaveDFe
$.documentos_referenciados[].chave_dfe
/chaveDFe
$.documentos_referenciados[].codigo_municipio_documento_fiscal_outro
/cMunDocFiscal
$.documentos_referenciados[].numero_documento_fiscal_outro
/nDocFiscal
$.documentos_referenciados[].descricao_documento_fiscal_outro
/xDocFiscal
$.documentos_referenciados[].numero_documento_nao_fiscal_outro
/nDoc
$.documentos_referenciados[].descricao_documento_nao_fiscal_outro
/xDoc
$.documentos_referenciados[].cpf_fornecedor
/Cpf
$.documentos_referenciados[].cnpj_fornecedor
/Cnpj
$.documentos_referenciados[].nif_fornecedor
/NIF
$.documentos_referenciados[].motivo_ausencia_nif_fornecedor
/cNaoNif
$.documentos_referenciados[].razao_social_fornecedor
/xNome
$.documentos_referenciados[].data_emissao_documento_dedutivel
/dtEmiDoc
$.documentos_referenciados[].data_competencia_documento_dedutivel
/dtCompDoc
$.documentos_referenciados[].tipo_valor_incluido
/tpReeRepRes
$.documentos_referenciados[].descricao_tipo_valor_incluido
/xTpReeRepRes
$.documentos_referenciados[].valor_repasse
/vlrReeRepRes
$.servico.ibs_cbs_situacao_tributaria
/CST
$.servico.ibs_cbs_classificacao_tributaria
/cClassTrib
$.servico.ibs_cbs_credito_codigo_classificacao
/cCredPres
$.servico.ibs_cbs_situacao_tributaria_regular
/CSTReg
$.servico.ibs_cbs_classificacao_tributaria_regular
/cClassTribReg
$.servico.ibs_uf_percentual_diferimento
/pDifUF
$.servico.ibs_mun_percentual_diferimento
/pDifMun
$.servico.cbs_percentual_diferimento
/pDifCBS
$.servico.ibs_cbs_codigo_municipio_incidencia
/cLocalidadeIncid
$.servico.ibs_cbs_descricao_municipio_incidencia
/xLocalidadeIncid
$.servico.perc_reducao_aliquota_compra_governamental
/pRedutor
$.servico.ibs_cbs_base_calculo
/vBC
$.servico.valor_repasse
/vCalcReeRepRes
$.servico.ibs_uf_aliquota
/pIBSUF
$.servico.ibs_uf_percentual_reducao_aliquota
/pRedAliqUF
$.servico.ibs_uf_aliquota_efetiva
/pAliqEfetUF
$.servico.ibs_mun_aliquota
/pIBSMun
$.servico.ibs_mun_percentual_reducao_aliquota
/pRedAliqMun
$.servico.ibs_mun_aliquota_efetiva
/pAliqEfetMun
$.servico.cbs_aliquota
/pCBS
$.servico.cbs_percentual_reducao_aliquota
/pRedAliqCBS
$.servico.cbs_aliquota_efetiva
/pAliqEfetCBS
$.servico.ibs_valor_total
/vIBSTot
$.servico.ibs_percentual_credito_presumido
/pCredPresIBS
$.servico.ibs_valor_credito_presumido
/vCredPresIBS
$.servico.ibs_uf_valor_diferimento
/vDifUF
$.servico.ibs_uf_valor
/vIBSUF
$.servico.ibs_mun_valor_diferimento
/vDifMun
$.servico.ibs_mun_valor
/vIBSMun
$.servico.cbs_percentual_credito_presumido
/pCredPresCBS
$.servico.cbs_valor_credito_presumido
/vCredPresCBS
$.servico.cbs_valor_diferimento
/vDifCBS
$.servico.cbs_valor
/vCBS
$.servico.ibs_uf_aliquota_efetiva_regular
/pAliqEfeRegIBSUF
$.servico.ibs_uf_valor_regular
/vTribRegIBSUF
$.servico.ibs_mun_aliquota_efetiva_regular
/pAliqEfeRegIBSMun
$.servico.ibs_mun_valor_regular
/vTribRegIBSMun
$.servico.cbs_aliquota_efetiva_regular
/pAliqEfeRegCBS
$.servico.cbs_valor_regular
/vTribRegCBS
$.servico.ibs_uf_aliquota_governamental
/pIBSUF
$.servico.ibs_uf_valor_governamental
/vIBSUF
$.servico.ibs_mun_aliquota_governamental
/pIBSMun
$.servico.ibs_mun_valor_governamental
/vIBSMun
$.servico.cbs_aliquota_governamental
/pCBS
$.servico.cbs_valor_governamental
/vCBS
$.obra.codigo
/CodigoObra
$.obra.art
/Art
{
"data_emissao": "2025-07-16T11:13:00",
"natureza_operacao": 1,
"optante_simples_nacional": false,
"prestador": {
"cnpj": "00000000000000",
"inscricao_municipal": "123445",
"codigo_municipio": 2408102
},
"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": 4106902,
"uf": "PR",
"cep": "82900-010"
},
"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": 5.0,
"item_lista_servico": "01.05.01",
"codigo_nbs": "1.1103.21.00",
"valor_iss": 0.05,
"iss_retido": false
}
}