Minimum requirements:

• .NET Framework 4.7.2
• Database in SQL Server 2016 or above
• Sage 2021 version or above

Introdução

O SmartRecycle é um produto que se destina á comunicação com as máquinas RVM, permitindo a leitura e abatimento dos valores de vasilhame das garrafas, cumprindo com o DL 152-D/2017.

Manual de instalação

O processo de instalação da extensibilidade é bastante simples. 
Pedimos ao utilizador que siga os passos abaixo indicados para instalar a extensibilidade SmartPrice.
Para a utilização da extensibilidade a base de dados deve correr numa versão SQL Server 2016 ou superior.

Passo 1 – Instalação da extensibilidade

Executar o exe de instalação do produto como administrador.

Passo 2 – Configurar o Sage

Abrir o BackOffice do Sage > Clicar no botão do menu > Clicar no botão “Personalização” > Clicar no botão “Parametrizações funcionais”

Ao abrir a janela dos “Parâmetros”, clicar no botão “Integração de Dados”. 

No sub-menu “Extensibilidade” preencher o campo “Ponto de entrada para a classe ISageExtender:” com o seguinte texto sem aspas.
“SmartDigit.SmartRecycle.Sage50c”

Alterar a opção “Carrega o módulo da extensibilidade em:” para a adequada.

Deve agora clicar no botão “Fechar e gravar” deverá depois reiniciar o Sage para as configurações serem aplicadas.

Manual de Configuração

A extensibilidade foi desenvolvida com o foco de ser simples e intuitiva, no entanto abaixo pode encontrar as descrições das funcionalidades.
Nos parâmetros encontra as settings do SmartRecycle

Perfil: Selecionar os varios perfil que existam criados
Provider: Provider ao qual vamos fazer a ligação (RvmSystems, Tomca, manual, etc)
Activo: Estado do perfil
Nome do Perfil: Nome do perfil criado
Perfil padrão: Caso exista varios perfils, para varios providers, indicamos qual o padrão.

Modalidade de Pagamento: Modalidade de pagamento a usar, com as recentes atualizações da Sage, apenas são aceites modalidades de pagamento do tipo OU.
Sére Retorno: Serie a usar quando fazemos o pagamento em numerário ao cliente
Doc. Retorno: Documento a usar quando fazemos o pagamento em numerário ao cliente

Base API URL: Fornecido pelo provider da maquina RVM
Auth URL: Fornecido pelo provider da maquina RVM
Client ID: Fornecido pelo provider da maquina RVM
Cliente Secret: Fornecido pelo provider da maquina RVM
Scope: Fornecido pelo provider da maquina RVM

No final de garantirmos que as settings estão corretas, temos o botão “testar ligação”, onde verificamos se tudo foi preenchido corretamente.

Manual de utilização

Tendo todas as configurações feitas anteriormente, podemos agora recolher as leituras emitidas pela maquina.
Para tal existem dois tipos de operação que podemos fazer.

Abater talão na venda – Onde o cliente trás o talão emitido pela máquina e quer usar o saldo para abater na venda em curso
Devolução em Numerário – Onde o cliente trás o talão emitido pela máquina e quer receber o valor sem efetuar qualquer compra no estabelecimento.

Para auxiliar todo este processo foram criadas duas funcões POS, que podem ser usadas tanto em POS como em backoffice.
Caso seja para usar o valor como modalidade de pagamento usamos a função SR.VOUCHER
Caso seja para devolver o valor ao cliente, dando uma saida de caixa, usamos a função SR.VOUCHER.RETURN

Ao usarmos o botão com a funcção SR.VOUCHER irá ser mostrada a seguinte janela

No campo “Codigo Voucher” é onde lemos o código de barras emitido pela maquina RVM, ao ler vamos validar o mesmo.
Podemos ler todos os códigos de barras (talões) que o cliente tenha.
Ao ler e passar a validação com sucesso, o valor do “total abatido” é atualizado.
ao carregar em confirmar o valor será transportado para modalidade de pagamento.

A função SR.VOUCHER.RETURN é igual á vista anteriormente, a diferença é que não lança o valor em modalidade de pagamento, mas sim numa saida de caixa.