A integração por FilesTXT permite que um PDV envie vendas para ImaCash gerando arquivos.txt em uma pasta configurada. ImaCash monitora essa pasta, lê os arquivos pendentes e cria a transação correspondente dentro do sistema.
Cada arquivo deve conter uma única transação na primeira linha. O nome do arquivo pode ser gratuito, embora seja recomendado utilizar o número do ticket para facilitar a rastreabilidade. O identificador real da operação é retirado do terceiro campo do conteúdo.
Exemplo de arquivo
```txt
0,10;2;12347;ALEX;2025-10-28 12:40:00;1
Formato do ficheiro
Cada linha deve ter 6 campos separados por ponto e vírgula ;.
Resposta de ImaCash
Quando a transação for concluída, ImaCash gera um arquivo de resposta na mesma pasta usando o número do ticket.
- Se a operação for concluída com sucesso: 12347.OK
- Se a operação for cancelada: 12347.KO
Esses arquivos de resposta não contêm dados; Sua presença indica o resultado da operação. O arquivo original é arquivado internamente em subpastas como processado ou erro, e a resposta visível ao PDV é o arquivo {ticket}.OK ou {ticket}.KO.
Regras importantes
- Cada arquivo.txt deve conter uma única operação.
- ImaCash lê apenas a primeira linha do arquivo.
- O número do bilhete deve ser único.
- Se o formato não tiver exatamente 6 campos, o arquivo será tratado como incorreto.
- Se o arquivo estiver vazio ou não puder ser interpretado, ele será movido para erro.
- Caso a instalação não aceite transações com cartão, 1 deverá ser enviado como forma de pagamento.
- O separador de campos deve ser sempre ;.
Fluxo de integração
- O PDV gera um arquivo .txt na pasta configurada.
- ImaCash detecta o arquivo e lê a primeira linha.
- Se o formato estiver correto, cria a transação com o número do bilhete indicado.
- O arquivo original é movido para a subpasta interna correspondente.
- Ao finalizar a operação, ImaCash gera o arquivo de resposta vazio (.OK ou .KO) na pasta do PDV.
