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

Campo	Obrigatoriedade	Observação
CPF/CNPJ do Tomador	Obrigatório
Endereço do Tomador	Obrigatório
Item Lista Serviço	Obrigatório	Utiliza padrão próprio.
Código CNAE	Não utilizado
Código Tributário Município	Não utilizado
Inscrição Municipal	Obrigatório	Deverá enviar apenas os números e letras que compõe esse campo.

Campos do Provedor

Optante Simples Nacional

$.optante_simples_nacional

Possíveis valores:
1 - Não Optante
2 - Optante - Microempreendedor Individual (MEI)
3 - Optante - Microempresa ou Empresa de Pequeno Porte (ME/EPP)

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 NBS

$.servico.codigo_nbs

Reforma

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

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

Tomador

$.tomador

NIF do Tomador

$.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,
  "optante_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"
  }
}

{
  "prestador": {
    "cnpj": "00000000000000",
    "inscricao_municipal": "123445",
    "codigo_municipio": "3505708"
  },
  "data_emissao": "2025-07-16T11:13:00",
  "natureza_operacao": 1,
  "servico": {
    "discriminacao": "TESTE DE EMISSAO",
    "item_lista_servico": "100503216",
    "valor_servicos": 1.0
  },
  "tomador": {
    "cnpj": "00000000000000",
    "razao_social": "nome da empresa",
    "endereco": {
      "logradouro": "rua do tomador",
      "numero": "numero do tomador",
      "bairro": "bairro do tomador",
      "codigo_municipio": 3505708,
      "cep": 3505708,
      "codigo_pais": "1015"
    }
  }
}