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 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 da finalidade da emissão de NFS-e
$.finalidade_emissao /finNFSe
Reforma
Indicador de consumidor final
$.consumidor_final /indFinal
ObrigatórioReforma
  • Valores possíveis:
  • 0 - Não
  • 1 - Sim
Código indicador da operação
$.servico.codigo_indicador_operacao /cIndOp
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 /tpOper
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 /gRefNFSe
Reforma
Lista de objetos do tipo chave_nfse
Chave da NFS-e referenciada
$.chaves_nfse_referenciadas[].chave_nfse /refNFSe
Reforma
Tipo ente governamental
$.tipo_compra_governamental /tpEnteGov
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 /indDest
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 /dest
Reforma
Grupo de informações do destinatário. O destinatário só deve ser informado quando [indicador_destinatario = 1]
CNPJ
$.destinatario.cnpj /CNPJ
Reforma
Número do CNPJ
CPF
$.destinatario.cpf /CPF
Reforma
Número do CPF
NIF
$.destinatario.nif /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 /cNaoNIF
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 /xNome
Reforma
Nome ou Razão Social
Endereço
$.destinatario.endereco /end
Reforma
Grupo de informações do endereço
Código município
$.destinatario.endereco.codigo_municipio /cMun
Reforma
CEP
$.destinatario.endereco.cep /CEP
Reforma
Código do país
$.destinatario.endereco.codigo_pais_ext /cPais
Reforma
Tabela de Países ISO
CEP no exterior
$.destinatario.endereco.cep_ext /cEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Nome da cidade no exterior
$.destinatario.endereco.nome_cidade_ext /xCidade
Reforma
Nome da cidade no exterior
Região no exterior
$.destinatario.endereco.regiao_ext /xEstProvReg
Reforma
Estado, província ou região da cidade no exterior
Logradouro
$.destinatario.endereco.logradouro /xLgr
Reforma
Número no logradouro do endereço
$.destinatario.endereco.numero /nro
Reforma
Complemento do endereço
$.destinatario.endereco.complemento /xCpl
Reforma
Bairro do endereço
$.destinatario.endereco.bairro /xBairro
Reforma
Telefone
$.destinatario.telefone /fone
Reforma
Email
$.destinatario.email /email
Reforma
Imóvel
$.imovel /imovel
Reforma
Grupo de informações de operações relacionadas a bens imóveis, exceto obras
Inscrição imobiliária fiscal
$.imovel.inscricao_imobiliaria /inscImobFisc
Reforma
CIB
$.imovel.codigo_cib /cCIB
Reforma
Código do Cadastro Imobiliário Brasileiro - CIB
Endereço do imóvel
$.imovel.endereco /end
Reforma
Grupo de informações do endereço do imóvel
CEP
$.imovel.endereco.cep /CEP
Reforma
CEP no exterior
$.imovel.endereco.cep_ext /cEndPost
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Nome da cidade no exterior
$.imovel.endereco.nome_cidade_ext /xCidade
Reforma
Nome da cidade no exterior
Região no exterior
$.imovel.endereco.regiao_ext /xEstProvReg
Reforma
Estado, província ou região da cidade no exterior
Logradouro
$.imovel.endereco.logradouro /xLgr
Reforma
Número no logradouro do endereço
$.imovel.endereco.numero /nro
Reforma
Complemento do endereço
$.imovel.endereco.complemento /xCpl
Reforma
Bairro do endereço
$.imovel.endereco.bairro /xBairro
Reforma
Documentos Referenciados
$.documentos_referenciados /gReeRepRes
Reforma
Lista de objetos do tipo documentos_referenciados
Tipo chave DFe
$.documentos_referenciados[].tipo_chave_dfe /tipoChaveDFe
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 /xTipoChaveDFe
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 /chaveDFe
Reforma
Chave do Documento Fiscal eletrônico do repositório nacional referenciado para os casos de operações já tributadas
Código município
$.documentos_referenciados[].codigo_municipio_documento_fiscal_outro /cMunDocFiscal
Reforma
Cód. do município emissor do doc. fiscal que não se encontra no repositório nacional
Número do documento fiscal
$.documentos_referenciados[].numero_documento_fiscal_outro /nDocFiscal
Reforma
Número do documento fiscal que não se encontra no repositório nacional
Descrição do doc.
$.documentos_referenciados[].descricao_documento_fiscal_outro /xDocFiscal
Reforma
Número do documento não fiscal
$.documentos_referenciados[].numero_documento_nao_fiscal /nDoc
Reforma
Desc. doc. não fiscal
$.documentos_referenciados[].descricao_documento_nao_fiscal_outro /xDoc
Reforma
CNPJ do fornecedor
$.documentos_referenciados[].cnpj_fornecedor /CNPJ
Reforma
CPF do fornecedor
$.documentos_referenciados[].cpf_fornecedor /CPF
Reforma
NIF do fornecedor
$.documentos_referenciados[].nif_fornecedor /NIF
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 forn.
$.documentos_referenciados[].motivo_ausencia_nif_fornecedor /cNaoNIF
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 /xNome
Reforma
Nome ou Razão Social
Data emissão doc. ded.
$.documentos_referenciados[].data_emissao_documento_dedutivel /dtEmiDoc
Reforma
Data da emissão do documento dedutível. (AAAA-MM-DD)
Data comp. doc. ded.
$.documentos_referenciados[].data_competencia_documento_dedutivel /dtCompDoc
Reforma
Data da comp. do documento dedutível. (AAAA-MM-DD)
Tipo valor incluído
$.documentos_referenciados[].tipo_valor_incluido /tpReeRepRes
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. repasse
$.documentos_referenciados[].descricao_tipo_valor_incluido /xTpReeRepRes
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_repasse /vlrReeRepRes
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 /CST
Reforma
Código de Situação Tributária do IBS e da CBS
Cód. class. trib. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria /cClassTrib
Reforma
Código de Classificação Tributária do IBS e da CBS
Cód. créd. pres. IBS/CBS
$.servico.ibs_cbs_credito_codigo_classificacao /cCredPres
Reforma
Código e classificação do crédito presumido: IBS e CBS
CST trib. reg. IBS/CBS
$.servico.ibs_cbs_situacao_tributaria_regular /CSTReg
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_regular /cClassTribReg
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 /pDifUF
Reforma
Perc. de diferimento para IBS Mun.
$.servico.ibs_mun_percentual_diferimento /pDifMun
Reforma
Percentual de diferimento para a CBS
$.servico.cbs_percentual_diferimento /pDifCBS
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"
  }
}