Timbrature

Il webservice Timbrature consente l'invio dei transiti di entrata e uscita al software di gestione presenze.

L'operazione richiede la disponibilità iniziale di file contenenti record individuali per ciascun transito. Le timbrature devono rispettare uno dei formati specifici interpretabili dal software.

Il sistema supporta diversi formati di importazione (in testo semplice). Di seguito è riportato, a titolo esemplificativo, il formato datafil:

01122508301234560000E20
TTMMGGHHNNBBBBBBCCCCVAA

T  = ID terminale
M  = Mese
GG = Giorno
HH = Ora
NN = Minuti
B  = Numero Badge
C  = Causale
V  = Verso
A  = Anno

Su richiesta e previo accordo con l'assistenza tecnica, il sistema offre la possibilità di definire formati di importazione personalizzati.

L'importazione dei dati può avvenire mediante appositi strumenti e documentazione integrativa forniti a titolo gratuito, oppure tramite l'invio autonomo dei file mediante richiesta con metodo HTTP POST.

Di seguito si riporta l'impiego del comando CURL (disponibile sui principali sistemi operativi) a scopo illustrativo:

Dall'interfaccia a riga di comando (Prompt dei comandi in ambiente Windows o Terminale) è possibile eseguire la sintassi seguente, sostituendo le voci in MAIUSCOLO (escluso POST) con i relativi valori di configurazione:

curl -X POST -H "azienda:NOMEAZIENDA" -H "password:PASSWORDPOST" -H "Content-Type:text/xml" --data-binary "@NOMEFILETIMB" -s https://server/post_timbrature.php

Parametri obbligatori

server       = Indirizzo del server utilizzato per l'accesso al programma presenze
azienda      = NOMEAZIENDA - Nome del database
password     = PASSWORDPOST - Password fornita per l'accesso al web service
NOMEFILETIMB = Nome e formato del file da trasmettere (es. datafil.txt)

ATTENZIONE sull'uso del carattere @ prima del nome file

• Con @ : il comando trasmette il contenuto del file specificato.
• Senza @ : il comando trasmette la stringa racchiusa tra le virgolette.

Codici di risposta da riga di comando
00,OK --> La procedura è stata eseguita con successo.
99,Errore "MOTIVAZIONE"  --> La procedura NON è andata a buon fine.

Esempio

Per "QUALCOSA" si intende un errore specifico (ESEMPIO: manca file, sintassi errata, manca password, azienda inesistente)