Este documento tem como objetivo orientar sobre as etapas e pré-requisitos necessários antes da importação de cadastros no sistema. Siga atentamente as instruções para garantir uma importação bem-sucedida.
Externo: Portal do Suporte — JIRA
Clientes > Empresas
Clientes > Instituições de Ensino
Clientes > Passageiros
Bilhetagem > Perfis
Bilhetagem > Políticas Tarifárias
Para iniciar o processo de importação:
Acesse o Portal de Suporte e preencha o formulário “Dúvidas BDOS”.
Anexe a planilha com os dados a serem importados.
Informe o tipo de cadastro (empresa, instituição de ensino, passageiro)
Se possível, inclua no ticket a orientação sobre o que deve ser feito com as linhas que apresentam erros nas informações — se devem ser excluídas ou se deseja que sejam corrigidas.
A primeira importação é realizada no ambiente de teste (homologação) para conferir se os dados importados estão corretos.
A importação no ambiente de produção é irreversível. Sempre valide os dados com atenção antes de realizar a importação final.
A importação geralmente segue esta ordem:
Empresas
Instituições de ensino
Passageiros
Isso garante que as entidades estejam disponíveis no sistema antes de vincular os passageiros a elas.
O cadastro dessas entidades é mais simples, mas deve ser feito antes da importação dos passageiros.
Informações de cadastro:
Nome da empresa/instituição
CNPJ
Telefone válido com DDD
E-mail válido (para acesso ao portal de compra)
CEP
Para instituições de ensino, é recomendável incluir também os dados de:
Horário:
Tipo: Manhã, tarde, noite ou integral
Horário oficial (ex: 06:00 - 12:00)
Ano letivo:
Data de início e fim do ano letivo.
Data de início e fim de férias.
Após o cadastro, um link de definição de senha é enviado ao e-mail informado. Esse acesso permitirá que o gestor compre créditos via portal.
⚠️ O campo de CNPJ é obrigatório, mas algumas instituições de ensino (municipais, principalmente) podem não ter CNPJ. Neste caso, sugerimos cadastrá-las com o CNPJ do próprio município.
Ao importar passageiros, é necessário avaliar os seguintes aspectos:
Os dados que são nativos do sistema são:
Dados do cadastro:
Saldo
Cartão vinculado (dispositivo)
Benefício que será concedido (perfil)
Dados para cadastro nas configurações de Bilhetagem > Perfis:
Informações básicas:
Nome completo
RG
CPF
Foto de documento de identidade com foto
Foto cadastral
Nome completo da mãe
Nome completo do pai
Foto documento da mãe
Foto documento do pai
Gênero — o sistema permite informar as opções de gênero
Etnia — o sistema permite informar as opções de etnia
Data de nascimento — o sistema permite informar a faixa etária
Informações de contato:
E-mail (também utilizado para acessar o Bipay)
Celular
Informações de endereço:
CEP
Comprovante de endereço
Informações de vínculo:
Empregador
Função do empregado
Data de admissão
Instituição de ensino
Autorização da autarquia de educação
Informações sociais:
Cartão do INSS
Cartão do SEDS
Informação de renda:
NIS — Número de Identificação Social
Informação de condição:
Gestação — o sistema permite informar as semanas
IMC — o sistema permite informar a taxa
Informações de saúde:
CID
Autorização da autarquia de saúde
💡 Dados adicionais devem ser enviados como documentos complementares.
Antes de continuar com o processo de importação, verifique se o cartão informado é compatível com o sistema. Leia mais aqui sobre cartões compatíveis.
⚠️ Solicitamos que envie para a ONBOARD uma amostra do cartão utilizado na operação antes de realizar a importação, para elaborarmos uma estratégia de portabilidade dos cartões para a operação.
Antes da importação, é necessário configurar as regras de benefícios nos módulos:
Bilhetagem → Perfis:
Concessão e expiração de créditos (se desejado que os passageiros recebam créditos automaticamente).
Solicitação de documentos.
Regras de perfis com acompanhantes.
Tipos de perfis com vínculo VT ou Estudante.
Bilhetagem → Política Tarifária
Políticas de desconto e embarque.
Veremos a seguir como proceder em cada caso.
⚠️ As regras precisam estar criadas antes da importação, por serem associadas diretamente ao perfil no momento do cadastro.
Acesse: Bilhetagem > Perfis
Neste módulo, serão definidos os documentos que serão vinculados aos cadastros, bem como regras de vínculo e benefícios.
Concessão de créditos
O sistema permite a concessão de saldo para os passageiros, tanto de maneira única como de maneira periódica.
Para isso, é importante definir:
Valor que será concedido;
Tempo: uma única vez ou a cada determinado período;
Regra de utilização: definir se o saldo só poderá ser utilizado na aplicação do perfil ou na utilização geral.
Passageiro comum ou sem vínculos específicos:
Não possui vínculos nem regras especiais.
Atentar-se unicamente com os documentos exigidos.
Passageiro com Acompanhante
Tipo de perfil: Comum
Deve ter vínculo com um perfil do tipo Acompanhante
Na importação, se houver passageiros que exigem acompanhante, é importante informar o nome e CPF do passageiro que será o acompanhante vinculado.
💡 Confira detalhadamente sobre o processo de cadastro de perfis com acompanhante aqui.
Estudante
Tipo de perfil: Estudante.
Ativar o vínculo com Instituição de Ensino no cadastro do perfil.
Na importação, vincular a uma instituição de ensino previamente cadastrada.
VT (Vale-Transporte)
Tipo de perfil: Vale-Transporte.
Ativar o vínculo com Empresa no cadastro do perfil.
Na importação, vincular a uma empresa previamente cadastrada.
Outros benefícios poderão ser cadastradas conforme as regras da operação. Sugerimos sempre conferir se os documentos solicitados no cadastro do perfil correspondem com estas regras ou normas.
Acesse: Bilhetagem > Política tarifária
Neste módulo, é importante definir descontos e regras de aplicação do benefício.
Confira os detalhes de cadastro da política aqui.
Sempre realize a primeira importação no ambiente de homologação para validação. Após a validação, os dados podem ser importados no ambiente de produção.
Lembre-se: a importação em produção não pode ser desfeita. Garanta que os dados estão corretos.