1. Primeiros passos
O Kanawa Soft é um sistema de gestão empresarial com módulos de vendas, compras, stock, clientes, finanças, recursos humanos, projetos, formação e comércio eletrónico. Entre com o e-mail e a palavra-passe da sua conta. Na primeira utilização, selecione Criar conta e configurar empresa e siga as etapas apresentadas.
2. Conta e segurança
Use uma palavra-passe forte e individual. Não partilhe credenciais. Termine a sessão em computadores partilhados. Conceda apenas as permissões necessárias a cada colaborador e reveja os acessos regularmente.
O proprietário deve manter o controlo da conta principal e dos métodos de recuperação. Nunca envie chaves privadas, palavras-passe ou segredos por mensagens públicas.
3. Empresa e filiais
Em Configurações, mantenha nome legal, nome comercial, NIF, telefone, e-mail, endereço, logótipo, moeda e regime fiscal atualizados. Associe filiais apenas depois de confirmar a empresa e aprovar a relação. Cada empresa mantém os seus próprios dados; o acesso cruzado exige associação autorizada.
4. Utilizadores e permissões
Crie utilizadores com nome, e-mail e função. Escolha permissões compatíveis com o trabalho: caixa, operador, gerente, contabilista ou administrador. Não atribua administração a quem apenas precisa de consultar ou registar operações.
5. Produtos e serviços
Antes de gravar um produto, informe o nome, referência/código, preço, unidade, categoria e stock inicial. O preço é guardado como valor decimal e não deve ser alterado automaticamente pelo sistema. Use uma referência única para cada artigo. Para serviços, registe descrição, preço e duração.
Para importar produtos, reveja o ficheiro e confirme os campos antes de executar. Corrija duplicados e referências inválidas.
6. Stock e inventário
Registe entradas, saídas, transferências, devoluções e ajustes com motivo e data. Confirme o stock físico antes de corrigir quantidades. Configure níveis mínimos para receber alertas. Uma venda deve validar disponibilidade e não pode reduzir o stock abaixo de zero.
7. Ponto de venda
- Abra Comercial → Ponto de Venda.
- Adicione os produtos ao carrinho por seleção ou scanner.
- Confirme quantidades e preços.
- Selecione ou registe o cliente; a opção anónimo só deve ser usada quando aplicável.
- Escolha a forma de pagamento.
- Introduza desconto autorizado e valor recebido.
- Confira subtotal, impostos, total e troco.
- Finalize e imprima/partilhe a fatura.
8. Scanner e códigos
Abra o scanner e permita o acesso à câmara do dispositivo. Leia o código de barras ou a referência do produto. Quando o código corresponder a um produto ativo, o artigo é acrescentado ao carrinho. Pode ler vários artigos em sequência; confirme cada quantidade e feche o scanner quando terminar. Se não existir correspondência, verifique a referência e cadastre o produto antes de vender.
9. Clientes e fornecedores
Registe nome, NIF, telefone, e-mail e endereço quando necessários. Evite duplicar clientes. Mantenha dados de fornecedores, prazos, contactos e histórico de compras atualizados.
10. Financeiro e pagamentos
Registe contas a pagar e receber, despesas, receitas e reconciliações. Em Configurações → Integrações e Pagamentos, escolha o método, ambiente, finalidade, endereço de checkout e credenciais do fornecedor. Os segredos são guardados no servidor. A indicação de configuração guardada não significa que exista uma integração de pagamento real ativa: é necessário implementar e testar a API oficial de cada fornecedor.
11. Fiscalidade e AGT
Configure o regime e os dados fiscais com apoio do contabilista. Os campos de integração AGT permitem guardar credenciais e testar a ligação quando os dados oficiais estiverem disponíveis. O teste de ligação não emite faturas nem significa certificação. Confirme sempre os requisitos legais e os resultados oficiais antes de operar em produção.
12. Formação, cursos e alunos
Cadastre o curso com nome, duração, carga horária e estado. Registe cada aluno com nome completo, número do BI, classe/nível, contactos, curso selecionado e data de inscrição. Os ficheiros do BI (frente e verso) são guardados num espaço privado por empresa, com acesso limitado a responsáveis autorizados. Não avance se faltar um campo obrigatório ou se o curso não estiver selecionado.
Crie as aulas com tema, data, hora, duração e formador. Registe a presença por aula. As notas devem resultar de avaliações reais, com data, tipo, pontuação obtida e pontuação máxima. O sistema calcula a média a partir dos registos, não de uma nota inventada.
13. Certificados
Escolha um dos modelos internos, personalize cores, texto, logótipo, nome do curso, nome do aluno, carga horária, classificação, data e número de certificado. O modelo pode incluir imagem do carimbo da empresa e assinaturas do proprietário e diretor. Carregue imagens autorizadas nas configurações de certificados. Reveja todos os dados antes de emitir e guardar o PDF.
Um certificado só deve ser emitido quando o aluno cumprir os critérios de conclusão definidos pela instituição e as notas/presenças estiverem registadas.
14. Loja online e integração por API
Em Administração → Integrações e Pagamentos, crie uma chave para a loja, dê-lhe um nome e descreva a finalidade. Restrinja os domínios autorizados e mantenha apenas a permissão de leitura do catálogo. Copie o segredo no momento da criação: ele é apresentado uma única vez. Pode revogar uma chave a qualquer momento.
Endpoint de catálogo: https://jiehrswweoyesbabrpjf.supabase.co/functions/v1/ks-store-api/catalog/products. A loja deve consultar este endpoint no seu servidor, usando três cabeçalhos: apikey: CHAVE_PUBLICAVEL_SUPABASE, x-api-key: API_KEY e Authorization: Bearer API_SECRET. O API Key é o identificador mostrado na criação; o API Secret é o segredo completo apresentado uma única vez. Não coloque o API Secret no HTML ou JavaScript público do site. O endpoint devolve apenas produtos ativos da empresa autorizada.
Depois de ligar a loja, teste a leitura, imagens, preços, stock, pedidos e fluxo de pagamento. A chave do catálogo não autoriza alterar produtos, preços ou stock.
15. GPS e mapas
Autorize a localização no Android e mantenha o GPS ativo. Escolha mapa de ruas ou satélite. A precisão depende do dispositivo, sinal GPS, permissões e ligação à internet. Não interprete uma localização antiga como posição atual.
16. Sincronização, cópias e eliminação
O sistema utiliza armazenamento local e sincronização com a base de dados central. Aguarde a confirmação de sincronização antes de trocar de dispositivo. Uma eliminação confirmada no servidor deve permanecer eliminada após atualização e sincronização. A reposição total dos dados de negócio exige a confirmação do proprietário e mantém a conta de acesso e a configuração principal da empresa, salvo operação administrativa separada.
17. Apoio ao cliente
E-mail: [email protected]
Site: kanawasoft.shop
Telefone: a configurar pela administração.
Ao pedir ajuda, indique o módulo, a operação realizada, a mensagem de erro, a data/hora e o dispositivo. Nunca envie palavras-passe, chaves privadas ou segredos de API.