Configurar Cashmatic no ImaCash
Antes de configurar
- O fornecedor deve ativar a API HTTPS Cashmatic e fornecer em privado o endereço, a porta e uma conta autorizada. Confirmar permissões de consulta, cobrança, cancelamento e retirada; não existem porta nem credenciais universais.
- O computador necessita de .NET Framework 4.7.2 ou posterior. Utilizar um certificado válido para o endereço configurado ou uma impressão digital SHA-256 confirmada pelo fornecedor por um canal fiável. Não aceitar automaticamente o certificado recebido nem desativar a sua verificação.
- Dedicar o dispositivo a esta instância do ImaCash. Não iniciar movimentos noutra aplicação ou na administração Cashmatic enquanto o ImaCash o utilizar: o cancelamento do serviço não bloqueia ordens simultâneas de terceiros.
Passos no ImaCash
- Abrir Configuração → Máquina e selecionar Cashmatic. O conector está disponível no canal beta; confirmar a versão e a instalação com o responsável técnico.
- Introduzir o endereço do dispositivo ou serviço indicado pelo fornecedor, a porta HTTPS, o utilizador e a palavra-passe privados. Não confundir esse endereço com o do computador ImaCash.
- Em Certificado HTTPS (SHA-256), deixar o campo vazio se o certificado já for válido ou introduzir a impressão digital autorizada do certificado do dispositivo. Este campo não é uma pasta nem um ficheiro.
- Escolher a moeda configurada no equipamento. O seletor admite moedas com duas casas decimais; a presença na lista não comprova o suporte do modelo ou firmware.
- Guardar e verificar a ligação com o equipamento em repouso. São consultados informação, estado e inventário, sem iniciar movimentos de numerário. Uma leitura falhada não significa inventário zero nem comprova o ciclo completo da cobrança.
Funções do conector beta
Inclui cobranças manuais e integradas, cancelamento de uma cobrança própria antes de atingir o valor com devolução integral confirmada, reembolsos, retiradas por valor e inventário reciclável e total. O resultado exige confirmar a operação própria, entradas, saídas e conclusão; um aviso de receção ou regresso ao repouso não basta.
Não estão ativados reabastecimentos, trocas de denominações, esvaziamentos, aberturas, depósitos livres, aceitação contínua nem seleção de denominações. Não se reconstitui o detalhe do numerário a partir de diferenças de inventário.
Se o resultado ficar pendente
Perante perda de comunicação, entrega incompleta ou resultado não identificável, rever a operação e o numerário com o responsável técnico. Não repetir a cobrança, reembolso ou retirada para testar, nem reiniciar para desbloquear. A revisão em memória não é recuperada de forma persistente entre processos.
Modelo e entrada em serviço
Antes do uso comercial, o fornecedor deve confirmar modelo, firmware e API, incluindo a consulta por referência de uma operação ainda ativa. Depois é necessário um teste supervisionado de cobrança exata, troco, cancelamento, reembolso, retirada e falhas de comunicação, comparando numerário e histórico. Este guia e os testes de software não comprovam certificação nem validação física de um modelo.