Configurar gsBase com ImaCash
gsBase é uma plataforma de desenvolvimento de aplicações de gestão. Este guia descreve o perfil de troca de ficheiros do ImaCash; o fornecedor deve confirmar que a aplicação instalada gera e recebe esse formato. Não comprova todos os ERP, versões ou a API própria do gsBase.
1. Preparar uma pasta exclusiva
Combine com o fornecedor uma pasta de intercâmbio para um único posto e consumidor. A conta Windows real do ImaCash precisa de listar ficheiros, abrir entradas em leitura e escrita exclusivas, eliminá-las e criar a subpasta RESPUESTA e os seus ficheiros. Não selecione a raiz de um disco, documentos, cópias de segurança ou pastas de outros programas.
2. Selecionar o perfil atual
Abra Configuração > Integração e selecione POS > GsBase. Em Vendas, escolha o diretório acordado com o ícone de pasta. Este perfil não solicita servidor, porta, conta SQL, palavra-passe ou DSN. O administrador fornece os dados privados da instalação.
3. Acordar registos e referências
O leitor utiliza os .txt do nível principal. Prepare um registo compacto por ficheiro, UTF-8 sem BOM e inferior a 1 KiB, com quatro campos separados por ponto e vírgula: loja; referência de venda; vendedor; montante. Aceita um quinto campo, mas não o utiliza. A referência vem do segundo campo, não do nome do ficheiro; deve ser única e válida para o nome da resposta. Não inclua caminhos nem separadores de diretório.
4. Confirmar a unidade do montante
O quarto campo tem duas interpretações: se for reconhecido como inteiro, é dividido por cem; caso contrário, é convertido como decimal segundo a configuração regional do Windows. O fornecedor deve verificar unidade, separador decimal, sinal, moeda e montante resultante antes de operar. Não suponha que um inteiro representa unidades monetárias completas nem que o mesmo texto decimal funciona em todos os computadores.
5. Guardar e verificar o acesso
Guarde e feche com a conta Windows do ImaCash, usando o caminho completo e não vazio. Ao iniciar, o perfil tenta preparar RESPUESTA; a indicação de ligado não comprova leitura do POS, formato correto ou numerário. Verifique pasta, permissões, montante e receção das respostas com o fornecedor antes da utilização comercial.
6. Compreender leitura e identificadores
As entradas são eliminadas após a leitura, antes da confirmação do resultado, mesmo sem obter uma venda válida. Não há arquivo de processados nem recuperação histórica por data. Loja e vendedor vêm do registo; o terminal é atribuído internamente e a data é a da leitura, não uma data de venda importada. Não são consultados catálogos de lojas, caixas ou vendedores e os filtros não comprovam isolamento por posto. Conserve a rastreabilidade na origem sem repor ficheiros para repetir.
7. Verificar RESPUESTA
A confirmação tenta escrever em RESPUESTA com a referência de venda e extensão .OK, contendo montante, entregue e troco separados por |; confirme o sinal do troco com o fornecedor. Uma transação marcada como cancelada tenta .KO com o montante e dois zeros. A recusa por si só não escreve resposta. A existência de um ficheiro não prova a sua leitura pelo POS, o fecho da venda ou a conclusão do cancelamento.
8. Validar o circuito e os limites
Este perfil regista as entradas como numerário e não oferece seletor Aceitar cartões, detalhe bancário independente, produtos, existências ou turnos. O quinto campo não comprova uma forma de pagamento. Valide sob supervisão referências, montantes e sinais, respostas nos dois programas e numerário real. Perante resultado incerto, reveja-os antes de repetir, repor ficheiros, resincronizar ou reiniciar. Um guia ou uma ligação não comprova validação física.
Conservamos o logótipo gsBase do catálogo; o guia explica o seletor POS atual e substitui as capturas antigas de configuração.