9 versões 44 entradas Actualizado em 17/08/2026

Nenhuma novidade encontrada para esta pesquisa.

Corrigida falha ao validar vouchers em terminais Envipco

Corrigido um erro que, nalguns postos, impedia a validação de vouchers de reciclagem em terminais Envipco, mostrando a mensagem "Erro ao validar voucher". A ligação ao servidor Envipco foi tornada mais robusta, permitindo validar e resgatar os vouchers normalmente em qualquer posto.

Manual (Recycle)

Visão geral

Introdução

O SmartRecycle é um add-on para Sage 50 destinado à integração com o Sistema de Depósito e Reembolso (SDR). Permite validar os vales/talões emitidos por máquinas de recolha automática (RVM) e tratar o respetivo valor no Sage, quer como meio de pagamento numa venda, quer como reembolso ao consumidor.

Nota sobre modalidades SDR Não confundir o tipo da modalidade de pagamento no Sage com o código exportado para SAF-T. A configuração deve respeitar o fluxo SDR definido no Sage e a integração utilizada pelo SmartRecycle.
.NET FrameworkVersão 4.7.2
Base de dadosSQL Server 2016 ou superior
Sage 50Versão 2026.01.03 ou superior
Preparação

Instalação

1. Instalar a extensibilidade

Execute o instalador do SmartRecycle com a opção Executar como administrador.

Instalação do SmartRecycle
Instalação da extensibilidade SmartRecycle.

2. Configurar o Sage

  1. No BackOffice do Sage, aceda a Menu → Personalização → Parametrizações funcionais.
    Acesso às Parametrizações funcionais
  2. Abra Integração de Dados.
    Integração de Dados
  3. No separador Extensibilidade, defina o ponto de entrada da classe.
    SmartDigit.SmartRecycle.Sage50c
  4. Selecione os módulos/postos onde a extensibilidade deverá ser carregada.
    Configuração da extensibilidade
  5. Clique em Fechar e gravar e reinicie o Sage.
Perfis

Configuração do SmartRecycle

As opções do SmartRecycle estão disponíveis nas parametrizações da extensibilidade. Em ecrãs de baixa resolução, utilize a função SR.SETTINGS para abrir a configuração numa janela redimensionável.

Janela de configuração do SmartRecycle
Configuração do perfil SmartRecycle.
Campo Descrição
Perfil Seleciona um dos perfis SmartRecycle existentes.
Provider Sistema com o qual é efetuada a comunicação, por exemplo RVM Systems, ENVIPCO, TOMRA ou modo Manual, quando disponível.
Ativo Define se o perfil está disponível para utilização.
Nome do perfil Identificação atribuída ao perfil.
Perfil padrão Perfil utilizado por omissão quando existem vários perfis.
Modalidade de pagamento Modalidade utilizada quando o vale/talão é aplicado numa venda.
Modalidade de pagamento de retorno Modalidade usada quando o valor é devolvido ao cliente. Quando a saída física é efetuada por caixa forte/reciclador, deve corresponder ao fluxo em Dinheiro exigido pela integração.
Enter confirma vouchers validados Permite confirmar automaticamente a operação com Enter após validação do voucher.
Validar códigos de barras internamente No modo Manual, permite restringir a validação a códigos existentes no Sage.
Reembolso

Tipo de retorno

A função SR.VOUCHER.RETURN pode tratar o reembolso por duas vias, de acordo com a configuração escolhida.

Saída de Caixa

O SmartRecycle efetua diretamente um movimento de saída de caixa correspondente ao valor devolvido ao cliente.

Documento de Venda

O SmartRecycle cria um documento interno configurado para representar a saída do valor. É o modo recomendado quando existe uma integração intermédia com caixa forte/reciclador.

Configuração do documento de retorno
Exemplo de documento interno utilizado no retorno.
Série de retorno Série utilizada na criação do documento de retorno. Quando aplicável, pode ser usada a série padrão do posto.
Documento de retorno Documento interno utilizado quando o tipo de retorno está definido como Documento de Venda.
Integração crítica

Caixas fortes

Quando o SmartRecycle é utilizado em conjunto com um add-on de caixa forte ou reciclador de numerário, a criação do documento no Sage não é suficiente. O add-on responsável pela máquina tem também de aceitar esse documento e reconhecer a modalidade como movimento em dinheiro.

Configuração validada para retorno através de Caixas Fortes Use esta parametrização quando a devolução do valor é feita fisicamente pela máquina.
Parâmetro Valor
Tipo de retorno Documento de Venda
Documento de retorno SCV — Saída caixa Venda
Modalidade de pagamento de retorno Dinheiro
Add-on das caixas fortes Adicionar SCV — Saída caixa Venda à lista de documentos permitidos/processados.
Se o documento é criado mas a caixa forte não devolve dinheiro A primeira verificação deve ser a autorização do documento SCV no add-on das caixas fortes e a configuração da Modalidade de pagamento de retorno = Dinheiro.

Diagnóstico rápido

  • O voucher foi validado com sucesso.
  • O tipo de retorno está definido como Documento de Venda.
  • O documento selecionado é SCV — Saída caixa Venda.
  • O documento SCV está autorizado no add-on das caixas fortes.
  • A modalidade de pagamento de retorno é Dinheiro.
  • O perfil da Glory está preparado para movimentos em numerário.
Comunicações

Dados de acesso à API / Provider

Os dados de acesso dependem do provider selecionado. Os valores necessários para cada integração devem ser fornecidos pelo respetivo fabricante ou operador da RVM.

Modo Manual Quando existe comunicação direta com o ecossistema SDR sem ligação a uma RVM, devem ser utilizados os acessos disponibilizados especificamente para esse modo.
Artigos

Associação do artigo SDR

O SmartRecycle disponibiliza uma associação própria entre o artigo da embalagem e o artigo utilizado para representar o depósito SDR. Esta funcionalidade é opcional e pode substituir a associação padrão efetuada no Sage.

Configuração da associação SDR
Configuração da associação de artigos SDR no SmartRecycle.

Aplicação em compras

Permite associar automaticamente o artigo do depósito SDR quando é registada a compra do artigo principal.

Ligação automática

As quantidades do artigo principal e do artigo SDR permanecem relacionadas.

Aplicação em vendas

Permite aplicar a associação nos documentos de venda configurados.

Campo “Usar SDR”

Facilita relatórios, layouts de etiquetas e outras personalizações.

Associação padrão do Sage

Associação padrão do Sage
Método de associação padrão no Sage.

Associação através do SmartRecycle

Separador SmartRecycle na ficha do artigo
Separador adicional do SmartRecycle na ficha do artigo.
Ativo Ativa a configuração SmartRecycle para o artigo.
Artigo extra personalizado Artigo do tipo Taxa a associar ao artigo principal.
Aplicar em vendas Aplica a associação nos documentos de venda.
Aplicar em compras Aplica a associação nos documentos de compra.
Campo extra “Usar SDR” Permite identificar artigos abrangidos pelo SDR para relatórios, impressão ou etiquetas.
Funcionalidade opcional Pode continuar a utilizar o método de associação disponibilizado pelo Sage se não pretender usar a associação própria do SmartRecycle.
Postos

Teste de ligação e configuração por posto

Depois de preencher o perfil, utilize o botão Testar ligação para validar os dados de comunicação.

Botão Testar ligação
Botão para validar a comunicação do perfil.

De seguida, aceda à configuração dos postos e defina, para cada posto, quais os perfis SmartRecycle disponíveis e qual o perfil utilizado por omissão.

Configuração do perfil por posto
Perfis SmartRecycle ativos e perfil padrão por posto.
Operação

Manual de utilização

Depois de concluída a configuração, o SmartRecycle permite tratar os vales/talões emitidos pelas RVM através de dois fluxos principais.

Usar o talão numa venda

O cliente apresenta o vale/talão e o respetivo valor é aplicado ao fluxo de pagamento da venda.

Reembolso sem compra

O cliente apresenta o vale/talão e recebe o valor correspondente sem efetuar uma compra.

Funções POS

SR.VOUCHER Valida o vale/talão e utiliza o respetivo valor no fluxo de pagamento da venda.
SR.VOUCHER.RETURN Valida o vale/talão e processa o reembolso de acordo com o tipo de retorno configurado.
SR.SETTINGS Abre a configuração do SmartRecycle numa janela redimensionável.
Exemplo de funções POS SmartRecycle
Exemplo de botões POS configurados para o SmartRecycle.

Utilizar um voucher numa venda — SR.VOUCHER

Ao executar a função SR.VOUCHER, é apresentada a janela de validação do voucher.

Janela de validação do voucher
Leitura e validação de vouchers no SmartRecycle.
  1. No campo Código Voucher, leia o código de barras do talão emitido pela RVM.
  2. O SmartRecycle valida o voucher junto do provider configurado.
  3. Podem ser introduzidos vários vouchers na mesma operação, quando suportado pelo fluxo configurado.
  4. Após cada validação com sucesso, o campo Total abatido é atualizado.
  5. Ao confirmar, o valor é aplicado ao fluxo de pagamento configurado.

Reembolsar um voucher — SR.VOUCHER.RETURN

A leitura e validação são semelhantes às da função SR.VOUCHER. A diferença é o destino do valor: em vez de ser utilizado para liquidar uma venda, é processado como reembolso ao cliente.

Exemplo Glory Se o voucher for validado e o documento for criado no Sage, mas a máquina não dispensar o dinheiro, confirme prioritariamente SCV autorizado no add-on e Modalidade de pagamento de retorno = Dinheiro .
Documentação

Referências

Downloads

Ficheiro Tamanho Data
RECYCLE202302001.v21.05.14.exe 70 MB 07/08/2026 Descarregar
RECYCLE202302001.v21.05.13.exe 70 MB 30/07/2026 Descarregar
RECYCLE202302001.v21.05.12.exe 70 MB 27/07/2026 Descarregar