Integração ImaCash

Odoo

Módulo próprio do ImaCash para automatizar cobranças em numerário no Odoo POS sem depender de conectores de terceiros.

Logótipo do Odoo
Retalho e hotelaria

Beta privada: A integração própria do ImaCash está pronta para testes controlados com Odoo 17, 18 e 19 antes da ativação de cobranças reais.

Conector próprio, sem SmartHoreca

O módulo e o protocolo foram desenvolvidos e são mantidos pela Imagina IT Solutions. A instalação não depende da ponte SmartHoreca nem de componentes de terceiros.

Cobrança direta no Odoo POS

No Odoo 19, o método é registado como máquina de numerário ImaCash. Odoo 17 e 18 usam o contrato de terminal de pagamento dessas versões. O operador seleciona o método ImaCash para pedir o pagamento em numerário e espera pela confirmação.

Conciliar antes de duplicar

Se a resposta se perder ou o tempo de espera terminar, mantenha a referência e consulte a mesma operação. Verifique o estado no Odoo, no ImaCash e no dispositivo antes de voltar a cobrar.

Odoo 17, 18 e 19

Cada versão dispõe de um pacote instalável específico. Esta primeira beta aceita apenas cobranças positivas em numerário; não processa cartões, reembolsos nem operações agrupadas.

Instalação protegida

O módulo é descarregado a partir das dependências Cloud autenticadas e requer o ImaCash 4.4.3.1031 ou posterior. A origem Odoo, o UUID da base de dados e o segredo de emparelhamento associam as duas instalações.

Preparar o emparelhamento

Um administrador deve instalar o módulo ImaCash POS Connector para Odoo 17, 18 ou 19 a partir das dependências autenticadas do Cloud. A instalação Odoo deve permitir módulos próprios e incluir Ponto de Venda.

  1. No Odoo, abra Ponto de Venda → Configuração → Métodos de pagamento. Crie ou edite um método com um diário de numerário e ative Usar ImaCash. Atribua o método ao ponto de venda que o vai utilizar.
  2. No separador ImaCash do método, o administrador prepara o endereço local do ImaCash e o tempo máximo de espera. Consulte a origem do Odoo e o UUID da base e configure o segredo privado de emparelhamento.
  3. No ImaCash, abra Configuração → Integração → POS → Odoo. IP do servidor e Porta correspondem ao serviço local do posto. Nome da base de dados recebe a origem web do Odoo sem caminho. Utilizador recebe o UUID da base e Palavra-passe recebe o mesmo segredo de emparelhamento.
  4. Ao sair de Configuração, guarde as alterações quando o ImaCash o pedir. Pode continuar a editar para corrigir ou sair sem guardar para descartar alterações pendentes. Recarregue o POS pelo procedimento do Odoo e confirme que o método ImaCash aparece no ponto de venda.

Os dados de emparelhamento são privados. Um administrador do Odoo gere o segredo e introduz o mesmo nos dois lados. O ImaCash deve estar aberto no posto, com a integração Odoo iniciada e a moeda correspondente ao pagamento.

Teste e resultado esperado

Antes de ativar pagamentos reais, o técnico responsável deve verificar o percurso completo no mesmo posto e com a mesma moeda. A confirmação no POS deve corresponder à operação do ImaCash. A instalação do módulo e este guia não comprovam a validação do dispositivo.

Abrir o manual de configuração do ImaCash

Documentação oficial do Odoo sobre máquinas de numerário

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.