Differenze tra le versioni di "Esportazione dati"

Da CometaSoftware Wiki.
Jump to navigation Jump to search
 
(4 versioni intermedie di uno stesso utente non sono mostrate)
Riga 3: Riga 3:
 
         Metodi presenti un questa sezione:
 
         Metodi presenti un questa sezione:
 
         <ul>
 
         <ul>
 +
            <li><b>fatture</b> metodo che ritorna le fatture</li>
 
             <li><b>presenze</b> metodo che ritorna il dettaglio delle presenze</li>
 
             <li><b>presenze</b> metodo che ritorna il dettaglio delle presenze</li>
  
Riga 11: Riga 12:
 
<br>
 
<br>
 
<table border="0" style="border:1px solid #999; border-collapse:collapse">
 
<table border="0" style="border:1px solid #999; border-collapse:collapse">
 +
    <tr>
 +
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 +
 +
<b>fatture</b></td>
 +
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>POST</td>
 +
 +
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>
 +
                  <b>application/json</b>
 +
                    <pre>
 +
{
 +
    "filtri":
 +
    {
 +
        "anno":2020,
 +
        "mese":2,
 +
        "soglia":8
 +
    },
 +
    "pagina":1,
 +
    "recordPerPagina":200
 +
}
 +
 +
</pre>
 +
                    <p><b>descrizione dei parametri</b></p>
 +
                    <table border="0" style="border:1px solid #999; border-collapse:collapse">
 +
                        <tr>
 +
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>parametro</th>
 +
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>descrizione</th>
 +
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>default</th>
 +
                            <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:owrap;'>obbligatorio</th>
 +
                        </tr>
 +
                        <tr>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>anno</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>Anno di estrazione</td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 +
                        </tr>
 +
 +
                        <tr>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>mese</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>Mese di estrazione</td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 +
                        </tr>
 +
                        <tr>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>soglia</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>valore al di sotto del quale la fattura non viene estratta</span></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>8</td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 +
                        </tr>
 +
                        <tr>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>pagina</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>numero di pagina richiesto</span></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>1</td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 +
                        </tr>
 +
                        <tr>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'><b>recordPerPagina</b></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>numero record per pagina di ritorno</span></td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'>50</td>
 +
                            <td style='border: 1px solid #999; padding: 3px; vertical-align: top;'></td>
 +
                        </tr>
 +
                    </table>
 +
 +
 +
           
 +
 +
 +
                </td>
 +
                <td style='border: 1px solid #999; padding: 3px; vertical-align: top; width:600px'>
 +
                    <p>  In caso di successo:</p>
 +
 +
                    <pre>
 +
{
 +
    "parametriDiRicerca": {
 +
        "filtri": {
 +
            "anno": 2020,
 +
            "mese": 2,
 +
            "soglia": 8.0
 +
        },
 +
        "pagina": 1,
 +
        "recordPerPagina": 100
 +
    },
 +
    "totaleRecordRicerca": 760,
 +
    "totaleRecord": 100,
 +
    "fatture": [
 +
        {
 +
            "id": 701,
 +
            "codice": "55309",
 +
            "data": "2020-02-24T00:00:00",
 +
            "tipoPagamento": null,
 +
            "totale": 68.0,
 +
            "descrizione": "OFFERTA N° 55309",
 +
            "cliente": {
 +
                "id": 9370,
 +
                "codice": "9363",
 +
                "codiceFiscale": "",
 +
                "nome": "Giovanni",
 +
                "cognome": "D'Angelo",
 +
                "email": "parentiemanuele@gmail.com",
 +
                "indirizzo": "villaglori 59",
 +
                "citta": "Catania",
 +
                "provincia": "",
 +
                "cap": "95126",
 +
                "nazione": "IT",
 +
                "telefono": "3384747730",
 +
                "cellulare": "3384747730"
 +
            },
 +
            "prodotti": [
 +
                {
 +
                    "id": 64,
 +
                    "codice": "292",
 +
                    "tipo": "biotecnologie",
 +
                    "nome": "KIT FORZA VITALE (28 giorni)",
 +
                    "descrizione": "Kit Forza Vitale composto da n.2 Q Disk Rossi e 1 Q Disk Verde",
 +
                    "quantita": 1,
 +
                    "prezzo": 55.0,
 +
                    "sconto": 0.0,
 +
                    "percentualeSconto": 0.0,
 +
                    "totale": 55.0
 +
                },
 +
                {
 +
                    "id": 137,
 +
                    "codice": "348",
 +
                    "tipo": "biotecnologie",
 +
                    "nome": "Spese di Logistica e Spedizione con corriere",
 +
                    "descrizione": "",
 +
                    "quantita": 1,
 +
                    "prezzo": 13.0,
 +
                    "sconto": 0.0,
 +
                    "percentualeSconto": 0.0,
 +
                    "totale": 13.0
 +
                }
 +
            ]
 +
            ...
 +
        }
 +
    ]
 +
}
 +
 +
I campi id sono gli identificativi univoci all'interno di Cometa.
 +
I campi codice sono i codici associati dall'utente o importati da altri sistemi.
 +
</pre>
 +
                    <p>In caso di errore:</p>
 +
 +
                    <pre>
 +
{
 +
  "successo": false,
 +
  "messaggio": "Descrizione dell'errore"
 +
}
 +
</pre>
 +
 +
                </td>
 +
 +
            </tr>
 
             <tr>
 
             <tr>
 
                 <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:nowrap;'>METODO</th>
 
                 <th style=' border: 1px solid #999; padding: 3px; font-size: 10pt; background-color: #DDD; text-transform: uppercase; white-space:nowrap;'>METODO</th>
Riga 27: Riga 180:
 
                  <b>application/json</b>
 
                  <b>application/json</b>
 
                     <pre>
 
                     <pre>
                    {
+
{
                      "anno":2020,
+
  "anno":2020,
                      "mese":"1",
+
  "mese":"1",
                      "applicativoEsterno":"TeamSystem",
+
  "applicativoEsterno":"TeamSystem",
                      "tipoRisorsa":"dipendente"
+
  "tipoRisorsa":"dipendente"
                  }
+
}
  
 
</pre>
 
</pre>
Riga 79: Riga 232:
  
 
                     <pre>
 
                     <pre>
{
+
{
"risorse": [
+
  "risorse": [
{
+
  {
"id": 84,
+
  "id": 84,
"codice": "99",
+
  "codice": "99",
"matricola": "XXX",
+
  "matricola": "XXX",
"nome": "Paolo",
+
  "nome": "Paolo",
"cognome": "Rossi",
+
  "cognome": "Rossi",
"codiceFiscale": "XXX",
+
  "codiceFiscale": "XXX",
"email": "xxx@gmail.com",
+
  "email": "xxx@gmail.com",
"nominativo": "Rossi Paolo",
+
  "nominativo": "Rossi Paolo",
"giorni": [
+
  "giorni": [
{
+
    {
"data": "2020-01-01T00:00:00",
+
    "data": "2020-01-01T00:00:00",
"giustificativi": [
+
    "giustificativi": [
{
+
      {
"id": 3,
+
      "id": 3,
"codice": "MAL",
+
      "codice": "MAL",
"descrizione": "Malattia",
+
      "descrizione": "Malattia",
"minuti": 480
+
      "minuti": 480
}
+
      }
],
+
    ],
"timbrature": [
+
    "timbrature": [
{
+
      {
"ingresso": "2020-01-01T09:00:00",
+
      "ingresso": "2020-01-01T09:00:00",
"uscita": "2020-01-01T12:45:00",
+
      "uscita": "2020-01-01T12:45:00",
"approvata": true,
+
      "approvata": true,
"minuti": 225
+
      "minuti": 225
},
+
      },
{
+
      {
"ingresso": "2020-01-01T14:00:00",
+
      "ingresso": "2020-01-01T14:00:00",
"uscita": "2020-01-01T18:00:00",
+
      "uscita": "2020-01-01T18:00:00",
"approvata": false,
+
      "approvata": false,
"minuti": 240
+
      "minuti": 240
}
+
      }
],
+
    ],
"minutiOrdinari": 300,
+
    "minutiOrdinari": 300,
"minutiStraordinari": 20,
+
    "minutiStraordinari": 20,
"minutiStraordinariNotturni": 0,
+
    "minutiStraordinariNotturni": 0,
"minutiStraordinariFestivi": 0,
+
    "minutiStraordinariFestivi": 0,
"minutiStraordinariFestiviNotturni": 0,
+
    "minutiStraordinariFestiviNotturni": 0,
"minutiStraordinariFestiviDiurni": 0,
+
    "minutiStraordinariFestiviDiurni": 0,
"minutiReperibilita": 0,
+
    "minutiReperibilita": 0,
"minutiReperibilitaFestiva": 0
+
    "minutiReperibilitaFestiva": 0
},
+
    },
  ...
+
    ...
]
+
  ]
},
+
  },
...
+
...
]
+
]
 
}
 
}
  
 
Il valore del campo codice della risorsa e della timbratura è il codice di transcodifica dell'applicativo impostato nei parametri e configurato in Cometa.
 
Il valore del campo codice della risorsa e della timbratura è il codice di transcodifica dell'applicativo impostato nei parametri e configurato in Cometa.
 +
 
Le timbrature si popolano se la rirosa effettua le timbrature.
 
Le timbrature si popolano se la rirosa effettua le timbrature.
 +
 
I campi dei minuti si popolano se la Risorsa compila il timesheet.
 
I campi dei minuti si popolano se la Risorsa compila il timesheet.
 +
 
I giustificativi di popolano se si utilizza la funzionalità di gestione dei giustificativi in cometa.
 
I giustificativi di popolano se si utilizza la funzionalità di gestione dei giustificativi in cometa.
 
</pre>
 
</pre>

Versione attuale delle 10:47, 4 feb 2021

Per eseguire i servizi presenti in questa sezione è necessario utilizzare un utente che abbia il permesso Accesso API

Metodi presenti un questa sezione:

  • fatture metodo che ritorna le fatture
  • presenze metodo che ritorna il dettaglio delle presenze


fatture POST

application/json

{
    "filtri":
    {
        "anno":2020,
        "mese":2,
        "soglia":8
    },
    "pagina":1,
    "recordPerPagina":200
}

descrizione dei parametri

parametro descrizione default obbligatorio
anno Anno di estrazione
mese Mese di estrazione
soglia valore al di sotto del quale la fattura non viene estratta 8
pagina numero di pagina richiesto 1
recordPerPagina numero record per pagina di ritorno 50



In caso di successo:

{
    "parametriDiRicerca": {
        "filtri": {
            "anno": 2020,
            "mese": 2,
            "soglia": 8.0
        },
        "pagina": 1,
        "recordPerPagina": 100
    },
    "totaleRecordRicerca": 760,
    "totaleRecord": 100,
    "fatture": [
        {
            "id": 701,
            "codice": "55309",
            "data": "2020-02-24T00:00:00",
            "tipoPagamento": null,
            "totale": 68.0,
            "descrizione": "OFFERTA N° 55309",
            "cliente": {
                "id": 9370,
                "codice": "9363",
                "codiceFiscale": "",
                "nome": "Giovanni",
                "cognome": "D'Angelo",
                "email": "parentiemanuele@gmail.com",
                "indirizzo": "villaglori 59",
                "citta": "Catania",
                "provincia": "",
                "cap": "95126",
                "nazione": "IT",
                "telefono": "3384747730",
                "cellulare": "3384747730"
            },
            "prodotti": [
                {
                    "id": 64,
                    "codice": "292",
                    "tipo": "biotecnologie",
                    "nome": "KIT FORZA VITALE (28 giorni)",
                    "descrizione": "Kit Forza Vitale composto da n.2 Q Disk Rossi e 1 Q Disk Verde",
                    "quantita": 1,
                    "prezzo": 55.0,
                    "sconto": 0.0,
                    "percentualeSconto": 0.0,
                    "totale": 55.0
                },
                {
                    "id": 137,
                    "codice": "348",
                    "tipo": "biotecnologie",
                    "nome": "Spese di Logistica e Spedizione con corriere",
                    "descrizione": "",
                    "quantita": 1,
                    "prezzo": 13.0,
                    "sconto": 0.0,
                    "percentualeSconto": 0.0,
                    "totale": 13.0
                }
            ]
            ...
        }
    ]
}

I campi id sono gli identificativi univoci all'interno di Cometa.
I campi codice sono i codici associati dall'utente o importati da altri sistemi.

In caso di errore:

{
  "successo": false,
  "messaggio": "Descrizione dell'errore"
}
METODO HTTP Verb PARAMETRI RISULTATO
presenze POST

application/json

{
  "anno":2020,
  "mese":"1",
  "applicativoEsterno":"TeamSystem",
  "tipoRisorsa":"dipendente"
}

descrizione dei parametri

parametro descrizione default obbligatorio
anno Anno di estrazione SI
mese Mese di estrazione SI
applicativoEsterno nome applicativo Esterno di si cui è configurata la transcodifica in Cometa
tipoRisorsa valori possibili: dipendente, collaboratore, esterno



In caso di successo:

{
  "risorse": [
  {
   "id": 84,
   "codice": "99",
   "matricola": "XXX",
   "nome": "Paolo",
   "cognome": "Rossi",
   "codiceFiscale": "XXX",
   "email": "xxx@gmail.com",
   "nominativo": "Rossi Paolo",
   "giorni": [
    {
     "data": "2020-01-01T00:00:00",
     "giustificativi": [
      {
       "id": 3,
       "codice": "MAL",
       "descrizione": "Malattia",
       "minuti": 480
      }
     ],
     "timbrature": [
      {
       "ingresso": "2020-01-01T09:00:00",
       "uscita": "2020-01-01T12:45:00",
       "approvata": true,
       "minuti": 225
      },
      {
       "ingresso": "2020-01-01T14:00:00",
       "uscita": "2020-01-01T18:00:00",
       "approvata": false,
       "minuti": 240
      }
     ],
     "minutiOrdinari": 300,
     "minutiStraordinari": 20,
     "minutiStraordinariNotturni": 0,
     "minutiStraordinariFestivi": 0,
     "minutiStraordinariFestiviNotturni": 0,
     "minutiStraordinariFestiviDiurni": 0,
     "minutiReperibilita": 0,
     "minutiReperibilitaFestiva": 0
    },
     ...
   ]
  },
 ...
 ]
}

Il valore del campo codice della risorsa e della timbratura è il codice di transcodifica dell'applicativo impostato nei parametri e configurato in Cometa.

Le timbrature si popolano se la rirosa effettua le timbrature.

I campi dei minuti si popolano se la Risorsa compila il timesheet.

I giustificativi di popolano se si utilizza la funzionalità di gestione dei giustificativi in cometa.

In caso di errore:

{
  "successo": false,
  "messaggio": "Descrizione dell'errore"
}