Baú da Felicidade
A integração com o Baú da Felicidade no módulo PDV permite que a farmácia ofereça aos seus clientes o carnê do programa diretamente no ponto de venda, além de possibilitar o recebimento das parcelas de forma prática e flexível na própria farmácia. Com a integração ativa, a farmácia pode, por meio do sistema Vetor Farma, gerenciar os recebimentos realizados por meio do relatório cubo dinâmico, ou gerar um arquivo no formato .txt, contendo todas as informações, o qual possibilita o repasse das informações para fins de faturamento e participação dos clientes aos sorteios, garantindo maior segurança, confiabilidade e agilidade na transmissão dos dados.
- É importante destacar que tanto a geração quanto o envio do arquivo contendo os dados das transações são de responsabilidade da própria farmácia e são realizados manualmente.
- As etapas desta operação estão organizadas em passos, contemplando a configuração da integração no sistema Vetor, a realização do pagamento dos carnês no PDV e a emissão do relatório de comprovantes com o envio das informações ao programa. Ressalta-se que o primeiro passo, referente à configuração da integração, é realizado exclusivamente pela equipe de Suporte Zetti Tech.
Pré-requisitos
Para realizar a integração deste recurso, é essencial que o cliente tenha contratado o serviço do Baú da Felicidade e que a implantação tenha sido devidamente liberada pelo setor comercial.
Após a contratação e a liberação comercial, nossa equipe de atendimento entrará em contato para captar as informações necessárias e iniciar as configuração da integração. Essa configuração é realizada por meio de parâmetros por empresa e parâmetros por filial, os quais são configuráveis exclusivamente pela equipe interna da Zetti Tech, conforme descrito a seguir.
1º Passo - Configuração da integração
Nesta etapa inicial, o agente autorizado realizará a configuração da integração do Baú da Felicidade no sistema Vetor Farma. Esse processo consiste na habilitação dos parâmetros por empresa e do parâmetro por filial, responsáveis por habilitar a comunicação com a API do programa e permitir o recebimento dos carnês no PDV. As chaves a seguir devem ser aplicadas conforme orientação das documentações específicas para configuração dos parâmetros do sistema, garantindo o correto funcionamento da integração. Clique aqui para acessar a documentação que explica o passo a passo do processo de configuração de parâmetros e habilite as chaves considerando as seguintes observações:
- Parâmetros por empresa
Os parâmetros por empresa são responsáveis por estabelecer a comunicação com a API do Baú da Felicidade e definir as regras gerais da integração para todas as filiais vinculadas.
- URL_API_BAU_FELICIDADE: Informe a URL de acesso à API do Baú da Felicidade, utilizada para a comunicação entre o sistema Vetor e o programa.
- LOGIN_API_BAU_FELICIDADE: Cadastre o usuário que será utilizado para autenticação e acesso à API do Baú da Felicidade.
- SENHA_API_BAU_FELICIDADE: Configure a senha correspondente ao usuário cadastrado, necessária para a autenticação segura na API.
- CODIGO_LOCAL_PAGAMENTO_BAU_FELICIDADE: Informe o código do local de pagamento onde os carnês serão processados. Essa informação é fornecida pela equipe da Jequiti.
- NOME_LOCAL_PAGAMENTO_BAU_FELICIDADE: Defina o nome do local de pagamento, conforme cadastro e orientação da equipe da Jequiti.
- DIAS_REPASSE_BAU_FELICIDADE: Informe a quantidade de dias necessários para que os valores dos carnês pagos no estabelecimento sejam repassados à Jequiti.
- Parâmetro por filial
O parâmetro por filial controla a ativação da integração em cada unidade, permitindo que apenas as filiais habilitadas realizem o recebimento dos carnês.
- HABILITA_INTEGRACAO_BAU_FELICIDADE: Responsável por habilitar a integração na filial que realizará o recebimento dos carnês.
Após a conclusão da configuração dos parâmetros e a habilitação da integração, os usuários da filial configurada estarão aptos a utilizar o recurso do Baú da Felicidade diretamente no PDV. A partir desse momento, a opção ficará disponível na tela de "Atalhos", no módulo PDV, permitindo o recebimento dos carnês, o registro das parcelas pagas e o envio das informações de pagamento ao sistema do Baú da Felicidade de forma integrada e segura. Confira a seguir como o operador de caixa deve registrar o recebimento do carnê.
2º Passo - Recebimento do carnê (Baú da Felicidade)
Os recebimentos do carnê podem ser realizados diretamente no módulo PDV pelo operador de caixa. Para isso, basta estar com o movimento aberto e, na tela de vendas, acessar o menu lateral >> Outras opções (F1):

Em seguida a tela de “Atalhos” será exibida, ela reúne diversos botões de ação. Entre eles, estará disponível o botão "Baú da Felicidade".

Ao clicar no botão >> Baú da Felicidade, a tela de recebimento será exibida, permitindo que o operador identifique o carnê e informe o valor recebido. Nesta tela, apenas o campo "Valor da transação" estará habilitado para edição. Os demais campos permanecerão desabilitados e serão preenchidos automaticamente após o preenchimento do campo habilitado. Confira os detalhes a seguir:

Utilize o campo "Valor da transação" para informar o código de barras do carnê, seja através da leitura ou digitação do código. Com isso, os outros campos para identificação do documento serão preenchidos automaticamente pelo sistema.

Os campos preenchidos de forma automática correspondem a:
Série: Apresenta a série do carnê, conforme indicado no documento apresentado pelo cliente.
Número do carnê: Indica o número identificador do carnê que será pago.
Número da parcela: Apresenta o número da parcela que está sendo quitada no momento.
Valor da parcela: Exibe o valor correspondente à parcela selecionada, conforme consta no carnê.
Após o preenchimento/conferencia de todos os campos, clique no botão>> Iniciar transação (F7) para dar continuidade ao recebimento e aguarde.

Após processar o início da transação, será exibida a tela "Outros recebimentos". Nesta tela, o campo "Valor a receber" exibirá o valor total da parcela, enquanto o campo "Valor restante" apresentará o mesmo valor, refletindo o total ainda a ser quitado. Os demais campos da tela estarão zerados, pois se referem às diferentes opções de pagamento. O usuário poderá combinar mais de uma forma de pagamento para quitar a parcela, conforme necessário.

Nesta tela, o usuário poderá utilizar a seção localizada à direita do módulo PDV para selecionar a forma de pagamento desejada, entre as opções "Dinheiro", "Cheque" ou "Cartão".

Ao selecionar a opção "Dinheiro", o campo correspondente na tela "Outros Recebimentos" será habilitado, permitindo que o usuário edite o valor a ser pago.

Ao escolher "Cheque" ou "Cartão", será exibida a tela específica para recebimento na modalidade selecionada. Após definir o valor a ser pago em qualquer uma dessas modalidades, o campo correspondente na seção "Outros Recebimentos" será preenchido automaticamente.
Clique aqui para aprender a utilizar a tela de recebimento em "Cheque" e clique aqui para aprender a utilizar a tela de recebimento em "Cartão".

No caso de utilização de mais de uma forma de pagamento, o campo "Valor restante" será atualizado conforme os valores de cada forma de recebimento forem sendo registrados, garantindo o acompanhamento correto do saldo ainda a ser quitado.

Para finalizar o recebimento do carnê, clique no botão "Confirmar (F2)" e clique na opção "Sim", na mensagem exibida em seguida.

Após a confirmação da operação, um cupom não fiscal será gerado automaticamente. De acordo com a configuração do ponto de venda, esse comprovante poderá ser impresso diretamente, caso exista uma impressora configurada, ou salvo no computador na pasta escolhida pelo operador.
É importante destacar que, caso a loja queira realizar a emissão da Nota Fiscal de Serviço, o sistema não realiza essa emissão de forma automática. Sendo assim, a responsabilidade passa a ser exclusivamente da própria farmácia, devendo o usuário acessar o portal autorizado e realizar manualmente a emissão da respectiva Nota Fiscal de Serviço.
É importante destacar que após finalizar o recebimento do cupom, não será possível cancelar a transação. O cancelamento só pode ser realizado enquanto a transação ainda estiver em andamento. Portanto, caso necessário, antes de confirmar o recebimento o usuário poderá cancelar a operação. Para isso, ele deverá clicar em "Voltar (Esc)" na seção à direita.

Em seguida, acionar o atalho >> F11 ou clicar no botão "Cancelar transação (F11)", localizado na lateral esquerda da tela.

Após acionar essa opção, será necessário confirmar a mensagem exibida pelo sistema.

É importante destacar ainda que ao retornar à tela "Baú da Felicidade" após iniciar uma transação, o botão "Recebimentos", localizado à direita da tela, estará habilitado. Ao acioná-lo, o sistema redirecionará o usuário para a tela de "Recebimentos". Portanto, após iniciar uma transação, o único caminho disponível será cancelar ou finalizar a operação. Não é possível sair da tela sem realizar uma dessas duas ações.

Se o operador clicar no botão >>Voltar (Esc) para sair da tela "Baú da felicidade" com uma transação iniciada e não finalizada, um alerta será exibido impedindo a ação, e orientando o operador a finalizar ou cancelar a transação atual.

Após a confirmação do pagamento, será gerado um cupom não fiscal, que poderá ser consultado posteriormente, para fins de gerenciamento dos recebimentos e o PDV retornará para a tela inicial de "Vendas", permitindo que o operador realize outra transação, conforme necessário. Contudo, é necessário gerenciar os registros de recebimento feitos e enviar os dados das transações realizadas ao programa para controle e registro do sorteio. Confira os detalhes sobre essa operação no próximo passo.
3º Passo - Emitir relatório de comprovantes e envio das informações ao programa
Para facilitar o acompanhamento dos recebimentos dos carnês do Baú da Felicidade, o sistema disponibiliza recursos que permitem consultar os comprovantes de recebimentos, gerar um relatório no formato de cubo dinâmico para análise e encaminhar as informações das transações ao programa. Essa operação é realizada no Módulo Vetor Farma. Para conhecer o passo a passo de utilização desses recursos, clique aqui e confira os detalhes.
É importante destacar que tanto a geração quanto o envio do arquivo contendo os dados das transações são de responsabilidade da própria farmácia e são realizados manualmente. Após a geração na solução Vetor Farma, o arquivo deverá ser encaminhado à equipe da Jequiti, conforme as orientações fornecidas por eles, assegurando maior segurança, confiabilidade e agilidade no repasse das informações para fins de faturamento e participação nos sorteios.
Experiências
✍️ Clique aqui, descreva o cenário com a experiência e a tratativa aplicada. Seu relato será avaliado e, se aprovado, contribuirá para a troca de conhecimento.
Nota final
Este tópico tem como objetivo esclarecer pontos específicos e complementares relacionados à documentação, oferecendo informações adicionais que contribuem para uma melhor compreensão do conteúdo apresentado.
Explore outros conteúdos e descubra o passo a passo da operação.