Com o intuito de disponibilizar as ferramentas necessárias para o bom desempenho de sua farmácia, a Linx traz inovações e melhorias para o Linx Softpharma, que foram aplicadas na Release 206.0, e através deste informativo vamos abordar sobre a integração com o Internet Banking.
Maiores informações referentes a esta inovação e as demais, serão detalhadas neste documento com a finalidade de trazer maior credibilidade e garantir a excelência dos processos administrativos da sua farmácia.
Integração Internet Banking
Para utilizar a funcionalidade é necessário ter o produto 133 - Integração Open Banking - 1.0 liberado para a filial. Para liberá-lo entre em contato com o nosso comercial.
Objetivo
Este programa é utilizado para gerenciar as contas bancárias Stones existentes, sendo listadas as contas Stones existentes para o CNPJs de suas lojas e que tenha sido realizado o processo de consentimento de acesso desta conta.
Ao acessar esta tela, serão listadas as contas Stones liberadas para que o Softpharma possa realizar movimentações financeiras utilizando estas contas. Para que uma conta possa ser utilizada para realizar operações na conta Stone, é necessário vincular esta conta a uma conta bancária do Softpharma (detalhamento descrito no item Vincular conta). A listagem de contas indica através de ícones se a conta Stone esta ou não vinculada a uma conta Softpharma.
Figura 01 - Conta Stone
Caso ao abrir esta tela não seja listado nenhuma conta ou faltar contas a serem exibidas se:
- Alguma de suas filiais já possuir conta Stone:
- Solicitar a busca da conta através do botão "Buscar conta Stone" - se houver conta cadastrada esta será listada na tela principal;
- Se nenhuma conta retornada na consulta anterior, solicitar consentimento de acesso a esta conta - Solicitar consentimento de acesso a conta.
- Se nenhuma filial possuir conta Stone - há opção de solicitar a criação de uma nova conta Stone a partir do Linx Softpharma - conforme descrito no item - Cadastrar nova conta Stone.
Buscar Conta Stone
Ao selecionar esta opção, será consultado na Stone se há alguma nova conta liberada para o CNPJ de suas filiais, se houver esta conta será inserida na listagem de contas Stone, poderá ser retornada mais de uma conta.
Caso não haja conta Stone liberada para sua filial, será exibida tela onde o usuário poderá:
- Cadastrar conta digital Stone - opção para iniciar a solicitação de abertura de conta na Stone - mais informações em Cadastrar nova conta Stone;
- Consentimento Stone - opção para solicitar acesso a conta - mais informações em Solicitar consentimento de acesso a conta.
Figura 02 - Buscar Conta Stone
Vincular Conta
Para que uma conta Stone possa ser utilizada no Softpharma é necessário que esta conta seja vinculada a uma conta bancária no cadastro de conta do Softpharma. Ao realizar o vinculo entre estas contas, serão adicionados informações complementares.
Ao selecionar uma conta Stone na listagem, se a conta já estiver vinculada, será exibida uma tela de edição deste vinculo, se não houver vinculo será exibido uma tela para criar o vinculo.
Dados de Vinculo de conta
- Opção de criação de conta:
- Conta existente - deverá ser selecionada uma conta bancária já existente no Softpharma. Sugestão de uso, quando já possuir conta Stone em uso no Softpharma, sendo esta utilizada para o Internet Banking;
- Nova conta - será criada uma nova conta bancária no cadastro do Softpharma, sendo número da conta, banco e titular os valores da conta Stone correspondente.
- ID da conta Stone - identificador da conta.
- Conta principal.
Figura 03 - Vincular Conta
Multa
Dias de Atraso: Data que define o dia a partir do qual a multa passam a ser aplicados ao boleto. Só é aceito no boleto de cobrança.
Valor percentual (%): Percentual da multa que será aplicada ao boleto. O valor do deve ser maior que 0.0 e até 2.0. Só é aceito no boleto de cobrança.
A multa é cobrada uma única vez.
A multa passa a contar a partir da data informada. Essa data tem que ser maior que o vencimento e menor que data limite.
Nos casos em que a data de vencimento cai em um dia não útil ela é automaticamente estendida para o próximo dia útil e a multa só passará a ser aplicada depois dessa data.
Campo não obrigatório, só preencher se for aplicar multa.
Juros
Dias de Atraso: Data que define o dia a partir do qual os juros passam a ser aplicados ao boleto. Só é aceito no boleto de cobrança.
Valor percentual (%): Percentual do Juros que será aplicado ao boleto por mês. O valor do deve ser maior que 0.0 e até 1.0. Só é aceito no boleto de cobrança.
O valor é aplicado por dia, levando em conta o valor proporcional, dado o juro mensal. Ex: 1% ao mês, seria 0,033% ao dia.
Os juros passam a contar a partir da data informada. Essa data tem que ser maior que o vencimento e menor que a data limite.
Nos casos em que a data de vencimento cai em um dia não útil, ela é automaticamente estendida para o próximo dia útil e os juros só passam a ser aplicados depois dessa data.
Campo não obrigatório, só preencher se for aplicar juros.
Taxa de Emissão
Está taxa é opcional. A tarifa do boleto bancário, também conhecida por TEC – Tarifa de Emissão do Carnê/Boleto, é a taxa cobrada para a emissão do boleto bancário. Essa taxa é variável conforme a negociação com o banco ou emissor do boleto.
Check-box: Adicionar taxa de emissão ao valor do boleto a ser gerado
Quando não marcado: O valor do boleto gerado será o valor do título correspondente, sendo a taxa de emissão do boleto uma despesa da Farmácia.
Quando marcado: O valor do boleto gerado será o valor do título correspondente mais o valor da taxa de emissão informada, sendo essa taxa de emissão cobrada adicionalmente no boleto.
Informação adicional: Caso não seja cobrado taxa de emissão de boleto, será lançado um contas a receber referente a taxa de emissão do boleto que o cliente pagou, porém não foi cobrada pela Stone. Este contas a receber será lançado como pago.
Data Limite Pagamento Após o Vencimento
Para os boletos do tipo cobrança, informe neste campo até quantos dias após o vencimento o boleto poderá ser recebido.
Caso o boleto tenha sido pago após esta data, estes serão devolvidos. Se não informado valor para este campo, a data limite de pagamento será a data de vencimento do boleto.
Deve ser maior que a data de vencimento, podendo ser até 365 dias após a data de emissão.
Caso seja um dia não útil, o pagamento poderá ser feito até o próximo dia útil. Os boletos que forem pagos após a data limite serão devolvidos.
Marcar Principal
O objetivo desta funcionalidade é informar qual conta Stone será utilizada na filial, como principal.
- Para cada filial pode haver somente uma conta principal, se alguma das filiais selecionada estiver marcada com outra conta como principal, esta configuração será alterada.
Figura 04 - Marcar Principal
Conta Principal
Caso a Farmácia utilize mais de um conta Stone, poderá ser informado uma Conta Principal como Sugestão em telas onde há a necessidade de selecionar uma conta, sendo está selecionada por padrão.
Cadastrar Nova Conta
Caso seja necessário a abertura de uma nova conta Stone. Poderá preencher os dados inicias dentro do Linx Softpharma para solicitação de abertura.
Figura 05 - Cadastrar Nova Conta
Criar Conta Stone
Após esta solicitação a abertura da conta passará por um processo de avaliação pela Stone, sendo comunicado no e-mail informado sobre o andamento do processo.
Fluxo de Consentimento
A partir da abertura de conta realizada pelo usuário, uma plataforma poderá solicitar acesso ao compartilhamento de informações e iniciação de pagamentos na conta de um usuário. Para isso, deverá gerar um Link de Consentimento.
Solicitar Consentimento
Será direcionado a uma pagina web, aonde será solicitado o Login e Senha, para posterior aceite do consentimento para habilitar a exibição da conta Stone no Linx Softpharma.
Figura 06 - Solicitar Consentimento
O que é o Consentimento
O Consentimento é um conceito fundamental no Open Banking, pois a partir da realização desse processo, um usuário poderá permitir o compartilhamento de suas informações entre diferentes instituições autorizadas pelo Banco Central e a movimentação de suas contas bancárias a partir de diferentes plataformas e não apenas pelo aplicativo ou site do banco, de forma segura, ágil e conveniente.
Usuário acessa o link e dá consentimento ao parceiro
Ao acessar o link, o usuário será direcionado para uma página da Stone em que irá escolher a quais contas de pagamento ele deseja conceder acesso ao SoftPharma. Ele também poderá verificar a quais escopos o SoftPharma passará a ter acesso após dar consentimento. Uma vez dado o consentimento, o usuário deverá ser direcionado de volta a página da Stone.
Veja abaixo um exemplo da tela de pedido de consentimento que será disponibilizada ao cliente:
Figura 07 - Conceder Permissão
Veja abaixo um exemplo de permissão concedida:
Figura 08 - Permissão Concedida
Ao clicar no botão “Ok, entendi”, o usuário será redirecionado para a página da Stone.
WebHook
Processo de atualização de dados, o objetivo principal desta tela é auxiliar o time de suporte com as informações de envio e recebimento do Internet Banking.
Figura 09 - WebHook
Overview
A ocorrência de certos eventos pode ser importante em diversos fluxos da integração de uma aplicação com a Stone Banking API. Por isso, utilizamos o webhook para notificar as aplicações integradas da ocorrência desses eventos.
Exemplo: Envio e Retorno das Movimentações, Baixa de Pagamento e Baixa de Recebimentos.
A aplicação irá receber webhooks dos eventos que acontecerem na(s) conta(s) sobre as quais ela opera e também recebem os eventos relacionados às contas sobre as quais foi dado consentimento.
Gerar Boleto Stone
Programa para emissão de boletos de contas a Receber, podendo ser títulos de clientes ou de convênios.
- Será gerado um boleto para cada título selecionado.
Para realizar a geração do boleto, acessar: Lançamentos → Contas a Receber → Movimento
- Selecionar o título que deseja gerar o Boleto Stone, selecionar o mesmo no GRID, clicar no ícone Internet Banking → Gerar Boleto Stone
Figura 10 - Contas a Receber - Movimento
Posteriormente será aberto a tela Boletos Stone, que apresentará os dados do boleto.
Figura 11 - Gerar Boleto Stone
Tipo de boleto - Opção do tipo de boleto a ser gerado.
- Conterá as seguintes opções:
- Cobrança - Opção selecionada por padrão
Boleto para cobrar por um serviço prestado, por um produto entregue ou para o pagamento de uma dívida de uma obrigação legal. Possibilita a inclusão de descontos, juros e multa. - Proposta
Boleto emitido antes da prestação de um serviço ou da entrega de um produto, como uma oferta, sendo o seu pagamento considerado o aceite da negociação. Também pode ser usado como proposta de um contrato e como convite para uma associação. Como ele é facultativo, o seu não pagamento não dará causa a protesto, cobranças e/ou inclusão em cadastros restritivos. Possibilita inclusão de desconto para pagamento do boleto antes do vencimento.
- Cobrança - Opção selecionada por padrão
Caso o cliente deseje dar um Desconto para pagamentos antecipados, "antes da data do vencimento do boleto", poderá ser concedido uma porcentagem de desconto no campo: Desconto no Boleto
Retorno Criação de Boleto
Nesta tela será apresentado o retorno do boleto, podendo ser um retorno positivo ou negativo, caso não siga as Regras para Geração.
Figura 12 - Criação de Boletos - Sucesso
Figura 13 - Criação de Boletos - Erro
Figura 14 - Consulta e Lançamento de Clientes
Gerenciar Boletos
Ao selecionar esta opção em: Lançamentos → Contas a Receber → Movimento → clicar no ícone Internet Banking → Gerenciador Boletos.
Abrirá o gerenciador de boletos emitidos Stone. Aonde o usuário pode visualizar as últimas atualizações automáticas realizadas pelo sistema, como forma de identificar quais ações (baixas, cancelamentos, agendamentos) foram realizadas na conta bancária.
Figura 15 - Gerenciar Boletos
Alteração
Foi adicionado uma nova aba Internet Banking, com o objetivo de visualizar as informações do boleto gerado e também com as funcionalidades de:
Situação: Atualizar o status do boleto;
Baixar Boleto: Será baixado automaticamente o boleto para a pasta C:\Softpharma\exportacao\Boletos\stone;
Excluir Boleto: Realizar o cancelamento do boleto de cobrança emitido. Será excluído apenas boletos que estiverem com situação diferente de pago.
Figura 16 - Alteração
WebHook
Informação adicional: A API da Stone possui um limite de consulta diária, desta forma não faremos a consulta automaticamente ao acessar a tela. Haverá a opção de utilizar o Webhook para realizar a atualização das informações, desta forma quando alguma informação da conta for alterada, a API da Stone notificará esse Webhook sobre a alteração da informação.
Pagamento Convênio
Para realizar a geração do boleto, acessar: Lançamentos → Contas a Receber → Pagamento de Convênio
Informar o convênio, selecionar o lançamento que deseja realizar a emissão do boleto, e acessar o ícone: Internet Banking, selecionar a Chave de Fechamento → Gerar Boleto Internet Stone
Figura 17 - Pagamento de Convênio
Gerar boleto Stone
Segue a mesma tratativa do Contas a Receber - Movimento de Cliente - Gerar boleto Stone
Fechamento de Convênio
Ao realizar o processo de fechamento de convênio, os títulos de clientes contidos neste convênio que possuem boletos não deverão ser considerados no fechamento de convênio.
Informação adicional: Esta validação será realizada tanto para o fechamento oficial quanto para o fechamento não oficial, para que não haja divergência de valores entre estes relatórios.
Gerenciar Boletos
Segue a mesma tratativa do Contas a Receber - Movimento de Cliente - Gerenciar Boletos
Novo Lançamento
Permite realizar a inclusão de um pagamento com boleto e também à possibilidade de realizar a consulta dos dados do boleto no Internet Banking.
Figura 18 - Novo Lançamento
Alteração
Possibilidade de realizar a consulta ou a troca do código de barras do boleto.
Figura 19 - Alteração de Lançamento
Vincular Cód. Barras
A função de vincular código de barras, permite ao usuário realizar a leitura de um código de barra e o sistema localiza as duplicatas que podem estar associadas ao boleto, permitindo assim que o cliente localize rapidamente o título do boleto recebido. Desta forma, será adicionado a opção de realizar consulta de boleto e pagamento deste.
Figura 20 - Vincular Código de Barras
Opção Consulta Boleto
- Ao selecionar esta opção, executa a consulta dos dados dos boletos selecionados.
Figura 21 - Boleto Internet Banking
Opção Pagar Boleto
- Está opção é liberada somente se a duplicada selecionada na listagem se enquadre no código de barra consultado.
- Gera a ordem de pagamento para o boleto selecionado.
Botão "Atualizar Status"
- Ao selecionar esta opção, realizar a consulta do pagamento das ordens de pagamentos selecionadas
Botão "Excluir ordem de pagamento"
- Esta opção exclui as ordens de pagamento selecionadas do Softpharma, somente serão excluídas as ordens de pagamento que possuírem uma das situações abaixo:
Falha;
Cancelada;
Rejeitada;
Expirada.
Internet Banking
Gerenciador de Pagamento
Ao selecionar esta opção abrirá o programa de gerenciador de pagamentos Internet Banking:
Figura 22 - Gerenciador de Pagamentos Internet Banking
Pagar Internet Banking
Ao selecionar esta opção abrirá o programa para incluir ordem de pagamento Internet Banking Stone:
Figura 23 - Pagar Boletos Internet Banking
Poderá ser realizado a consulta do saldo pelo ícone: 
Também poderá ser realizado o Pagamento/Agendamento com as seguintes datas:
Data Atual;
Data do Título;
Data Específica.
Controle Bancário
Este programa é utilizado para realizar os lançamentos de transferência entre contas bancárias ou para o Caixa Financeiro, bem como os valores de Débito e Crédito que estão no extrato emitido pelo Banco, por exemplo: juros, taxas, etc.
Figura 24 - Controle Bancário
Lançamentos Bancários
Nesta tela poderá ser visualizado o Lançamento das informações referente aos pagamentos recebidos/efetuados.
Figura 25 - Lançamentos Bancários
Extrato Bancário Internet Banking
Este programa é utilizado para controle dos lançamentos efetuados pelo Internet Banking, referente aos pagamentos recebidos/efetuados.
Figura 26 - Extrato Bancário Internet Banking
Wizard - Assistente de Configuração Internet Banking
Introdução
Assistente ou Wizard é um padrão de projeto de software amplamente utilizado em interface gráfica do usuário para prover um meio simples de realizar tarefas complexas em sistemas computacionais, através de um esquema passo-a-passo.
Objetivo
Seu objetivo é diminuir a grande quantidade de validações simultâneas em uma única tela de um software, evitando que o usuário tenha que preencher diversas informações e submeter ao sistema para que seja validado, sendo que uma pequena parcela dessas informações pode inviabilizar o processo. A solução é dividir a interação do usuário com o sistema em pequenas etapas guiadas, promovendo as validações necessárias entre cada etapa e proporcionando ao usuário ajuda para interação com cada tela provida pelo sistema.
Utilização
Sua forma de utilização se resume em uma série de etapas tendo, cada uma, opções que podem ser escolhidas pelos usuários até que se chegue em uma tela final. É comumente utilizado na hora da instalação de softwares, onde o usuário interage com o instalador em diversas telas onde após preencher um conjunto de informações requeridas para a continuidade da instalação.
Passo-a-Passo
Após realizar o processo de Buscar a Conta Stone e posteriormente, realizar o Vinculo da Conta, será aberto um Wizard, com o passo-a-passo de todas as etapas necessárias para o início da emissão dos boletos.
1º Etapa - Selecionar conta a ser configurada: Irá listar as contas que foram localizadas na Stone, será necessário selecionar a conta que deseja configurar.
Cancelar: Caso seja selecionado esta opção, as configurações informadas serão perdidas.
2º Etapa - Vincular contas: Irá solicitar o vinculo da Conta Bancária, existindo duas opções:
1 - Check-box: Vincular a conta Stone a uma conta existente no cadastro de conta bancária Softpharma.
2 - Check-box: Criar uma nova conta no cadastro de conta bancária Softpharma utilizando os dados da conta Stone.
Voltar: Quando na Etapa 2, ao voltar a informação de vincular conta será perdida.
3º Etapa - Emissão de boletos: Configuração de emissão de boletos, opção para informar se irá ou não cobrar Juros e Multa, e até quantos dias após o vencimento o boleto poderá ser recebido.
1 - Opção Não Cobrar
2 - Opção Cobrar
4º Etapa - Taxa de emissão: Ao receber um boleto que possui cobrança de taxa de emissão, será realizado um lançamento de contas a pagar (já pago/baixado) referente a taxa cobrada pela Stone pelo boleto, sendo necessário a configuração de um Fornecedor para o lançamento destas taxas.
5º Etapa - Emissão não cobrada: Opção onde o cliente pode optar se será ou não será feita a cobrança da taxa de emissão do boleto, adicionando ou não a taxa ao valor do boleto a ser gerado.
1 - Opção Não será
2 - Opção Será
6º Etapa - Servidor de e-mail: Configuração Não Obrigatória.
1 - Caso cliente opte por enviar os boletos gerados por e-mail, realizar as configurações necessárias solicitadas em tela.
2 - Caso não seja realizado a configuração, não será possível utilizar os recursos de envio de e-mail de boletos emitidos.
7º Etapa - Atualização automática: Caso cliente deseja ou não realizar a atualização automática das movimentações realizadas no Internet Banking.
1 - Opção Utilizar
2 - Opção Não utilizar
Finalização do Processo de Configuração
- Caso haja mais alguma conta a ser configurada, será direcionada para a Etapa 1.
- Caso necessário alterar alguma informação após finalizar esta configuração, basta selecionar a conta e selecionar a opção Vincular Conta, nesta tela haverá as mesmas configurações existentes neste Wizard.