Como integrar catracas ao sistema de emissão de BP-e
Integrar catracas ao sistema de emissão de BP-e significa transformar eventos operacionais de embarque, validação, integração, gratuidade e pagamento em dados fiscais confiáveis, capazes de sustentar relatórios analíticos, totalizações, XML autorizado, protocolo e auditoria.
- Entenda como integrar catracas, validadores e bilhetagem ao sistema emissor de BP-e.
- Veja quais dados precisam ser capturados, tratados, classificados, conciliados e usados na emissão fiscal.
- Conheça como o Sistema Vexado pode apoiar BP-e, BP-e TM, integrações, APIs, relatórios, financeiro, automação e gestão operacional.
Integrar catracas ao sistema de emissão de BP-e é um processo técnico, fiscal e operacional. A catraca, o validador, o contador ou o sistema de bilhetagem não emitem o BP-e sozinhos. Eles geram eventos de acesso. O sistema precisa receber esses eventos, validar os dados, classificar os passageiros, separar tarifas e gratuidades, consolidar valores, gerar relatórios analíticos e, só então, formar a base fiscal do Bilhete de Passagem Eletrônico.
No transporte rodoviário tradicional, o BP-e normalmente nasce de uma passagem individual, com passageiro, origem, destino, horário, poltrona, valor e pagamento. Já em operações com catracas, como transporte metropolitano, semiurbano, metroviário ou ferroviário, a base fiscal pode nascer de milhares de eventos de embarque por dia. Por isso, a integração precisa ser confiável, auditável e preparada para alto volume.
O objetivo não é apenas “puxar o número da catraca”. O objetivo é criar uma trilha completa: catraca ou validador → estação, veículo, linha ou ciclo → tipo de passageiro → tarifa, gratuidade ou integração → valor fiscal → relatório analítico → totalização → XML autorizado do BP-e.
Precisa integrar catracas ao BP-e? Fale com o Vexado e veja como organizar emissão fiscal, APIs, bilhetagem, relatórios, totalizações, financeiro e gestão operacional.
Resumo rápido
Para integrar catracas ao sistema de emissão de BP-e, a empresa precisa criar uma camada de integração entre catracas, validadores, bilhetagem e sistema fiscal. Essa camada deve capturar eventos com identificador único, estação ou veículo, data e hora, tipo de passageiro, tarifa, gratuidade, integração, valor e status. Depois, o sistema deve validar, deduplicar, classificar, consolidar, gerar relatório analítico, conciliar com o financeiro e emitir o BP-e conforme o leiaute e a regra aplicável.
Captura dos eventos
Receber dados de catracas, validadores, contadores, APIs, arquivos ou sistema de bilhetagem.
Tratamento fiscal
Classificar passageiros, tarifas, gratuidades, integrações, valores e divergências.
Relatório analítico
Demonstrar a origem dos dados usados na totalização e no BP-e.
Emissão do BP-e
Gerar XML, assinar, transmitir, consultar autorização, armazenar protocolo e auditar.
Como integrar catracas ao sistema de emissão de BP-e?
Para integrar catracas ao sistema de emissão de BP-e, a empresa deve criar um fluxo técnico que receba os eventos das catracas e validadores, normalize os dados, vincule cada evento a uma estação, linha, veículo ou ciclo, classifique passageiros e tarifas, trate duplicidades, gere relatórios analíticos, consolide valores e envie a base validada para o módulo emissor de BP-e.
Resposta direta: a integração deve seguir este caminho: catraca/validador → captura do evento → API ou importação → validação → deduplicação → classificação fiscal → relatório analítico → totalização → emissão do XML → autorização do BP-e → armazenamento e auditoria.
O tema deve ser validado em fontes oficiais, como a Portaria CAT 102/2018, a Portaria SRE 33/2026, a Portaria CAT 96/2015, a página da SEFAZ-SP sobre BP-e Transporte Metropolitano, a página da SEFAZ-SP sobre o BP-e, as Perguntas Frequentes do BP-e e os documentos técnicos do BP-e.
O que significa integrar catraca ao BP-e?
Integrar catraca ao BP-e significa conectar o equipamento ou o sistema de bilhetagem ao sistema fiscal da empresa. A catraca registra o evento de acesso. O validador pode informar cartão, QR Code, benefício, integração ou gratuidade. A bilhetagem informa tarifa, categoria, produto tarifário e valor. O sistema emissor transforma esses dados em base fiscal.
Catraca
Registra giro, bloqueio, acesso, contador ou evento físico.
Validador
Registra cartão, QR Code, bilhete eletrônico, gratuidade, integração ou benefício.
Bilhetagem
Define tarifa, produto, categoria, regra de integração, valor e status do pagamento.
Emissor BP-e
Gera XML, assina digitalmente, transmite, consulta autorização e armazena o protocolo.
Ponto importante: a catraca não deve ser tratada como documento fiscal. Ela é fonte de dados. O documento fiscal continua sendo o BP-e autorizado.
Arquitetura recomendada da integração
A arquitetura ideal depende do fornecedor das catracas, do sistema de bilhetagem, da operação e do volume de dados. Mesmo assim, um fluxo seguro normalmente possui quatro camadas: captura, normalização, consolidação e emissão fiscal.
| Camada | Função | Resultado esperado |
|---|---|---|
| 1. Captura | Receber eventos de catracas, validadores, contadores, bilhetagem, APIs, arquivos ou filas. | Eventos brutos armazenados com segurança. |
| 2. Normalização | Padronizar campos, códigos, datas, estações, veículos, tarifas, categorias e status. | Dados consistentes para processamento. |
| 3. Consolidação | Classificar passageiros, deduplicar eventos, tratar divergências e formar totalizações. | Base operacional validada para o fiscal. |
| 4. Emissão fiscal | Gerar relatório analítico, montar XML, assinar, transmitir, consultar autorização e armazenar. | BP-e autorizado com lastro e auditoria. |
Em projetos mais robustos, pode haver também uma fila de processamento, banco intermediário, painel de divergências, API de reprocessamento, logs de importação, trilha de auditoria e conciliação financeira automática.
Dados mínimos que a catraca precisa enviar
O sistema precisa receber dados suficientes para que cada evento seja rastreável. Quando a catraca não possuir todos os dados, a integração deve complementar as informações com o validador, o sistema de bilhetagem, o cadastro de estações, o cadastro de veículos ou o cadastro de linhas.
| Grupo | Dados recomendados | Por que importa |
|---|---|---|
| Evento | ID único, data, hora, lote, origem, sequência, status e tipo do evento. | Permite rastreabilidade, deduplicação e auditoria. |
| Dispositivo | Código da catraca, validador, bloqueio, contador ou sistema equivalente. | Mostra qual equipamento registrou o acesso. |
| Local | Estação, ponto, terminal, veículo, linha, sentido ou ciclo de viagem. | Define a referência operacional e fiscal. |
| Passageiro | Exclusivo, integrado, gratuito, estudante, idoso, beneficiário ou categoria especial. | Evita misturar passageiros com tratamentos fiscais diferentes. |
| Tarifa | Tarifa comum, integrada, desconto, bilhete, cartão, QR Code ou produto tarifário. | Explica como o valor foi formado. |
| Valor | Valor cobrado, valor reconhecido, remuneração, ajuste, valor contábil e base fiscal. | Conecta operação, financeiro e BP-e. |
| Auditoria | Usuário, sistema de origem, hash, arquivo de origem, data de importação e logs. | Ajuda a comprovar a origem e integridade do dado. |
Boa prática: nunca depender apenas de um contador final. O ideal é ter evento individual ou lote detalhado, com chave única, data, hora, equipamento, estação ou veículo, categoria e valor.
API, arquivos ou banco intermediário: qual forma de integração usar?
A integração pode ser feita por API, arquivos, banco intermediário, fila de mensagens ou conector específico do fornecedor. A melhor escolha depende da infraestrutura da empresa e do nível de maturidade do sistema de bilhetagem.
| Modelo de integração | Quando usar | Cuidados |
|---|---|---|
| API em tempo quase real | Quando o fornecedor permite envio ou consulta de eventos por endpoint. | Usar autenticação, logs, idempotência, retry e controle de falhas. |
| Arquivo por lote | Quando a bilhetagem exporta CSV, TXT, XML, JSON ou outro formato em períodos definidos. | Controlar layout, hash, lote, reprocessamento, data de geração e versão. |
| Banco intermediário | Quando o sistema de origem grava eventos em uma base compartilhada ou replicada. | Evitar alteração sem log e controlar leitura incremental. |
| Fila de mensagens | Quando há alto volume e necessidade de processamento assíncrono. | Garantir ordenação, confirmação, reprocessamento e prevenção de duplicidade. |
| Conector do fornecedor | Quando o fornecedor possui SDK, Webhook, serviço Windows, agente local ou integração proprietária. | Documentar dependências, versão, credenciais, logs e SLA. |
Em operações críticas, o ideal é separar a integração do emissor fiscal. Primeiro o sistema recebe e valida os eventos. Depois consolida. Só então envia a base validada para emissão do BP-e.
Normalização e padronização dos dados
Depois de capturar os eventos, o sistema precisa normalizar os dados. Isso evita que a mesma estação, catraca, tarifa ou categoria apareça de formas diferentes nos relatórios e na emissão fiscal.
Estações e pontos
Padronizar código, nome, município, endereço, tipo, estação de embarque e integração.
Dispositivos
Padronizar código da catraca, bloqueio, contador, validador e equipamento vinculado.
Datas e horários
Tratar fuso horário, data do evento, data de processamento, lote e competência.
Tarifas
Padronizar tarifa comum, integrada, benefício, gratuidade, desconto e produto tarifário.
Passageiros
Classificar pagante, integrado, gratuito, estudante, idoso e demais categorias.
Status
Separar evento válido, inválido, duplicado, offline, cancelado, ajustado ou reprocessado.
Exemplo prático: se uma estação aparece como “Sé”, “SE”, “Estação Sé” e “Metro Se”, o relatório fiscal pode quebrar. O sistema precisa mapear todas as variações para um cadastro oficial único.
Deduplicação e idempotência
Um dos pontos mais importantes da integração é impedir que o mesmo evento seja contado duas vezes. Catracas e validadores podem reenviar eventos, arquivos podem ser reprocessados e APIs podem repetir chamadas em caso de instabilidade.
| Controle | Como aplicar | Benefício |
|---|---|---|
| ID único do evento | Cada giro, validação ou acesso deve possuir chave única. | Evita duplicidade em reenvios. |
| Hash do lote | Gerar hash do arquivo ou lote importado. | Identifica importações repetidas. |
| Controle de sequência | Usar sequência por equipamento, data ou lote. | Ajuda a detectar falhas, saltos ou repetições. |
| Idempotência na API | Permitir que a mesma requisição seja recebida sem duplicar registro. | Protege contra tentativas repetidas. |
| Painel de divergências | Separar eventos suspeitos antes da totalização. | Impede erro fiscal antes da emissão. |
Ponto crítico: integração fiscal sem idempotência é perigosa. Uma instabilidade simples pode duplicar passageiros, receita e base de cálculo.
Classificação fiscal dos eventos
Nem todo evento de catraca deve entrar do mesmo jeito na base do BP-e. O sistema precisa classificar o evento antes de totalizar.
| Tipo de evento | Tratamento recomendado | Risco se classificar errado |
|---|---|---|
| Passageiro pagante | Registrar tarifa, valor, estação/veículo, dispositivo e período. | Receita fiscal incorreta. |
| Passageiro integrado | Separar da tarifa comum e vincular à regra de integração. | Duplicidade de passageiro ou receita. |
| Passageiro gratuito | Classificar benefício e separar de pagantes. | Inflar receita ou distorcer relatório. |
| Evento inválido | Enviar para divergência ou descarte justificado. | Entrar dado sem validade na base fiscal. |
| Evento offline | Registrar data real do evento e data de sincronização. | Competência incorreta. |
| Evento reprocessado | Manter vínculo com evento original e motivo do reprocessamento. | Alteração sem auditoria. |
Relatório analítico e totalizações
Depois que os eventos são capturados, normalizados e classificados, o sistema precisa gerar relatórios analíticos e totalizações. Esse relatório é o lastro que explica como os dados da catraca viraram base fiscal.
Relatório por estação
Mostra passageiros, tarifas, gratuidades, integrações, dispositivos, valores e divergências por estação.
Relatório por veículo
Mostra passageiros e valores por veículo, linha, sentido e ciclo de viagens, quando aplicável.
Relatório diário
Fecha os dados por dia para evitar acúmulo de divergências no fim do período.
Totalização mensal
Consolida o mês de referência quando a regra permitir e quando não for possível emitir por ciclo.
Relatório fiscal
Relaciona totalizações com XMLs, protocolos, autorizações, rejeições e cancelamentos.
Relatório de divergências
Lista duplicidades, eventos inválidos, offline, sem tarifa, sem estação, sem veículo ou sem classificação.
Trilha ideal: BP-e autorizado → totalização → relatório analítico → evento de catraca → dispositivo → estação/veículo → passageiro → tarifa → valor → financeiro.
Geração do XML e autorização do BP-e
A integração com catracas prepara a base fiscal, mas a emissão do BP-e continua exigindo geração de XML conforme leiaute, assinatura digital, transmissão ao ambiente autorizador, consulta de status, tratamento de rejeição, armazenamento e protocolo.
| Etapa fiscal | O que o sistema precisa fazer | Cuidado |
|---|---|---|
| Pré-validação | Conferir se totalização, estação, veículo, tarifa, valores e competência estão corretos. | Evitar rejeição ou emissão inconsistente. |
| Geração do XML | Montar o documento conforme leiaute aplicável ao BP-e ou BP-e TM. | Usar versão correta do manual, schema e regras de validação. |
| Assinatura digital | Assinar o XML com certificado digital válido do emitente. | Controlar validade, CNPJ e configuração do certificado. |
| Transmissão | Enviar o XML ao ambiente autorizador. | Controlar contingência, retorno, timeout e tentativas. |
| Autorização | Consultar autorização, rejeição ou pendência. | Armazenar protocolo e status final. |
| Armazenamento | Guardar XML, protocolo, relatório, logs e evidências. | Garantir rastreabilidade para auditoria e fiscalização. |
Conciliação financeira
Integrar catracas ao BP-e também exige conciliação financeira. O valor totalizado para emissão precisa conversar com bilhetagem, arrecadação, gratuidades, integrações, repasses, ajustes, caixa, contas a receber e relatórios contábeis.
Receita por período
Consolida valores por dia, mês, estação, linha, veículo, tarifa ou categoria.
Gratuidades
Separa passageiros gratuitos dos passageiros pagantes.
Integrações
Evita duplicidade de passageiro ou receita em conexões tarifárias.
Ajustes
Controla correções, reprocessamentos, compensações, eventos offline e divergências.
Valor contábil
Conecta operação, relatório analítico, totalização, documento fiscal e financeiro.
Auditoria financeira
Permite rastrear valores do BP-e até eventos originais e regras de remuneração.
Segurança, logs e auditoria
Como a integração alimenta documento fiscal, o controle de segurança é essencial. O sistema precisa registrar quem importou, quando importou, de qual origem veio o dado, qual lote foi processado, quais eventos foram aceitos, quais foram rejeitados e quais totalizações geraram BP-e.
| Controle de segurança | Como aplicar | Benefício |
|---|---|---|
| Autenticação | Usar token, chave de API, certificado, VPN ou credenciais controladas. | Impede envio indevido de dados. |
| Permissões | Separar usuários de integração, fiscal, financeiro, auditoria e administração. | Evita alteração indevida na base fiscal. |
| Logs imutáveis | Registrar importação, alteração, reprocessamento, fechamento e emissão. | Garante rastreabilidade. |
| Controle de fechamento | Bloquear alteração silenciosa após fechamento diário ou mensal. | Protege a integridade da totalização. |
| Backup | Guardar eventos, relatórios, XMLs, protocolos e evidências. | Evita perda de base fiscal. |
Funcionalidades necessárias no sistema
Um sistema para integrar catracas ao BP-e precisa reunir recursos fiscais, operacionais, técnicos e financeiros. A emissão do XML é apenas uma etapa. O mais importante é controlar a origem dos dados que sustentam a emissão.
| Funcionalidade | O que precisa fazer | Benefício |
|---|---|---|
| Cadastro de dispositivos | Controlar catracas, validadores, contadores, bloqueios e sistemas equivalentes. | Permite rastrear cada evento até o equipamento. |
| Cadastro de estações, veículos ou linhas | Vincular eventos à estação, veículo, linha, sentido, ciclo ou ponto correto. | Evita totalização em referência errada. |
| API de integração | Receber eventos por API, arquivo, banco intermediário, fila ou conector. | Automatiza a coleta de dados. |
| Validação de eventos | Checar campos obrigatórios, formato, data, status, tarifa, dispositivo e vínculo. | Impede que dados ruins entrem no fiscal. |
| Deduplicação | Usar ID único, hash, lote, sequência e regra de idempotência. | Evita duplicidade de passageiros e valores. |
| Classificação tarifária | Separar pagante, integrado, gratuito, benefício, desconto e tarifa comum. | Gera relatório fiscal correto. |
| Relatório analítico | Demonstrar estação, dispositivo, passageiros, tarifas, valores, gratuidades e ajustes. | Sustenta a emissão do BP-e. |
| Totalização | Consolidar dados por estação, veículo, ciclo, dia, mês ou regra aplicável. | Prepara base para o XML. |
| Emissão de BP-e | Gerar XML, assinar, transmitir, consultar autorização, tratar rejeições e armazenar. | Completa o fluxo fiscal. |
| Conciliação financeira | Comparar bilhetagem, catracas, relatórios, valores e BP-e autorizados. | Evita divergência entre operação, fiscal e financeiro. |
Como o Sistema Vexado pode ajudar
O Sistema Vexado pode apoiar empresas que precisam estruturar emissão de BP-e, integração de dados, APIs, automação de processos, relatórios, financeiro e gestão operacional. Em projetos com catracas, o principal desafio é transformar eventos operacionais em base fiscal confiável e auditável.
Emissão de BP-e
A solução de emissão de BP-e apoia empresas que precisam organizar documentos fiscais eletrônicos de transporte de passageiros.
BP-e metropolitano
A página de BP-e para transporte metropolitano apoia operações com catracas, validadores, estações e totalizações.
BP-e semiurbano
A página de BP-e para transporte semiurbano ajuda a posicionar operações com linhas, catracas e cobrança por sistemas equivalentes.
BP-e metroviário
A página de BP-e para transporte metroviário apoia operações com estações, integração e bilhetagem.
Integrações e APIs
As integrações e APIs podem conectar catracas, validadores, bilhetagem, estações, veículos, financeiro, fiscal e sistemas externos.
Automação de processos
A automação de processos ajuda a reduzir retrabalho entre operação, fiscal, financeiro e relatórios.
Sistema web nacional: o Vexado é uma solução web para empresas de transporte e pode apoiar operações em diferentes estados brasileiros, conforme implantação, suporte, configuração fiscal, integrações necessárias e estrutura digital da empresa.
Erros comuns na integração de catracas com BP-e
Os erros mais comuns são integrar apenas o total da catraca, não guardar evento individual, não usar identificador único, duplicar eventos, misturar pagantes com gratuitos, não separar integração, não padronizar estações, deixar catraca sem vínculo, emitir XML sem relatório e não conciliar valores com o financeiro.
Usar só contador final
O total sozinho não explica passageiro, tarifa, integração, gratuidade, valor e origem do dado.
Não ter ID único
Sem chave única, reprocessamentos podem duplicar eventos.
Não tratar offline
Eventos sincronizados depois podem cair em competência errada.
Não separar integração
Integrações podem duplicar passageiros e receita se forem tratadas como embarque comum.
Não gerar relatório
Sem relatório analítico, o BP-e fica sem lastro operacional.
Emitir sem conciliar
Fiscal, bilhetagem e financeiro precisam fechar antes da emissão.
Para aprofundar, veja também os conteúdos sobre BP-e e catracas de metrô, BP-e e integração entre estações e como transformar dados de catracas em BP-e modelo 63.
Checklist prático para integrar catracas ao BP-e
O checklist abaixo ajuda a empresa a avaliar se a integração está preparada para sustentar emissão de BP-e com segurança.
- Confirmar a unidade federada competente pela emissão.
- Validar se a operação exige BP-e, BP-e TM, totalização mensal, ciclo de viagens, estação de embarque ou outro critério.
- Identificar todos os fornecedores de catracas, validadores, bilhetagem e sistemas equivalentes.
- Definir se a integração será por API, arquivo, banco intermediário, fila ou conector.
- Padronizar o layout dos eventos recebidos.
- Criar identificador único para cada evento de catraca ou validação.
- Controlar data real do evento, data de importação, lote e origem do dado.
- Vincular cada evento à estação, veículo, linha, sentido, ciclo ou referência fiscal correta.
- Separar passageiro pagante, integrado, gratuito, estudante, idoso, benefício e demais categorias.
- Mapear tarifas, produtos tarifários, cartões, QR Codes, bilhetes, gratuidades e integrações.
- Controlar valor recebido, remuneração, ajuste, valor contábil, base de cálculo e imposto quando devido.
- Deduplicar eventos antes da totalização.
- Tratar eventos inválidos, offline, sem tarifa, sem estação, sem veículo ou sem classificação.
- Gerar relatório analítico diário com lastro dos eventos.
- Consolidar totalizações por estação, veículo, ciclo, dia ou mês conforme a regra aplicável.
- Conciliar bilhetagem, catracas, relatórios, financeiro e documentos fiscais.
- Gerar XML do BP-e conforme leiaute, MOC, schemas e notas técnicas aplicáveis.
- Assinar digitalmente, transmitir, consultar autorização e tratar rejeições.
- Armazenar XML, protocolo, relatórios, eventos originais, logs e evidências.
- Validar todo o fluxo com contador, responsável fiscal, SEFAZ, jurídico, operação, fornecedor de bilhetagem e equipe técnica.
Precisa transformar esse checklist em projeto? Fale com o Vexado e veja como integrar catracas, bilhetagem, BP-e, relatórios e financeiro.
Fontes oficiais para validar integração de catracas ao BP-e
Como integração de catracas ao BP-e envolve obrigação fiscal, a empresa deve validar regras em fontes oficiais e com profissionais responsáveis. O sistema apoia a operação e a emissão, mas não substitui contador, responsável fiscal, SEFAZ, equipe jurídica, órgão regulador, fornecedor de bilhetagem ou equipe técnica.
Portaria CAT 102/2018
Consulte regras sobre BP-e, BP-e TM, catracas, contadores, sistemas equivalentes, ciclos e totalizações: Portaria CAT 102/2018.
Portaria SRE 33/2026
Consulte a norma que atualizou regras do BP-e em São Paulo: Portaria SRE 33/2026.
Portaria CAT 96/2015
Consulte procedimentos para transporte metroviário e ferroviário de passageiros: Portaria CAT 96/2015.
BP-e Transporte Metropolitano
Consulte a página oficial da SEFAZ-SP sobre BP-e TM: SEFAZ-SP BP-e TM.
Sobre o BP-e
Consulte a definição oficial do BP-e modelo 63: SEFAZ-SP Sobre o BP-e.
Documentos BP-e
Consulte manuais, schemas, notas técnicas e documentos do BP-e: Documentos BP-e SVRS.
Atendimento web para empresas de transporte em todo o Brasil
O Vexado é uma solução web para empresas de transporte e pode apoiar operações de emissão fiscal, BP-e, BP-e TM, bilhetagem, financeiro, integrações, relatórios e gestão operacional em diferentes estados brasileiros, conforme implantação, suporte, configuração fiscal, integrações necessárias e estrutura digital da empresa.
A solução pode atender empresas que atuam no Acre, Alagoas, Amapá, Amazonas, Bahia, Ceará, Distrito Federal, Espírito Santo, Goiás, Maranhão, Mato Grosso, Mato Grosso do Sul, Minas Gerais, Pará, Paraíba, Paraná, Pernambuco, Piauí, Rio de Janeiro, Rio Grande do Norte, Rio Grande do Sul, Rondônia, Roraima, Santa Catarina, São Paulo, Sergipe e Tocantins.
FAQ completo sobre integração de catracas ao BP-e
Como integrar catracas ao sistema de emissão de BP-e?
A integração deve capturar eventos de catracas e validadores, normalizar dados, vincular estação, veículo ou linha, classificar passageiros e tarifas, tratar duplicidades, gerar relatório analítico, consolidar valores e enviar a base validada para emissão do BP-e.
A catraca emite o BP-e?
Não. A catraca registra eventos operacionais. O sistema emissor é responsável por gerar XML, assinar, transmitir, consultar autorização, armazenar protocolo e manter relatórios de suporte.
Qual a melhor forma de integração: API ou arquivo?
Depende do fornecedor e da operação. API é melhor para integração automatizada e recorrente. Arquivo por lote pode funcionar quando o fornecedor não oferece API, desde que haja controle de layout, hash, lote, duplicidade e logs.
Quais dados a catraca precisa enviar?
O ideal é enviar identificador único do evento, data, hora, dispositivo, estação ou veículo, tipo de passageiro, tarifa, gratuidade, integração, valor, status e origem do dado.
Como evitar duplicidade de passageiros?
Usando identificador único por evento, hash de lote, controle de sequência, idempotência na API, logs de importação e painel de divergências antes da totalização.
Precisa guardar os eventos originais?
Sim. Os eventos originais, relatórios, logs, XMLs e protocolos são importantes para auditoria e comprovação da base fiscal.
O relatório analítico é necessário?
Sim. Ele demonstra como os dados de catracas, validadores e bilhetagem foram transformados em totalização e BP-e.
Como tratar gratuidade e integração?
Gratuidades e integrações devem ser classificadas separadamente para evitar distorção de receita, passageiro, valor contábil e base fiscal.
O sistema precisa conciliar com o financeiro?
Sim. O valor usado no BP-e deve conversar com bilhetagem, arrecadação, gratuidades, integrações, repasses, ajustes e relatórios financeiros.
O Vexado pode ajudar com integração de catracas?
O Vexado pode apoiar projetos com emissão de BP-e, BP-e TM, integrações, APIs, automações, relatórios, financeiro e gestão operacional, conforme análise técnica e fiscal.
Empresas fora de São Paulo seguem a mesma regra?
Empresas fora de São Paulo devem validar as regras com a SEFAZ da própria unidade federada, pois credenciamento, prazos, ambiente, leiaute e procedimentos podem variar.
O sistema substitui o contador?
Não. O sistema apoia a operação e a emissão, mas decisões fiscais, enquadramento, prazos e obrigatoriedade devem ser validadas com contador, responsável fiscal e SEFAZ.
Quer integrar catracas ao sistema de BP-e? Fale com o Vexado e veja como organizar APIs, bilhetagem, emissão fiscal, relatórios, totalizações e financeiro.
Conclusão
Integrar catracas ao sistema de emissão de BP-e exige muito mais do que buscar um contador de passageiros. A empresa precisa criar uma integração capaz de capturar eventos, validar dados, deduplicar registros, classificar passageiros, separar tarifas, gratuidades e integrações, consolidar valores, gerar relatórios analíticos e emitir o BP-e com XML autorizado e protocolo.
O ponto mais importante é garantir rastreabilidade. Todo número usado no BP-e precisa ser explicado por uma trilha clara: evento original, dispositivo, estação ou veículo, categoria tarifária, valor, totalização, relatório e XML autorizado.
O Sistema Vexado pode apoiar empresas que precisam estruturar emissão de BP-e, BP-e TM, integrações, APIs, relatórios, automação, financeiro e gestão operacional. Como esse tema envolve obrigação fiscal sensível e integração técnica, qualquer implantação deve ser validada com contador, SEFAZ, equipe jurídica, fornecedor de bilhetagem, equipe técnica e responsáveis regulatórios.
Quer estruturar essa integração com mais segurança? Conheça o Vexado e veja como uma solução web pode apoiar catracas, bilhetagem, emissão fiscal, relatórios e gestão.
Aviso: Este conteúdo é educativo e comercial. Para temas fiscais, regulatórios, contratuais, técnicos, credenciamento, certificado digital, integração de catracas, BP-e, BP-e modelo 63, BP-e TM, catracas, validadores, bilhetagem, estação de embarque, estação de integração, ciclo de viagens, totalizações, relatório analítico, valor contábil, base de cálculo, ICMS, rejeições, cancelamentos, contingência, emissão de documentos, APIs, pagamentos ou obrigações específicas, a empresa deve validar as regras aplicáveis com seu contador, responsável fiscal, SEFAZ, órgão competente, equipe jurídica, fornecedor de bilhetagem, equipe técnica ou profissionais especializados antes de tomar decisões.
