Formato di interscambio registratori di cassa

Questa sezione è dedicata ai produttori di registratori di cassa che desiderano interfacciare i propri modelli con Easyfatt, nel caso in cui tali modelli non siano supportati nativamente da Easyfatt.

Il file di interscambio di Easyfatt utilizza la sintassi comune ai file INI di Windows. Vediamo un esempio:

1. [General]

2. Versione=2

3. Note=File creato da Danea Easyfatt 2013 Professional  rev. 22  build 5614  -  www.danea.it

4. MsgCortesia=Grazie e#0D#0A  arrivederci!

5. Porta=COM1 oppure Ethernet

6. IndirizzoIP=192.168.1.0

7. CodFiscalePartitaIva=CMAPTR87A10F839L

8. TotResto=0

9. TotScontrino=1469.88

10. NumRighe=3

11. NumPagam=1

12.  

13. [Pagam1]

14. Desc=Contanti

15. Importo=1469.88

16. Tender=1

17.  

18. [Riga1]

19. Desc=Assira smalto bianco

20. PercIva=20

21. Reparto=1

22. Reso=False

23. Qta=1

24. PrezzoUnitario=182.4

25. DescSconto=SCONTO 20+6%

26. ImportoSconto=45.24

27.  

28. [Riga2]

29. Desc=Caldaia Akassia 30

30. PercIva=10

31. Reparto=1

32. Reso=False

33. Qta=2

34. PrezzoUnitario=632.4

35. DescSconto=SCONTO 10%

36. ImportoSconto=126.48

37.  

38. [Riga3]

39. Desc=Caldaia Akassia 60

40. PercIva=20

41. Reparto=1

42. Reso=True

43. Qta=3

44. PrezzoUnitario=826.8

Legenda

• Riga 1
  Sezione generale, è la "testa" dello scontrino.

• Riga 2
  Versione del file: prima di procedere alla lettura della restante parte è necessario verificare la versione, in quanto a versioni differenti potrebbero coincidere sintassi e/o comandi differenti.

• Riga 3
  Note interne al file, di nessun uso nella stampa dello scontrino.

• Riga 4
  Messaggio di cortesia che verrà stampato alla fine dello scontrino. I caratteri #0D#0A segnalano la presenza di un salto riga (invio).

• Riga 5
  Porta di comunicazione con il registratore di cassa, seriale o ethernet.

• Riga 6
  Indirizzo IP della cassa, indicato quando si utilizza la porta ethernet.

• Riga 7
  Codice Fiscale o Partita Iva del cliente, presente nel caso di scontrino "parlante".

• Riga 8
  Resto, presente quando si chiude lo scontrino da PC.

• Riga 9
  Importo totale scontrino.

• Riga 10
  Il parametro indica quante righe verranno stampate nello scontrino (seguono, infatti, nelle righe 18, 28, 38).

• Riga 11
  Il parametro indica quanti pagamenti verranno utilizzati (seguono, infatti, nella riga 13).

• Riga 13
  Sezione del primo pagamento, presente quando lo scontrino è chiuso da PC.

• Riga 14
  Descrizione pagamento.

• Riga 15
  Importo pagamento.

• Riga 16
  Numero pagamento.

• Riga 19
  Descrizione della voce da stampare nello scontrino.

• Riga 21
  Reparto associato all'aliquota Iva, da usare nel caso in cui il registratore lavori per "reparti".

• Riga 22
  Se Reso=True, si tratta di un reso (quindi l'importo viene stornato dallo scontrino). Reso=False in caso di vendita normale.

• Riga 23, 33, 43
  Nelle quantità e negli importi, il simbolo decimale viene espresso con il punto (.).

• Riga 25, 26
  La descrizione e l'importo calcolato dello sconto vengono indicati solo se c'è uno sconto.

Funzionamento

Il file di interscambio viene salvato nella cartella dell'eseguibile che viene richiamato per processarlo con il nome SCONTR.TXT. Da notare che, quando viene chiamato l'eseguibile da Easyfatt, viene passato un parametro che è proprio il percorso ed il nome da trattare; si consiglia agli sviluppatori di fare riferimento al parametro e non al nome SCONTR.TXT che potrebbe essere variato in futuro.