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
- Abra Configuração > Integração e selecione Open POS NG (Avalon) - Beta.
- Em Nome ODBC, indique o nome exato do DSN de sistema x86. Preencha o utilizador e a palavra-passe apenas se o DSN não os gerir.
- 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
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.