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.

Como configurar a ligação ao ERP

Ligação ao ERP

Campos usados para ligar a app ao ambiente correto.

ERP
Endereço do serviço usado pela app.
Empresa
Base ou empresa onde a operação vai ser feita.
API key
Chave de acesso. Se estiver errada, a app não consegue sincronizar nem criar documentos.
Como configurar impressão e documentos

Impressão

Campos que controlam a saída em talão local.

Impressora Bluetooth
Equipamento escolhido para talões emitidos pela app.
Modelo de impressão
Formato usado na impressão local, quando esse fluxo se aplica.

Documentos

Definem a série e o contexto base das operações.

Documento
Tipo de documento principal escolhido para a operação.
Série
Série associada ao documento escolhido.
Sector
Sector usado nas liquidações e noutros fluxos dependentes dessa configuração.

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 pendentes 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.
Como lançar os pagamentos

Separador Pagamentos

Define como o recibo é pago.

Meio de pagamento
Forma de recebimento, por exemplo numerário, transferência ou cheque.
Valor
Montante lançado nesse meio de pagamento.
Data
Data do pagamento associada à linha.
Número
Número de referência do meio de pagamento, quando aplicável.
Descrição
Texto complementar apresentado na linha do pagamento.
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.
  • 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.
QR code
Foi reduzido para cerca de 60% do tamanho anterior no talão local.

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.