Mudanças entre as edições de "Partiu Vantagens"

De WikiBase
(Configuração do Robô Partiu)
 
(47 revisões intermediárias pelo mesmo usuário não estão sendo mostradas)
Linha 8: Linha 8:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
'''Essa documentação se refere à procedimentos internos da Base Software, está em construção e poderá sofrer ajustes até a liberação final.'''
+
'''Essa documentação se refere à procedimentos necessários para a implantação do serviço '''Partiu Clube de Vantagens'''.'''
  
 
|}
 
|}
  
  
O '''Partiu Vantagens''' consiste na disponibilização do acesso ao serviço do [http://www.partiuvantagens.com.br/#/landing/consumer '''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 '''Partiu Vantagens''' consiste na disponibilização do acesso ao serviço do [http://www.partiuvantagens.com.br/#/landing/consumer '''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.
  
  
Linha 20: Linha 20:
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"|
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"|
  
O Promocode consiste numa sequência de 8 a 10 caracteres alfanuméricos com combinação única, ou seja, nunca se repete.
+
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.
+
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:
+
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.
 
*'''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.
Linha 38: Linha 38:
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"|
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"|
  
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.
+
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).
+
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).
  
 
|}
 
|}
Linha 61: Linha 61:
 
*3 Cores Principais de Identidade Visual da Administradora
 
*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.
+
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 quando o usuário logar.
  
  
Linha 74: Linha 74:
 
|}
 
|}
  
==Procedimentos==
+
==Lançamento de Opcionais==
====Roteiro Padrão de Implantação====
+
 
 +
{| style="border-spacing:0;width:100%;"
 +
| style="background-color:#F18F8F;border:none;padding:0.097cm;width:100px;"| [[Imagem:Atencao.png|center]]
 +
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|
 +
 
 +
'''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.'''
 +
 
 +
|}
 +
 
 +
 
 +
[[Arquivo:Partiu_Parametro_325.JPG|center]]
 +
 
 +
 
 +
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.
 +
 
 +
{| style="border-spacing:0;width:100%;"
 +
| style="background-color:#96CFF5;border:none;padding:0.097cm;width:100px;"| [[Imagem:Dica.png|center]]
 +
| style="background-color:#96CFF5;border:none;padding:0.097cm;"|
 +
 
 +
Para o '''Sistema Base Locação''' o serviço deverá ser lançado na '''Aba Serviços''' do '''Contrato de Locação'''.
 +
 
 +
Consulte também a documentação referente ao [[Lançamentos de Opcionais|Lançamentos de Opcionais]].
 +
 
 +
|}
 +
 
 +
==Roteiro Padrão de Implantação==
  
 
O roteiro padrão consiste em:
 
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 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.
+
*'''Base Locação''' - Gerar os promocodes tipo assinatura para os locatários e transmiti-los ao respectivo bureaux.
  
  
Linha 88: Linha 113:
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"|
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"|
  
No caso do Sistema '''Base Locação''' também é possível gerar Promocodes para proprietários.
+
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'''.  
+
Não existe nenhum controle automático de cobrança para promocodes do tipo assinatura para locação. A única forma de cobrança será através das '''Aba Serviços''' do '''Contrato de Administração'''.  
  
 
|}
 
|}
Linha 97: Linha 122:
 
Contudo, existem particularidades com relação ao lançamento do serviço do tipo assinatura (opcional cobrado no recibo):
 
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.
+
: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.
 
: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.
+
: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====
+
==Modelos de Divulgação==
  
 
A divulgação é feita através de encartes promocionais com formato e layout especial desenvolvido junto ao bureaux.
 
A divulgação é feita através de encartes promocionais com formato e layout especial desenvolvido junto ao bureaux.
Linha 149: Linha 174:
  
 
|}
 
|}
 +
 +
 +
==Procedimentos==
  
 
====Revisão do Cadastro de Síndicos====
 
====Revisão do Cadastro de Síndicos====
Linha 158: Linha 186:
 
'''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.'''
 
'''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'''.'''
+
'''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'''.'''
  
 
|}
 
|}
Linha 180: Linha 208:
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"|
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"|
  
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.
+
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).
 
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ô Partiu====
 
====Configuração do Robô Partiu====
 
  
 
{| style="border-spacing:0;width:100%;"
 
{| style="border-spacing:0;width:100%;"
Linha 202: Linha 224:
 
|}
 
|}
  
<!--
 
  
O '''Robô Partiu''' é 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.
+
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.
  
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.
+
'''Dados de conexão com a API da Partiu:'''
  
A instalação deverá ser feita através do download do programa '''Instalacao_Partiu.exe''' disponível no [http://www.basesoft.com.br/agil '''Base Ágil'''] ou link direto em [http://suporte.basesoft.com.br/Download/Updates/Instalacao_Partiu.exe Instalação 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 para configuração das entidades, duração e renovação dos promocodes:'''
  
[[Arquivo:Partiu_Base_Agil.JPG|center]]
+
:$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'''.
  
  
Linha 218: Linha 242:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
'''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.'''
+
'''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.'''
  
'''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.'''
+
'''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.'''
  
 
|}
 
|}
  
  
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.
+
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'''.'''
[[Arquivo:Partiu_Atualizar_DB.JPG|center]]
+
 
+
 
+
[[Arquivo:Partiu_Atualizar_DB1.JPG|center]]
+
  
  
 
{| style="border-spacing:0;width:100%;"
 
{| style="border-spacing:0;width:100%;"
| style="background-color:#96CFF5;border:none;padding:0.097cm;width:100px;"| [[Arquivo:Dica.png|center]]
+
| style="background-color:#F18F8F;border:none;padding:0.097cm;width:100px;"| [[Imagem:Atencao.png|center]]
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
+
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
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.
+
'''Para assinatura, quando configurado um período menor que 45 dias para a duração, o robô assumirá 45 dias por padrão.'''
  
 
|}
 
|}
  
-->
 
  
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.
+
:$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.'''
Dados de conexão com a API da Partiu:
+
:$diasParaRenovarGratuidade = 2 - '''Quantidade de dias antecedentes que o robô fará a verificação da validade para a renovação do promocode gratuito.'''
 
+
:$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'''.
+
  
  
Linha 261: Linha 272:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
'''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.'''
+
'''Existe uma distinção quanto ao status do promocode.'''
  
'''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.'''
+
'''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.'''
  
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'''.'''
 
  
 +
'''Dados para a configuração do envio de informações cadastrais das entidades:'''
  
{| style="border-spacing:0;width:100%;"
+
O envio dos dados cadastrais das entidades é facultativo e deverá ser configurado.
| style="background-color:#F18F8F;border:none;padding:0.097cm;width:100px;"| [[Imagem:Atencao.png|center]]
+
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|
+
  
'''Para assinatura, quando configurado um período menor que 45 dias para a duração, o robô assumirá 45 dias por padrão.'''
+
: $enviarDadosCadastrais['enviar_dados'] - '''Ativa o envio de dados cadastrais, os valores válidos são SIM e NAO.'''
 
+
: $enviarDadosCadastrais['entidades'] - '''Permite determinar quais entidades serão enviadas, os valores válidos são TODOS (envia os dados cadastrais de todas as entidades prospectadas) e PAGANTES (envia dos dados cadastrais somente das entidades que efetuaram o pagamento da partiu.'''
|}
+
 
+
 
+
:$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.'''
+
  
  
Linha 291: Linha 295:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
'''Existe uma distinção quanto ao status do Promocode.'''
+
'''O envio de dados cadastrais das entidades compreende as informações referentes ao nome, endereço completo, CPF, e-mail e telefones.'''
 
+
'''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.'''
+
'''Essa funcionalidade está ativa somente para o envio de dados de entidades vinculadas aos condomínios.'''
  
 
|}
 
|}
Linha 303: Linha 303:
 
====Gerando Promocodes (Robô/API Partiu)====
 
====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.
+
A geração dos promocodes é feita através da execução do Robô Partiu passando o parâmetro de geração.
  
 
Ex. '''robo /partiu'''
 
Ex. '''robo /partiu'''
  
O parâmetro '''/partiu''' gera Promocodes de 10 posições.
+
O parâmetro '''/partiu''' gera promocodes de 10 posições.
  
  
Linha 326: Linha 326:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
'''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.'''
+
'''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====
+
====Gerando Dados Cadastrais (Robô/API Partiu)====
  
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 dos dados cadastrais é feita através da execução do Robô Partiu passando o parâmetro de geração ''/cadastro''.
  
A geração da gratuidade para os síndicos está diretamente condicionada à correta manutenção do cadastro no sistema.
+
Esse procedimento é opcional e deverá ser ativado nas configurações do robô, mesmo que o parâmetro ''/cadastro'' seja passado os dados não serão gerados se esse procedimento não estiver ativado nas configurações.
  
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.
+
Ex. '''robo /cadastro'''
  
 +
O parâmetro '''/cadastro''' gera os dados cadastrais.
  
[[Arquivo:Partiu_Verificar_Sindico.JPG|center]]
+
 
 +
[[Arquivo:Partiu_Gerar_Cadastros.JPG|center]]
  
  
 
{| style="border-spacing:0;width:100%;"
 
{| style="border-spacing:0;width:100%;"
| style="background-color:#96CFF5;border:none;padding:0.097cm;width:100px;"| [[Arquivo:Dica.png|center]]
+
| style="background-color:#96CFF5;border:none;padding:0.097cm;width:100px;"| [[Imagem:Dica.png|center]]
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
+
| style="background-color:#96CFF5;border:none;padding:0.097cm;"|
  
Um exemplo do arquivo de verificação poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/VERIFICACAO_SINDICO.CSV Verificação Síndico].
+
O robô também pode ser executado de forma que seja ''debugado'' passando o parâmetro /debug '''Ex. robo /cadastro /debug'''.
  
 
|}
 
|}
 
 
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.
 
  
  
Linha 358: Linha 357:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
'''A execução do comando deverá ser feita passando o caminho do banco de dados como parâmetro.'''
+
'''Depois de devidamente configurado, o robô deverá ser adicionado ao agendador de tarefas ('''não esquecendo de passar o parâmetro /cadastro''') com periodicidade de execução mensal, pois, o envio de dados cadastrais deve ter um intervalo maior devido ao excesso de dados apurados.'''
  
 
|}
 
|}
  
 +
===Relatórios Padronizados===
  
[[Arquivo:Partiu_Gerar_Promocode1.JPG|center]]
+
O Robô partiu tem alguns relatórios predefinidos que deverão ser utilizados para a configuração de layouts junto ao bureaux, além de consultas e verificações dos dados gerados. São eles:
  
 
+
:*'''chave_condomino''' - Gera uma listagem de promocodes gerados por unidade, ordenado pelo código do condomínio e código da unidade.
Esse comando irá gerar o arquivo '''CHAVE_SINDICO.CSV''' dentro da mesma pasta, esse arquivo deverá ser enviado à respectiva empresa de impressão bureaux.
+
::Esse relatório deverá ser utilizado para a prospecção (lançamento) do serviço. Ele poderá ser mesclado com o arquivo bureaux de recibos para a geração de um layout diferenciado no lançamento.
 +
:*'''chave_sindico''' - Gera uma listagem de promocodes gerados por síndico, ordenado pelo código do condomínio. Ele poderá ser utilizado como fonte bureaux para a geração de um layout diferenciado.
 +
::Esse relatório deverá ser utilizado para a divulgação do serviço, na opção de gratuidade para os síndicos;
 +
:*'''verificar_sindico''' - Gera uma listagem de verificação para inconsistências no cadastro dos síndicos.
 +
:*'''dados_cadastrais''' - Gera uma listagem de dados cadastrais dos condôminos enviados para a partiu (o envio dos dados cadastrais é opcional e deverá ser configurado no robô).
 +
:*'''chave_locador''' - Gera uma listagem de promocodes gerados por locador, ordenado pelo código do locador.
 +
:*'''chave_locatario''' - Gera uma listagem de promocodes gerados por locatário, ordenado pelo código do imóvel.
 +
::Esse relatório deverá ser utilizado para a prospecção (lançamento) do serviço. Ele poderá ser mesclado com o arquivo bureaux de recibos para a geração de um layout diferenciado no lançamento.
 +
:*'''verificar_locador''' - Gera uma listagem de verificação para inconsistências no cadastro dos locadores.
  
  
Linha 373: Linha 381:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
'''A empresa deverá estar preparada para processar o arquivo de acordo com o layout de impressão para o lançamento.'''
+
'''Consulte o [http://suporte.basesoft.com.br/Download/Updates/partiu.zip '''Pacote de arquivos'''] para obter o pacote completo de exemplos dos layouts.'''
 +
 
 +
'''Consulte o tópico '''Construção de Relatórios''' na documentação do [[Robo GIT|'''Robô GIT''']]. '''
  
 
|}
 
|}
  
 +
=====Arquivo Bureaux de Síndicos=====
  
{| style="border-spacing:0;width:100%;"
+
Esse relatório deverá ser utilizado para a divulgação do serviço, na opção de gratuidade para os síndicos;
| style="background-color:#96CFF5;border:none;padding:0.097cm;width:100px;"| [[Arquivo:Dica.png|center]]
+
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
+
 
+
Um exemplo do arquivo de síndicos poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/Chaves_Sindico.csv 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'''.
+
'''verificar_sindico''' - Gera uma listagem de verificação para inconsistências no cadastro dos síndicos.
  
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'''.
+
'''chave_sindico''' - Gera uma listagem de promocodes gerados por síndico, ordenado pelo código do condomínio. Ele poderá ser utilizado como fonte bureaux para a geração de um layout diferenciado.
  
  
Linha 397: Linha 400:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
'''A execução do comando deverá ser feita passando o caminho do banco de dados como parâmetro.'''
+
'''É obrigatória a geração do arquivo de verificação de síndico ('''verificar_sindico''') antes de enviar os dados para o bureaux.'''
  
|}
+
'''Esse relatório fará a verificação do cadastro de síndicos dos condomínios, apontando possíveis inconsistências que deverão ser corrigidas imediatamente. '''
 
+
 
+
[[Arquivo:Partiu_Gerar_Promocode2.JPG|center]]
+
 
+
 
+
Esse comando irá gerar o arquivo '''CHAVE_CONDOMINO.CSV''' dentro da mesma pasta, esse arquivo deverá ser enviado à respectiva empresa de impressão bureaux.
+
 
+
 
+
{| style="border-spacing:0;width:100%;"
+
| style="background-color:#F18F8F;border:none;padding:0.097cm;width:100px;"| [[Imagem:Atencao.png|center]]
+
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|
+
 
+
'''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.'''
+
  
 
|}
 
|}
Linha 421: Linha 411:
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
  
Um exemplo do arquivo de condôminos poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/Chaves_Condomino.csv Arquivo Condômino].
+
Um exemplo do arquivo de verificação também poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/VERIFICACAO_SINDICO.CSV Verificação Síndico].
  
|}
+
Um exemplo do arquivo de síndicos também poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/Chaves_Sindico.csv Arquivo Síndico].
 
+
====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'''.
+
 
+
 
+
{| style="border-spacing:0;width:100%;"
+
| style="background-color:#F18F8F;border:none;padding:0.097cm;width:100px;"| [[Imagem:Atencao.png|center]]
+
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|
+
 
+
'''A execução do comando deverá ser feita passando o caminho do banco de dados como parâmetro.'''
+
  
 
|}
 
|}
  
 +
====Arquivo Bureaux de Condôminos====
  
[[Arquivo:Partiu_Gerar_Promocode3.JPG|center]]
 
  
 +
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 de promocodes com o arquivo correspondente à impressão dos recibos'''.
  
Esse comando irá gerar o arquivo '''CHAVE_LOCATARIO.CSV''' dentro da mesma pasta, esse arquivo deverá ser enviado à respectiva empresa de impressão bureaux.
+
'''chave_condomino''' - Gera uma listagem de promocodes gerados por unidade, ordenado pelo código do condomínio e código da unidade.
  
 +
'''dados_cadastrais''' - Gera uma listagem de dados cadastrais dos condôminos enviados para a partiu (o envio dos dados cadastrais é opcional e deverá ser configurado no robô).
  
 
{| style="border-spacing:0;width:100%;"
 
{| style="border-spacing:0;width:100%;"
Linha 451: Linha 430:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
'''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.'''
+
'''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.'''
  
 
|}
 
|}
Linha 460: Linha 439:
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
  
Um exemplo do arquivo de locatários poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/CHAVE_LOCATARIO.CSV Arquivo Locatário].
+
Um exemplo do arquivo de condôminos também poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/Chaves_Condomino.csv Arquivo Condômino].
 +
 
 +
Um exemplo do arquivo de dados cadastrais enviados também poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/dados_cadastrais.csv Dados Cadastrais.]
  
 
|}
 
|}
  
====Gerando Arquivo Bureaux de Locadores====
+
====Arquivo Bureaux de Locatários====
  
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'''.
+
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'''.
 +
 
 +
'''chave_locatario''' - Gera uma listagem de promocodes gerados por locatário, ordenado pelo código do imóvel.
  
  
Linha 475: Linha 457:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
'''A execução do comando deverá ser feita passando o caminho do banco de dados como parâmetro.'''
+
'''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.'''
  
 
|}
 
|}
 
 
[[Arquivo:Partiu_Gerar_Promocode4.JPG|center]]
 
 
 
Esse comando irá gerar o arquivo '''CHAVE_LOCADOR.CSV''' dentro da mesma pasta, esse arquivo deverá ser enviado à respectiva empresa de impressão bureaux.
 
  
  
Linha 490: Linha 466:
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
  
Um exemplo do arquivo de locadores poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/CHAVE_LOCADOR.CSV Arquivo Locador].
+
Um exemplo do arquivo de locatários também poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/CHAVE_LOCATARIO.CSV Arquivo Locatário].
  
 
|}
 
|}
  
===Verificar Promocodes Ativados===
+
====Arquivo Bureaux de Locadores====
  
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.
+
'''chave_locador''' - Gera uma listagem de promocodes gerados por locador, ordenado pelo código do locador.
 
+
{| style="border-spacing:0;width:100%;"
+
| style="background-color:#F18F8F;border:none;padding:0.097cm;width:100px;"| [[Imagem:Atencao.png|center]]
+
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|
+
 
+
'''A execução do comando deverá ser feita passando o caminho do banco de dados como parâmetro.'''
+
 
+
|}
+
 
+
 
+
[[Arquivo:Partiu_Verificar_Promocode.JPG|center]]
+
 
+
 
+
Esse comando irá gerar o arquivo '''CHAVES_ATIVAS.CSV''' dentro da mesma pasta, esse arquivo conterá o resumo dos Promocodes que foram ativados.
+
  
 +
O envio de promocodes aos locadores deverá ser feito por meio de mala direta.
  
  
Linha 518: Linha 481:
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
 
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
  
Um exemplo do arquivo poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/CHAVES_ATIVAS.CSV Chaves Ativas].
+
Um exemplo do arquivo de locadores também poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/CHAVE_LOCADOR.CSV Arquivo Locador].
  
 
|}
 
|}
  
===Lançamento de Opcionais===
+
<!--
 +
===Verificar Promocodes Ativados===
 +
 
  
 
{| style="border-spacing:0;width:100%;"
 
{| style="border-spacing:0;width:100%;"
Linha 528: Linha 493:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
'''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.'''
+
'''Consulte o tópico '''Construção de Relatórios''' na documentação do [[Robo GIT|'''Robô GIT''']]. '''
  
 
|}
 
|}
  
 
[[Arquivo:Partiu_Parametro_325.JPG|center]]
 
 
 
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.
 
  
 
{| style="border-spacing:0;width:100%;"
 
{| style="border-spacing:0;width:100%;"
| style="background-color:#96CFF5;border:none;padding:0.097cm;width:100px;"| [[Imagem:Dica.png|center]]
+
| style="background-color:#96CFF5;border:none;padding:0.097cm;width:100px;"| [[Arquivo:Dica.png|center]]
| style="background-color:#96CFF5;border:none;padding:0.097cm;"|
+
| style="background-color:#96CFF5;border:none;padding:0.097cm;"| '''
  
Para o '''Sistema Base Locação''' o serviço deverá ser lançado na '''Aba Serviços''' do '''Contrato de Locação'''.
+
Um exemplo do arquivo tanbém poderá ser consultado em [http://suporte.basesoft.com.br/Download/Updates/CHAVES_ATIVAS.CSV Chaves Ativas].
 
+
Para mais detalhes sobre o lançamento de opcionais para condomínio consulte a documentação em [[Lançamentos de Opcionais|Lançamentos de Opcionais]].
+
  
 
|}
 
|}
 +
-->
  
===Controles Adicionais===
+
==Controles Adicionais==
  
 
Além dos controles necessários para a execução do robô, existem outros controles incorporados ao sistema para complementar o funcionamento.
 
Além dos controles necessários para a execução do robô, existem outros controles incorporados ao sistema para complementar o funcionamento.
Linha 554: Linha 513:
 
'''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.
 
'''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_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_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.

Edição atual tal como às 09h41min de 16 de março de 2017

Clube Partiu Vantagens


Visão Geral

Atencao.png

Essa documentação se refere à procedimentos necessários para a implantação do serviço Partiu Clube de Vantagens.


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.


Dica.png

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).


Dica.png

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 quando o usuário logar.


Atencao.png

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.

Lançamento de Opcionais

Atencao.png

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.


Partiu Parametro 325.JPG


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.

Dica.png

Para o Sistema Base Locação o serviço deverá ser lançado na Aba Serviços do Contrato de Locação.

Consulte também a documentação referente ao Lançamentos de Opcionais.

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.


Dica.png

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 para locação. 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:


Modelo Encarte Sindico Capa.jpg
Capa
Modelo Encarte Sindico Centro.jpg
Centro


Dica.png

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:


Modelo Encarte Morador Capa.jpg
Capa
Modelo Encarte Morador Centro.jpg
Centro


Atencao.png

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).


Procedimentos

Revisão do Cadastro de Síndicos

Atencao.png

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:

  1. 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).
  2. Verificar se todos os mandatos estão com os síndicos apontados corretamente.

Erros mais comuns:

  1. Cadastro de síndico sem data de início do mandato.
  2. Cadastro de síndico com data de termino do mandato expirada (maior que a data atual).
  3. Cadastro de síndico sem identificação de unidade e profissional externo.
  4. 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.


Dica.png

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).

Configuração do Robô Partiu

Atencao.png

Consulte o tópico Configuração do Robô na documentação do Robô GIT.


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 para configuração das entidades, duração e renovação dos promocodes:

$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.


Atencao.png

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.


Atencao.png

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.


Atencao.png

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.


Dados para a configuração do envio de informações cadastrais das entidades:

O envio dos dados cadastrais das entidades é facultativo e deverá ser configurado.

$enviarDadosCadastrais['enviar_dados'] - Ativa o envio de dados cadastrais, os valores válidos são SIM e NAO.
$enviarDadosCadastrais['entidades'] - Permite determinar quais entidades serão enviadas, os valores válidos são TODOS (envia os dados cadastrais de todas as entidades prospectadas) e PAGANTES (envia dos dados cadastrais somente das entidades que efetuaram o pagamento da partiu.


Atencao.png

O envio de dados cadastrais das entidades compreende as informações referentes ao nome, endereço completo, CPF, e-mail e telefones.

Essa funcionalidade está ativa somente para o envio de dados de entidades vinculadas aos condomínios.

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.


Partiu Gerar Promocode.JPG


Dica.png

O robô também pode ser executado de forma que seja debugado passando o parâmetro /debug Ex. robo /partiu /debug.


Atencao.png

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 Dados Cadastrais (Robô/API Partiu)

A geração dos dados cadastrais é feita através da execução do Robô Partiu passando o parâmetro de geração /cadastro.

Esse procedimento é opcional e deverá ser ativado nas configurações do robô, mesmo que o parâmetro /cadastro seja passado os dados não serão gerados se esse procedimento não estiver ativado nas configurações.

Ex. robo /cadastro

O parâmetro /cadastro gera os dados cadastrais.


Partiu Gerar Cadastros.JPG


Dica.png

O robô também pode ser executado de forma que seja debugado passando o parâmetro /debug Ex. robo /cadastro /debug.


Atencao.png

Depois de devidamente configurado, o robô deverá ser adicionado ao agendador de tarefas (não esquecendo de passar o parâmetro /cadastro) com periodicidade de execução mensal, pois, o envio de dados cadastrais deve ter um intervalo maior devido ao excesso de dados apurados.

Relatórios Padronizados

O Robô partiu tem alguns relatórios predefinidos que deverão ser utilizados para a configuração de layouts junto ao bureaux, além de consultas e verificações dos dados gerados. São eles:

  • chave_condomino - Gera uma listagem de promocodes gerados por unidade, ordenado pelo código do condomínio e código da unidade.
Esse relatório deverá ser utilizado para a prospecção (lançamento) do serviço. Ele poderá ser mesclado com o arquivo bureaux de recibos para a geração de um layout diferenciado no lançamento.
  • chave_sindico - Gera uma listagem de promocodes gerados por síndico, ordenado pelo código do condomínio. Ele poderá ser utilizado como fonte bureaux para a geração de um layout diferenciado.
Esse relatório deverá ser utilizado para a divulgação do serviço, na opção de gratuidade para os síndicos;
  • verificar_sindico - Gera uma listagem de verificação para inconsistências no cadastro dos síndicos.
  • dados_cadastrais - Gera uma listagem de dados cadastrais dos condôminos enviados para a partiu (o envio dos dados cadastrais é opcional e deverá ser configurado no robô).
  • chave_locador - Gera uma listagem de promocodes gerados por locador, ordenado pelo código do locador.
  • chave_locatario - Gera uma listagem de promocodes gerados por locatário, ordenado pelo código do imóvel.
Esse relatório deverá ser utilizado para a prospecção (lançamento) do serviço. Ele poderá ser mesclado com o arquivo bureaux de recibos para a geração de um layout diferenciado no lançamento.
  • verificar_locador - Gera uma listagem de verificação para inconsistências no cadastro dos locadores.


Atencao.png

Consulte o Pacote de arquivos para obter o pacote completo de exemplos dos layouts.

Consulte o tópico Construção de Relatórios na documentação do Robô GIT.

Arquivo Bureaux de Síndicos

Esse relatório deverá ser utilizado para a divulgação do serviço, na opção de gratuidade para os síndicos;

verificar_sindico - Gera uma listagem de verificação para inconsistências no cadastro dos síndicos.

chave_sindico - Gera uma listagem de promocodes gerados por síndico, ordenado pelo código do condomínio. Ele poderá ser utilizado como fonte bureaux para a geração de um layout diferenciado.


Atencao.png

É obrigatória a geração do arquivo de verificação de síndico (verificar_sindico) antes de enviar os dados para o bureaux.

Esse relatório fará a verificação do cadastro de síndicos dos condomínios, apontando possíveis inconsistências que deverão ser corrigidas imediatamente.


Dica.png

Um exemplo do arquivo de verificação também poderá ser consultado em Verificação Síndico.

Um exemplo do arquivo de síndicos também poderá ser consultado em Arquivo Síndico.

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 de promocodes com o arquivo correspondente à impressão dos recibos.

chave_condomino - Gera uma listagem de promocodes gerados por unidade, ordenado pelo código do condomínio e código da unidade.

dados_cadastrais - Gera uma listagem de dados cadastrais dos condôminos enviados para a partiu (o envio dos dados cadastrais é opcional e deverá ser configurado no robô).

Atencao.png

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.


Dica.png

Um exemplo do arquivo de condôminos também poderá ser consultado em Arquivo Condômino.

Um exemplo do arquivo de dados cadastrais enviados também poderá ser consultado em Dados Cadastrais.

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.

chave_locatario - Gera uma listagem de promocodes gerados por locatário, ordenado pelo código do imóvel.


Atencao.png

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.


Dica.png

Um exemplo do arquivo de locatários também poderá ser consultado em Arquivo Locatário.

Arquivo Bureaux de Locadores

chave_locador - Gera uma listagem de promocodes gerados por locador, ordenado pelo código do locador.

O envio de promocodes aos locadores deverá ser feito por meio de mala direta.


Dica.png

Um exemplo do arquivo de locadores também poderá ser consultado em Arquivo Locador.


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.

Funcionalidades Base Condomínio