Esportazione dati

Da CometaSoftware Wiki.
Versione del 4 feb 2021 alle 10:47 di Emanuele.parenti (discussione | contributi)
(diff) ← Versione meno recente | Versione attuale (diff) | Versione più recente → (diff)
Jump to navigation Jump to search

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"
}