Configuração de VGaleno
Esta integração tem um custo adicional à licença padrão do ImaCash. Confirme as condições com a Imagina antes da entrada em serviço.
1. Dados a solicitar ao VGaleno
O VGaleno deve instalar o controlador Informix de 32 bits compatível e os seus pré-requisitos, preparar o DSN de sistema e a autenticação e confirmar os parâmetros privados de ligação, a estrutura, as permissões de leitura e confirmação e o ID da gaveta do posto. O pack ajuda a preparar o Windows; não substitui a instalação nem a validação do fornecedor.
2. Escolher um ODBC existente ou novo
O ImaCash necessita de IBM INFORMIX ODBC DRIVER de 32 bits, mesmo no Windows de 64 bits. O pack utiliza Windows PowerShell 5.1 de 32 bits. Se o VGaleno já preparou um DSN funcional, verifique-o diretamente; não o recrie por defeito.
Transfira ImaCash VGaleno 1.0.1 (x86) a partir de Dependências de Admin ou Distribuidores. O ZIP completo inclui o assistente PowerShell, IBM Informix Client SDK 4.10.TC16W4 e Visual C++ 2013 x86. Confirme a compatibilidade do posto e do servidor com o VGaleno.
Abrir Dependências do ImaCloud (requer acesso)
Se o ODBC já estiver preparado
Combine o fecho normal do ImaCash sem operações em curso. Extraia o ZIP completo e execute diretamente COMPROBAR.cmd com o utilizador e as permissões reais de Windows do ImaCash, indicando o DSN de sistema x86 existente. Não precisa de executar INICIAR.cmd nem de recriar o DSN. Se a verificação for bem-sucedida, continue com a gaveta confirmada e os campos do ImaCash. Se faltar a ligação, siga a preparação abaixo com o VGaleno.
Se faltar o DSN: preparação com o VGaleno
INICIAR.cmd: extraia todo o ZIP para uma pasta local; não o execute dentro do ficheiro comprimido. Feche o ImaCash normalmente, sem operações em curso, e abra este ficheiro. O Windows pedirá permissão de administrador para preparar o posto.- Se faltar Visual C++ 2013 x86 ou o controlador Informix x86, o assistente abre os instaladores oficiais incluídos. Complete as janelas e condições; não é uma instalação silenciosa. Se pedirem um reinício do Windows, reinicie e volte a abrir INICIAR.cmd.
- Apenas para preparar um DSN novo: introduza os dados privados confirmados pelo VGaleno, incluindo nome do DSN, servidor, porta TCP, instância Informix, base de dados e ID da gaveta. O kit 1.0.1 exige uma porta numérica mesmo com um alias de serviço; não descobre a porta a partir desse alias. hosts, services, ClientLocale e DatabaseLocale são opções do fornecedor. O assistente não deteta a gaveta nem altera o ImaCash.
- Ao criar um DSN novo, abre-se o formulário oficial do controlador para completar a autenticação. O assistente não pede nem guarda palavras-passe em PowerShell, JSON ou relatórios. Se reutilizar um DSN existente coincidente, esse formulário não volta a abrir automaticamente; reveja a autenticação com o VGaleno se necessário.
Introduza localmente os dados privados da conta autorizada pelo VGaleno. São necessárias permissões de leitura e de escrita para confirmar as operações da integração; uma conta apenas de leitura não basta. Não conceda administração geral.
Guarda cópias verificadas antes de alterar hosts ou services. Não substitui um DSN incompatível nem aliases que apontem para outro destino: pare e reveja qualquer conflito com o fornecedor. Não altera a firewall, o antivírus nem a segurança do servidor. TLS ou outro protocolo exige um perfil compatível confirmado pelo VGaleno.
3. Verificar com o utilizador real do ImaCash
COMPROBAR.cmd: feche a janela elevada de configuração e execute este ficheiro com o mesmo utilizador e permissões Windows do ImaCash. Não solicita elevação: se o ImaCash não funciona como administrador, também não eleve este teste. Introduza o nome do DSN. A verificação demora no máximo 30 segundos, abre o DSN sem acrescentar utilizador ou palavra-passe e consulta apenas a estrutura de leitura, sem recuperar vendas ou nomes nem escrever dados comerciais.
O ImaCash abre o DSN sem acrescentar utilizador ou palavra-passe à ligação. Um técnico deve verificar a abertura e o fecho com a conta Windows que irá executar o ImaCash, sem introdução interativa de credenciais. O teste isolado do controlador não comprova por si só essa autenticação.
Um resultado correto apenas comprova a ligação e a estrutura de leitura; não valida a caixa nem as permissões de escrita para confirmar operações. Não use um pagamento real como teste de ligação. A receção de vendas e as suas confirmações exigem um teste supervisionado acordado com o VGaleno, com a mesma caixa, conta e versão do servidor.
4. Completar os campos do ImaCash
- O assistente não altera a configuração do ImaCash. Abra Configuração > Integração e selecione a categoria POS e VGaleno. Pharmacy / Farmácia corresponde à documentação antiga.
- Em Nombre de la BBDD, introduza exatamente General > Data Source Name do DSN de 32 bits verificado. Não introduza User Id, Database Name ou Service do controlador: são campos distintos.
- Em ID Cajón, introduza a gaveta de intercâmbio confirmada pelo VGaleno para esse posto. Não tem de coincidir com o terminal e não identifica a máquina de numerário. Para várias gavetas autorizadas, separe os ID numéricos por vírgulas e sem espaços. COMPROBAR.cmd não obtém este dado: não suponha um número nem crie cobranças para o descobrir.
- Combine a entrada em serviço com o VGaleno antes de guardar e ativar a integração: o arranque operacional pode encontrar operações pendentes. Não altere outros parâmetros sem confirmação do fornecedor.
Referência técnica: configuração manual
Esta referência identifica ficheiros e campos para rever com o VGaleno. Conserve a ligação funcional; não repita alterações já realizadas pelo fornecedor ou assistente.
Ficheiros hosts e services
Faça uma cópia destes ficheiros antes de os editar como administrador, sem acrescentar a extensão .txt. Só são necessárias novas entradas se os aliases indicados pelo VGaleno ainda não forem resolvidos pela instalação.
C:\Windows\System32\drivers\etc\hosts: Associe o IP real do servidor ao nome do computador ou alias. Não confunda este nome com a instância Informix.C:\Windows\System32\drivers\etc\services: Associe o nome do serviço à porta TCP indicada pelo VGaleno. Não altere um serviço existente nem suponha que a porta é sempre 2004.
Estas duas linhas são modelos, não valores para copiar. A primeira pertence a hosts e a segunda a services; substitua cada marcador pelo dado confirmado pelo fornecedor.
[IP_VGALENO] [HOST_VGALENO]
[SERVICE_VGALENO] [PORT_VGALENO]/tcpOrigem de dados ODBC (DSN)
No Windows de 64 bits, abra o Administrador de Origens de Dados ODBC de 32 bits. Crie um DSN de sistema com IBM INFORMIX ODBC DRIVER, acessível à conta Windows que executa o ImaCash.
C:\Windows\SysWOW64\odbcad32.exe
No Windows de 32 bits, o administrador ODBC encontra-se em: C:\Windows\System32\odbcad32.exe
- General > Data Source Name: nome do DSN que irá introduzir no ImaCash. Não tem de coincidir com o nome da base de dados.
- Connection: preencha Server Name (instância Informix), Host Name (computador ou IP), Service (serviço ou porta confirmados), Protocol (onsoctcp quando aplicável) e Database Name (base ativa), com os dados do VGaleno.
onsoctcp significa TCP. Se Service contiver um alias, o Windows deve resolvê-lo através da respetiva entrada em services. O VGaleno deve confirmar a porta da instalação; não existe uma porta universal. Verifique um DSN funcional pelo nome, sem o recriar para introduzir uma porta numérica.