Manual de instalação (SmartNikiConnect)

Criado por Etorre · 02/07/2026 Alterado por Etorre · 18/08/2026

Visão geral

Introdução

O SmartNikiConnect liga o Sage 50 ao Niki: importação de documentos de compra, portal de loyalty, importação de folhetos promocionais, entre outras valências.

.NET FrameworkVersão 4.7.2
Base de dadosSQL Server 2016 ou superior
Sage 50Versão 2021 ou superior
Preparação

Instalação

Execute o instalador do SmartNikiConnect como administrador.

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

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.SmartNikiConnect.Sage50c
  4. Selecione os módulos/postos onde a extensibilidade deverá ser carregada.
    Configuração da extensibilidade SmartNikiConnect
  5. Clique em Fechar e gravar e reinicie o Sage.
Ligação

Configuração da ligação

Nas parametrizações aparece a opção SmartNikiConnect. Os valores são fornecidos pela SmartDigit ou pela entidade à qual se ligam.

Parâmetros de ligação SmartNikiConnect
Parâmetros de ligação SmartNikiConnect.
Loyalty

Gift & Loyalty Card

Configuração Gift e Loyalty Card
Configuração Gift & Loyalty Card.

Ao ler um cartão com saldo, o tipo de movimentação define se o valor entra como desconto direto ou como modalidade de pagamento.

Para gravar os pontos em campos extra do documento Sage, ative Guardar pontos em campos extra. O campo extra deve ser do tipo Texto.

Campo extraDescrição
Pontos créditoPontos atribuídos na venda.
Pontos acumuladoTotal de pontos desde o início.
Pontos débitoPontos gastos na venda.
Pontos saldoSaldo atual do cartão.

Funções POS / backoffice (os nomes das funções são os da aplicação):

NIKI.LOYALITY.CLEANLimpar a operação de loyalty.
NIKI.LOYALITY.SPENDUtilizar saldo/pontos.
NIKI.LOYALITY.SPEND.NOFINISHUtilizar saldo sem finalizar.
NIKI.LOYALITY.RESEND.FORMReenviar o formulário.
Janela das funções de loyalty
Janela ao executar as funções de loyalty.

Ao finalizar a venda é mostrado o quadro das promoções aplicadas:

Promoções aplicadas na venda
Promoções aplicadas.