Guia técnico de emissão de NFS-e em Bonito de Minas/MG pela API da Focus NFe

Saiba como emitir NFS-e em Bonito de Minas (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
Não permite por webservices Apenas via portal / requisição na prefeitura

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 TomadorObrigatório
Item Lista ServiçoObrigatórioUtiliza o padrão da Lei Complementar 116/2003
Código CNAENão utilizado
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)

Outras Informações

  • Não permite cancelamento via webservices, somente pelo portal da prefeitura por meio de processo administrativo.
  • O envio da IM do prestador é opcional nesta prefeitura.

JSONs de Exemplo

{
  "data_emissao": "2025-07-29T07:34:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3108255
  },
  "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": 3108255,
      "uf": "MG",
      "cep": "39490-000"
    },
    "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,
    "aliquota": 5,
    "valor_iss": 0.05,
    "item_lista_servico": "16.01",
    "codigo_tributario_municipio": "160101",
    "iss_retido": false
  }
}