Guia técnico de emissão de NFS-e em Canápolis/MG pela API da Focus NFe

Saiba como emitir NFS-e em Canápolis (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
GovDigital
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

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorObrigatório
Endereço do TomadorObrigatório
Item Lista ServiçoObrigatórioUtiliza 6 dígitos numéricos (2 para Item, 2 para Subitem e 2 para Desdobro Nacional, conforme Código de Tributação Nacional)
Código CNAEOpcional
Código Tributário MunicípioOpcional

Campos do Provedor

Serviço
$.servico /Servico
CST PIS/COFINS
$.servico.situacao_tributaria_pis_cofins /CST
Reforma
Código de Situação Tributária do PIS/COFINS (00-09)
Tipo Retenção PIS/COFINS
$.servico.tipo_retencao_pis_cofins /TpRetPisCofins
Reforma
Tipo de retenção do PIS/COFINS: 1-Retido, 2-Não Retido
Município de Prestação
$.servico.codigo_municipio_prestacao /MunicipioPrestacao
Reforma
Código do município de prestação (IBGE)
País de Prestação
$.servico.codigo_pais_prestacao /PaisPrestacao
Reforma
Código do país de prestação (BACEN)
Código NBS
$.servico.codigo_nbs /CodigoNBS
Reforma
Código NBS (Nomenclatura Brasileira de Serviços) - 9 dígitos
Código Indicador Operação
$.servico.codigo_indicador_operacao /CIndOp
Reforma
Código indicador da operação de fornecimento - 6 dígitos
Classificação Tributária Regular IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria_regular /CClassTribReg
Reforma
Código da Classificação Tributária do IBS e da CBS de tributação regular - 6 dígitos
Imóvel
$.imovel /Imovel
Reforma
Grupo de informações de operações relacionadas a bens imóveis (quando CIndOp for 020101, 020201 ou 020301)
CCIB
$.imovel.codigo_cib /CCIB
Reforma
Código do Cadastro Imobiliário Brasileiro (8 chars) - disponível a partir de 2026
Endereço do Imóvel
$.imovel.endereco /Endereco
Reforma
Grupo de informações do endereço do imóvel (usar quando não tiver CCIB)
CEP no Exterior
$.imovel.endereco.cep_ext /CodigoEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior (1-11 chars)
Cidade no Exterior
$.imovel.endereco.nome_cidade_ext /CidadeExterior
Reforma
Nome da cidade no exterior (1-60 chars)
Região no Exterior
$.imovel.endereco.regiao_ext /EstProvRegExterior
Reforma
Estado, província ou região da cidade no exterior (1-60 chars)
Tomador
$.tomador /Tomador
NIF
$.tomador.nif /NIF
Reforma
Número de Identificação Fiscal fornecido por órgão de administração tributária no exterior (1-40 chars)
Motivo Ausência NIF
$.tomador.motivo_ausencia_nif /CodNaoNIF
Reforma
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
CEP no Exterior
$.tomador.endereco.cep_ext /CodigoEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior (1-11 chars)
Cidade no Exterior
$.tomador.endereco.nome_cidade_ext /CidadeExterior
Reforma
Nome da cidade no exterior (1-60 chars)
Região no Exterior
$.tomador.endereco.regiao_ext /EstProvRegExterior
Reforma
Estado, província ou região da cidade no exterior (1-60 chars)
Obra
$.obra /ConstrucaoCivil
Reforma
Grupo de informações da construção civil
Código Obra
$.obra.codigo /CodigoObra
Reforma
Identificador da obra (1-15 chars). No Focus NFe mapeia para obra.codigo
ART
$.obra.art /Art
Reforma
Anotação de Responsabilidade Técnica (1-15 chars)
Inscrição Imobiliária Fiscal
$.obra.inscricao_imobiliaria /InscImobFisc
Reforma
Inscrição imobiliária fiscal (1-30 chars)
ID Obra
$.obra.id_obra /IdObra
Reforma
Identificador da obra (1-15 chars)
CCIB
$.obra.codigo_cib /CCIB
Reforma
Código do Cadastro Imobiliário Brasileiro (8 chars) - disponível a partir de 2026
Endereço da Obra
$.obra.endereco /Endereco
Reforma
Grupo de informações do endereço da obra
CEP no Exterior
$.obra.endereco.cep_ext /CodigoEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior (1-11 chars)
Cidade no Exterior
$.obra.endereco.nome_cidade_ext /CidadeExterior
Reforma
Nome da cidade no exterior (1-60 chars)
Região no Exterior
$.obra.endereco.regiao_ext /EstProvRegExterior
Reforma
Estado, província ou região da cidade no exterior (1-60 chars)
Modo de Prestação
$.modo_prestacao /MdPrestacao
Reforma
Modo de Prestação: 0-Desconhecido, 1-Transfronteiriço, 2-Consumo no Brasil, 3-Presença Comercial no Exterior, 4-Movimento Temporário de Pessoas Físicas
Vínculo entre as Partes
$.vinculo_negocio /VincPrest
Reforma
Vínculo entre as partes no negócio: 1-Controlada, 2-Controladora, 3-Coligada, 4-Matriz, 5-Filial ou sucursal, 6-Outro vínculo
Código da Moeda
$.codigo_moeda /TpMoeda
Reforma
Código que identifica a moeda conforme tabela do BACEN (3 dígitos)
Valor do Serviço em Moeda Estrangeira
$.valor_servico_ext /VServMoeda
Reforma
Valor do serviço prestado expresso em moeda estrangeira
Mecanismo ComEx Prestador
$.mecanismo_comercio_ext_prestador /MecAFComexP
Reforma
Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo prestador (00-08)
Mecanismo ComEx Tomador
$.mecanismo_comercio_ext_tomador /MecAFComexT
Reforma
Mecanismo de apoio/fomento ao Comércio Exterior utilizado pelo tomador (00-26)
Movimentação Temporária de Bens
$.movimentacao_temporaria_bens /MovTempBens
Reforma
Operação vinculada à Movimentação Temporária de Bens: 0-Desconhecido, 1-Não, 2-Vinculada Declaração de Importação, 3-Vinculada Declaração de Exportação
MDIC
$.mdic /Mdic
Reforma
Compartilhar as informações com a Secretaria de Comércio Exterior: 0-Não enviar, 1-Enviar
Atividade de Evento
$.evento /AtvEvento
Reforma
Grupo de informações do DPS relativas a Evento (obrigatório para atividades do grupo 12.XX.XX)
Nome do Evento
$.evento.nome /Nome
Reforma
Nome/Identificação do evento (1-255 chars)
Data de Início
$.evento.data_inicio /DataInicio
Reforma
Data de início do evento (AAAA-MM-DD)
Data de Fim
$.evento.data_fim /DataFim
Reforma
Data de fim do evento (AAAA-MM-DD)
ID Atividade de Evento
$.evento.id_atividade_evento /IdAtvEv
Reforma
Identificação da Atividade de Evento (código identificador de evento determinado pela Administração Tributária Municipal, 1-30 chars)
Endereço do Evento
$.evento.endereco /Endereco
Reforma
Grupo de informações do endereço do evento
CEP no Exterior
$.evento.endereco.cep_ext /CodigoEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior (1-11 chars)
Cidade no Exterior
$.evento.endereco.nome_cidade_ext /CidadeExterior
Reforma
Nome da cidade no exterior (1-60 chars)
Região no Exterior
$.evento.endereco.regiao_ext /EstProvRegExterior
Reforma
Estado, província ou região da cidade no exterior (1-60 chars)

Outras Informações

  • Pode ser necessário solicitar liberação para emissão de NFSe/RPS:
    • Portal da prefeitura > Login > Autorização Emissão RPS.

JSONs de Exemplo

{
  "data_emissao": "2026-02-13T07:34:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123456",
    "codigo_municipio": 3111804
  },
  "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": 3111804,
      "uf": "MG",
      "cep": "38380-000"
    },
    "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": 2.0,
    "item_lista_servico": "041201",
    "codigo_nbs": "123012300",
    "codigo_indicador_operacao": "030101",
    "ibs_cbs_classificacao_tributaria": "200029",
    "iss_retido": false
  }
}