Guia técnico de emissão de NFS-e em Santo André/SP pela API da Focus NFe

Saiba como emitir NFS-e em Santo André (SP) 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
Ginfes
Formato
Próprio (ABRASF)
Autenticação
Certificado digital
Cancelamento
Ativo

Ambientes Disponíveis

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

Campos Importantes

CampoObrigatoriedadeObservação
CPF/CNPJ do TomadorOpcional
Endereço do TomadorOpcional
Item Lista ServiçoObrigatórioUtiliza o padrão da Lei Complementar 116/2003
Código CNAEOpcional
Código Tributário MunicípioNão utilizado

Campos do Provedor - Reforma Tributária (apenas HOMOLOGAÇÃO)

Indic. Operação
$.consumidor_final /indFinal
Reforma
  • Indica operação de uso ou consumo pessoal (art. 57)
  • Valores possíveis:
  • 0 - Não;
  • 1 - Sim;
Documentos Referenciados
$.documentos_referenciados /gReeRepRes
Chave DF-e
$.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
CNPJ Fornecedor
$.documentos_referenciados[].cnpj_fornecedor /CNPJ
Reforma
Número da inscrição no Cadastro Nacional de Pessoa Jurídica (CNPJ) do Fornecedor do serviço
Cod.Mun. Emissor
$.documentos_referenciados[].codigo_municipio_documento_fiscal_outro /cMunDocFiscal
Reforma
Código do município emissor do documento fiscal que não se encontra no repositório nacional
CPF Fornecedor
$.documentos_referenciados[].cpf_fornecedor /CPF
Reforma
Número da inscrição no Cadastro de Pessoa Física (CPF) do Fornecedor do serviço
Dt. Comp. Doc.
$.documentos_referenciados[].data_competencia_documento_dedutivel /dtCompDoc
Reforma
Data da competência do documento dedutível. Ano, mês e dia (AAAA-MM-DD)
Dt. Emissão Doc.
$.documentos_referenciados[].data_emissao_documento_dedutivel /dtEmiDoc
Reforma
Data da emissão do documento dedutível. Ano, mês e dia (AAAA-MM-DD)
Descrição DF-e
$.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)'
Desc. Doc. Fiscal
$.documentos_referenciados[].descricao_documento_fiscal_outro /xDocFiscal
Reforma
Descrição do documento fiscal
Desc. Doc. Fiscal
$.documentos_referenciados[].descricao_documento_nao_fiscal_outro /xDoc
Reforma
Descrição do documento não fiscal
Des. tipo valor incluido
$.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'
Não NIF Fornecedor
$.documentos_referenciados[].motivo_ausencia_nif_fornecedor /cNaoNIF
Reforma
  • 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;
NIF Fornecedor
$.documentos_referenciados[].nif_fornecedor /NIF
Reforma
Este elemento só deverá ser preenchido para fornecedores não residentes no Brasil
Num. Doc. Fiscal
$.documentos_referenciados[].numero_documento_fiscal_outro /nDocFiscal
Reforma
Número do documento fiscal que não se encontra no repositório nacional
Num. Doc. Fiscal
$.documentos_referenciados[].numero_documento_nao_fiscal_outro /nDoc
Reforma
Número do documento não fiscal
Nome Fornecedor
$.documentos_referenciados[].razao_social_fornecedor /xNome
Reforma
Nome / Razão Social do do Fornecedor do serviço
Tipo Chave DF-e
$.documentos_referenciados[].tipo_chave_dfe /tipoChaveDFe
Reforma
  • Documento fiscal a que se refere a chaveDfe que seja um dos documentos do Repositório Nacional
  • Valores possíveis:
  • 1 - NFS-e;
  • 2 - NF-e;
  • 3 - CT-e;
  • 9 - Outro;
Tipo valor incluido
$.documentos_referenciados[].tipo_valor_incluido /tpReeRepRes
  • 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 referenciados
  • Valores possíveis:
  • 01 - Repasse de remuneração por intermediação de imóveis a demais corretores envolvidos na operação;
  • 02 - Repasse de valores a fornecedor relativo a fornecimento intermediado por agência de turismo;
  • 03 - Reembolso ou ressarcimento recebido por agência de propaganda e publicidade por valores pagos relativos a serviços de produção externa por conta e ordem de terceiro;
  • 04 - Reembolso ou ressarcimento recebido por agência de propaganda e publicidade por valores pagos relativos a serviços de mídia por conta e ordem de terceiro;
  • 99 - Outros reembolsos ou ressarcimentos recebidos por valores pagos relativos a operações por conta e ordem de terceiro;
Valor repasse
$.documentos_referenciados[].valor_repasse /vlrReeRepRes
Reforma
Valor monetário (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$)
Indic. Emissão
$.finalidade_emissao /finNFSe
Reforma
  • Indicador da finalidade da emissão de NFS-e
  • Valores possíveis:
  • 0 - NFS-e regular;
Indic. destinatário
$.indicador_destinatario /indDest
Reforma
  • A respeito do Destinatário dos serviços
  • Valores possíveis:
  • 0 - O tomador identificado na NFS-e é o adquirente e o destinatário do fornecimento (tomador = adquirente = destinatário);
  • 1 - O tomador e o adquirente são a mesma pessoa, mas o destinatário é uma pessoa física ou jurídica ou equiparada diversa do indicado como tomador/adquirente ou se trata de um estabelecimento do adquirente diferente do indicado no campo “tomador” (tomador = adquirente ≠ destinatário);
Perc. total UF
$.percentual_total_tributos_estaduais /pTotTribEst
Reforma
Valor percentual total aproximado dos tributos estaduais (%)
Perc. total Federal
$.percentual_total_tributos_federais /pTotTribFed
Reforma
Valor percentual total aproximado dos tributos federais (%)
Perc. total Mun.
$.percentual_total_tributos_municipais /pTotTribMun
Reforma
Valor percentual total aproximado dos tributos municipais (%)
Perc. total SN
$.percentual_total_tributos_simples_nacional /pTotTribSN
Reforma
Valor percentual aproximado do total dos tributos da alíquota do Simples Nacional (%)
Servico
$.servico
Alíq. COFINS
$.servico.aliquota_cofins /pAliqCofins
Reforma
Valor da Alíquota da COFINS (%)
Alíq. PIS
$.servico.aliquota_pis /pAliqPis
Reforma
Valor da Alíquota do PIS (%)
BC PIS/COFINS
$.servico.base_calculo_pis_cofins /vBCPisCofins
Reforma
Valor da Base de Cálculo do PIS/COFINS (R$)
NFSeReferenciada
$.servico.chaves_nfse_referenciadas /gRefNFSe
Chave NFS-e Ref.
$.servico.chaves_nfse_referenciadas[].chave_nfse /refNFSe
Reforma
Chave da NFS-e referenciada
Cód. indic. Operação
$.servico.codigo_indicador_operacao /cIndOp
Reforma
Código indicador da operação de fornecimento, conforme tabela 'código indicador de operação'
Cód. Moeda
$.servico.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
BC IBS/CBS
$.servico.ibs_cbs_base_calculo /vBC
Reforma
Valor da Base de Cálculo do ISSQN (R$) = Valor do Serviço - Desconto Incondicionado - Deduções/Reduções - Benefício Municipal. vBC = vServ - descIncond - (vDR ou vCalcDR + vCalcReeRepRes) - (vRedBCBM ou VCalcBM)
Cód. Trib. IBS/CBS
$.servico.ibs_cbs_classificacao_tributaria /cClassTrib
Reforma
Código de Classificação Tributária do IBS e da CBS
Doc. Mun. Incidencia
$.servico.ibs_cbs_codigo_municipio_incidencia /cLocalidadeIncid
Reforma
Código IBGE da localidade de incidência do IBS/CBS (local da operação)
CST IBS/CBS
$.servico.ibs_cbs_situacao_tributaria /CST
Reforma
Código de Situação Tributária do IBS e da CBS
Envio MDIC
$.servico.mdic /mdic
Reforma
  • Envio de informações ao MDIC
  • Valores possíveis:
  • 0 - Não enviar ao MDIC
  • 1 - Enviar ao MDIC
Mec. Aferição ComEx Prestador
$.servico.mecanismo_comercio_ext_prestador /mecAFComexP
Reforma
  • Mecanismo de Aferição - Comércio Exterior (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
Mec. Aferição ComEx Tomador
$.servico.mecanismo_comercio_ext_tomador /mecAFComexT
Reforma
  • Mecanismo de Aferição – Comércio Exterior (Tomador)
  • Valores possíveis:
  • 00 - Desconhecido
  • 01 - Nenhum
  • 02 - Adm. Pública e Representação Internacional
  • 03 - Aluguéis e Arrendamento de Máquinas/Equipamentos
  • 04 - Arrendamento de Aeronave - Transporte Aéreo Público
  • 05 - Comissão a Agentes Externos
  • 06 - Armazenagem/Movimentação no Exterior
  • 07 - Eventos FIFA (Subsidiária)
  • 08 - Eventos FIFA
  • 09 - Fretes e Arrendamentos
  • 10 - Material Aeronáutico
  • 11 - Promoção de Bens no Exterior
  • 12 - Promoção de Destinos Turísticos
  • 13 - Promoção do Brasil no Exterior
  • 14 - Promoção de Serviços no Exterior
  • 15 - RECINE
  • 16 - RECOPA
  • 17 - Registro/Manutenção de Marcas/Patentes
  • 18 - REICOMP
  • 19 - REIDI
  • 20 - REPENEC
  • 21 - REPES
  • 22 - RETAERO
  • 23 - RETID
  • 24 - Royalties / Assistência Técnica
  • 25 - Avaliação de Conformidade - OMC
  • 26 - ZPE
Modo de Prestação
$.servico.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
Mov. Temporária Bens
$.servico.movimentacao_temporaria_bens /movTempBens
Reforma
  • 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
Número Doc. Importação
$.servico.numero_declaracao_importacao /nDI
Reforma
Número do Documento de Importação, campo alfanumérico com tamanho mínimo de 1 e máximo de 12 caracteres.
Número Reg. Exportação
$.servico.numero_registro_exportacao /nRE
Reforma
Número do Registro de Exportação, campo alfanumérico com tamanho fixo de 12 caracteres.
Perc. red. alíq. gov.
$.servico.perc_reducao_aliquota_compra_governamental /pRedutor
Reforma
Percentual de redução de aliquota em compra governamental
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;
Tipo ret. PIS/COFINS
$.servico.tipo_retencao_pis_cofins /tpRetPisCofins
Reforma
  • Tipo de retencao do Pis/Cofins
  • Valores possíveis:
  • 1 - Retido;
  • 2 - Não Retido;
Valor COFINS
$.servico.valor_cofins /vCofins
Reforma
Valor monetário do COFINS (R$)
Valor PIS
$.servico.valor_pis /vPis
Reforma
Valor monetário do PIS (R$)
Valor Serviço Moeda
$.servico.valor_servico_ext /vServMoeda
Reforma
Valor decimal do serviço na moeda informada, com até 15 dígitos inteiros e 2 casas decimais.
Vínculo entre partes
$.servico.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
Tipo governamental
$.tipo_ente_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;
  • 9 - Outro;
Tipo Ope. gov.
$.tipo_operacao_governamental /tpOper
Reforma
  • Tipo de Operação com Entes Governanementais 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.
Tomador
$.tomador
Endereço Exterior
$.tomador.endereco /EnderecoExterior
CEP Exterior
$.tomador.endereco.cep_ext /cEndPost
Reforma
Código País Exterior
$.tomador.endereco.codigo_pais /CodigoPais
Reforma
Código do país do endereço no exterior (Tabela de países do IBGE).
Endereço completo Exterior
$.tomador.endereco.endereco_completo /EnderecoCompletoExterior
Reforma
Nome da Cidade Exterior
$.tomador.endereco.nome_cidade_ext /xCidade
Reforma
Região/Província/Estado Exterior
$.tomador.endereco.regiao_ext /xEstProvReg
Reforma

Outras Informações

  • A liberação do ambiente de homologação poderá ser solicitado através do e-mail: atendimento@ginfes.com.br. No envio do Lote deverá conter informações como: CNPJ e Inscrição municipal de acordo com o cadastro da prefeitura.
  • Se o contribuinte possuir dígito verificador em sua inscrição municipal, deverá realizar a consulta na prefeitura para identificar se o digito verificador foi contemplado em seu cadastro. Não poderá ser utilizado o "-" (ifem). Caso o dígito verificado não esteja contemplado esse não poderá ser informado.

JSONs de Exemplo

{
  "data_emissao": "2025-07-16T11:13:00",
  "optante_simples_nacional": true,
  "regime_especial_tributacao": "6",
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": 3547809
  },
  "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,
    "aliquota": 2.0,
    "valor_iss": 0.02,
    "discriminacao": "Exemplo serviços",
    "item_lista_servico": "4.16"
  }
}
{
  "data_emissao": "2026-04-23T17:37:56-0300",
  "natureza_operacao": 1,
  "optante_simples_nacional": false,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "00000",
    "codigo_municipio": 3547809
  },
  "tomador": {
    "cnpj": "11.111.111/0000-00",
    "razao_social": "Fictício Tomador",
    "endereco": {
      "logradouro": "Rua Fictícia",
      "numero": "11",
      "complemento": "ap101",
      "bairro": "Centro",
      "codigo_municipio": 3547809,
      "uf": "SP",
      "cep": "81000-100"
    },
    "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.0,
    "aliquota": 4.0,
    "item_lista_servico": "07.01",
    "iss_retido": false,
    "codigo_tributario_municipio": "7.01/108811/1271",
    "codigo_municipio": 3547809,
    "valor_pis": 0.07,
    "valor_cofins": 0.03,
    "valor_inss": 0,
    "valor_ir": 0.02,
    "valor_csll": 0.01,
    "situacao_tributaria_pis_cofins": "00",
    "codigo_nbs": "114032290",
    "codigo_indicador_operacao": "100301",
    "ibs_cbs_situacao_tributaria": "200",
    "ibs_cbs_classificacao_tributaria": "200052"
  },
  "consumidor_final": 0,
  "finalidade_emissao": 0,
  "indicador_destinatario": 0,
  "percentual_total_tributos_federais": 13.33,
  "percentual_total_tributos_estaduais": 0,
  "percentual_total_tributos_municipais": 3.0
}