Partiu Vantagens

Clube Partiu Vantagens

Visão Geral

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.

O promocode consiste numa sequência de 8 a 10 caracteres alfanuméricos com combinação única, ou seja, nunca se repete. O sistema permite a geração de até 4 promocodes por entidade, porém o padrão é 2.

Com relação aos promocodes, temos dois tipos distintos quanto a renovação da utilização:

• Gratuidade - Renovado automaticamente pelo sistema, sem a necessidade de assinatura. Pode ser oferecido estrategicamente à alguns tipos de entidade, por exemplo aos síndicos como forma de divulgar o serviço nos condomínios.

• Assinatura - Renovação condicionada ao pagamento do serviço (opcional cobrado no recibo do condômino ou locatário).

Existe uma distinção entre a validade para renovação dos promocodes e a sua ativação no Aplicativo Partiu. Depois de gerado, o promocode tem um prazo para ser ativado no aplicativo (a princípio 5 anos), depois de ativado tem 60 dias de utilização e é renovado por mais 60 dias pelo sistema levando em consideração as regras de gratuidade e assinatura citadas acima. Então no caso de gratuidade, tomando como exemplo o síndico, ele terá 5 anos para ativa-lo e depois de ativado 60 dias de utilização. Situação semelhante poderá ocorrer no caso de outra entidade, tomando como exemplo o condômino, mesmo sendo assinatura ele receberá os promocodes de acesso com validade de 5 anos para ativá-los e 60 dias de utilização independente do pagamento. Contundo, a renovação do prazo de utilização estará condicionado ao pagamento (opcional do recibo).

Credenciamento do Cliente

Antes da implantação do serviço o cliente deverá ser credenciado junto ao Clube de Vantagens Partiu.

Esse processo consiste em enviar as informações descritas abaixo:

• Nome Fantasia
• Razão Social
• Telefone
• CNPJ
• Nome do Usuário Responsável
• CPF do Usuário Responsável
• Telefone do Usuário Responsável
• Email do Responsável
• Logo (vetorizada, se possível)
• 3 Cores Principais de Identidade Visual da Administradora

Depois que o credenciamento for efetivado a Base receberá as informações referentes aos respectivos Token e Enterprise_id do cliente. Essas informações particulares garantem que o cliente da administradora irá utilizar o aplicativo deixando claro o seu tipo vinculo, pois, o aplicativo exibirá a identificação visual da administradora quando o usuário logar.

O credenciamento será feito e repassado para a Base exclusivamente pelo pessoal da Partiu. Tanto o Token quanto o Enterprise_id pessoal da administradora é de suma importância para a continuidade do processo.

Lançamento de Opcionais

Antes do lançamentos dos itens nos recibos o Parâmetro 325 que correspondente a conta (para o Base Condomínio) e/ou histórico (para o Base Locação) padrão correspondente ao item opcional do recibo.

O Controle de Lançamento de Opcionais poderá ser utilizado para fazer o lançamento automático da cobrança em todos os rateios dos condomínios, sem a necessidade de editar rateio por rateio.

Para o Sistema Base Locação o serviço deverá ser lançado na Aba Serviços do Contrato de Locação. 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.

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:

Capa

Centro

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:

Capa

Centro

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

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.

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

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.

As entidades que não estiverem no regime de gratuidade serão controladas pelo regime de assinatura, porém a única forma automática de cobrança do serviço por assinatura é pela emissão de cobrança bancária com a inclusão do item opcional no recibo. Portanto, somente para entidades contempladas pela cobrança. A única distinção quanto a ativação é pelo tipo de entidade, a partir do momento que um tipo de entidade é eleita para receber o promocode todas as entidades do mesmo tipo serão contempladas.

Além das informações mencionadas acima, existem outras configurações:

$duracaoPromocode['ASSINATURA'] = 60 - Corresponde à quantidade de dias que o promocode de assinatura estará apto para uso depois de ativado.

Para assinatura, quando configurado um período menor que 45 dias para a duração, o robô assumirá 45 dias por padrão.

$duracaoPromocode['GRATUIDADE'] = 60 - Corresponde à quantidade de dias que o promocode gratuito estará apto para uso depois de ativado.

$diasParaRenovarAssinatura = 2 - Quantidade de dias antecedentes que o robô fará a verificação da validade para a renovação do promocode de assinatura.

$diasParaRenovarGratuidade = 2 - Quantidade de dias antecedentes que o robô fará a verificação da validade para a renovação do promocode gratuito.

Existe uma distinção quanto ao status do promocode. O promocode ativado significa que ele foi utilizado pelo cliente no aplicativo e será regido pelos parâmetros $duracaoPromocode. Sendo do tipo Assinatura a renovação estará condicionada ao pagamento do item opcional no recibo. Porém, os 60 dias valem para a utilização do promocode como forma de degustação, à partir daí o promocode será desabilitado. promocodes do tipo Gratuidade são renovados automaticamente enquanto a entidade estiver dentro do critério eletivo (Ex. Enquanto for síndico), mesmo que não tenham sido ativados. Os 60 dias também valem para utilização do promocode como forma de degustação à partir do momento que for ativado, mesmo que a entidade não esteja mais dentro dos critérios eletivos.

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.

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.

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

Depois de devidamente configurado, o robô deverá ser adicionado ao agendador de tarefas (não esquecendo de passar o parâmetro /partiu) com periodicidade de execução diária, para que ele gere os promocodes adicionais e atualize o banco de dados com relação aos códigos ativados.

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

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

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.

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.

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

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

A empresa bureaux de impressão deverá estar preparada para processar o arquivo, mesclando as informações com o arquivo de recibos através dos campos CODIGO_CONDOMINIO e CODIGO_DA_UNIDADE de acordo com o layout de impressão para o lançamento.

Um exemplo do arquivo de condôminos 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.

A empresa bureaux de impressão deverá estar preparada para processar o arquivo, mesclando as informações com o arquivo de recibos através do campo CODIGO_DO_IMOVEL de acordo com o layout de impressão para o lançamento.

Um exemplo do arquivo de locatários 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.

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