Voltar

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

Saiba como emitir NFS-e em Extrema (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
WebISS
Padrão
ABRASF 2.01
Autenticação
Certificado digital
Cancelamento
Ativo

Ambientes Disponíveis

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

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorObrigatório
Endereço do TomadorObrigatório
Item Lista ServiçoObrigatórioUtiliza o padrão nacional da Lei Complementar 116/2003
Código CNAEObrigatório
Código Tributário MunicípioObrigatórioUtiliza o valor do campo item_lista_servico.

Campos Exclusivos

Indicador de consumidor final
$.consumidor_final
ObrigatórioReforma
  • Valores possíveis:
  • 1 - Sim
  • 2 - Não
Código indicador da operação
$.servico.codigo_indicador_operacao
Reforma
Código indicador da operação de fornecimento, conforme tabela "código indicador de operação"
Tipo Operação Entes Governamentais
$.tipo_operacao_governamental
Reforma
  • Tipo de Operação com Entes Governamentais ou outros serviços sobre bens imó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
$.chaves_nfse_referenciadas
Reforma
Lista de objetos do tipo chave_nfse
Chave da NFS-e referenciada
$.chaves_nfse_referenciadas[].chave_nfse
Reforma
Tipo ente governamental
$.tipo_compra_governamental
Reforma
  • Tipo de ente governamental. Para administração pública direta e suas autarquias e fundações.
  • Valores possíveis:
  • 1 - União
  • 2 - Estado
  • 3 - Distrito Federal
  • 4 - Município
Ind. Destinatário
$.indicador_destinatario
Reforma
  • Indica o destinatário do serviço. Valores possíveis:
  • 0 - O destinatário é o próprio tomador/adquirente identificado na NFS-e (tomador=adquirente=destinatário)
  • 1 - O destinatário não é o próprio adquirente, podendo ser outra pessoa, física ou jurídica (ou equiparada), ou um
  • estabelecimento diferente do indicado como tomador (tomador=adquirente≠destinatário)
Destinatário
$.destinatario
Reforma
Grupo de informações do destinatário. O destinatário só deve ser informado quando [indicador_destinatario = 1]
CNPJ
$.destinatario.cnpj
Reforma
Número do CNPJ
CPF
$.destinatario.cpf
Reforma
Número do CPF
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
Nome ou Razão Social
Endereço
$.destinatario.endereco
Reforma
Grupo de informações do endereço
Código município
$.destinatario.endereco.codigo_municipio
Reforma
CEP
$.destinatario.endereco.cep
Reforma
Código do país
$.destinatario.endereco.codigo_pais_ext
Reforma
Tabela de Países ISO
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
Logradouro
$.destinatario.endereco.logradouro
Reforma
Número no logradouro do endereço
$.destinatario.endereco.numero
Reforma
Complemento do endereço
$.destinatario.endereco.complemento
Reforma
Bairro do endereço
$.destinatario.endereco.bairro
Reforma
Telefone
$.destinatario.email
Reforma
Email
$.destinatario.email
Reforma
Imóvel
$.imovel
Reforma
Grupo de informações de operações relacionadas a bens imóveis, exceto obras
Inscrição imobiliária fiscal
$.imovel.inscricao_imobiliaria
Reforma
CIB
$.imovel.codigo_cib
Reforma
Código do Cadastro Imobiliário Brasileiro - CIB
Endereço do imóvel
$.imovel.endereco
Reforma
Grupo de informações do endereço do imóvel
CEP
$.imovel.endereco.cep
Reforma
CEP no exterior
$.imovel.endereco.cep_ext
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Nome da cidade no exterior
$.imovel.endereco.nome_cidade_ext
Reforma
Nome da cidade no exterior
Região no exterior
$.imovel.endereco.regiao_ext
Reforma
Estado, província ou região da cidade no exterior
Logradouro
$.imovel.endereco.logradouro
Reforma
Número no logradouro do endereço
$.imovel.endereco.numero
Reforma
Complemento do endereço
$.imovel.endereco.complemento
Reforma
Bairro do endereço
$.imovel.endereco.bairro
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_documento_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_documento_fiscal_outro
Reforma
Número do documento não fiscal
$.documentos_referenciados[].numero_documento_nao_fiscal
Reforma
Desc. do doc. não fiscal
$.documentos_referenciados[].descricao_documento_nao_fiscal_outro
Reforma
CNPJ do fornecedor
$.documentos_referenciados[].cnpj_fornecedor
Reforma
CPF do fornecedor
$.documentos_referenciados[].cpf_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_fornecedor
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
Nome ou Razão Social
Data emissão doc. ded.
$.documentos_referenciados[].data_emissao_documento_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_valor_incluido
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
Desc. reembolso ou ressarcimento
$.documentos_referenciados[].descricao_tipo_valor_incluido
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"
Val. reemb./ressarc.
$.documentos_referenciados[].valor_reembolso_repasse_ressarcimento
Reforma
Valor monetário reembolso ou ressarcimento(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$)
CST IBS/CBS
$.servico.ibs_cbs_situacao_tributaria
Reforma
Código de Situação Tributária do IBS e da CBS
Cód. class. trib. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria
Reforma
Código de Classificação Tributária do IBS e da CBS
Cód. créd. pres. IBS/CBS
$.servico.ibs_credito_codigo_classificacao
Reforma
Código e classificação do crédito presumido: IBS e CBS
CST trib. reg. IBS/CBS
$.servico.ibs_cbs_situacao_tributaria_regular
Reforma
Código de Situação Tributária do IBS e da CBS de tributação regular
Cód. class. trib. reg. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria_regulars
Reforma
Código de Classificação Tributária do IBS e da CBS de tributação regular
Perc. de diferimento para IBS UF
$.servico.ibs_uf_percentual_diferimento
Reforma
Perc. de diferimento para IBS Mun.
$.servico.ibs_mun_percentual_diferimento
Reforma
Percentual de diferimento para a CBS
$.servico.cbs_percentual_diferimento
Reforma

Outras Informações

  • Para efetuar a emissão em ambiente de homologação, é necessário fazer um cadastro no portal

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3125101
  },
  "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": {
    "valor_servicos": 1.0,
    "aliquota": 2.0,
    "item_lista_servico": "04.01",
    "codigo_tributario_municipio": "04.01",
    "codigo_cnae": "8630503",
    "discriminacao": "TESTE DE WEBSERVICE"
  }
}
{
  "data_emissao": "2025-07-16T11:13:00",
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3125101
  },
  "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": {
    "valor_servicos": 1.0,
    "aliquota": 2.0,
    "item_lista_servico": "04.01",
    "codigo_tributario_municipio": "04.01",
    "codigo_cnae": "8630503",
    "discriminacao": "TESTE DE WEBSERVICE",
    "codigo_indicador_operacao": "000001",
    "ibs_cbs_situacao_tributaria": "001",
    "ibs_cbs_classificacao_tributaria": "000001"
  }
}