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

De WikiBase
(→‎Arquivo Bureaux de Locatários)
 
(16 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 96: Linha 96:
 
Para o '''Sistema Base Locação''' o serviço deverá ser lançado na '''Aba Serviços''' do '''Contrato de Locação'''.
 
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|Lançamentos de Opcionais]].
+
Consulte também a documentação referente ao [[Lançamentos de Opcionais|Lançamentos de Opcionais]].
  
 
|}
 
|}
Linha 104: Linha 104:
 
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 113: 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 122: 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==
Linha 186: 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 208: 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).
  
 
|}
 
|}
−
 
−
 
−
{| 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;"|
 
−
 
−
'''Consulte o tópico '''Construção de Relatórios''' na documentação do [[Robo GIT|'''Robô GIT''']]. '''
 
−
 
−
|}
 
−
 
  
 
====Configuração do Robô Partiu====
 
====Configuração do Robô Partiu====
Linha 244: Linha 234:
 
'''Dados para configuração das entidades, duração e renovação dos promocodes:'''
 
'''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'''.
+
:$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'''.
 
:$gratuidades - '''Corresponde à qual tipo de entidade terá direito a gratuidade'''.
  
Linha 254: Linha 244:
 
'''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.'''
 
'''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.'''
+
'''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.'''
  
 
|}
 
|}
Linha 261: Linha 251:
 
Além das informações mencionadas acima, existem outras configuraçõ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'''.'''
+
:$duracaoPromocode['ASSINATURA'] = 60 - '''Corresponde à quantidade de dias que o promocode de assinatura estará apto para uso '''depois de ativado'''.'''
  
  
Linha 273: Linha 263:
  
  
−
:$duracaoPromocode['GRATUIDADE'] = 60 - '''Corresponde à quantidade de dias que o Promocode gratuito estará apto para uso '''depois de ativado'''.'''
+
:$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.'''
+
:$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.'''
+
:$diasParaRenovarGratuidade = 2 - '''Quantidade de dias antecedentes que o robô fará a verificação da validade para a renovação do promocode gratuito.'''
  
  
Linha 282: Linha 272:
 
| 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.'''
+
'''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'''.'''
+
'''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.'''
+
'''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.'''
+
'''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.'''
  
 
|}
 
|}
Linha 313: 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 336: 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.'''
  
 
|}
 
|}
Linha 342: Linha 332:
 
====Gerando Dados Cadastrais (Robô/API Partiu)====
 
====Gerando Dados Cadastrais (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 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'''
 
Ex. '''robo /cadastro'''
Linha 378: Linha 370:
 
::Esse relatório deverá ser utilizado para a divulgação do serviço, na opção de gratuidade para os 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.
 
:*'''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.
+
:*'''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_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.
 
:*'''chave_locatario''' - Gera uma listagem de promocodes gerados por locatário, ordenado pelo código do imóvel.
Linha 389: Linha 381:
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
 
| style="background-color:#F18F8F;border:none;padding:0.097cm;"|  
  
−
'''Consulte o [http://suporte.basesoft.com.br/Download/Updates/partiu.zip '''Pacote de arquivos'''] para obter exemplos dos layouts.'''
+
'''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''']]. '''
 
'''Consulte o tópico '''Construção de Relatórios''' na documentação do [[Robo GIT|'''Robô GIT''']]. '''
Linha 396: Linha 388:
  
 
=====Arquivo Bureaux de Síndicos=====
 
=====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.
 
'''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.
 
'''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;
 
  
  
 
{| 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;"|  
  
−
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].
+
'''É 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. '''
  
 
|}
 
|}
Linha 416: Linha 410:
 
| 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;"| [[Arquivo: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 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].
 
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].
Linha 424: Linha 420:
  
  
−
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'''.
+
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.
 
'''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.
+
'''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 478: Linha 474:
 
'''chave_locador''' - Gera uma listagem de promocodes gerados por locador, ordenado pelo código do locador.
 
'''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.
+
O envio de promocodes aos locadores deverá ser feito por meio de mala direta.
  
  
Linha 511: Linha 507:
 
-->
 
-->
  
−
===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 517: 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

Disponível em "http://www.basesoft.com.br/w/index.php?title=Partiu_Vantagens&oldid=20842"