Integração ImaCash

evoPOS

Beta do ImaCash para importar operações JSON do evoPOS da MADIC UK: pasta, permissões, moeda e alcance da confirmação local.

Imagem de produto evoPOS da MADIC UK com terminais e logótipo
Retalho e postos de combustível

Beta técnica: A integração do evoPOS, desenvolvido pela MADIC UK, está pronta para testes controlados com exportações JSON reais antes da utilização em produção.

Configuração necessária

Abra Configuração > Integração, escolha POS > evoPOS e a pasta em Vendas. Feche Configuração e confirme a gravação. Guardar verifica apenas se a pasta existe, sem comprovar permissões, receção ou pagamento. A moeda configurada no ImaCash deve coincidir com a indicada nas linhas de pagamento.

Preparar uma pasta exclusiva

O utilizador Windows do ImaCash precisa de ler e mover ficheiros e criar subpastas. Dedique a pasta a esta instalação e confirme posto, utilizador e loja. Este perfil não pede servidor SQL, porta, utilizador ou palavra-passe.

Entregar ficheiros completos

O exportador deve terminar a escrita antes de tornar cada .json visível na pasta principal. Não se percorrem subpastas nem se recupera histórico por data e hora. Ficheiros com mais de 10 MiB são rejeitados; os bloqueados ou incompletos podem aguardar outra leitura.

Valores e formas de pagamento

São aceites valores positivos e um único tipo reconhecido: numerário ou cartão. Usa-se o total da venda, não o numerário entregue nem o troco. Pagamentos mistos, formas desconhecidas ou incoerentes e moedas incompatíveis são rejeitados; vendas anuladas, suspensas ou de formação são separadas. Não admite reembolsos. Aceitar cartões não comprova pagamento bancário ou total de cartão.

Significado das subpastas

processed indica persistência local do ficheiro, não pagamento físico. error conserva ficheiros não admitidos ou falhas de importação; ignored separa operações excluídas e duplicate duplicados detetados numa leitura. Reveja a causa com o suporte; não reponha nem renomeie ficheiros para forçar outra tentativa. Não se garante ausência de duplicados em todos os cenários.

Âmbito desta beta

A especificação atual ainda não define uma resposta de confirmação, anulação ou mudança de estado para o evoPOS. Confirmar ou rejeitar no ImaCash não fecha nem anula a venda no evoPOS e não comprova o resultado da máquina.

Verificar o percurso completo

Combine amostras anonimizadas autorizadas e um teste supervisionado de receção, valor, moeda, referências e resultado. Este perfil não fornece artigos, turnos ou catálogos de postos e vendedores. O banco sintético não valida equipamentos físicos. Perante um resultado incerto, verifique o evoPOS, o ImaCash e o numerário real antes de repetir, repor ficheiros ou reiniciar.

Informação oficial do evoPOS na MADIC UK

Integração beta disponível

O próximo passo é validar com exportações reais do evoPOS

Contacte o suporte para preparar o exportador e combinar um teste supervisionado antes do uso comercial.