Voltar

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

Saiba como emitir NFS-e em Barueri (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
Próprio
Formato
Próprio
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 padrão próprio.
Código CNAENão utilizado
Código Tributário MunicípioNão utilizado
Inscrição MunicipalObrigatórioDeverá enviar apenas os números e letras que compõe esse campo.

Campos do Provedor

Chave de acesso da NFS-e referenciada
$.chave_nfse_referenciada
Reforma
Código Optante Simples Nacional
$.codigo_opcao_simples_nacional
Reforma
  • Possíveis valores:
  • 1 - Não Optante
  • 2 - Optante - Microempreendedor Individual (MEI)
  • 3 - Optante - Microempresa ou Empresa de Pequeno Porte (ME/EPP)
Indicador Consumo Final
$.consumidor_final
Reforma
  • Valores possíveis:
  • 0 - Não
  • 1 - Sim
Destinatario
$.destinatario
CNPJ Destinatário
$.destinatario.cnpj
Reforma
CPF Destinatário
$.destinatario.cpf
Reforma
E-mail
$.destinatario.email
Reforma
Endereco
$.destinatario.endereco
Bairro
$.destinatario.endereco.bairro
Reforma
CEP
$.destinatario.endereco.cep
Reforma
CEP no exterior
$.destinatario.endereco.cep_ext
Reforma
Código Municipio
$.destinatario.endereco.codigo_municipio
Reforma
Código País
$.destinatario.endereco.codigo_pais
Reforma
Complemento
$.destinatario.endereco.complemento
Reforma
Logradouro
$.destinatario.endereco.logradouro
Reforma
Cidade
$.destinatario.endereco.nome_cidade
Reforma
Número
$.destinatario.endereco.numero
Reforma
Região no exterior
$.destinatario.endereco.regiao_ext
Reforma
UF
$.destinatario.endereco.uf
Reforma
NIF Destinatário
$.destinatario.nif
Reforma
Razão Social
$.destinatario.razao_social
Reforma
Imovel
$.imovel
Código NCM do Imóvel
$.imovel.codigo_ncm
Reforma
Código da Nomenclatura Comum do Mercosul do bem móvel objeto de locação.
Descrição do Imóvel
$.imovel.descricao
Reforma
Descrição do bem móvel objeto de locação.
Quantidade do Imóvel
$.imovel.quantidade
Reforma
Quantidade para bem móvel objeto de locação.
Indicador Destinatário
$.indicador_destinatario
Reforma
  • Valores possíveis:
  • 0 - O destinatário é o próprio tomador identificado na NFS-e (tomador = destinatário)
  • 1 - O destinatário não é o próprio tomador, podendo ser o intermediário ou outra pessoa, física ou jurídica (ou equiparada), ou um estabelecimento diferente do indicado como tomador (tomador != destinatário)
Regime Apuração Tributos SN
$.regime_tributario_simples_nacional
Reforma
  • Possíveis valores:
  • 1 - Regime de apuração dos tributos federais e municipal pelo Simples Nacional;
  • 2 - Regime de apuração dos tributos federais pelo Simples Nacional e o ISSQN pela NFS-e conforme respectiva legislação municipal do tributo;
  • 3 - Regime de apuração dos tributos federais e municipal pela NFS-e conforme respectivas legilações federal e municipal de cada tributo;
Servico
$.servico
Código indicador da operação de fornecimento, conforme tabela do Anexo VII (Indicador de Operações)
$.servico.codigo_indicador_operacao
ObrigatórioReforma
Código NBS
$.servico.codigo_nbs
ObrigatórioReforma
Código de Nomenclatura Brasileira de Serviços
Data do fim do evento
$.servico.data_fim_evento
Reforma
Data do fim do evento. Formato: AAAAMMDD
Data do início do evento
$.servico.data_inicio_evento
Reforma
Data do início do evento. Formato: AAAAMMDD
Código de Classificação Tributária do IBS e da CBS
$.servico.ibs_cbs_classificacao_tributaria
ObrigatórioReforma
Cód. Créd. presumido IBS/CBS
$.servico.ibs_cbs_credito_codigo_classificacao
Reforma
Código e classificação do crédito presumido: IBS e CBS
Indicador de operação de doação
$.servico.ibs_cbs_indicacao_doacao
Reforma
  • Valores possíveis:
  • 1 - Informar quando doação
Código de Situação Tributária do IBS e da CBS
$.servico.ibs_cbs_situacao_tributaria
Reforma
Nome do evento
$.servico.nome_evento
Reforma
Nome do evento Artístico, Cultural, Esportivo, entre outros. Obrigatório para atividades com código de serviço iniciados em 12 (serviços relativos à atividades de eventos, diversões, lazer, entretenimento e congeneres).
Vínculo do serviço prestado
$.servico.vinculo_servico_prestado
Reforma
  • Campo necessário apenas em caso de tomador estrageiro. Possíveis valores:
  • 0 - Sem vínculo com o Tomador / Prestador
  • 1 - Controlada
  • 2 - Controladora
  • 3 - Coligada
  • 4 - Matriz
  • 5 - Filial ou sucursal
  • 6 - Outro vínculo
Tipo governamental
$.tipo_ente_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
Tipo Ope. gov.
$.tipo_operacao_governamental
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
Endereco
$.tomador.endereco
CEP no exterior
$.tomador.endereco.cep_ext
Reforma
Código alfanumérico do Endereçamento Postal no exterior
Código do país
$.tomador.endereco.codigo_pais_ext
Reforma
Tabela de Países ISO
Nome da cidade no exterior
$.tomador.endereco.nome_cidade_ext
Reforma
Nome da cidade no exterior
Região no exterior
$.tomador.endereco.regiao_ext
Reforma
Estado, província ou região da cidade no exterior
NIF
$.tomador.nif
Reforma
Número de Identificação Fiscal do tomador estrangeiro

Outras Informações

  • Emissão NFSe por arquivos:
    • O município de Barueri utiliza um provedor próprio que tinha um padrão proprietário. Caso opte por emitir por esse formato, é necessário fazer algumas alterações. Veja mais informações sobre a emissão por arquivo Aqui
  • Tomador estrangeiro:
    • Todos os campos no json de exemplo pra tomador estrangeiro são obrigatórios.
      • cnpj: Pode ser enviado o ID estrangeiro ou outra numeração que identifique o tomador ou empresa
      • codigo_municipio e cep: Podem ser replicados os mesmos valores do prestador
      • codigo_pais: Código do pais do tomador. A cidade usa uma tabela específica de numeração para o codigo_pais

JSONs de Exemplo

{
  "data_emissao": "2026-02-20T09:20:57",
  "natureza_operacao": 1,
  "codigo_opcao_simples_nacional": 3,
  "regime_tributario_simples_nacional": 1,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123",
    "codigo_municipio": 3505708
  },
  "tomador": {
    "cnpj": "85.904.290/0001-50",
    "razao_social": "Fictício Tomador",
    "endereco": {
      "logradouro": "Rua Fictícia",
      "numero": "2",
      "complemento": "ap02",
      "bairro": "Centro",
      "codigo_municipio": "3550308",
      "uf": "PR",
      "cep": "82900-010"
    },
    "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": 5.0,
    "iss_retido": false,
    "item_lista_servico": "170202220"
  }
}
{
  "data_emissao": "2026-02-20T09:20:57",
  "natureza_operacao": 1,
  "codigo_opcao_simples_nacional": 3,
  "regime_tributario_simples_nacional": 1,
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123",
    "codigo_municipio": 3505708
  },
  "tomador": {
    "nif": "1232456",
    "razao_social": "Fictício Tomador",
    "endereco": {
      "logradouro": "Rua Fictícia",
      "numero": "2",
      "complemento": "ap02",
      "bairro": "Centro",
      "nome_cidade_ext": "Cidade",
      "regiao_ext": "CA",
      "cep_ext": "82900010",
      "codigo_pais_ext": "1015"
    },
    "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": 5.0,
    "iss_retido": false,
    "item_lista_servico": "170202220"
  }
}