Integração ImaCash

Ficheros Alcornoque

Configure Ficheros Alcornoque com ImaCash: pasta exclusiva de troca, permissões, captura de pedidos de numerário e verificação dos resultados.

Marca ImaCash que identifica o perfil Ficheros Alcornoque
Outros

Configurar Ficheros Alcornoque com ImaCash

Este perfil troca ficheiros com o POS. Antes da utilização, o fornecedor deve confirmar que a instalação produz e recolhe o formato previsto para Ficheros Alcornoque. Configure a máquina de numerário separadamente; esta ficha não valida todas as edições ou modelos.

1. Preparar uma pasta exclusiva

Combine com o fornecedor uma pasta dedicada a esta instalação. O ImaCash lê e elimina pedidos e cria ficheiros de resposta nessa pasta: o utilizador Windows que executa a aplicação precisa dessas permissões. Não escolha a raiz do disco, documentos pessoais, cópias de segurança ou uma pasta com ficheiros alheios. Se for partilhada, confirme o acesso e as permissões com esse mesmo utilizador.

2. Selecionar o perfil

Abra Configuração > Integração, escolha a categoria ImaCash e selecione exatamente Ficheros Alcornoque. Não o substitua por ficherosTXT, CashDro Ficheros ou outro perfil de ficheiros: os formatos e as respostas não se consideram equivalentes.

3. Indicar Vendas

Em Vendas, utilize o seletor de pasta para indicar o caminho completo de troca confirmado. Selecione um diretório, não um ficheiro de venda. Este perfil não pede servidor SQL, base de dados, porta ou conta de ligação. Não publique o caminho privado nem os dados de acesso a uma partilha de rede.

4. Guardar ao fechar

Feche Configuração e confirme a gravação quando for solicitado; siga o reinício proposto, se aplicável. Volte a abrir a janela para verificar o caminho. Um caminho preenchido ou um indicador ligado não demonstra que a pasta existe, tem permissões ou recebe ficheiros válidos; guardar também não comprova um pagamento.

5. Compreender a captura

São lidos os ficheiros TXT disponíveis nessa pasta, sem recuperar histórico pela data de sincronização. Os pedidos são eliminados durante a captura, antes da confirmação do pagamento: preserve a rastreabilidade a partir do POS com o suporte e não partilhe a pasta entre leitores. A data vem da criação do ficheiro e não comprova a data fiscal original. O fornecedor deve validar referência, vendedor, montante, sinal, moeda e separador decimal.

6. Rever o âmbito e os filtros

Os pedidos são classificados como numerário; este perfil não discrimina pagamentos mistos nem autoriza ou liquida cartões. Não oferece catálogos próprios de lojas, terminais ou vendedores: verifique os filtros locais com casos incluídos e excluídos, sem assumir separação por empresa ou caixa. A leitura de artigos, turnos e total bancário não está validada.

7. Verificar o resultado na origem

A confirmação tenta criar uma resposta .OK ou .KO associada à referência na mesma pasta. Uma confirmação local ou a existência do ficheiro não demonstra que o POS o leu e encerrou a operação; uma resposta de cancelamento também não comprova devolução de numerário. Verifique o resultado no POS, no ImaCash e na máquina antes de dar a operação por concluída.

8. Validar antes da utilização comercial

Combine um teste supervisionado com pedidos completos no formato preparado pelo fornecedor e verifique cada resultado de ponta a ponta. Não pressuponha recuperação automática nem ausência de duplicados. Perante um resultado incerto, reveja os sistemas e o numerário real com o suporte antes de reenviar ficheiros, repetir, resincronizar ou reiniciar. Esta revisão documental não substitui a validação física.

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.