O município de Barueri (Alphaville/SP) é um dos maiores polos empresariais e tecnológicos da América Latina, sediando milhares de empresas de software, SaaS, fintechs, data centers e agências digitais. Consequentemente, quase todo escritório de contabilidade e desenvolvedor de ERP no Brasil atende clientes estabelecidos na cidade.
No entanto, a emissão de NFS-e em Barueri é famosa por ser uma das integrações mais difíceis do país: a prefeitura não utiliza o padrão ABRASF nem aderiu ao convênio simplificado do SNNFSE nacional. O envio é baseado em lotes estruturados por registros posicionais e delimitados (Registro 1, Registro 2 e Registro 9), com validações rigorosas que frequentemente disparam erros criptográficos como as críticas 239, 240, 241 e 245.
Neste guia técnico, analisamos a arquitetura do motor municipal de Barueri e como a Notaas unificou o envio em JSON, resolvendo automaticamente o parser do Registro 2 e a entrega do PDF com QR Code canônico.
🏛️ A Estrutura Única de Lote de Barueri (Registros 1, 2 e 9)
Diferente de prefeituras convencionais que aceitam um XML com a tag <Rps>, o webservice de Barueri opera com agrupamentos hierárquicos:
- Registro 1 (Header do Arquivo/Lote): Informa a versão do layout, identificação do prestador e tipo de remessa.
- Registro 2 (Detalhe da Prestação de Serviço): Contém os dados do tomador, endereço, descrição dos serviços, atividade municipal (CNAE/item LC 116), alíquotas e deduções.
- Registro 9 (Trailer de Fechamento): Linha de controle com o total de registros enviados e o somatório dos valores de serviço.
Qualquer quebra de linha mal posicionada, caractere especial não escapado ou divergência de alíquota no Registro 2 invalida o lote inteiro.
🚨 Principais Códigos de Crítica de Barueri e Suas Soluções
Ao integrar com Barueri, quatro erros respondem por mais de 90% dos chamados de suporte:
| Código | Mensagem Oficial da Prefeitura | Causa Raiz Técnica | Como a Notaas Resolve |
|---|---|---|---|
| 239 | Inscrição Municipal Inválida ou Cancelada | Inscrição Municipal informada com dígitos a mais ou prestador com pendência cadastral no CTM | Sanitização automática do formato da IM e validação prévia de dígitos verificadores |
| 240 | Alíquota Informada Divergente do Cadastro | A alíquota enviada no RPS difere da alíquota vinculada ao CNAE/Atividade no cadastro da empresa em Barueri | Coerção inteligente da alíquota cadastrada no projeto ou herança automática da alíquota do município |
| 241 | Valor dos Serviços Zerado ou Incompatível | Divergência no somatório dos itens em relação ao total do Registro 2 | Totalização estrita em ponto flutuante de alta precisão |
| 245 | Discriminação dos Serviços Obrigatória | Campo de descrição ausente, excessivamente curto ou com tags HTML inválidas | Higienização de strings preservando quebras de linha limpas |
⚡ Emitindo em Barueri com o Mesmo JSON do Padrão Nacional
Com a Notaas, sua aplicação ou sistema contábil não precisa construir geradores de Registro 2. Você envia o payload padrão em JSON e a plataforma traduz automaticamente para o protocolo de Barueri:
Chamada cURL Unificada:
curl -X POST https://platform.notaas.com.br/api/v1/emitir \
-H "Content-Type: application/json" \
-H "X-API-Key: sk_live_sua_chave" \
-d '{
"tipo": "nfse",
"ambiente": "producao",
"referencia": "saas_alphaville_891",
"prestador": {
"cnpj": "12345678000195",
"inscricaoMunicipal": "1234567"
},
"tomador": {
"cpfCnpj": "98765432000109",
"razaoSocial": "Cliente Corporativo S/A",
"email": "fiscal@corporativo.com.br",
"endereco": {
"logradouro": "Alameda Rio Negro",
"numero": "500",
"bairro": "Alphaville",
"codigoMunicipio": "3505708",
"uf": "SP",
"cep": "06454000"
}
},
"servico": {
"codigoTributacaoMunicipio": "010701",
"discriminacao": "Hospedagem em nuvem e suporte técnico especializado",
"valorServicos": 3200.00,
"aliquota": 2.0
}
}'
O Que Acontece nos Bastidores (notaas-platform v0.54.31):
- Montagem do Registro 2: Os dados são validados contra os schemas do webservice de Barueri.
- Assinatura e Envio: O lote é transmitido com o certificado digital ICP-Brasil A1 do cliente.
- Reconciliação e PDF Oficial: O retorno da prefeitura é interceptado, o número da nota e código de verificação são extraídos e a Notaas gera o PDF oficial de Barueri com QR Code canônico armazenado em CDN de alta disponibilidade.
Para conferir outros padrões municipais e comparativos de mercado, veja nosso Guia da API NFS-e Nacional.
❓ Perguntas Frequentes (FAQ)
1. Empresas do Simples Nacional sediadas em Barueri podem emitir via API?
Sim. A Notaas configura o regime tributário no cadastro do projeto e aplica as regras tributárias correspondentes do Simples Nacional para o município de Barueri.
2. Como cancelar uma NFS-e autorizada em Barueri?
Basta enviar uma requisição POST /api/v1/cancelar com o ID da invoice ou número da nota e o motivo do cancelamento. A plataforma aciona o método de cancelamento oficial da prefeitura e notifica seu webhook.
🚀 Comece a Integrar com a Notaas Hoje
Automatize a emissão de notas fiscais no seu SaaS, ERP ou plataforma com a API fiscal mais moderna e resiliente do mercado:
- Plano Gratuito: 50 notas fiscais/mês em produção sem cartão de crédito
- Sandbox Imediato: Ambiente de testes completo com webhooks e eventos em tempo real
- Multi-cidades e SEFAZ: Suporte ao padrão NFS-e Nacional, capitais e NF-e/NFC-e de mercadorias
👉 Criar Conta Gratuita na Notaas Platform (50 Notas/Mês)
👉 Acessar a Documentação Técnica Oficial