Guia técnico de emissão de NFS-e em Coração de Jesus/MG pela API da Focus NFe

Saiba como emitir NFS-e em Coração de Jesus (MG) 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
Sintese
Formato
Próprio (ABRASF)
Autenticação
Certificado digital
Cancelamento
Ativo

Ambientes Disponíveis

Ambiente
Disponível
Portal de Acesso
Produção
Sim
Homologação
Sim
Não disponível

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorObrigatório
Endereço do TomadorOpcional
Item Lista ServiçoObrigatórioUtiliza o padrão da Lei Complementar 116/2003
Código CNAEObrigatórioO mesmo valor utilizado em item_lista_serviço
Código Tributário MunicípioObrigatórioUtiliza 6 dígitos numéricos (2 para Item, 2 para Subitem e 2 para Desdobro Nacional, conforme Código de Tributação Nacional)

Campos do Provedor

NFS-e referenciadas
$.chaves_nfse_referenciadas /NotasReferenciadas
Chave da NFS-e referenciada
$.chaves_nfse_referenciadas[].chave_nfse /ChaveNfse
Reforma
Código da moeda
$.codigo_moeda /TpMoeda
Reforma
Código da moeda que identifica a transação comercial
Evento
$.evento
Código do evento
$.evento.codigo /IdentificacaoEvento
Reforma
Data de fim do evento
$.evento.data_fim /DtFim
Reforma
Data de início do evento
$.evento.data_inicio /DtIni
Reforma
Descrição do evento
$.evento.descricao /DescricaoEvento
Reforma
Endereco
$.evento.endereco
Bairro
$.evento.endereco.bairro /XBairro
Reforma
CEP
$.evento.endereco.cep /CEP
Reforma
CEP no exterior
$.evento.endereco.cep_ext /CodigoEndPost
Reforma
Complemento
$.evento.endereco.complemento /XCpl
Reforma
Logradouro
$.evento.endereco.logradouro /XLgr
Reforma
Nome da cidade no exterior
$.evento.endereco.nome_cidade_ext /XCidade
Reforma
Número
$.evento.endereco.numero /Nro
Reforma
Região no exterior
$.evento.endereco.regiao_ext /XEstProvReg
Reforma
Estado, província ou região da cidade no exterior
Imovel
$.imovel
Código CIB
$.imovel.codigo_cib /CodigoCIB
Reforma
Endereco
$.imovel.endereco
Bairro
$.imovel.endereco.bairro /XBairro
Reforma
CEP
$.imovel.endereco.cep /CEP
Reforma
CEP no exterior
$.imovel.endereco.cep_ext /CodigoEndPost
Reforma
Complemento
$.imovel.endereco.complemento /XCpl
Reforma
Logradouro
$.imovel.endereco.logradouro /XLgr
Reforma
Nome da cidade no exterior
$.imovel.endereco.nome_cidade_ext /XCidade
Reforma
Número
$.imovel.endereco.numero /Nro
Reforma
Região no exterior
$.imovel.endereco.regiao_ext /XEstProvReg
Reforma
Estado, província ou região da cidade no exterior
Inscrição imobiliária fiscal
$.imovel.inscricao_imobiliaria /InscImobFisc
Reforma
MDIC
$.mdic /MDIC
Reforma
  • Indicador se a NFS-e deverá ser disponibilizada ao MDIC
  • Valores possíveis:
  • 0 - Não enviar para o MDIC
  • 1 - Enviar para o MDIC
Apoio prestador ext.
$.mecanismo_comercio_ext_prestador /MecAFComexP
Reforma
  • Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo prestador do serviço
  • Valores possíveis:
  • 0 - Desconhecido (tipo não informado na nota de origem)
  • 1 - Nenhum
  • 2 - ACC - Adiantamento sobre Contrato de Câmbio - Redução a Zero do IR e do IOF
  • 3 - ACE - Adiantamento sobre Cambiais Entregues - Redução a Zero do IR e do IOF
  • 4 - BNDES-Exim Pós-Embarque - Serviços
  • 5 - BNDES-Exim Pré-Embarque - Serviços
  • 6 - FGE - Fundo de Garantia à Exportação
  • 7 - PROEX - Equalização
  • 8 - PROEX - Financiamento
Apoio tomador ext.
$.mecanismo_comercio_ext_tomador /MecAFComexT
Reforma
  • Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo tomador do serviço
  • Valores possíveis:
  • 0 - Desconhecido (tipo não informado na nota de origem)
  • 1 - Nenhum
  • 2 - Adm. pública e repr. internacional
  • 3 - Aluguéis e arrend. mercantil de máquinas, equip., embarc. e aeronaves
  • 4 - Arrendamento mercantil de aeronave para empresa de transporte aéreo público
  • 5 - Comissão a agentes externos na exportação
  • 6 - Despesas de armazenagem, mov. e transporte de carga no exterior
  • 7 - Eventos FIFA (subsidiária)
  • 8 - Eventos FIFA
  • 9 - Fretes, arrendamentos de embarcações ou aeronaves e outros
  • 10 - Material aeronáutico
  • 11 - Promoção de bens no exterior
  • 12 - Promoção de dest. turísticos brasileiros
  • 13 - Promoção do Brasil no exterior
  • 14 - Promoção de serviços no exterior
  • 15 - RECINE
  • 16 - RECOPA
  • 17 - Registro e manutenção de marcas, patentes e cultivares
  • 18 - REICOMP
  • 19 - REIDI
  • 20 - REPENEC
  • 21 - REPES
  • 22 - RETAERO
  • 23 - RETID
  • 24 - Royalties, assistência técnica, científica e assemelhados
  • 25 - Serviços de avaliação da conformidade vinculados aos acordos da OMC
  • 26 - ZPE
Modo de prestação
$.modo_prestacao /MdPrestacao
Reforma
  • Valores possíveis:
  • 0 - Desconhecido (tipo não informado na nota de origem)
  • 1 - Transfronteiriço
  • 2 - Consumo no Brasil
  • 3 - Movimento temporário de pessoas físicas
  • 4 - Consumo no exterior
Movimentação Temporária
$.movimentacao_temporaria_bens /MovTempBens
Reforma
  • Vínculo da Operação à Movimentação Temporária de Bens
  • Valores possíveis:
  • 0 - Desconhecido (tipo não informado na nota de origem)
  • 1 - Não
  • 2 - Vinculada - Declaração de importação
  • 3 - Vinculada - Declaração de exportação
Número da declaração de importação
$.numero_declaracao_importacao /NDI
Reforma
Número do registro de exportação
$.numero_registro_exportacao /NRE
Reforma
Obra
$.obra
Código da obra
$.obra.codigo /CodigoObra
Reforma
Código CIB da obra
$.obra.codigo_cib /CodigoCIB
Reforma
Código da obra no Cadastro Imobiliário Brasileiro
Endereco
$.obra.endereco
Bairro
$.obra.endereco.bairro /XBairro
Reforma
CEP
$.obra.endereco.cep /CEP
Reforma
CEP no exterior
$.obra.endereco.cep_ext /CodigoEndPost
Reforma
Complemento
$.obra.endereco.complemento /XCpl
Reforma
Logradouro
$.obra.endereco.logradouro /XLgr
Reforma
Nome da cidade no exterior
$.obra.endereco.nome_cidade_ext /XCidade
Reforma
Número
$.obra.endereco.numero /Nro
Reforma
Região no exterior
$.obra.endereco.regiao_ext /XEstProvReg
Reforma
Estado, província ou região da cidade no exterior
Inscrição imobiliária fiscal da obra
$.obra.inscricao_imobiliaria /InscImobFisc
Reforma
Servico
$.servico
Alíquota COFINS (%)
$.servico.aliquota_cofins /AliquotaCofins
Reforma
Alíquota PIS (%)
$.servico.aliquota_pis /AliquotaPis
Reforma
Base de cálculo PIS/COFINS
$.servico.base_calculo_pis_cofins /ValorBasePisCofins
Reforma
Valor da base de cálculo do PIS/COFINS
Alíquota da CBS
$.servico.cbs_aliquota /AliquotaCbs
Reforma
Alíquota efetiva da CBS
$.servico.cbs_aliquota_efetiva /AliquotaEfetivaCbs
Reforma
Percentual de redução da alíquota da CBS
$.servico.cbs_percentual_reducao_aliquota /ReducaoAliquotaCbs
Reforma
Valor da CBS
$.servico.cbs_valor /ValorCbs
Reforma
Código indicador da operação de fornecimento
$.servico.codigo_indicador_operacao /CodigoIndicadorOperacao
Reforma
Cód. NBS
$.servico.codigo_nbs /CodigoNbs
Reforma
Código da lista de Nomenclatura Brasileira de Serviços (NBS)
Base de cálculo do IBS e da CBS
$.servico.ibs_cbs_base_calculo /ValorBaseIbsCbs
Reforma
Classificação tributária do IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria /ItemCst
Reforma
Código de classificação tributária do IBS e da CBS
Descrição do CST do IBS/CBS
$.servico.ibs_cbs_descricao_situacao_tributaria /DescricaoGrupoCst
Reforma
CST do IBS/CBS
$.servico.ibs_cbs_situacao_tributaria /CodigoGrupoCst
Reforma
Código de Situação Tributária do IBS e da CBS
Alíquota municipal do IBS
$.servico.ibs_mun_aliquota /AliquotaIbsMunicipal
Reforma
Alíquota efetiva municipal do IBS
$.servico.ibs_mun_aliquota_efetiva /AliquotaEfetivaIbsMunicipal
Reforma
Percentual de redução da alíquota municipal do IBS
$.servico.ibs_mun_percentual_reducao_aliquota /ReducaoAliquotaIbsMunicipal
Reforma
Valor do IBS municipal
$.servico.ibs_mun_valor /ValorIbsMunicipal
Reforma
Alíquota estadual do IBS
$.servico.ibs_uf_aliquota /AliquotaIbsEstadual
Reforma
Alíquota efetiva estadual do IBS
$.servico.ibs_uf_aliquota_efetiva /AliquotaEfetivaIbsEstadual
Reforma
Percentual de redução da alíquota estadual do IBS
$.servico.ibs_uf_percentual_reducao_aliquota /ReducaoAliquotaIbsEstadual
Reforma
Valor do IBS estadual
$.servico.ibs_uf_valor /ValorIbsEstadual
Reforma
CST PIS/COFINS
$.servico.situacao_tributaria_pis_cofins /CstPisCofins
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 Isenta da Contribuição
  • 08 - Operação sem Incidência da Contribuição
  • 09 - Operação com Suspensão da Contribuição
Tipo de retenção PIS/COFINS e CSLL
$.servico.tipo_retencao_pis_cofins /TipoRetencaoPisCofins
Reforma
  • Valores possíveis:
  • 0 - PIS/COFINS/CSLL Não Retidos
  • 3 - PIS/COFINS/CSLL Retidos
  • 4 - PIS/COFINS Retidos, CSLL Não Retido
  • 5 - PIS Retido, COFINS/CSLL Não Retido
  • 6 - COFINS Retido, PIS/CSLL Não Retido
  • 7 - PIS Não Retido, COFINS/CSLL Retidos
  • 8 - PIS/COFINS Não Retidos, CSLL Retido
  • 9 - COFINS Não Retido, PIS/CSLL Retidos
Tipo de operação governamental
$.tipo_operacao_governamental /TipoOperacao
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
Valor do serviço em moeda estrangeira
$.valor_servico_ext /VServMoeda
Reforma
Vínculo entre as partes no negócio
$.vinculo_negocio /VincPrest
Reforma
  • Valores possíveis:
  • 0 - Sem vínculo com o tomador/prestador
  • 1 - Controlada
  • 2 - Controladora
  • 3 - Coligada
  • 4 - Matriz
  • 5 - Filial ou sucursal
  • 6 - Outro vínculo
  • 9 - Desconhecido (tipo não informado na nota de origem)

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3118809
  },
  "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",
    "valor_servicos": 1.0,
    "aliquota": 2.01,
    "item_lista_servico": "4.12",
    "codigo_tributario_municipio": "041201",
    "codigo_cnae": "412",
    "iss_retido": false
  }
}