Configurare gsBase con ImaCash
gsBase è una piattaforma per sviluppare applicazioni gestionali. Questa guida descrive il profilo di scambio file di ImaCash; il fornitore deve confermare che l’applicazione installata genera e riceve tale formato. Non dimostra la compatibilità con tutti gli ERP, versioni o con l’API gsBase.
1. Preparare una cartella esclusiva
Concorda con il fornitore una cartella di scambio per una sola postazione e un solo utilizzatore dei file. L’account Windows effettivo di ImaCash deve poter elencare i file, aprire le entrate in lettura e scrittura esclusive, eliminarle e creare la sottocartella RESPUESTA e i suoi file. Non selezionare la radice di un disco, documenti, backup o cartelle di altri programmi.
2. Selezionare il profilo attuale
Apri Configurazione > Integrazione e seleziona POS > GsBase. In Vendite, scegli la directory concordata con l’icona della cartella. Questo profilo non richiede server, porta, account SQL, password o DSN. L’amministratore fornisce i dati privati dell’installazione.
3. Concordare record e riferimenti
Il lettore utilizza i .txt del livello principale. Prepara un record compatto per file, UTF-8 senza BOM e inferiore a 1 KiB, con quattro campi separati da punto e virgola: negozio; riferimento di vendita; venditore; importo. Accetta un quinto campo ma non lo usa. Il riferimento viene dal secondo campo, non dal nome del file; deve essere univoco e valido per il nome della risposta. Non includere percorsi o separatori di directory.
4. Confermare l’unità dell’importo
Il quarto campo ha due interpretazioni: se riconosciuto come intero, viene diviso per cento; altrimenti viene convertito come decimale secondo le impostazioni locali di Windows. Il fornitore deve verificare unità, separatore decimale, segno, valuta e importo risultante prima dell’uso. Non presumere che un intero rappresenti unità monetarie complete o che lo stesso testo decimale funzioni su tutti i computer.
5. Salvare e verificare l’accesso
Salva e chiudi con l’account Windows di ImaCash, usando il percorso completo e non vuoto. All’avvio il profilo tenta di preparare RESPUESTA; l’indicazione connesso non dimostra lettura del POS, formato corretto o contante. Verifica cartella, permessi, importo e ricezione delle risposte con il fornitore prima dell’uso commerciale.
6. Comprendere lettura e identificativi
Le entrate vengono eliminate dopo la lettura, prima della conferma del risultato, anche senza ottenere una vendita valida. Non esistono archivio degli elaborati o recupero storico per data. Negozio e venditore vengono dal record; il terminale è assegnato internamente e la data è quella di lettura, non una data di vendita importata. Non vengono interrogati cataloghi di negozi, casse o venditori e i filtri non dimostrano isolamento per postazione. Conserva la tracciabilità all’origine senza ripristinare file per ripetere.
7. Verificare RESPUESTA
La conferma tenta di scrivere in RESPUESTA con il riferimento di vendita ed estensione .OK, contenente importo, consegnato e resto separati da |; verifica il segno del resto con il fornitore. Una transazione contrassegnata come annullata tenta .KO con l’importo e due zeri. Il solo rifiuto non scrive risposta. La presenza di un file non dimostra che il POS lo abbia letto, chiuso la vendita o completato l’annullamento.
8. Validare il circuito e i limiti
Questo profilo registra le entrate come contante e non offre selettore Accetta carte, dettaglio bancario indipendente, prodotti, scorte o turni. Il quinto campo non dimostra un metodo di pagamento. Verifica sotto supervisione riferimenti, importi e segni, risposte nei due programmi e contante effettivo. In caso di risultato incerto, controllali prima di ripetere, ripristinare file, risincronizzare o riavviare. Una guida o connessione non costituisce una validazione fisica.
Conserviamo il logo gsBase del catalogo; la guida spiega il selettore POS attuale e sostituisce le vecchie schermate di configurazione.