Configurare FicherosTXT con ImaCash
FicherosTXT riceve richieste da un POS tramite file di testo. Il fornitore deve preparare il formato e raccogliere gli esiti prima dell’uso commerciale. Non è Ficheros Alcornoque, FicherosRCSCash o un profilo di test; il nome non convalida ogni dispositivo o sistema operativo.
1. Preparare lo scambio
Riserva una cartella a questo POS e a questa installazione. L’utente Windows di ImaCash deve poter leggere, creare, spostare ed eliminare file e creare sottocartelle. Non scegliere la radice del disco, documenti personali o backup. Verifica le condivisioni di rete con lo stesso utente; non presumere più lettori simultanei.
2. Selezionare FicherosTXT
Apri Configurazione > Integrazione, scegli la categoria ImaCash e seleziona FicherosTXT. Configura separatamente il dispositivo di gestione del contante. Il nome del metodo non rende equivalenti altri connettori di file e non richiede profili nascosti o di test.
3. Indicare la cartella
In Vendite, seleziona la directory di scambio confermata dal fornitore, non un singolo file. Le vecchie schermate possono mostrare Transazioni e un precedente pulsante Salva. Il connettore non richiede server SQL, database, porta o credenziali proprie. Mantieni privati il percorso e i dati di accesso alla condivisione di rete.
4. Preparare il TXT
Ogni file contiene una richiesta: viene letta solo la prima riga, con esattamente sei campi separati da punto e virgola. Non aggiungere intestazioni e non fare affidamento sulle righe successive. Il POS deve completare il file prima di renderlo visibile come TXT; concorda codifica e formato con il fornitore per le impostazioni locali di Windows di ImaCash.
| Campo | Contenuto da confermare con il fornitore |
|---|---|
| Importo | Importo richiesto e segno, senza separatore delle migliaia. Verifica il separatore decimale nelle effettive impostazioni locali di ImaCash. Un importo negativo non prova l’autorizzazione del rimborso. |
| Terminale | Identificativo della postazione POS conservato nella richiesta, non il modello del dispositivo. |
| Riferimento | Identificativo unico e valido dell’operazione, adatto a denominare la risposta e senza separatori di percorso. Non riutilizzarlo o modificarlo per ripetere un pagamento incerto. |
| Venditore | Identificativo o etichetta dell’operatore inviato dal POS; deve corrispondere ai filtri senza presumere un catalogo di utenti. |
| Data e ora | Data e ora interpretabili da ImaCash nelle sue impostazioni locali. Conferma formato e data operativa con il fornitore. |
| Tipo di pagamento | 1 per contanti o 0 per carta secondo il formato concordato. Non inviare altri valori né interpretare il campo come autorizzazione bancaria. |
5. Salvare alla chiusura
Chiudi Configurazione e conferma il salvataggio quando richiesto; segui il riavvio proposto, se pertinente. L’avvio verifica accesso di base alla cartella e scrittura, ma l’indicatore connesso non prova formato, spostamento dei file, incasso o ricezione della risposta da parte del POS.
6. Distinguere acquisizione e pagamento
I TXT disponibili vengono letti senza ricostruire lo storico dalla data di sincronizzazione. I file possono passare in processed quando acquisiti o esaminati localmente; non significa pagato. I file vuoti o malformati possono passare in error senza che ogni problema generi una risposta .KO. Non eliminare, modificare o reinserire questi file per forzare un incasso.
7. Verificare carte e filtri
Il tipo 1 identifica contanti e 0 carta. Accetta carte consente di includere tali richieste; non autorizza né regola il pagamento bancario e il formato non suddivide i pagamenti misti. Verifica terminale e venditore con i filtri locali; i sei campi non forniscono azienda o cassa indipendenti né cataloghi di negozi od operatori. La lettura di articoli, turni e totale bancario non è convalidata.
8. Verificare risposte e annullamento
La conferma tenta di scrivere una risposta .OK identificata dal riferimento, che può differire dal nome del TXT originale. L’annullamento usa .KO e può rinominare il proprio file di richiesta; non ogni errore di formato è un annullamento. Il POS deve usare il formato di annullamento concordato con il fornitore. La presenza del file non prova lettura o chiusura all’origine né rimborso fisico.
9. Convalidare il percorso completo
Con il fornitore, prova richiesta, acquisizione, importo e segno, esito in ImaCash e nel dispositivo e ricezione della risposta nel POS. Conferma data operativa, valuta, filtri e annullamenti ammessi senza promettere una finestra universale di due ore o assenza di duplicati. In caso di dubbio, controlla sistemi e contante reale prima di ripetere, reinviare, cambiare riferimenti, risincronizzare o riavviare. Questa revisione documentale non sostituisce una prova fisica.