Manual técnico

Teknisoft Orders - Manual Tecnico

Guia curto para instalar, testar e acompanhar o funcionamento normal da app.

1. Objetivo

  • Preparar a app para uso diário em encomendas e liquidações.
  • Garantir trabalho offline com clientes e artigos já sincronizados.
  • Validar criação de documentos, impressão e consulta documental.

2. Pré-requisitos

  • ERP, empresa e API key corretos.
  • Documento, série e sector configurados na app.
  • Impressora Bluetooth emparelhada no Android, quando usada.
  • Primeira sincronização de clientes e artigos concluída.

3. Validação inicial

  1. Abrir Definições e confirmar ligação e impressão.
  2. Sincronizar Clientes.
  3. Sincronizar Artigos.
  4. Confirmar preço, pendente e desconto num cliente de teste.
  5. Confirmar documento, série e sector das liquidações.

4. Menu Definições

Este menu define a ligação ao ambiente certo e a base da operação diária. Está organizado em três separadores: Geral, Encomendas e Liquidações.

O que significa o separador Geral

Ligação e ambiente

Campos usados para ligar a app ao ambiente correto e controlar o comportamento base da instalação.

ERP Provider
Escolhe o tipo de ERP. Em ambiente Wintouch, a app usa os catálogos, documentos e integrações próprias desse ERP.
NIF
Identifica o serviço ou empresa usado para resolver a configuração do ambiente Wintouch.
Empresa ERP
Empresa ou base onde as operações vão ser criadas. Esta escolha afeta documentos, séries, sectores, layouts e meios de pagamento disponíveis.
Intervalo sync
Tempo entre sincronizações automáticas, quando essa opção está ativa.
Tamanho listagens
Número de registos visíveis por página nas grelhas principais.
Modo de Interface
Define se a app trabalha em modo telemóvel ou em modo tablet/POS.
Preço em Artigos
Controla se os artigos são mostrados com IVA ou sem IVA.
Casas decimais (Qtd)
Número de casas decimais permitido na quantidade das linhas.

Bluetooth e impressão local

Campos que controlam a saída por impressora Bluetooth.

Impressora Bluetooth
Permite ativar Bluetooth, emparelhar no Android e escolher a impressora usada pela app.
Impressora emparelhada
Equipamento atualmente selecionado para impressão local.

Opções gerais

Afetam consulta, sincronização e uso diário da app.

Mostrar coluna Stock em Artigos
Mostra ou esconde a coluna de stock na lista de artigos.
Atualizar quantidades
Ativa o comportamento definido para atualização de quantidades na operação da app.
Teclado numérico +
Ativa o modo de teclado numérico reforçado em campos compatíveis.
Artigos Favoritos
Permite marcar e filtrar artigos favoritos na app.
PIN das Definições
Protege o acesso ao menu de definições e permite trocar o PIN atual.
O que significa o separador Encomendas

Documento e impressão

Definem como as encomendas são criadas e apresentadas.

Tipo de Documento
Documento usado para criação da encomenda no ERP.
Série de Documento
Série associada ao documento escolhido.
Modelo de impressão
Escolhe entre Standard e Ticket. Esta escolha afeta os layouts disponíveis.
Layout de Impressão
Layout usado na impressão principal. Depende do modelo de impressão e pode ser ajustado automaticamente pela série.
Layout PDF
Layout usado quando a app abre ou gera a versão PDF do documento.
Armazém predefinido
Armazém sugerido nas encomendas quando esse contexto é usado.
Documentos Bcc para
Email que recebe cópia oculta dos documentos enviados por email.

Opções do fluxo

Controlam como a app se comporta ao criar encomendas.

Ativar sincronização automática
Permite que a app sincronize periodicamente sem intervenção manual.
Lembrar preço de artigo/cliente
Mantém o contexto do preço já usado nesse cliente/artigo quando aplicável.
Permitir desconto na linha
Ativa o campo de desconto diretamente nas linhas da encomenda.
Limpar campo de Pesquisa
Depois de adicionar artigo, limpa a pesquisa para facilitar nova procura.
Enviar email
Após criar a encomenda, tenta enviar o documento por email.
Impressão automática Bluetooth
Após criar a encomenda, tenta imprimir automaticamente na impressora Bluetooth configurada.
O que significa o separador Liquidações

Documento e impressão

Definem o contexto usado quando a app cria um recibo de liquidação.

Documento
Tipo de documento usado nas liquidações.
Série
Série associada ao documento de liquidação.
Sector
Sector enviado na criação do recibo.
Modelo de impressão
Escolhe entre Standard e Ticket para o contexto de liquidações.
Layout de impressão
Layout de impressão do recibo, dependente do modelo selecionado.
Layout PDF
Layout usado quando a app abre o PDF da liquidação.
Documentos Bcc para
Email que recebe cópia oculta dos recibos enviados por email.

Opções do fluxo

Controlam a listagem e o fecho das liquidações.

Enviar email
Após criar a liquidação, tenta enviar o recibo por email.
Impressão automática Bluetooth
Após criar a liquidação, tenta imprimir automaticamente o talão ou recibo.
Listar Apenas Vencidos
Quando ativa, a lista de documentos a liquidar mostra apenas documentos vencidos. Quando desativada, mostra pendentes e vencidos.

5. Menu Clientes

Serve para localizar o cliente certo e arrancar a operação com dados já disponíveis localmente.

Como consultar e pesquisar clientes

Lista de clientes

Mostra a informação principal de consulta rápida.

Código
Identificação interna do cliente.
Nome
Nome apresentado ao utilizador para seleção.
NIF
Número fiscal do cliente.
Pendente
Valor ainda em aberto. É atualizado localmente depois de criar ou imprimir uma liquidação.
Desconto global
Linha de desconto trazida da sincronização do cliente.

Pesquisa e ações

Ajuda a encontrar o cliente e seguir para a operação seguinte.

Pesquisa
Filtro por código, nome ou outro texto disponível na lista.
Sincronizar
Atualiza a base local de clientes para trabalho offline.
Abrir cliente
Entra no detalhe ou usa o cliente como base para uma nova operação.

6. Menu Artigos

Serve para procurar artigos e alimentar a encomenda com dados já sincronizados.

Como localizar e adicionar artigos

Lista de artigos

Mostra o essencial para escolha rápida do produto.

Código
Referência interna do artigo.
Descrição
Nome apresentado ao utilizador.
Preço
Preço que a app mostra para venda ou consulta.
Stock
Quantidade disponível, quando essa coluna está ativa.

Pesquisa e ações

Ajuda a reduzir a lista e a carregar artigos para a encomenda.

Pesquisa
Filtro por referência ou descrição.
Sincronizar
Atualiza artigos no SQLite local para uso offline.
Adicionar
Envia o artigo selecionado para a encomenda em edição.

7. Menu Encomendas

As encomendas são preparadas na app e depois sincronizadas com o ERP. O importante é validar cliente, linhas, totais e fecho do documento.

Como preencher o cabeçalho da encomenda

Cabeçalho

Identifica a encomenda e o cliente associado.

Cliente
Cliente dono da encomenda.
Documento
Tipo de documento configurado para a encomenda.
Série
Série usada ao sincronizar com o ERP.
Data
Data da encomenda.
Como preencher as linhas da encomenda

Linhas da encomenda

Campos usados em cada artigo adicionado.

Artigo
Produto selecionado para a linha.
Quantidade
Número de unidades pedidas.
Preço
Preço final da linha antes de totais do documento.
Desc. %
Desconto aplicado nessa linha.
Armazém
Armazém associado, quando essa opção existe no fluxo.
Obs
Observação que segue com a linha para o ERP.
Total da linha
Resultado final dessa linha com quantidade, preço e desconto.
Como fechar e sincronizar a encomenda

Ações

Controlam o fecho e a sincronização da encomenda.

Guardar
Grava o estado atual da encomenda na app.
Criar e Sincronizar
Cria a encomenda e envia o documento para o ERP.
Preview / PDF
Nas encomendas sincronizadas, abre o documento devolvido pelo ERP para visualização ou impressão.

8. Menu Liquidações

Este menu serve para receber pendentes, aplicar desconto quando necessário e emitir o recibo.

Como usar o cabeçalho e navegar nos recibos

Cabeçalho

Define em que documento o recibo vai ser criado e permite navegar em recibos já existentes.

Documento
Tipo de recibo ou documento de liquidação.
Série
Série usada com esse documento.
Data do documento
Data lançada no recibo.
Número
Número do recibo em consulta. Serve também de referência na navegação.
|<
Abre diretamente o primeiro recibo da série, ou seja, o número 1.
< e >
Recua ou avança um recibo na navegação.
>|
Salta para o último recibo disponível.
Como preencher as linhas a liquidar

Separador Linhas

Mostra os documentos a liquidar do cliente e permite decidir o que vai ser liquidado.

Sel.
Marca a linha para entrar na liquidação.
Documento origem
Documento pendente que está a ser liquidado.
Original
Valor original desse documento.
Desconto
Valor abatido no momento da liquidação.
Recebido
Valor pago pelo cliente nessa linha.
Pendente
Valor que sobra depois de aplicar desconto e recebido.

Se a opção Listar Apenas Vencidos estiver ativa nas definições, esta grelha mostra só documentos vencidos. Se estiver desativada, inclui também documentos ainda não vencidos.

Como lançar os pagamentos

Separador Pagamentos

Define como o recibo é pago.

Meio de pagamento
Lista carregada do ERP. Cada opção aparece no formato código - descrição, por exemplo NUMERARIO - Numerário ou TRANSFBANCARIA - Transferência bancária.
Valor
Montante lançado nesse meio de pagamento.
Data
Data do pagamento associada à linha.
Data Venc.
Data de vencimento associada à linha de pagamento.
Número
Número de referência do meio de pagamento, quando aplicável.
Banco / Localidade
Campos complementares usados quando o meio de pagamento exige esse detalhe.
Como criar e imprimir a liquidação

Ações

Fecham a liquidação e atualizam o contexto local.

Criar Liquidação
Cria o recibo no ERP e recalcula o pendente do cliente na base local.
Imprimir
Imprime o recibo. Depois da impressão manual, o pendente local volta a ser atualizado.
Abrir PDF
Abre a versão do documento devolvida pelo ERP, quando esse fluxo é usado.
  • Uma linha com desconto e recebido a zero continua selecionada.
  • O pendente segue a fórmula original - desconto - recebido.
  • Os meios de pagamento são obtidos do catálogo do ERP e o recibo é criado com o PaymentMethodID correspondente.
  • Depois de criar a liquidação, o pendente do cliente é atualizado na base local.
  • Depois de imprimir o recibo manualmente, esse update é repetido.

9. Impressão e navegação

Como funciona por tipo de documento

Encomendas

Preview
Mostra a encomenda já sincronizada com base no documento devolvido pelo ERP.
Imprimir
Nas encomendas sincronizadas, segue o modelo do ERP e não um talão local alternativo.

Liquidações

Talão local
Pode sair por Bluetooth quando esse fluxo está ativo na app.
V. Desc.
No talão local, mostra o desconto da própria liquidação e não o desconto do documento origem.

10. Diagnóstico rápido

Como resolver os problemas mais comuns
  • Sem clientes ou artigos: fazer sincronização.
  • Pendente errado: criar ou imprimir liquidação para forçar atualização local.
  • Desconto não aparece no talão: confirmar o fluxo de impressão e o campo V. Desc..
  • Documento não encontrado: confirmar documento, série e número.
  • Bluetooth falha: confirmar emparelhamento e impressora selecionada.

11. Checklist técnico

Como validar a app no final da instalação
  1. Confirmar configurações do ERP e documentos.
  2. Sincronizar clientes e artigos.
  3. Criar uma encomenda de teste e confirmar sincronização.
  4. Criar uma liquidação de teste com desconto, quando aplicável.
  5. Imprimir e confirmar atualização do pendente local.