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

Padrão

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.
Optante Simples Nacional	Opcional	Este campo utiliza um formato diferente da nossa API. Possíveis valores: 1 - Não Optante 2 - Optante - Microempreendedor Individual (MEI) 3 - Optante - Microempresa ou Empresa de Pequeno Porte (ME/EPP)
Regime Tributário	Opcional	Este campo utiliza um formato diferente da nossa API. 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

Campos Exclusivos

NIF do Tomador

$tomador.nif

Opcional

Número de Identificação Fiscal do tomador estrangeiro

Código NBS

$servico.codigo_nbs

Opcional

Código de Nomenclatura Brasileira de Serviços

Vínculo do serviço prestado

$servico.vinculo_servico_prestado

Opcional

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

Nome do evento

$servico.nome_evento

Opcional

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).

Data do início do evento

$servico.data_inicio_evento

Opcional

Formato: AAAAMMDD

Data do fim do evento

$servico.data_fim_evento

Opcional

Formato: AAAAMMDD

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

{
  "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": "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"
  }
}

{
  "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"
    }
  }
}