Robo GIT
Índice
- 1 Visão Geral
- 2 Credenciamento do Cliente
- 3 Procedimentos
- 3.1 Roteiro Padrão de Implantação
- 3.2 Modelos de Divulgação
- 3.3 Revisão do Cadastro de Síndicos
- 3.4 Configuração do Robô
- 3.5 Gerando Promocodes (Robô/API Partiu)
- 3.6 Gerando Arquivo Bureaux de Síndicos
- 3.7 Gerando Arquivo Bureaux de Condôminos
- 3.8 Gerando Arquivo Bureaux de Locatários
- 3.9 Gerando Arquivo Bureaux de Locadores
- 3.10 Verificar Promocodes Ativados
- 3.11 Lançamento de Opcionais
- 3.12 Controles Adicionais
Visão Geral
Essa documentação se refere à procedimentos internos da Base Software, está em construção e poderá sofrer ajustes até a liberação final. |
O Partiu Vantagens consiste na disponibilização do acesso ao serviço do Clube de Vantagens Partiu para as entidades (clientes, fornecedores, funcionários, etc.) das administradoras, oferecendo descontos em vários estabelecimentos comerciais credenciados pela empresa. O acesso dos clientes é feito através do Aplicativo Partiu, disponível para Androide e IOS. O cliente deverá se cadastrar utilizando chaves de acesso (Promocodes) que serão atribuídas pelo sistema em conjunto com a API do Clube de Vantagens Partiu.
O Promocode consiste numa sequência de 8 a 10 caracteres alfanuméricos com combinação única, ou seja, nunca se repete. O sistema permite a geração de até 4 Promocodes por entidade, porém o padrão é 2. |
Com relação aos Promocodes, temos dois tipos distintos quanto a renovação da utilização:
- Gratuidade - Renovado automaticamente pelo sistema, sem a necessidade de assinatura. Pode ser oferecido estrategicamente à alguns tipos de entidade, por exemplo aos síndicos como forma de divulgar o serviço nos condomínios.
- Assinatura - Renovação condicionada ao pagamento do serviço (opcional cobrado no recibo do condômino ou locatário).
Existe uma distinção entre a validade para renovação dos Promocodes e a sua ativação no Aplicativo Partiu. Depois de gerado, o Promocode tem um prazo para ser ativado no aplicativo (a princípio 5 anos), depois de ativado tem 60 dias de utilização e é renovado por mais 60 dias pelo sistema levando em consideração as regras de gratuidade e assinatura citadas acima. Então no caso de gratuidade, tomando como exemplo o síndico, ele terá 5 anos para ativa-lo e depois de ativado 60 dias de utilização. Situação semelhante poderá ocorrer no caso de outra entidade, tomando como exemplo o condômino, mesmo sendo assinatura ele receberá os Promocodes de acesso com validade de 5 anos para ativá-los e 60 dias de utilização independente do pagamento. Contundo, a renovação do prazo de utilização estará condicionado ao pagamento (opcional do recibo). |
Credenciamento do Cliente
Antes da implantação do serviço o cliente deverá ser credenciado junto ao Clube de Vantagens Partiu.
Esse processo consiste em enviar as informações descritas abaixo:
- Nome Fantasia
- Razão Social
- Telefone
- CNPJ
- Nome do Usuário Responsável
- CPF do Usuário Responsável
- Telefone do Usuário Responsável
- Email do Responsável
- Logo (vetorizada, se possível)
- 3 Cores Principais de Identidade Visual da Administradora
Depois que o credenciamento for efetivado a Base receberá as informações referentes aos respectivos Token e Enterprise_id do cliente. Essas informações particulares garantem que o cliente da administradora irá utilizar o aplicativo deixando claro o seu tipo vinculo, pois, o aplicativo exibirá a identificação visual da administradora ao logar.
O credenciamento será feito e repassado para a Base exclusivamente pelo pessoal da Partiu. Tanto o Token quanto o Enterprise_id pessoal da administradora é de suma importância para a continuidade do processo. |
Procedimentos
Roteiro Padrão de Implantação
O roteiro padrão consiste em:
- Base Condomínio - Gerar os Promocodes (tipo gratuidade para os síndicos e tipo assinatura para os condôminos) e transmiti-los ao respectivo bureaux.
- Base Locação - Gerar os Promocodes tipo assinatura para os locatários e transmiti-los ao respectivo bureaux.
No caso do Sistema Base Locação também é possível gerar Promocodes para proprietários. Não existe nenhum controle automático de cobrança para Promocodes do tipo assinatura. A única forma de cobrança será através das Aba Serviços do Contrato de Administração. |
Contudo, existem particularidades com relação ao lançamento do serviço do tipo assinatura (opcional cobrado no recibo):
- No primeiro mês o Promocode será oferecido como cortesia, ou seja, não haverá a cobrança do item no recibo.
- Com isso, existe a necessidade da geração de um arquivo CSV separado que deverá ser mesclado ao arquivo de recibos afim de gerar um layout diferenciado em A3 para os condôminos e locatários (no caso do Sistema Base Locação). A tarefa de mesclagem do arquivo CSV com o arquivo de recibos é de responsabilidade do bureaux.
- A partir do mês seguinte, será realizada a cobrança independente da ativação e, havendo o item no recibo, o sistema exibirá os Promocodes no campo complemento do respectivo item.
Modelos de Divulgação
A divulgação é feita através de encartes promocionais com formato e layout especial desenvolvido junto ao bureaux.
Modelo de divulgação junto aos síndicos:
Esse modelo leva em consideração o lançamento do serviço do tipo gratuidade para os síndicos. |
Modelo de divulgação junto aos moradores:
Esse modelo contempla somente o lançamento do serviço tipo assinatura para os condôminos, quando será enviado o código promocional junto ao recibo sem a cobrança do item opcional. A partir do mês subsequente a cobrança será incorporada ao recibo sem a necessidade de gerar o layout diferenciado. Ainda não existe Layout para implantação para o Sistema Base Locação, o mesmo deverá ser desenvolvido pela Partiu em conjunto com a administradora. A adoção desse modelo deverá ser negociada junto ao respectivo bureaux de impressão. Atualmente temos o serviço implantado com as empresas Equipress (Telefone 21 2516-2556 Contato Ricardo), Officer Laser (Telefone 21 2253-2984 Contato Antônio Carlos) e Printer Data (Telefone 21 31735935 Contato Heloisa). |
Revisão do Cadastro de Síndicos
Quando adotado o roteiro padrão para a implantação do serviço incluindo o lançamento de gratuidade para os síndicos, é imprescindível que o cliente faça a revisão do cadastro dos síndicos afim de garantir que nenhum síndico fique de fora. Outro fator importante é que, por padrão o sistema NÃO GERA PromocodeS PARA ENTIDADES PESSOA JURÍDICA E NEM PARA SÍNDICOS COM MANDATO VENCIDO. |
Os procedimentos são:
- Verificar se todos os mandatos estão cadastrados e com o seu respectivo prazo em conformidade com a data corrente (data de termino do mandato).
- Verificar se todos os mandatos estão com os síndicos apontados corretamente.
Erros mais comuns:
- Cadastro de síndico sem data de início do mandato.
- Cadastro de síndico com data de termino do mandato expirada (maior que a data atual).
- Cadastro de síndico sem identificação de unidade e profissional externo.
- Cadastro de síndico que não seja o condômino (ex. pessoa de relação pessoal do condômino) sem a identificação do profissional externo.
Como o sistema não gera Promocodes para entidades pessoa jurídica, o ideal é que o responsável pela empresa seja cadastrado como profissional externo e indicado no cadastro do síndico. O mesmo procedimento deverá ser adotado para condomínio cujo o síndico seja uma entidade diferente da entidade apontada na unidade (Ex. Esposa do condômino). |
A procedure PROC_CLUBE_VANTAGENS_SINDICO pode auxiliar no processo de verificação, pois, quando executada com o parâmetro '00000000000000000000 0000000000S' faz uma verificação do cadastro dos síndicos e exibe uma listagem com possíveis irregularidades.
Ex. SELECT * FROM PROC_CLUBE_VANTAGENS_SINDICO('00000000000000000000 0000000000S')
Configuração do Robô
O Robô é o programa responsável pela solicitação dos Promocodes via Webservice junto ao servidor da Partiu e atualização dessas informações de acordo com cada entidade no banco de dados do sistema.
Além de solicitar novos Promocodes ele também consulta informações sobre Promocodes ativados pelos clientes, da mesma forma atualizando o banco de dados.
A instalação deverá ser feita através do download do programa Instalacao_Partiu.exe disponível no Base Ágil ou link direto em Instalação Partiu.
A instalação do Robô Partiu deverá ser feita no mesmo equipamento que executa outras rotinas automáticas de atualização do sistema (Ex. Base Filtro, Robô CRM, etc.) e que deverá ter a capacidade de agendamento para execução automática. O programa de instalação poderá ser utilizado também para atualização de versão, pois, conserva os arquivos de configuração dos clientes. |
Antes de configurar o robô é necessário que se faça a atualização do banco de dados com as tabelas, procedures e triggers necessárias para o seu funcionamento. Dentro da pasta de instalação será criada a pasta FSQL onde poderá ser encontrado o comando Atualizar_DB.bat, esse comando deverá ser executado via prompt e se encarregará de realizar as respectivas atualizações.
Esse procedimento será necessário somente no momento da instalação, pois, o processo de atualização de versão do banco de dados pelo Base Utilitários se encarregará de fazer as atualizações caso seja necessário. |
O Robô tem a estrutura de configuração (através do arquivo config.inc.php) e execução semelhante ao Robô do Base CRM, porém, antes desse processo devemos atentar para alguns detalhes importantes.
Dados de conexão com a API da Partiu:
- $config['api_token'] - Corresponde ao Token fornecido pela Partiu no momento do credenciamento.
- $config['api_enterprise_id'] - Correspondente ao Enterprise_id fornecido pela Partiu no momento do credenciamento.
Dados de configuração das entidades:
- $elegiveis - Corresponde à qual tipo de entidade (ex. Síndico, Condômino, Fornecedor, etc.) estará apta para receber os Promocodes.
- $gratuidades - Corresponde à qual tipo de entidade terá direito a gratuidade.
As entidades que não estiverem no regime de gratuidade serão controladas pelo regime de assinatura, porém a única forma automática de cobrança do serviço por assinatura é pela emissão de cobrança bancária com a inclusão do item opcional no recibo. Portanto, somente para entidades contempladas pela cobrança. A única distinção quanto a ativação é pelo tipo de entidade, a partir do momento que um tipo de entidade é eleita para receber o Promocode todas as entidades do mesmo tipo serão contempladas. |
Além das informações mencionadas acima, existem outras configurações:
- $duracaoPromocode['ASSINATURA'] = 60 - Corresponde à quantidade de dias que o Promocode de assinatura estará apto para uso depois de ativado.
Para assinatura, quando configurado um período menor que 45 dias para a duração, o robô assumirá 45 dias por padrão. |
- $duracaoPromocode['GRATUIDADE'] = 60 - Corresponde à quantidade de dias que o Promocode gratuito estará apto para uso depois de ativado.
- $diasParaRenovarAssinatura = 2 - Quantidade de dias antecedentes que o robô fará a verificação da validade para a renovação do Promocode de assinatura.
- $diasParaRenovarGratuidade = 2 - Quantidade de dias antecedentes que o robô fará a verificação da validade para a renovação do Promocode gratuito.
Existe uma distinção quanto ao status do Promocode. O Promocode ativado significa que ele foi utilizado pelo cliente no aplicativo e será regido pelos parâmetros $duracaoPromocode. Sendo do tipo Assinatura a renovação estará condicionada ao pagamento do item opcional no recibo. Porém, os 60 dias valem para a utilização do Promocode como forma de degustação, à partir daí o Promocode será desabilitado. Promocodes do tipo Gratuidade são renovados automaticamente enquanto a entidade estiver dentro do critério eletivo (Ex. Enquanto for síndico), mesmo que não tenham sido ativados. Os 60 dias também valem para utilização do Promocode como forma de degustação à partir do momento que for ativado, mesmo que a entidade não esteja mais dentro dos critérios eletivos. |
Gerando Promocodes (Robô/API Partiu)
A geração dos Promocodes é feita através da execução do Robô Partiu passando o parâmetro de geração.
Ex. robo /partiu
O parâmetro /partiu gera Promocodes de 10 posições.
O robô também pode ser executado de forma que seja debugado passando o parâmetro /debug Ex. robo /partiu /debug. |
Depois de devidamente configurado, o robô deverá ser adicionado ao agendador de tarefas (não esquecendo de passar o parâmetro /partiu) com periodicidade de execução diária, para que ele gere os Promocodes adicionais e atualize o banco de dados com relação aos códigos ativados. |
Gerando Arquivo Bureaux de Síndicos
Conforme mencionado anteriormente, o modelo padrão incorpora o lançamento de Promocodes do tipo gratuidade para os síndicos. Esse lançamento depende da geração do arquivo padrão para que o respectivo bureaux faça as impressões do Layout correspondente ao lançamento para cada síndico.
A geração da gratuidade para os síndicos está diretamente condicionada à correta manutenção do cadastro no sistema.
O comando Verificar_sindico.bat pode auxiliar na verificação do cadastro, ele gera o arquivo VERIFICACAO_SINDICO.CSV contendo a listagem dos cadastros com possíveis inconsistências. Esse arquivo deverá ser analisado pela administradora afim de ajustar o cadastro dos síndicos de forma que o arquivo bureaux seja gerado corretamente.
Um exemplo do arquivo de verificação poderá ser consultado em Verificação Síndico. |
Depois de feitos os ajustes, o procedimento de geração do arquivo padrão deverá ser feito executando o comando Exportar_Chave_Sindico.bat que também estará dento da pasta FSQL, via prompt de comando.
A execução do comando deverá ser feita passando o caminho do banco de dados como parâmetro. |
Esse comando irá gerar o arquivo CHAVE_SINDICO.CSV dentro da mesma pasta, esse arquivo deverá ser enviado à respectiva empresa de impressão bureaux.
A empresa deverá estar preparada para processar o arquivo de acordo com o layout de impressão para o lançamento. |
Um exemplo do arquivo de síndicos poderá ser consultado em Arquivo Síndico. |
Gerando Arquivo Bureaux de Condôminos
Além dos síndicos, o modelo padrão também incorpora o lançamento de Promocodes do tipo assinatura para os condôminos, contudo, o padrão de lançamento não será feito com a cobrança do item opcional no primeiro mês. No primeiro momento o condômino receberá o layout diferenciado como degustação (60 dias), pois, somente a partir do mês seguinte a cobrança será efetuada. Esse lançamento depende da geração do arquivo padrão para que o respectivo bureaux faça as impressões do Layout correspondente mesclando o arquivo do chaves com o arquivo correspondente à impressão dos recibos.
O procedimento de geração do arquivo padrão deverá ser feito executando, via prompt, o comando Exportar_Chave_Condomino.bat que também estará dento da pasta FSQL.
A execução do comando deverá ser feita passando o caminho do banco de dados como parâmetro. |
Esse comando irá gerar o arquivo CHAVE_CONDOMINO.CSV dentro da mesma pasta, esse arquivo deverá ser enviado à respectiva empresa de impressão bureaux.
A empresa bureaux de impressão deverá estar preparada para processar o arquivo, mesclando as informações com o arquivo de recibos através dos campos CODIGO_CONDOMINIO e CODIGO_DA_UNIDADE de acordo com o layout de impressão para o lançamento. |
Um exemplo do arquivo de condôminos poderá ser consultado em Arquivo Condômino. |
Gerando Arquivo Bureaux de Locatários
O padrão de lançamento não será feito com a cobrança do item opcional no primeiro mês. No primeiro momento o locatário receberá o layout diferenciado como degustação (60 dias), pois, somente a partir do mês seguinte a cobrança será efetuada. Esse lançamento depende da geração do arquivo padrão para que o respectivo bureaux faça as impressões do Layout correspondente mesclando o arquivo do chaves com o arquivo correspondente à impressão dos recibos.
O procedimento de geração do arquivo padrão deverá ser feito executando, via prompt, o comando Exportar_Chave_Locatario.bat que também estará dento da pasta FSQL.
A execução do comando deverá ser feita passando o caminho do banco de dados como parâmetro. |
Esse comando irá gerar o arquivo CHAVE_LOCATARIO.CSV dentro da mesma pasta, esse arquivo deverá ser enviado à respectiva empresa de impressão bureaux.
A empresa bureaux de impressão deverá estar preparada para processar o arquivo, mesclando as informações com o arquivo de recibos através do campo CODIGO_DO_IMOVEL de acordo com o layout de impressão para o lançamento. |
Um exemplo do arquivo de locatários poderá ser consultado em Arquivo Locatário. |
Gerando Arquivo Bureaux de Locadores
O envio de Promocodes aos locadores deverá ser feito por meio de mala direta.
O procedimento de geração do arquivo padrão deverá ser feito executando, via prompt, o comando Exportar_Chave_Locador.bat que também estará dento da pasta FSQL.
A execução do comando deverá ser feita passando o caminho do banco de dados como parâmetro. |
Esse comando irá gerar o arquivo CHAVE_LOCADOR.CSV dentro da mesma pasta, esse arquivo deverá ser enviado à respectiva empresa de impressão bureaux.
Um exemplo do arquivo de locadores poderá ser consultado em Arquivo Locador. |
Verificar Promocodes Ativados
Também via prompt, o comando Verificar_Promocode_Ativo.bat poderá ser utilizado para gerar um arquivo de controle contendo os Promocodes que foram ativados.
A execução do comando deverá ser feita passando o caminho do banco de dados como parâmetro. |
Esse comando irá gerar o arquivo CHAVES_ATIVAS.CSV dentro da mesma pasta, esse arquivo conterá o resumo dos Promocodes que foram ativados.
Um exemplo do arquivo poderá ser consultado em Chaves Ativas. |
Lançamento de Opcionais
Antes do lançamentos dos itens nos recibos o Parâmetro 325 que correspondente a conta (para o Base Condomínio) e/ou histórico (para o Base Locação) padrão correspondente ao item opcional do recibo. |
O Controle de Lançamento de Opcionais poderá ser utilizado para fazer o lançamento automático da cobrança em todos os rateios dos condomínios, sem a necessidade de editar rateio por rateio.
Para o Sistema Base Locação o serviço deverá ser lançado na Aba Serviços do Contrato de Locação. Para mais detalhes sobre o lançamento de opcionais para condomínio consulte a documentação em Lançamentos de Opcionais. |
Controles Adicionais
Além dos controles necessários para a execução do robô, existem outros controles incorporados ao sistema para complementar o funcionamento.
Viewer GR_ENTIDADE_CLUBE_VANTAGENS - Monta consulta das entidades com os seus respectivos escopos (síndico, condômino, locador, etc), além do metadata referente aos campos de controle do clube de vantagens.
Trigger TG_CLUBE_VANTAGENS_COMPLEMENTO - Monitora a tabela de itens do recibo adicionando os Promocodes da entidade ao campo complemento do respectivo item.
Trigger TG_CLUBE_VANTAGENS_BAIXA - Também monitora a tabela de itens do recibo atualizando o metadata referente a data de pagamento do item na viewer GR_ENTIDADE_CLUBE_VANTAGENS.
Trigger TG_CLUBE_VANTAGENS_AVULSO - Monitora a tabela de unidades no lançamento avulso de contas a receber para zerar os valores de unidades vinculadas à entidades não elegíveis.