Manual técnico

Teknisoft PD Sync - Manual Técnico

Instalar, configurar e acompanhar a sincronização entre o Tech Rest e o Wintouch Cloud.

Download do instalador Página do produto

1. Objetivo

  • Enviar as vendas do Tech Rest (FS, FT e FR) para o Wintouch Cloud.
  • Criar e atualizar no Tech Rest os artigos e famílias mantidos no Wintouch.
  • Trabalhar com várias empresas (NIF), cada uma com várias lojas.
  • Correr sozinho, na bandeja do Windows, no servidor do Tech Rest da loja.

2. Requisitos

  • Windows 10 ou 11, 64 bits.
  • Acesso ao SQL Server do Tech Rest (no próprio PC ou na rede).
  • Microsoft ODBC Driver 17 ou 18 for SQL Server (normalmente já instalado com o Tech Rest).
  • Empresa no Wintouch Cloud e respetiva API key.
  • Acesso à internet por HTTPS (API Wintouch e atualizações).
  • Permissões de administrador para instalar.

3. Instalação

  1. Descarregar o instalador no PC do Tech Rest.
  2. Executar PDSync-Setup.exe e aceitar o pedido de administrador do Windows.
  3. Escolher, se pretendido, o atalho no Ambiente de Trabalho e Arrancar com o Windows (recomendado: o PD Sync arranca minimizado na bandeja).
  4. No fim, o PD Sync abre. A instalação fica em C:\Program Files\PDSync.

Instalar uma versão nova por cima da anterior atualiza o programa e mantém a configuração. Fechar a janela não termina o PD Sync: continua na bandeja (ícone PD). Para sair, usar Sair no menu da bandeja.

4. Configurar a empresa

No separador Empresas/Lojas, carregar em Nova empresa, preencher os três blocos e carregar em Guardar. Depois, Testar ligações confirma o acesso ao Wintouch e ao SQL Server.

Separador Empresas/Lojas com os blocos Empresa, Wintouch e Tech Rest
Separador Empresas/Lojas.
Bloco Empresa
NIF
NIF da empresa. É validado e serve também para confirmar que a base do Tech Rest é a desta empresa.
Nome
Nome mostrado no Estado e nos Logs.
Empresa ativa
Desmarcar suspende a sincronização desta empresa sem perder a configuração.
Artigos
Estado da associação inicial de artigos e botão Associar artigos… (ver secção 8).
Bloco Wintouch (cloud)
Endereço da API
Já preenchido (https://api.wintouchcloud.com:443/api/v1). Só muda em casos especiais.
Empresa (x-current-enterprise)
Código da empresa no Wintouch Cloud.
API key
Chave de acesso à API. Fica guardada no Gestor de Credenciais do Windows e nunca aparece na configuração nem nos logs.
Aplicação / posto / origem
Identificação enviada ao Wintouch. Manter os valores por omissão, salvo indicação do suporte.
Bloco Tech Rest (SQL Server local)
Servidor
Instância do SQL Server, por exemplo localhost\SQLEXPRESS.
Base de dados
Base do Tech Rest desta empresa.
Autenticação do Windows
Usa o utilizador do Windows em vez de utilizador e password SQL.
Utilizador / Password SQL
Credenciais SQL Server. A password fica no Gestor de Credenciais do Windows.
Driver ODBC
ODBC Driver 17 ou 18 for SQL Server, conforme o que estiver instalado.
TrustServerCertificate
Aceita o certificado do SQL Server local. Normalmente fica ligado.
Nº do posto
Número de posto usado nos identificadores dos registos criados pelo PD Sync.
Tipos de venda (SAF-T)
Tipos de documento lidos como venda. Por omissão FS, FT, FR.
Utilizador Tech Rest
Empregado do Tech Rest que fica como autor dos artigos e famílias criados ou alterados.
Produto / Família modelo
Registos do Tech Rest usados como base ao criar artigos e famílias novos (IVA, unidades, centro de pedido e outras opções do POS). Por omissão, o produto e a família ativos mais antigos.
Carregar listas da base
Lê da base os empregados ativos e os produtos e famílias disponíveis como modelo.

5. Lojas

Na tabela Lojas da empresa, Adicionar loja e preencher:

Código
Código curto da loja (ex.: L1).
Nome
Nome mostrado no Estado e nos Logs.
Nº loja Tech Rest
Número da loja na base do Tech Rest. É verificado contra a base.
Ativa
Desmarcar suspende só esta loja.

Com a loja selecionada, configurar Documento Wintouch… e Famílias…, e carregar em Guardar.

6. Documento Wintouch da loja

Define como cada venda do Tech Rest é criada no Wintouch. As opções são lidas do Wintouch e escolhidas em listas.

As vendas do Tech Rest já são documentos fiscais comunicados à AT. No Wintouch, escolha um tipo de documento não fiscal ou certificado mas excluído do SAF-T. O PD Sync avisa se o tipo escolhido for comunicado no SAF-T.
Tipo de documento
Tipo onde as vendas são criadas.
Série / Setor
Série do tipo escolhido e setor.
Cliente
Procurar por código ou NIF. A entidade tem de estar marcada como cliente no Wintouch.
Moeda / País
Normalmente EUR e Portugal.
Armazém
Opcional.
Artigo genérico
Code do artigo Wintouch usado nas linhas de venda cujo artigo não existe no Wintouch. Use Verificar para confirmar.

Se não for possível ler as listas, a opção Escrever GUIDs à mão permite indicar os identificadores diretamente.

7. Famílias a sincronizar

Em Famílias… escolhe-se que famílias de artigos do Wintouch são enviadas para o Tech Rest desta loja.

  • Sincronizar todas as famílias inclui também as que forem criadas no futuro (opção por omissão).
  • Também é possível escolher os artigos sem família.
  • Se uma família deixar de estar escolhida, os artigos que já estão no Tech Rest não são apagados.
  • Ao mudar a escolha e guardar, os artigos da empresa voltam a ser lidos todos no ciclo seguinte.

8. Associação inicial de artigos

Os artigos ligam-se pelo Code do Wintouch, gravado na referência do artigo no Tech Rest. Numa loja que já tem catálogo, é preciso fazer esta ligação antes de o PD Sync criar artigos, para não duplicar o catálogo.

  1. Em Empresas/Lojas, carregar em Associar artigos….
  2. O PD Sync propõe pares por descrição igual. Rever a lista (há filtro e exportação para CSV).
  3. Escrever o Code nos artigos que ficaram sem par.
  4. Carregar em Gravar referências e confirmar associação.
Enquanto a associação estiver por confirmar, o PD Sync só atualiza artigos já associados e não cria artigos novos.

9. O que é sincronizado

Vendas: Tech Rest → Wintouch
  • São lidos os documentos dos tipos configurados (por omissão FS, FT e FR) de cada loja.
  • Cada venda é criada uma única vez no Wintouch, com o documento configurado na loja.
  • Uma venda só fica marcada como enviada depois de o Wintouch a aceitar. As recusadas ficam pendentes e são tentadas no ciclo seguinte, com o motivo nos Logs.
  • Linhas cujo artigo não existe no Wintouch vão para o artigo genérico da loja.
  • Os documentos do Tech Rest são só lidos, nunca alterados.
Artigos e famílias: Wintouch → Tech Rest
  • São lidos os artigos ativos do Wintouch alterados desde a última sincronização.
  • Os artigos em falta no Tech Rest são criados (com base no produto modelo), e as famílias em falta também.
  • Os artigos existentes são atualizados: descrição, família, IVA e preço.
  • Preço: o preço do Wintouch passa para o Tech Rest. Um artigo sem preço (ou a 0) no Wintouch mantém o preço do POS. Se for criado, fica a 0 € e fica um aviso nos Logs para definir o preço no POS.
  • Os textos são cortados ao tamanho permitido pelo Tech Rest (descrição até 50 caracteres).
  • O Tech Rest envia depois as alterações para a sua cloud, como habitualmente.
Fichas técnicas

Ainda não disponível. Será acrescentada numa versão futura.

10. Uso diário

Separador Estado

Mostra se a sincronização automática está ativa ou em pausa, a última e a próxima execução, e o resultado por empresa, loja e direção (estado, itens tratados e mensagem de erro). Botões Pausar/Retomar e Sincronizar agora.

Separador Estado com vendas e produtos sincronizados em duas lojas
Separador Estado (dados de demonstração).
Separador Logs

Registos em tempo real com filtro por Nível e Âmbito (empresa ou loja), pesquisa de texto e Seguir para mostrar sempre as linhas mais recentes. Exportar… gera um ficheiro para enviar ao suporte; Abrir pasta de logs mostra os ficheiros completos.

Separador Logs com o registo de um ciclo de sincronização
Separador Logs (dados de demonstração).
Ícone na bandeja

Menu com Abrir, Sincronizar agora, Pausar/Retomar e Sair. Quando um ciclo termina com erros, aparece um aviso a indicar o separador Logs.

11. Separador Configuração

Intervalo entre sincronizações
Minutos entre ciclos automáticos (por omissão, 5).
Vendas na 1.ª sincronização
Na primeira sincronização de uma loja, quantos dias de vendas para trás são enviados (por omissão, 1).
Nível do ficheiro de log
Detalhe gravado no ficheiro. Usar Debug só a pedido do suporte.
Servidor de atualizações
Já preenchido com o site da Teknisoft. Não alterar.
Verificar a cada
Horas entre verificações de versão nova (por omissão, 6).
Instalar atualizações automaticamente
Instala sem perguntar. Recomendado em servidores sem utilizador presente.
Arrancar com o Windows
Abre o PD Sync minimizado na bandeja quando o utilizador entra no Windows.

Abrir pasta de dados mostra a configuração, o estado e os logs.

12. Atualizações

  1. Ao arrancar e periodicamente, o PD Sync verifica se há versão nova neste site.
  2. Descarrega o instalador e confirma a assinatura SHA-256. Se não coincidir, cancela.
  3. Pergunta se instala, ou instala logo se essa opção estiver ativa.
  4. Espera que a sincronização em curso termine, instala em modo silencioso e volta a abrir na bandeja.

Para verificar à mão: Configuração → Verificar agora. O Windows pode pedir confirmação de administrador.

13. Onde ficam os dados

Pasta de dados
%APPDATA%\PDSync
Configuração
config.yaml
Estado
state.db: vendas já enviadas, últimas sincronizações e histórico.
Logs
logs\pdsync.log (rotativos).
Passwords e API keys
Gestor de Credenciais do Windows.

Não apagar o state.db: é ele que impede que vendas já enviadas sejam enviadas outra vez.

14. Resolução de problemas

Mensagens mais comuns
Sem ligação ao SQL Server do Tech Rest
Servidor ou base errados, serviço SQL parado ou driver ODBC em falta. Usar Testar ligações.
A base não tem a loja N / é de outro NIF
O nº da loja ou o NIF não corresponde à base configurada. Proteção contra a base errada.
Wintouch recusou as credenciais (HTTP 401)
API key ou código de empresa errados.
Configuração do documento Wintouch incompleta
Preencher Documento Wintouch… da loja.
Vendas rejeitadas
Ver o motivo nos Logs. Ficam pendentes e são tentadas de novo.
Artigos novos não criados
A associação inicial de artigos ainda não foi confirmada (secção 8).
A aplicação não abre
Já está a correr: procurar o ícone PD na bandeja.

Para pedir apoio, usar Logs → Exportar… e enviar o ficheiro para [email protected].

15. Checklist de instalação

Como validar a instalação numa loja
  1. Instalar com Arrancar com o Windows ativo.
  2. Criar a empresa, preencher Wintouch e Tech Rest, Carregar listas da base e escolher o utilizador Tech Rest.
  3. Testar ligações sem erros.
  4. Adicionar as lojas, configurar Documento Wintouch… (tipo não comunicado no SAF-T) e Famílias….
  5. Fazer a associação inicial de artigos e confirmar.
  6. Sincronizar agora e confirmar no Estado que vendas e produtos ficam OK.
  7. Confirmar no Wintouch uma venda de teste e no Tech Rest um artigo criado ou atualizado.
  8. Em Configuração, ativar Instalar atualizações automaticamente se o PC não tiver utilizador presente.