SmartNikiConnect — SmartDigit

Centro do produto

SmartNikiConnect — conector Niki. Manuais na wiki SmartDigit.

38 versões 69 entradas Actualizado em 25/09/2026

Nova funcionalidade

Modo de teste para experimentar a fidelização sem enviar dados à Niki

Nas definições do cartão de fidelização, no separador "Gift & Loyality Card", está agora disponível a opção "Modo de teste (não enviar pontos/cartões/vales à Niki)". Quando esta opção é ativada, os pontos de fidelização atribuídos numa venda, a atribuição de um cartão físico e as operações de cartão presente deixam de ser enviados à Niki, enquanto a pesquisa de clientes e a pré-visualização de descontos continuam a funcionar normalmente. Sempre que uma operação é ignorada por este motivo, é apresentada uma mensagem a avisar o operador e a venda é gravada sem qualquer bloqueio.

Correcção

Correção de falha intermitente no recálculo da fatura ao gastar pontos de fidelização

Foi corrigida uma falha intermitente do Sage que por vezes ocorria ao recalcular a fatura durante o processo de gastar pontos de fidelização, por exemplo depois de confirmar a pré-visualização de descontos. O sistema tenta agora recalcular automaticamente até 3 vezes antes de desistir; se ainda assim não conseguir, é apresentada uma mensagem a pedir para cancelar e reiniciar a transação, em vez de continuar com valores que poderiam estar incorretos.

Nova funcionalidade

Mais validações e indicador de carregamento no Cartão Presente

No diálogo do Cartão Presente, um cartão fora de validade mostra agora de imediato a mensagem 'O cartão expirou!', em vez de a operação falhar apenas ao fechar o documento. Foram também acrescentadas validações para cartões inativos, eliminados ou com saldo insuficiente, deixou de ser possível confirmar um movimento com valor zero ou negativo, e passou a aparecer uma animação enquanto o sistema consulta o cartão.

Nova funcionalidade

Validação do NIF ao identificar o cliente na Fidelização

Ao identificar um cliente com Número de Identificação Fiscal na fidelização, o sistema verifica agora se o NIF está correto. Se não estiver, é mostrado um aviso ao operador, mas o NIF continua a ser gravado no documento tal como foi introduzido.

Nova funcionalidade

Exclusão de clientes profissionais (B2B) da Fidelização

Em Definições → Loyality Card, passou a ser possível definir uma lista de clientes que ficam de fora do cartão de fidelização — por exemplo, clientes profissionais com preços especiais, para evitar que acumulem pontos além do desconto que já têm. Também é possível fazer o oposto, restringindo a fidelização apenas a essa lista. Antes de gravar, é possível testar a lista e ver de imediato quantos clientes foram encontrados, ou um aviso caso haja algum erro na configuração.

Correcção

Correção na ficha de detalhe das promoções (folhetos)

Corrigido um erro na ficha de detalhe de uma promoção em que a descrição não era apresentada, e as datas de início e fim podiam aparecer com o formato incorreto consoante a configuração regional do computador.

Correcção

Ligação à Niki mais rápida e fiável

A aplicação deixou de pedir uma nova autenticação à Niki em cada operação de fidelização, mantendo a sessão em memória até esta expirar naturalmente. Isto reduz esperas e possíveis falhas de ligação durante o atendimento ao cliente.

Correcção

Bloqueio do colar de texto (Ctrl+V) na identificação do cliente

Quando a opção 'Bloquear Teclado' está ativa no perfil, deixou de ser possível colar texto (Ctrl+V) no campo de identificação do cliente na fidelização, reforçando a leitura exclusiva por leitor de código de barras ou cartão.

Correcção

Correção de desconto quando se aplicam várias promoções na mesma venda

Corrigido um erro que podia impedir a aplicação correta do desconto quando existia mais do que uma promoção a aplicar descontos a linhas na mesma venda, incluindo casos em que o artigo perdia a indicação do armazém depois do desconto ser aplicado.

Correcção

Valor a gastar em pontos de fidelidade passa a ser sempre manual

No ecrã 'Utilize pontos de fidelidade', o campo 'Valor a Abater' e a respetiva percentagem deixam de vir pré-preenchidos e passam a começar sempre em 0 — o operador tem sempre de introduzir manualmente o valor que o cliente pretende gastar, evitando descontos aplicados por engano. O botão de fidelização passou também a servir apenas para identificar o cliente e consultar o seu saldo de pontos; para gastar pontos deve usar-se a opção específica para o efeito.

Correcção

Teste de ligação com resultado detalhado

O teste de ligação ao Niki passou a devolver um resultado mais detalhado, indicando "Ligação testada com sucesso" ou, em caso de falha, remetendo para os registos para mais detalhes.

Nova funcionalidade

Teclado numérico nos ecrãs de cartão presente

Os ecrãs de cartão presente passaram a ter um botão de teclado que abre o teclado numérico no ecrã, facilitando a introdução de valores em terminais táteis.

Nova funcionalidade

Ativar ou desativar a verificação de descontos da encomenda

Nova definição que permite ativar ou desativar a verificação da encomenda (pré-visualização de descontos) consoante a configuração pretendida para cada instalação.

Nova funcionalidade

Venda de cartão presente (carregamento de saldo)

Nova funcionalidade "Venda de Gift Card" que permite carregar saldo num cartão presente, com validação do valor a carregar (valores mínimo e máximo) e do estado do cartão.

Nova funcionalidade

Cartão presente com escolha de perfil e reversível

O ecrã de cartão presente passou a permitir escolher o perfil de ligação e a operação passou a ser reversível: se a venda for alterada depois de aplicado o cartão presente, os valores são repostos automaticamente.

Nova funcionalidade

Teclado numérico no ecrã tátil

Novo teclado numérico no ecrã, opcional, para introdução de dados em terminais táteis. Pode ser ativado nas definições do cartão de fidelização (opção "Usar Teclado Numérico") e fica disponível na identificação do cliente e na introdução do valor a abater em pontos.

Nova funcionalidade

Fecho automático após confirmação do cliente

Nova opção que fecha automaticamente o ecrã de identificação assim que a pesquisa do cliente é confirmada com sucesso, agilizando o atendimento.

Nova funcionalidade

Suporte a códigos promocionais (promocode)

Passou a ser possível aplicar um código promocional à venda, através do ecrã "Atribuir Promocode".

Nova funcionalidade

Pré-visualização de descontos da encomenda

Nova funcionalidade de verificação da encomenda: antes de fechar a venda, o operador pode ver o ecrã "Descontos Aplicados", que compara linha a linha o documento original com os descontos propostos pelo programa de fidelização e apresenta a poupança total do cliente e os pontos de fidelidade envolvidos.

Correcção

Melhor deteção de leitura por scanner

Melhorada a deteção da entrada por leitor de código de barras e o tratamento das teclas no campo de identificação do cliente.

Correcção

Correções diversas na importação de documentos e fidelização

Correções na pesquisa e filtros por datas, no arredondamento de totais, na ordenação das linhas e na atribuição de pontos em algumas lojas, além de melhor compatibilidade com versões mais antigas da base de dados.

Nova funcionalidade

Continuar a venda ao cancelar a identificação do cliente

No ecrã de identificação do cliente, premir Escape passou a permitir continuar a venda sem interromper o processo. O botão de confirmação fica ativo mesmo sem cliente identificado e muda para verde quando o cliente é identificado.

Nova funcionalidade

Preço de custo e vários códigos de barras por artigo

Ao criar artigos durante a importação, passou a ser possível definir o preço de custo e associar vários códigos de barras ao mesmo artigo. Os artigos são criados com três casas decimais.

Nova funcionalidade

Evitar importar o mesmo documento duas vezes

A importação de documentos passou a verificar se um documento já foi importado, evitando duplicados, e a marcar corretamente os documentos como processados.

Correcção

Correções nos folhetos

Desativada a ordenação por coluna na lista de folhetos e corrigido o estado "ignorado" de artigos de campanhas ainda não criadas.

Nova funcionalidade

Suporte a pagamento MB WAY

Introdução do suporte a pagamentos por MB WAY.

Nova funcionalidade

IVA, descontos e filtros na importação de documentos

A importação de documentos passou a suportar IVA e a aplicar descontos por linha, e ganhou novos filtros de pesquisa. Ao criar um artigo, os preços com e sem imposto passaram a ser calculados corretamente.

Nova funcionalidade

Separação do tipo de pagamento para fidelização e cartão presente

As definições passaram a permitir configurar tipos de pagamento distintos para o cartão de fidelização e para o cartão presente, garantindo que cada operação é lançada no meio de pagamento correto.

Nova funcionalidade

Assistente de importação de documentos

Novo assistente passo-a-passo para importar documentos (por exemplo, compras) provenientes do Niki, permitindo rever e validar os artigos antes de os gravar.

Nova funcionalidade

Gestão de folhetos e campanhas promocionais

Novo ecrã "Folhetos" para receber as campanhas promocionais do Niki, ver o detalhe de cada campanha e os respetivos artigos, criar ou associar artigos no sistema e enviar as campanhas para o sistema de faturação. É possível ainda pré-visualizar os anexos em PDF de cada campanha.

Nova funcionalidade

Limpar dados do cliente durante a venda

Nova função para limpar a identificação do cliente a meio de uma venda. Ao ser executada, o sistema confirma com a mensagem "Os dados Loyality foram limpos".

Nova funcionalidade

Cartões presente (gift cards)

Introdução do suporte a cartões presente: é possível pagar uma venda com um cartão presente, consultar o saldo disponível e carregar valor no cartão. Todas as operações de cartão presente ficam registadas.

Nova funcionalidade

Atribuição e criação de cartões de fidelização

Passou a ser possível atribuir um novo cartão de fidelização a um cliente diretamente a partir do ponto de venda, com o ecrã "Atribuir Novo Cartão", indicando o número do cartão a associar.

Nova funcionalidade

Utilização de pontos de fidelidade na venda

Novo ecrã "Utilize pontos de fidelidade" que permite abater pontos acumulados do cliente numa venda, indicando o valor a abater ou a percentagem do total. O sistema impede abater pontos numa transação de valor zero e valida que não se gastam mais pontos do que os disponíveis.

Nova funcionalidade

Configuração de vários perfis de ligação

Passou a ser possível configurar mais do que um perfil de ligação ao Niki (por exemplo, para lojas diferentes) e escolher o perfil a utilizar em cada operação. Quando existe apenas um perfil, a escolha fica oculta e o funcionamento é igual ao anterior.

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.

Configurar o Sage

No BackOffice do Sage, aceda a Menu → Personalização → Parametrizações funcionais.
Abra Integração de Dados.
No separador Extensibilidade, defina o ponto de entrada da classe.
SmartDigit.SmartNikiConnect.Sage50c
Selecione os módulos/postos onde a extensibilidade deverá ser carregada.
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.

Loyalty

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 extra	Descrição
Pontos crédito	Pontos atribuídos na venda.
Pontos acumulado	Total de pontos desde o início.
Pontos débito	Pontos gastos na venda.
Pontos saldo	Saldo atual do cartão.

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

`NIKI.LOYALITY.CLEAN`	Limpar a operação de loyalty.
`NIKI.LOYALITY.SPEND`	Utilizar saldo/pontos.
`NIKI.LOYALITY.SPEND.NOFINISH`	Utilizar saldo sem finalizar.
`NIKI.LOYALITY.RESEND.FORM`	Reenviar o formulário.

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

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

Vídeos

Criar Promoção

Desconto Simples de Item (Artigos Existentes na BD)

Desconto Simples de Item (Artigos Não Existentes na BD)

Regras do Carrinho

Efeitos

Limites

Promocode

Downloads

Ficheiro	Tamanho	Data
NIKICONNECT202302001.v21.05.09.exe	70 MB	01/10/2026	Descarregar
NIKICONNECT202302001.v21.05.08.exe	70 MB	17/09/2026	Descarregar
NIKICONNECT202302001.v21.05.07.exe	70 MB	15/09/2026	Descarregar

21.5.9

Modo de teste para experimentar a fidelização sem enviar dados à Niki

Correção de falha intermitente no recálculo da fatura ao gastar pontos de fidelização

21.5.8

Mais validações e indicador de carregamento no Cartão Presente

Validação do NIF ao identificar o cliente na Fidelização

Exclusão de clientes profissionais (B2B) da Fidelização

Correção na ficha de detalhe das promoções (folhetos)

Ligação à Niki mais rápida e fiável

Bloqueio do colar de texto (Ctrl+V) na identificação do cliente

Correção de desconto quando se aplicam várias promoções na mesma venda

Valor a gastar em pontos de fidelidade passa a ser sempre manual

21.5.7

Teste de ligação com resultado detalhado

Teclado numérico nos ecrãs de cartão presente

Ativar ou desativar a verificação de descontos da encomenda

Venda de cartão presente (carregamento de saldo)

21.5.6

Cartão presente com escolha de perfil e reversível

Teclado numérico no ecrã tátil

21.5.5

Melhorias no cálculo de descontos por tipo de pagamento

Guardar pontos em campos extra do documento

21.5.4

Fecho automático após confirmação do cliente

Suporte a códigos promocionais (promocode)

Pré-visualização de descontos da encomenda

Melhor deteção de leitura por scanner

21.5.2

Maior fiabilidade na atualização dos pontos de fidelidade

21.5.1

Mensagem mais clara quando não há documentos

21.4.46

Filtro por intervalo de datas

21.4.45

Entrada apenas por leitor de código de barras

21.4.44

Novo ecrã de registo de cliente

21.4.43

Melhorias no ecrã de reenvio de transações

21.4.42

Coluna de pontos expirados no histórico

Símbolo de moeda configurável

21.4.41

Gestão de perfil por defeito e proteção dos dados de acesso

21.4.40

Escolha de perfil na identificação do cliente

21.4.39

Data do documento no histórico de transações

21.4.38

Ordem das mensagens de erro na comunicação de pontos

21.4.37

Arredondamento ao abater a totalidade dos pontos

21.4.36

Ecrã para reenviar transações de fidelização

21.4.35

Correção no reenvio de transações em falta

21.4.34

Mensagens e identificação do cliente na fidelização

21.4.33

Comunicação de pontos apenas após gravar o documento

Fornecedor por defeito ao criar artigos

21.4.32

Armazém nas linhas do documento

21.4.31

Armazém por defeito na importação de documentos

21.4.30

Identificar o cliente por telemóvel ou email

21.4.29

Mais tipos de documento a atribuir pontos

21.4.28

Correções diversas na importação de documentos e fidelização

Continuar a venda ao cancelar a identificação do cliente

Preço de custo e vários códigos de barras por artigo

Evitar importar o mesmo documento duas vezes

21.4.27

Correções nos folhetos

Suporte a pagamento MB WAY

IVA, descontos e filtros na importação de documentos

21.4.26