Integração ImaCash

Octan POS

Configure o Octan POS da Alvic no ImaCash com Firebird e saiba que pagamentos são lidos e como verificar a ligação.

Logótipo da Alvic
Posto de combustível

O OctanPOS liga-se ao ImaCash através do servidor Firebird da instalação. Peça à Alvic ou ao administrador o endereço, a porta, uma conta autorizada e o caminho local da base ativa no servidor ou o respetivo alias Firebird; não utilize uma cópia de segurança.

Passos a seguir

  1. No ecrã principal, abra Configuração → Integração.
  2. Programa de gestao:
    • Categoria: POS
    • Integracao: OctanPOS
  3. Dados de integracao:
    • IP do servidor: Introduzir o endereco IP do servidor.
    • Porta: Porta TCP real do Firebird, normalmente 3050. Confirme-a com o administrador; não é uma porta HTTP.
    • Utilizador: Conta Firebird autorizada para essa base de dados. Não presuma que as credenciais predefinidas do formulário são válidas.
    • Palavra-passe: Dado privado fornecido pelo administrador. Introduza-o apenas no ImaCash.
    • Vendas: Caminho absoluto do FO5.FDB num disco local do servidor indicado, por exemplo C:\ALVIC\FO5.FDB, ou um alias Firebird já configurado, por exemplo OCTANPOS. Os exemplos não identificam a sua instalação. Não introduza um caminho UNC (\\servidor\partilha\FO5.FDB), uma unidade de rede mapeada nem o prefixo IP:porta:; IP e porta têm campos separados. O seletor do Windows não converte um caminho partilhado num caminho válido para o servidor.
  4. Guardar: Ao sair de Configuração, escolha guardar as alterações. Pode voltar à edição para fazer correções ou sair sem guardar para descartar as alterações pendentes.

Permissões necessárias

A conta do sistema operativo que executa o serviço Firebird deve conseguir aceder ao ficheiro e às suas pastas, com as permissões de leitura e escrita exigidas pelo motor. Abrir a partilha com o utilizador do Windows não comprova esse acesso. O administrador deve também verificar as restrições de acesso a bases Firebird e, se for utilizado um alias, se aponta para a base ativa.

O ImaCash solicita o papel ALVICCONS. O administrador deve confirmar que existe nessa base, que a conta o pode assumir e que dispõe de SELECT nas tabelas de vendas, pagamentos, terminais, pessoas e catálogos consultadas pelo OctanPOS. As permissões SQL e as do ficheiro são independentes: esta integração de leitura não precisa de permissões para modificar tabelas.

O que o ImaCash consulta

O conector lê os pagamentos admitidos dos terminais de venda desde a data de leitura, incluindo essa data. Identifica numerário e cartão segundo a configuração do Octan POS e aplica o filtro de posto se estiver ativo. As entradas e saídas de caixa são lidas à parte.

Confirmar ou rejeitar uma operação no ImaCash deixa o pagamento inalterado no Octan POS. Uma linha de cartão não confirma um débito. Verifique o estado no sistema que processou o pagamento.

Verificar a configuração

Com o técnico responsável, confirme que aparece a referência esperada com o posto, a data e o montante corretos. Guardar ou ver a ligação ativa não comprova a leitura ou o resultado do pagamento. Se faltar uma venda, verifique a base ativa, o filtro de posto e a forma de pagamento antes de resincronizar.

Consultar Octan POS na Alvic

Abrir o manual de configuração do ImaCash

Capturas de configuração de Octan POS

Integração pronta para avançar

Se esta ficha se adequa ao seu software, o próximo passo é passar para a operação real

Podemos ajudá-lo a validar o âmbito, confirmar hardware compatível e preparar o próximo passo de implementação.