Antes de começar
Três coisas resolvem 90% do tempo de configuração. Se você tiver as três em mãos, o resto é preencher tela.
Checklist
- Os dados de conexão do TotalBUS — servidor, porta, nome do serviço (ou SID), usuário, senha e schema. Quem tem isso é o TI ou quem administra o Oracle. Há um pedido pronto para copiar.
- Um extrato recente de cada agência parceira (o PDF ou a planilha que ela manda com o repasse). É dele que saem a comissão, a base, a multa e as datas de corte — e é contra ele que você vai conferir o primeiro período.
- Quais pontos de venda do TotalBUS são de cada agência. Normalmente o nome já diz (QueroPassagem, Venda Web Whitelabel…). Se tiver dúvida, quem cadastrou os PDVs no TotalBUS sabe.
Nem todo ponto de venda "internet" é parceiro. Venda embarcada e canais próprios podem estar marcados como internet no TotalBUS e não entram em repasse nenhum. Por isso o vínculo agência → ponto de venda é escolhido à mão, no passo 3 — não é deduzido automaticamente.
Criar a conta
- Acesse app.repassecerto.com.br/cadastro e informe o nome da viação, o CNPJ, o seu nome e o seu e-mail.
- Abra o e-mail que chega em seguida e clique em Entrar. O link vale por 15 minutos e só funciona uma vez — se expirar, peça outro na tela de login.
- Você cai na tela Início, com os Primeiros passos. Ela mostra o que já está feito e o que falta, e é para lá que você volta sempre que parar no meio.
Os 14 dias grátis começam agora, sem cartão. Uma conta = uma viação (CNPJ). Grupos com mais de uma viação criam uma conta para cada, com o TotalBUS de cada uma.
Entrar depois: por link mágico (só o e-mail) ou por senha, se você cadastrar uma em Perfil.
Conectar ao TotalBUS
O Repasse Certo lê as vendas direto do banco Oracle do TotalBUS, pela rede, com um usuário somente leitura. Nada é instalado no servidor e nada é gravado lá. As credenciais ficam cifradas e nunca voltam ao navegador.
O que pedir ao TI
Este é o texto que a própria tela de conexão oferece no botão Copiar pedido para o TI. Pode mandar como está:
Pedido pronto
Os campos
| Campo | O que é | Exemplo |
|---|---|---|
| Servidor | Endereço (host ou IP) do Oracle do TotalBUS, alcançável pela internet ou por VPN. | oracle.viacao.com.br |
| Porta | Porta do listener. Quase sempre 1521. | 1521 |
| Nome do serviço ou SID | Como o banco se identifica. O TI sabe qual dos dois é. Na dúvida, tente o nome do serviço primeiro. | TOTALBUS.viacao.com.br ou ORCL |
| Usuário e senha | Conta Oracle criada para o Repasse Certo, só com SELECT. | leitura_repassecerto |
| Schema | O dono das tabelas do TotalBUS. Segue o padrão VTA_ + nome da viação. | VTA_VIACAO |
Testar e salvar
Clique em Testar e salvar. O sistema abre uma conexão, faz uma consulta mínima e só grava se deu certo. Se falhar, a mensagem já vem traduzida:
| Mensagem | Causa provável | O que fazer |
|---|---|---|
| Usuário ou senha incorretos | ORA-01017 | Confira com o TI. Senhas do Oracle diferenciam maiúsculas. |
| Conta bloqueada ou senha expirada | ORA-28000, ORA-28001 | Peça ao TI para desbloquear e, se possível, marcar a senha como sem expiração. |
| Serviço ou SID não encontrado | ORA-12514, ORA-12505 | O servidor respondeu, mas não conhece esse nome. Troque entre Nome do serviço e SID ou confirme o valor com o TI. |
| Servidor não alcançado | ORA-12541, ECONNREFUSED, ETIMEDOUT | Host/porta errados ou firewall fechado. O TI precisa liberar a porta para o Repasse Certo. |
| Tabela não encontrada | ORA-00942 | Schema errado ou o usuário não recebeu SELECT nas tabelas. Confira o VTA_… e as permissões. |
Segurança. A senha é cifrada (AES-256-GCM) antes de ir para o banco e nunca é exibida de novo — o campo aparece em branco e "mantida". Para trocar, preencha outra e teste de novo.
Cadastrar as agências parceiras
Cada agência é um assistente de 4 passos. Cada passo é salvo sozinho — pode parar e retomar, o Início mostra o que ficou incompleto. Uma agência só entra na conciliação quando está pronta: tem ponto de venda e prazo de pagamento.
3.1 Dados
Nome da agência (como ela aparece para você — Quero Passagem, DistriBusion…) e o percentual de comissão do contrato. Aceita vírgula: 8,5.
3.2 Pontos de venda
A lista vem do TotalBUS (por isso a conexão vem antes). Marque os pontos de venda de tipo internet que pertencem a esta agência. Um ponto de venda só pode pertencer a uma agência — senão a mesma venda entraria em dois repasses.
3.3 Regras de cálculo
Aqui é onde o extrato da agência manda. Cada parceiro faz de um jeito, e o Repasse Certo reproduz o jeito de cada um:
| Parâmetro | Pergunta que ele responde | Onde achar no extrato |
|---|---|---|
| Base da comissão | A comissão incide só sobre a tarifa, ou também sobre taxa de embarque, pedágio, seguro, outros? | Compare o "valor do bilhete" do extrato com a tarifa do TotalBUS. Se o do extrato é maior e redondo, a taxa de embarque está embutida. |
| Arredondamento | A comissão é calculada sobre o total do período ou bilhete a bilhete e depois somada? | Some as comissões linha a linha. Se bate com o total do extrato, é por bilhete; se o total é % × base, é no total. A diferença é de centavos — mas é ela que marca um repasse certo como divergente. |
| Multa de cancelamento | A agência retém um percentual da tarifa quando o passageiro cancela? | Linhas de cancelamento com um valor "retido" ou "multa". Percentual sobre a tarifa. |
| Comissão sobre a multa | Ela cobra a comissão em cima da multa também? | Se a comissão do extrato inclui as multas na base. |
| Carência | Cancelar até X horas depois da compra é grátis? | Contrato ou política de cancelamento da agência. Só preencha se existir — é uma consulta a mais. |
Três exemplos medidos contra extratos reais, para você se localizar:
- Comissão só sobre a tarifa
- Arredonda no total
- Sem multa
- Tarifa + taxa de embarque
- O "valor do bilhete" do extrato é a soma dos dois
- Multa de 5% da tarifa
- Comissão sobre a multa também
- Arredonda por bilhete
Os parâmetros ficam congelados em cada período conciliado. Se o contrato mudar, altere aqui: os períodos já fechados continuam mostrando o número de quando foram fechados.
3.3b Modelo do extrato (opcional)
Ainda em Dados, escolha o modelo do extrato que esta agência envia — Whitelabel/J3, ClickOferta, Quero Passagem, DistriBusion ou BusZap. Com o modelo, a conciliação passa a aceitar o upload da planilha do parceiro e confere bilhete a bilhete (passo 4). Sem modelo, tudo funciona igual; só não há o confronto.
3.4 Prazos de pagamento
Como a agência corta o mês e quando paga cada corte. Escolha um modelo e ajuste os dias:
| Modelo | Períodos | Pagamento |
|---|---|---|
| Decendial | 1–10 · 11–20 · 21–31 | dia 15 · dia 25 · dia 5 do mês seguinte |
| Quinzenal | 1–15 · 16–31 | dia 20 · dia 5 do mês seguinte |
| Mensal | 1–31 | um dia do mês seguinte |
- Os prazos precisam cobrir os dias 1 a 31 sem buraco nem sobreposição — a régua na tela fica verde quando está certo. Meses curtos se resolvem sozinhos: "21–31" vale até 28 em fevereiro.
- A data de pagamento que cai em fim de semana ou feriado nacional rola para o próximo dia útil. Feriados estaduais e municipais não entram.
- Prazos têm vigência por mês: se a agência mudar o corte, cadastre o novo "a partir de" tal mês. O histórico continua com o corte antigo.
Corte pelo relógio de Brasília. O extrato da agência corta o dia por Brasília, e o número a conciliar é o dela — mesmo que a sua operação esteja em outro fuso.
Conciliar o primeiro período
- Escolha a agência e o mês. Os períodos daquele mês aparecem na lateral com a situação: a conferir, vencido, conciliado.
- Abra um período. O valor esperado é apurado ao vivo no TotalBUS (leva alguns segundos): vendas brutas, o que a comissão alcança, cancelamentos do período, multas retidas e o total que a agência deve depositar. Remarcações aparecem à parte e não mexem no valor; cancelamentos por troca, transferência ou check-in ficam listados como "não entram nesta conta".
- Confira com o extrato da agência. Se a agência tem modelo de extrato (3.3b), clique em Enviar extrato no cartão "Extrato do parceiro" e escolha a planilha
.xlsxque o parceiro mandou para este período. O sistema casa cada linha com a apuração pelo número do bilhete e do BP-e e separa em quatro listas: valores diferentes (mesmo bilhete, tarifa/taxas/comissão/multa diferentes), só no extrato, só na apuração e conferidos — e diz quanto cada grupo explica da diferença. Sem modelo, confira o total e, se não bater, as linhas: o número de bilhete exibido no cancelamento é o do bilhete original, o mesmo do extrato. - Registre o depósito (valor e data). O sistema reapura antes de gravar — não confia no que estava na tela — e congela totais e lista de bilhetes.
- Bateu? O período fica conciliado e a equipe recebe o aviso por e-mail. Não bateu? O motivo é obrigatório e vai no e-mail — fica registrado quem apontou a diferença e por quê.
Cada período conciliado pode ser impresso ou exportado em CSV com os bilhetes, para anexar à cobrança.
Reabrir só o administrador faz, com motivo. O depósito digitado é preservado e os totais antigos ficam no histórico do período — nada se perde, tudo fica auditável.
Não bateu? O que conferir
Um primeiro período que não fecha quase sempre é cadastro, não conta errada. Se a agência tem modelo de extrato, envie a planilha do parceiro no período: o confronto bilhete a bilhete aponta direto os bilhetes que explicam a diferença. Com ou sem ele, o sintoma diz qual parâmetro olhar:
| Sintoma | Causa provável | Ajuste |
|---|---|---|
| Diferença de centavos, sempre para o mesmo lado | Arredondamento da comissão (no total × por bilhete) | 3.3 · Arredondamento |
| Comissão do extrato maior que a sua, na mesma proporção | A agência comissiona também a taxa de embarque (ou pedágio) | 3.3 · Base da comissão |
| Vendas brutas menores que o extrato | Falta um ponto de venda no vínculo da agência | 3.2 · Pontos de venda |
| Vendas brutas maiores que o extrato | Um ponto de venda que não é dessa agência (ou é venda própria) está vinculado | 3.2 · Pontos de venda |
| Bilhetes que estão num período no extrato e noutro no sistema | Dias de corte diferentes do que a agência usa | 3.4 · Prazos de pagamento |
| Cancelamentos batem em quantidade, mas o valor devolvido é menor no extrato | A agência retém multa e você não cadastrou | 3.3 · Multa e comissão sobre a multa |
| Alguns cancelamentos sem multa no extrato, outros com | Carência após a compra | 3.3 · Carência |
| Um cancelamento do extrato "não aparece" | O extrato desconta no mês do cancelamento, não no da venda — procure no período em que foi cancelado | Nada a ajustar: é a regra |
| Uma venda do TotalBUS não está no extrato | Bilhete com BP-e rejeitado pela SEFAZ não entra no repasse | Nada a ajustar: o sistema já exclui |
| O confronto lista quase tudo como "só no extrato" e "só na apuração" | Arquivo de outro período ou de outra agência (a tela avisa quando o período do resumo não bate) | Envie a planilha certa |
Depois de ajustar, volte ao período: enquanto ele está aberto, tudo é recalculado ao vivo. Se já tinha sido conciliado, reabra com motivo e concilie de novo.
Sobrou diferença que nenhuma linha explica? Mande o extrato e o período para [email protected]. Cada regra do cálculo foi medida contra extratos reais — se o seu parceiro faz algo que não está aqui, queremos saber.
Convidar a equipe
Entrada só por convite: informe o e-mail e o papel, e a pessoa recebe um link que vale por 7 dias. Usuários são ilimitados.
| Papel | Pode | Não pode |
|---|---|---|
| Operador | Conciliar, registrar depósito, imprimir e exportar | Reabrir períodos, mexer em agências, conexão ou usuários |
| Administrador | Tudo do operador + agências, conexão, usuários, reabertura e assinatura | — |
Desativar alguém vale na hora — a sessão aberta cai no próximo clique.
Lembretes por e-mail
Todo dia de manhã, um e-mail por viação para a equipe, com o que importa naquele dia: depósitos previstos (já com o valor esperado apurado), períodos vencidos sem conciliação e aviso prévio dos próximos. Nada a configurar.
- Avisos na hora quando alguém concilia (bateu ou divergente, com o motivo) ou reabre um período.
- Cada link do e-mail abre direto no período.
- Quem não quiser receber desliga no próprio Perfil — os outros continuam recebendo.
Assinatura e cancelamento
- 14 dias grátis a partir da criação da conta, sem cartão, com tudo liberado.
- Depois, R$ 349,00 por mês por viação, com impostos, tudo incluído: agências e usuários ilimitados, lembretes, exportação. Sem plano maior nem "enterprise".
- Cancele quando quiser, em Configurações, sem falar com ninguém. O acesso continua até o fim do período já pago; não há fidelidade nem multa.
- Os dados (períodos conciliados, histórico) ficam disponíveis para exportar até o fim do acesso.
Glossário
| Agência parceira | Quem vende a sua passagem pela internet e repassa o dinheiro depois (Buser, BlaBlaCar, Quero Passagem, DistriBusion, o seu site whitelabel…). |
| Ponto de venda | O cadastro no TotalBUS por onde a venda entra. Cada agência tem um ou mais. |
| Período de repasse | A fatia do mês que a agência fecha e paga junto (ex.: 1 a 10). |
| Valor esperado | Vendas brutas − comissão − cancelamentos do período (− multas retidas, se houver). O que a agência deve depositar. |
| Conciliar | Registrar o depósito e comparar com o valor esperado. Bateu = conciliado; não bateu = divergente, com motivo. |
| Modelo de extrato | O desenho da planilha que a agência manda com o repasse. Cadastrado na agência, permite enviar o arquivo e conferir bilhete a bilhete. |
| Snapshot | Os totais e a lista de bilhetes congelados no momento da conciliação, com os parâmetros usados. Um período fechado mostra o mesmo número para sempre. |
| Reabrir | Desfazer a conciliação (só administrador, com motivo) para conciliar de novo. O histórico fica. |
| Remarcação | Passagem trocada de data/horário. Não é venda nova nem cancelamento: efeito zero, listada à parte. |
| Multa de cancelamento | Parte da tarifa que a agência retém quando o passageiro cancela. É do contrato — não existe no TotalBUS. |
| Carência | Janela depois da compra em que cancelar é grátis (sem multa). |
| BP-e | O documento fiscal do bilhete. Rejeitado pela SEFAZ, o bilhete não é venda e fica fora do repasse. |
Pronto para o primeiro passo?
Crie a conta e siga este guia com o sistema aberto ao lado. Ele volta a ser útil quando o contrato de alguma agência mudar.