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

Saiba como emitir NFS-e em Piedade de Caratinga (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
VersaTecnologia
Padrão
ABRASF 2.04
Autenticação
Certificado digital
Cancelamento
Ativo

Ambientes Disponíveis

Ambiente
Disponível
Portal de Acesso
Produção
Sim
Homologação
Não
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 nacional da Lei Complementar 116/2003
Código CNAENão utilizado
Código Tributário MunicípioNão utilizado

Campos Exclusivos

CST PIS/COFINS
$.servico.situacao_tributaria_pis_cofins /Cst
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 Tributável da Contribuição
  • 08 - Operação sem Incidência da Contribuição
  • 09 - Operação com Suspensão da Contribuição
Base Cálculo PIS/COFINS
$.servico.base_calculo_pis_cofins /vBCPisCofins
Reforma
Valor da Base de Cálculo do PIS/COFINS (R$)
Alíq. PIS
$.servico.aliquota_pis /pAliqPis
Reforma
Valor da Alíquota do PIS (%)
Alíq. COFINS
$.servico.aliquota_cofins /pAliqCofins
Reforma
Valor da Alíquota do COFINS (%)
Tipo Retenção PIS/COFINS
$.servico.tipo_retencao_pis_cofins /tpRetPisCofins
Reforma
  • Tipo de Retenção do PIS/COFINS
  • Valores possíveis:
  • 1 - Retido
  • 2 - Não Retido
Cód. NBS
$.servico.codigo_nbs /CodigoNbs
ObrigatórioReforma
Código da lista de Nomenclatura Brasileira de Serviços (NBS)
Modo de Prestação
$.modo_prestacao /mdPrestacao
Reforma
  • Modo de Prestação (exportação/importação)
  • Valores possíveis:
  • 0 - Desconhecido
  • 1 - Transfronteiriço
  • 2 - Consumo no Brasil
  • 3 - Movimento Temporário
  • 4 - Consumo no Exterior
Vínculo entre partes
$.vinculo_negocio /vincPrest
Reforma
  • Vínculo entre as partes no negócio (exportação/importação)
  • Valores possíveis:
  • 0 - Sem vínculo
  • 1 - Controlada
  • 2 - Controladora
  • 3 - Coligada
  • 4 - Matriz
  • 5 - Filial
  • 6 - Outro vínculo
Cód. Moeda
$.codigo_moeda /tpMoeda
Reforma
  • Código da moeda conforme padrão ISO 4217, composto por 3 dígitos numéricos.
  • Valores possíveis: https://bcb.gov.br/estabilidadefinanceira/cotacoestodas
Valor Serviço Moeda
$.valor_servico_ext /vServMoeda
Reforma
Valor decimal do serviço na moeda informada, com até 15 dígitos inteiros e 2 casas decimais.
Mec. de apoio ComEx Prestador
$.mecanismo_comercio_ext_prestador /mecAFComexP
Reforma
  • Mecanismo de apoio ao Comércio Exterior utilizado pelo Prestador
  • Valores possíveis:
  • 00 - Desconhecido
  • 01 - Nenhum
  • 02 - ACC - Adiantamento sobre Contrato de Câmbio
  • 03 - ACE - Adiantamento sobre Cambiais Entregues
  • 04 - BNDES-Exim Pós-Embarque - Serviços
  • 05 - BNDES-Exim Pré-Embarque - Serviços
  • 06 - FGE - Fundo de Garantia à Exportação
  • 07 - PROEX - Equalização
  • 08 - PROEX - Financiamento
Mov. Temporária Bens
$.movimentacao_temporaria_bens /movTempBens
Reforma
  • Vínculo da Operação à Movimentação Temporária de Bens
  • Valores possíveis:
  • 0 - Desconhecido
  • 1 - Não
  • 2 - Vinculada - Declaração de Importação
  • 3 - Vinculada - Declaração de Exportação
MDIC
$.mdic /mdic
Reforma
  • Envio de informações ao MDIC
  • Valores possíveis:
  • 0 - Não enviar ao MDIC
  • 1 - Enviar ao MDIC
Identificação/Nome Evento
$.evento.nome /IdentificacaoEvento
Reforma
Descrição do evento
$.evento.descricao /DescricaoEvento
Reforma
Tipo Dedução
$.documentos_referenciados[].tipo_deducao /TipoDeducao
Reforma
  • Codigo de identificação do tipo da deducao
  • Valores possíveis:
  • 1 - Materiais
  • 2 - Subempreitada de mão de obra
  • 3 - Serviços
  • 4 - Produção externa
  • 5 - Alimentação e bebidas/frigobar
  • 6 - Reembolso de despesas
  • 7 - Repasse consorciado
  • 8 - Repasse plano de saúde
  • 99 - Outras deduções
Decrição Dedução
$.documentos_referenciados[].descricao_deducao /DescricaoDeducao
Reforma
Cód. município NFSe
$.documentos_referenciados[].codigo_municipio_nfse /CodigoMunicipioGerador
Reforma
Número NFSe
$.documentos_referenciados[].numero_nfse /NumeroNfse
Reforma
Cód. verificação NFSe
$.documentos_referenciados[].codigo_verificacao_nfse /CodigoVerificacao
Reforma
Número NFe
$.documentos_referenciados[].numero_nfe /NumeroNfe
Reforma
UF NFe
$.documentos_referenciados[].uf_nfe /UfNfe
Reforma
Chave de acesso NFe
$.documentos_referenciados[].chave_nfe /ChaveAcessoNfe
Reforma
Identificação outro Documento
$.documentos_referenciados[].identificacao_documento_fiscal_outro /IdentificacaoDocumento
Reforma
CPF Fornecedor
$.documentos_referenciados[].cpf_fornecedor /Cpf
Reforma
CNPJ Fornecedor
$.documentos_referenciados[].cnpj_fornecedor /Cnpj
Reforma
NIF Fornecedor
$.documentos_referenciados[].nif_fornecedor /NifFornecedor
Reforma
Cód. país Fornecedor(Ext.)
$.documentos_referenciados[].codigo_pais_ext_fornecedor /CodigoPais
Reforma
Data emissão
$.documentos_referenciados[].data_emissao_documento_dedutivel /DataEmissao
Reforma
Valor Dedutivel
$.documentos_referenciados[].valor_dedutivel /ValorDedutivel
Reforma
Valor utilizado dedução
$.documentos_referenciados[].valor_utilizado_deducao /ValorUtilizadoDeducao
Reforma

JSONs de Exemplo

{
  "data_emissao": "2026-01-12T07:34:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": true,
  "regime_especial_tributacao": 6,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3150158
  },
  "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": 3150158,
      "uf": "MG",
      "cep": "35325-000"
    },
    "telefone": "41 3256-8060",
    "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": 5.0,
    "item_lista_servico": "04.12",
    "codigo_nbs": "1.2301.23.00",
    "valor_iss": 0.05,
    "iss_retido": false
  }
}