Beta técnica: Está disponível um conector ODBC só de leitura para uma primeira validação controlada numa instalação real do Open POS NG. Não deve ser ativado para operações reais em numerário antes de concluir a matriz de testes.
Pré-requisitos
O ImaCash deve ser executado em Windows e alcançar o servidor local do Open POS NG. Crie um DSN de sistema ODBC de 32 bits com o controlador de base de dados utilizado pela instalação e uma conta só de leitura com permissão SELECT sobre uma tabela ou vista transacional preparada pela Avalon ou pelo responsável do POS.
Configuração no ImaCash
- Na janela principal, abre Configuração > Integração > POS e seleciona Open POS NG (Avalon) - Beta. Utiliza a identificação autorizada solicitada pelo ImaCash.
- Em Nome ODBC, indica o nome exato do DSN de sistema de 32 bits preparado pelo responsável. Deve funcionar na conta Windows que executa o ImaCash, sem outra caixa de autenticação. Utilizador e Palavra-passe são dados privados; preenche-os apenas quando a configuração do DSN os exigir.
- Em Tabela ou vista de vendas, indique a origem exata autorizada, com uma linha por operação ou forma de pagamento; nunca uma tabela de artigos que repita o total do talão. Use esquema.tabela quando necessário. O ImaCash não pesquisa nem seleciona outras origens.
Mapeamento explícito e autoritativo
Introduz em Mapeamento de colunas o contrato confirmado pelo responsável. Os nomes e valores do exemplo seguinte ilustram a sintaxe; não descrevem o esquema de todas as instalações do Open POS NG. Não coles uma ligação, palavra-passe ou dados de vendas neste campo.
Defina sempre o mapeamento de colunas com pares separados por ponto e vírgula; o ImaCash usa-o como contrato autoritativo e não tenta adivinhar colunas. Deve incluir dateonly=true|false: true indica que date é uma coluna DATE sem hora e permite usar time com dateonly=true; false indica que date já contém data e hora. Por exemplo: id=ID;date=DATA;dateonly=true;time=HORA;cash=VALOR_DINHEIRO;operator=OPERADOR;terminal=CAIXA. O contrato cash aceita um único valor coerente por ID e falha de forma fechada se esse ID se repetir com valores diferentes. Para linhas de pagamento, use amount=VALOR_PAGAMENTO;payment=FORMA_PAGAMENTO;cashvalue=DINHEIRO|CASH. Se os identificadores precisarem de delimitadores, adicione quote=none|double|bracket|backtick; none é o valor predefinido.
Contrato de finalização obrigatório
Configure uma destas duas opções: uma vista que contenha apenas vendas finais juntamente com finalonly=true; ou status=ESTADO;closedvalue=FECHADA|PAGA;modified=MODIFICADA_EM para filtrar os estados fechados e recuperar fechos tardios. No contrato amount+payment com status+modified, modified identifica a alteração da venda: o ImaCash obtém primeiro os IDs modificados e depois recupera todas as respetivas linhas antes de somar o numerário, evitando a captura parcial de um pagamento misto. Sem um destes contratos, a integração falha de forma fechada.
Âmbito desta beta
A integração lê operações recentes e entrega ao ImaCash apenas o numerário, incluindo somente a componente em numerário dos pagamentos mistos e as devoluções com sinal negativo. É estritamente só de leitura: nunca modifica o Open POS NG nem escreve confirmações, estados, pagamentos ou cancelamentos na Avalon.
Guardar e verificar a configuração
Ao fechar Configuração com alterações, podes guardar, continuar a editar ou sair sem guardar as alterações pendentes. A gravação decorre por fases: uma falha posterior não reverte fases já guardadas. Abrir o DSN e verificar a origem e o mapeamento apenas comprova esse acesso de leitura; não confirma uma captura completa, um pagamento ou o funcionamento do dispositivo.
Filtros, histórico e validação inicial
Os filtros de posto e operador exigem as colunas terminal e operator no mapeamento, respetivamente. Revê a seleção e a ativação em Ajustes > Filtros. A consulta utiliza uma janela recente de até duas horas; a ressincronização não garante recuperar todo o histórico. Esta beta não importa artigos, existências, turnos nem um total separado de cartões.
Antes da utilização comercial, o responsável deve verificar numa instalação real uma venda em numerário, um pagamento misto, um reembolso, um fecho tardio e a continuidade após reiniciar, incluindo a ausência de duplicados. Um teste com dados fictícios ou uma ligação bem-sucedida não conclui essa validação. Perante um resultado incerto, verifica o talão e o numerário real antes de repetir, ressincronizar ou reiniciar.
Consultar configuração, gravação e saída no manual do ImaCash