A integração por FilesTXT permite que um PDV envie vendas para ImaCash gerando arquivos.txt em um arquivo configurado. ImaCash monitora esta colagem, 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, mas recomenda-se utilizar o número do ticket para facilitar a rastreabilidade. O identificador real da operação é removido do terceiro campo de 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 linha ;.
Resposta de ImaCash
Quando a transação for concluída, ImaCash irá gerar um arquivo de resposta ao mesmo tempo usando o número do ticket.
- A operação foi concluída com o seguinte sucesso: 12347.OK
- Se a operação foi 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 está apenas na primeira linha do arquivo.
- O número do bilhete deve ser único.
- Caso o formato não possua exatamente 6 campos, o arquivo será tratado como incorreto.
- Se o arquivo estiver vazio ou não puder ser interpretado, ele será movido incorretamente.
- Em caso de instalação ou transação de óleo com carrinho, deverá ser enviado 1 como forma de pagamento.
- O separador de campos deve ser sempre ;.
Fluxo de integração
- O PDV irá gerar um arquivo.txt no arquivo configurado.
- ImaCash detecta o arquivo e a primeira linha.
- Se o formato estiver correto, crie a transação com o número do bilhete indicado.
- O arquivo original foi movido para a subpasta interna correspondente.
- Ao final da operação, ImaCash verá o arquivo de resposta vazio (.OK ou .KO) na pasta do PDV.
