Manual técnico
Teknisoft PD Sync - Manual Técnico
Instalar, configurar e acompanhar a sincronização entre o Tech Rest e o Wintouch Cloud.
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.
- As fichas técnicas (composições) não são sincronizadas: ficam só 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
- Descarregar o instalador no PC do Tech Rest.
- Executar
PDSync-Setup.exee aceitar o pedido de administrador do Windows. - Escolher, se pretendido, o atalho no Ambiente de Trabalho e Arrancar com o Windows (recomendado: o PD Sync arranca minimizado na bandeja).
- 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 da Teknisoft). 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.
Bloco Empresa
NIF
NIF da empresa (9 algarismos, validado). Para ter outra configuração do mesmo NIF (outra base Tech Rest ou outra empresa Wintouch), acrescente uma letra: ex.:
504128582G. Serve também para confirmar que a base do Tech Rest é desta empresa. Pode ser alterado: o registo das vendas enviadas e as credenciais passam para o NIF novo, sem reenviar nada.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ões Associar artigos… (ver secção 8) e Reenviar artigos… (lê e envia de novo todos os artigos na sincronização seguinte; os que já existem são atualizados, não duplicados).
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.
Zonas das famílias
Zonas do Tech Rest (sala, esplanada, take away…) onde ficam as famílias que o PD Sync cria. Por omissão, todas as zonas ativas, como as famílias criadas no próprio Tech Rest. As famílias que já existem não são alteradas.
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 certificado (recomendado: não precisa de série comunicada à AT e nunca é comunicado) 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.
Se o tipo for pago no momento (por exemplo, uma fatura-recibo), cada venda leva um pagamento com o total. O meio de pagamento do Wintouch é escolhido pelo código SAF-T do meio usado no Tech Rest (Dinheiro → Numerário, Multibanco → Cartão…). Se o tipo gerar conta corrente (fatura), a venda vai sem pagamento e com vencimento.
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.
- Em Empresas/Lojas, carregar em Associar artigos….
- O PD Sync propõe pares por descrição igual. Rever a lista (há filtro e exportação para CSV).
- Nos artigos que ficaram sem par, fazer duplo clique na coluna Code Wintouch e escrever parte do nome ou do Code. As sugestões (“Code · nome”) vêm do Wintouch; escolher uma com Enter ou com um clique. Com a célula vazia, a pesquisa começa já pela descrição do artigo no Tech Rest.
- Carregar em Gravar referências e confirmar associação.
Também pode escrever o Code completo à mão: o PD Sync confirma-o no Wintouch. A pesquisa não distingue maiúsculas. No Wintouch, os acentos contam: se “cafe” não encontrar o artigo, experimente “café” ou só uma parte sem acento (“caf”). Se o artigo escolhido for de uma família que não é sincronizada na loja, a descrição fica a laranja com o aviso fora das famílias sincronizadas da loja: a associação é gravada, mas o artigo não será atualizado pelo PD Sync.
Enquanto a associação estiver por confirmar, o PD Sync só atualiza artigos já associados e não cria artigos novos.
Se mudar a base de dados do Tech Rest ou a empresa Wintouch de uma empresa, a associação volta a por confirmar (era da base antiga) e todos os artigos são lidos e enviados de novo. Faça a associação na base nova antes de a confirmar.
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
- Em cada sincronização são lidos os artigos ativos do Wintouch alterados desde a anterior.
- De hora a hora (configurável) são lidos todos os artigos: mudar só o preço no Wintouch não altera a data do artigo, e é esta leitura que apanha essas mudanças. Só os artigos alterados são escritos no Tech Rest.
- Os artigos em falta no Tech Rest são criados (com base no produto modelo), e as famílias em falta também, ligadas às zonas escolhidas.
- 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
Não são sincronizadas. As fichas técnicas (composições dos artigos) são mantidas só no Wintouch.
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 (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.
No fim de cada ciclo aparece um resumo, também na barra de estado da janela: por exemplo, 3 venda(s) enviada(s) para o Wintouch, 1 artigo(s) atualizado(s) no Tech Rest, sem erros. Se houver erros, indica a loja e a tarefa que falhou (ex.: 1 erro(s) (L1 vendas)); o motivo está nas linhas anteriores.
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).
Ler todos os artigos a cada
Horas entre leituras completas dos artigos do Wintouch (por omissão, 1). Apanha os preços alterados no Wintouch.
Nível do ficheiro de log
Detalhe gravado no ficheiro. Usar Debug só a pedido do suporte.
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
- Ao arrancar e periodicamente, o PD Sync verifica se há versão nova neste site.
- Descarrega o instalador e confirma a assinatura SHA-256. Se não coincidir, cancela.
- Pergunta se instala, ou instala logo se essa opção estiver ativa.
- 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%\PDSyncConfiguração
config.yamlEstado
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.
"AT - Comunicação de séries: 5002"
O tipo de documento Wintouch é certificado e a série não foi comunicada à AT. Escolha um tipo não certificado em Documento Wintouch… (recomendado) ou comunique a série no Wintouch.
Meio de pagamento sem correspondência no Wintouch
Não há no Wintouch um meio de pagamento ativo com o mesmo código SAF-T (NU, CD, CH, TB…) do usado no Tech Rest. Crie-o ou ative-o no Wintouch.
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). Também acontece depois de mudar a base do Tech Rest ou a empresa Wintouch.
Preço alterado no Wintouch não chega ao Tech Rest
É apanhado na leitura completa seguinte (de hora a hora, por omissão). Para enviar já: Reenviar artigos… e Sincronizar agora. Um artigo sem preço (ou a 0) no Wintouch mantém o preço do POS.
A base é de outro NIF
O NIF da empresa não corresponde ao da base do Tech Rest (lido da ficha da empresa no Tech Rest). Confirme a base de dados ou o NIF.
A aplicação não abre
Já está a correr: procurar o ícone da Teknisoft 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
- Instalar com Arrancar com o Windows ativo.
- Criar a empresa, preencher Wintouch e Tech Rest, Carregar listas da base e escolher o utilizador Tech Rest.
- Testar ligações sem erros.
- Adicionar as lojas, configurar Documento Wintouch… (tipo não comunicado no SAF-T) e Famílias….
- Fazer a associação inicial de artigos e confirmar.
- Sincronizar agora e confirmar no Estado que vendas e produtos ficam OK.
- Confirmar no Wintouch uma venda de teste e no Tech Rest um artigo criado ou atualizado.
- Em Configuração, ativar Instalar atualizações automaticamente se o PC não tiver utilizador presente.